Project Open Residential  -  Version 1.0.1 - 10 august 2025

The objective of Project Open Residential is to restore the source
code of Residential District, namely "ste.mis" and ALL the missions
therein from the partially decompiled ste.scr.

To get the compiled code, just extract "ste.mis" and the folder "ste"
together and run "ste.mis" in the miss2.exe compiler (made by DMA Design).

OBSERVATION: do NOT use the embedded compiler of mispad, it will give you
an error. Use the official compiler instead.
Download: https://gtamp.com/GTA2/gta2script.7z

To install this open source version of Downtown District into GTA2, just
move all contents of the folder "Compiled script" into /GTA2/data/

Alternatively, you can compile the source code and drag "ste.scr" 
into /GTA2/data/ and all other .SCR missions compiled files 
to /GTA2/data/ste/

OBSERVATION: You must not forget to copy those .SCR missions compiled files
(such as ste_end.scr, ste_re1.scr etc) to /GTA2/data/ste/ to make it work properly.
Any desynchronization between ste.scr and its missions files in
/GTA2/data/ste/ will potentially lead to a crash.

You can change the counter "fix_wang_cars_glitch" in ste.mis to restore
or fix the duplicate glitch of wang cars which is present on v9.6.

Greetings from Valps.

----------------------------

Github:  https://github.com/Valps/Project_Open_Residential
GtaMP: https://gtamp.com/forum/viewtopic.php?t=1392

----------------------------

Version 1.0.1:

- The redneck yellow mission doesn't crash anymore. It was caused by a slow
  setup of the mission "Tanks-Giving", and if the player answer the other
  phone fast enough it will crash the game. This is fixed now.
  (Thanks Tezuro for finding this bug)

- The scientist mission "Redneck Attack!" now has a faster cleanup. 
  This means that if you start another mission right after finishing 
  "Redneck Attack!", the probability of crashing the game will be reduced.
  (Also Thanks Tezuro)

Version 1.0.0:

- The most important variables (functions, triggers, objects, counters,
saved counters etc.) now have intelligible names.
- Fixed the redneck medium phone (no more softlocks or
duplicated "Tanks-Giving")
- Restored the bug of getting 6 wanted level multiple times in mission
"Tanks-Giving", since it is exploited by speedrunners.

Version 0.3.0:

- All Zaibatsu Missions
- I did some little changes using some briefs that are missing in original missions:
* "Fire Truck Fun":
  - First: Now if you destroy the cop car you're using before approaching
  the van, a unused brief will display on screen.
  - Second: Now the reward brief is properly displayed after finishing the mission.
* "Operation Z"
  - The SRS Meteor driver will pursue you after getting his car robbed. It
  doesn't feature in original because of a little mistake made by its
  designer.

Version 0.2.0:

- All Scientist Missions
- Prison alarm lights of the mission "Penal Ties" were fixed.

- Now you can choose if you want to restore or maintain the wang cars
  glitch fixed simply by changing the counter "fix_wang_cars_glitch"
  in ste.mis

- Now the three Zaibatsu assassins in the mission "Labrat's Plan" are free.
  After 25 years, they were finally released from their
  zaibatsu garages and they will bother you with a silenced machine gun,
  flamethrower and even rocket launcher. I just moved their spawn point,
  so the mission will behave as it was intended by the original designer
  (Stephen Banks?). You can restore the original behavior (three assassins
  stuck) by copying and paste the original spawn coordinates in ste_sm1.mis


Version 0.1.0:

Includes:
- All objects, parked cars, powerups, sounds, cranes, trains, gangs, kill frenzies etc.
- All Wang cars working
- All Redneck Missions
- The gang shoot-out in the beginning
- "The Final Job" Mission

Fixing some original ste.scr issues:
- Redneck crane fixed
- Now the Army guards in mission "Tanks-Giving" does not shoot at each other.

----------------------------

Known issues:

- None for now.   :D
- If you find a bug or crash, tell me at gtamp forum or open an issue in github.

----------------------------

Credits:

Valps - Rework of the code
TradeMark (T.M.) - for his decompiler
Ben Millard & Pyro - for all the script info in Project Cerbera
Sektor - for keeping up GTAMP forum and Game Hunter
Jernej and B-$hep - for GXT editor