Build the engine

Build and self-test the Alt:SA engine from source. For contributors with access to the private repository.

For contributors with access to the private Alt-SAMP/Engine repository.

Requirements#

  • Unity 2020.3.26f1 exactly.
  • Your own copy of the classic PC GTA San Andreas.
  • Git with submodules.

Steps#

  1. Install the exact Unity version:
Shell
1unity install 2020.3.26f1 -c 7298b473bc1a --no-cm -y
  1. Clone the engine with its submodules:
Shell
1git clone --recurse-submodules https://github.com/Alt-SAMP/Engine.git
  1. Create config.user.json in the repository root with your game folder:
JSON
1{ "game_dir": "C:/Games/GTA San Andreas" }
  1. Build and self-test:
Shell
1Tools/build.sh                # Build/Alt-SA/Alt-SA.exe2Tools/run-autotest.sh         # single player3Tools/run-autotest.sh mp      # host + client

The repository's AGENTS.md has the full setup, the code map and known issues. The unity-dev-build and unity-autotest skills explain the build and self-test in depth.