Grand Theft Auto: San Andreas
About the project
Grand Theft Auto: San Andreas es un videojuego de acción-aventura de mundo abierto de disparos en tercera persona desarrollado por Rockstar North y publicado por Rockstar Games. Es el quinto videojuego principal de la serie Grand Theft Auto, después de Grand Theft Auto: Vice City de 2002, y la séptima entrega en general. Ambientado en el estado estadounidense ficticio de San Andreas, el juego sigue a Carl "CJ" Johnson, que regresa a casa después del asesinato de su madre y descubre que su antigua banda ha perdido gran parte de su territorio.
2 versions of Grand Theft Auto: San Andreas
You're viewing: Grand Theft Auto: San Andreas
Official project information
gtasa-reversed 
A project to reverse Grand Theft Auto San Andreas completely, and to rewrite and document every function.
Community
Please join our community Discord: GTA Groupies [The invite is permanent, feel free to share it!]
About the project
Building this project will result in a DLL file that 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 ones. The game will behave 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. (needs to be updated) We currently estimate that about 50-60% of the code is done. Since this project is done as a hobby, and worked on at irregular intervals, there's no time estimate on when it'll be finished.
Build Instructions
0. Requirements/Prerequisites
- Visual Studio 2026
- Python >= 3.x (For Conan)
- Conan (>= 2.x)
- CMake (>= 4.2.0)
1. Install Python and Conan
- Install the latest Python [When installing make sure to tick the "Add to PATH" checkbox!]
- Install Conan using
pip install conan[You might need to reload the console if you've freshly installed Python.] (See guide) - If you are installing Conan for the first time, also run
conan profile detect
2. Setting up VS
- Run the setup script with
python setup.py- It defaults towindows-msvcx86 Debug. If you want a different configuration you have to pass Conan config/options to the script (ex.:python setup.py -s arch=x86 -s build_type=Release) or use custom profiles. - Open the folder with VS's native CMake integration (Right click -> "Open in Visual Studio") - The
.slngenerated by CMake should (in theory) work as well, but the CMake integration works somewhat better. - If you'd just like to build use
python setup.py --build(Or if you're experienced withconan, you can use it directly as well)
3. Set up the game and ASI
- GTA SA Compact exe: Our code requires you to use this exe, otherwise you will experience random crashes. You must own the original game and assets for this to work.
[!IMPORTANT] GTA SA Compact exe is not the same as 1.0 US exe, so check that your executable is exactly
5'189'632 bytes(4.94 MiB).
-
To install all the necessary files (after building the project!), run
contrib/install.pywith administrator privileges [Necessary to create symlinks on Windows] in the root directory. Alternatively, you can install them by yourself:- ASI Loader
- Mouse Fix (dinput8.dll) [Can be found in the zip in the
contribfolder]
You can download them in a single archive.
Other plugins
Using other (than the ones we've tested) plugins is strongly discouraged and we provide no support.
Contributing
Coding/Contributing Guidelines
Before you start writing code, please make sure to read the coding guidelines for this project. Consider these points before opening a PR:
- Follow the coding guidelines, it exists for a reason.
- Try to focus your changes onto single subject, do not create PRs that cover many things at once. This is because it's hard to properly test and review such PRs.
- If you intend to add non-vanilla features please first consult with us, so you don't waste your time.
What to work on?
Check out this discussion for some inspiration ;)
Debugging
- Make sure the latest DLL is in the
scriptsfolder of your GTASA installation - Skip this step if you've usedcontrib/install.py(As it uses symlinks (To the debug version)!) - Launch the game
- Attach using the ReAttach plugin to make your life easier
Credits
- All contributors of the plugin-sdk project.
- All contributors of the original project.
- Hundreds of great people on gtaforums.com.
- re3 team.
- And everyone who contributed to GTA:SA reversing.