/gta-reversed

Reversed code of GTA:SA executable (gta_sa.exe) 1.0 US

Primary LanguageC++

gtasa-reversed Build Status

A project to reverse Grand Theft Auto San Andreas completely, and to rewrite and document every function.

Discord

Join our discord server. You can request us to decompile a function for you. If you wish to contribute, then we'll be happy to assist you.

What exactly is this project?

Building this project will result in a DLL file, that DLL file can be injected into GTA:SA using any ASI loader out there. After the DLL file has been injected, the ingame functions will be replaced by the reversed code. The game will behave exactly the same. Now if we make any changes to the reversed code, it will take effect in the game. The goal is to keep reversing until we have the entire game reversed to compile a standalone executable.

Progress

The progress of reversed classes can be tracked here.

Build Instructions

You can either build with Premake5 or CMake, that's up to you.

Premake5
  1. Clone the project, including the submodules git clone --recurse-submodules https://github.com/codenulls/gta-reversed.git.

  2. Execute premake5.bat (Visual Studio 2019 is required)

  3. You'll find gta_reversed.sln shortcut in the same folder as premake5.bat.

CMake
  1. Download and install latest CMake for windows from HERE.

  2. Open CMake GUI Capture

  3. Clone the project, including the submodules git clone --recurse-submodules https://github.com/codenulls/gta-reversed.git.

  4. Set the Source and Build directories (Don't forget to append "Bin" after the path for build), like this:

Capture

  1. Click configure, you'll see a dialogue box. Choose "Visual Studio 16 2019" and "Win32," then click Finish.

CMakeSettings

  1. Once configuration is complete, click the Generate button.
  2. You'll find GTASA.sln in Bin folder.

Credits