lmmloli / gta-reversed-modern Goto Github PK

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

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.

The progress of reversed classes can be tracked here. (needs to be updated)

Before you start writing code, please make sure to read the coding guidelines for this project.

• Visual Studio 2022 (Community Edition is enough)
• CMake (for those who want to use CMake instead of premake5)

• GTA SA Compact exe
• ASI Loader
• III.VC.SA.WindowedMode.asi
• Improved Fast Loader (Optional)
• Mouse Fix (dinput8.dll)

You can download them in a single archive. Using other plugins is strongly discouraged as the compact version doesn't like them.

You can either build with Premake5 or CMake; that's up to you, but a C++20 capable compiler with support is required.

First clone the project, including the submodules:

git clone --recurse-submodules https://github.com/gta-reversed/gta-reversed-modern.git

You can create symbolic links for artifacts to not copy them every time you compiled the project.

Open a console with administrator privileges in the git repo's directory and run contrib\link_asi.bat or right click link_asi.bat file and click Run as administrator, then follow instructions at the command window.

Check this out for some inspiration ;)

• 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.