in0finite/SanAndreasUnity

Open source reimplementation of GTA San Andreas game engine in Unity

C#

2,644

2,070 commits

updated Jun 16, 2023

See the code

README

San Andreas Unity



   

San Andreas Unity is an open source reimplementation of GTA San Andreas game engine in Unity.

This won't be a complete reimplementation, but the focus is on gameplay features, mutliplayer, and creating a framework which will allow easy game extending and unlimited modding possibilities.

For more information about the project, read this wiki page.

When running for the first time, the game will ask you for path to GTA installation. You need to own GTA in order to play it.

Download

Download it for Windows, Linux or Android.

The game is tested on Linux, Windows, Mac, and Android. It supports both Mono and IL2CPP scripting backends, so it can be built for any platform that Unity supports, provided that you can copy PC version of GTASA to target device.

Multiplayer

Game fully works in multiplayer. You can start the game as dedicated server, as a host (server & client at the same time), or you can connect to a server. This works on all supported platforms, which means you can start a host even on Android device.

If you want to host a server, take a look at command line instructions and server administration.

Development setup

  • clone the project, including submodules: git clone --depth 1 --recurse-submodules https://github.com/GTA-ASM/SanAndreasUnity
  • open the project with Unity 2020.3.26 or newer
  • open startup scene located at Assets/Scenes/Startup.unity
  • press Play button

In-game controls

Press Escape while in game to open pause menu. You'll see there a lot of utilities, and among them, there is a window which shows all controls.

Game modes

Game can be extended through plugins/game modes in the form of C# DLLs. More info on wiki.

Contributing

Join us on discord to discuss about development.

You can check out issues for newcomers, issues related to importing assets from original game, or the whole list of issues.

Issues that are in focus right now are those with high priority label and those found in milestones.

Screenshots

Videos

game-engine
gta
reimplementation
unity3d

in0finite/SanAndreasUnity

Open source reimplementation of GTA San Andreas game engine in Unity

C#

2,644

2,070 commits

updated Jun 16, 2023

See the code

README

San Andreas Unity



   

San Andreas Unity is an open source reimplementation of GTA San Andreas game engine in Unity.

This won't be a complete reimplementation, but the focus is on gameplay features, mutliplayer, and creating a framework which will allow easy game extending and unlimited modding possibilities.

For more information about the project, read this wiki page.

When running for the first time, the game will ask you for path to GTA installation. You need to own GTA in order to play it.

Download

Download it for Windows, Linux or Android.

The game is tested on Linux, Windows, Mac, and Android. It supports both Mono and IL2CPP scripting backends, so it can be built for any platform that Unity supports, provided that you can copy PC version of GTASA to target device.

Multiplayer

Game fully works in multiplayer. You can start the game as dedicated server, as a host (server & client at the same time), or you can connect to a server. This works on all supported platforms, which means you can start a host even on Android device.

If you want to host a server, take a look at command line instructions and server administration.

Development setup

  • clone the project, including submodules: git clone --depth 1 --recurse-submodules https://github.com/GTA-ASM/SanAndreasUnity
  • open the project with Unity 2020.3.26 or newer
  • open startup scene located at Assets/Scenes/Startup.unity
  • press Play button

In-game controls

Press Escape while in game to open pause menu. You'll see there a lot of utilities, and among them, there is a window which shows all controls.

Game modes

Game can be extended through plugins/game modes in the form of C# DLLs. More info on wiki.

Contributing

Join us on discord to discuss about development.

You can check out issues for newcomers, issues related to importing assets from original game, or the whole list of issues.

Issues that are in focus right now are those with high priority label and those found in milestones.

Screenshots

Videos

game-engine
gta
reimplementation
unity3d

Significant stargazers

Hennadii Chernyshchyk

157 followers · starred Mar 2024

xctan

105 followers · starred Nov 2023

rkfg

65 followers · starred Sep 2019

Yotam Barnoy

59 followers · starred Feb 2021