Skip to content

Latest commit

 

History

History
38 lines (22 loc) · 2.59 KB

README.md

File metadata and controls

38 lines (22 loc) · 2.59 KB
Raw

NOTE: This is only a mirror, do not create issues or pull requests here, you can do that on original repository which is hosted on GitLab.

gtasa-reversed

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

Build Instructions

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

  2. Open CMake GUI CMake GUI

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

CMake GUI

  1. Click configure, you'll see a dialogue box, choose "Visual Studio 15 2017," and click Finish.

CMake GUI

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

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, it will hook these reversed functions, if your game crashes, then it means there's some problem with the code and it has to be fixed, otherwise if the game runs smoothly, our code works, and we can focus on reversing more functions and classes, that's pretty much it.

Motivation

I'm an active contributor for Multi Theft Auto San Andreas, which is a project that adds multiplayer functionality to GTA:SA. GTA:SA was reversed by MTA team and many other hackers on GTA related forum, they documented the addresses of GTA functions, but almost no one seems to rewrite the code in readable and compilable C++, that is the main reason why this project was created. Currently, MTA:SA has barely any active contributors because to add new features, you must know how to reverse GTA:SA, so to make it easier for new contributors, rewriting and documenting these functions in C++ will allow them to understand how GTA:SA works internally without the need of understanding ASM or any low level stuff.

Advice

The goal is to rewrite every GTA:SA function exactly as you see in the executable, so anyone who is trying to reverse GTA:SA should find this project helpful.

  • It's okay to do minor improvements if deemed necessary.
  • Use naming convention of plugin-sdk project.

Credits

TODO