SanAndreasUnity/README.md

# San Andreas Unity

<br>

<div align="center">
    <img src="https://i.imgur.com/aIojfPW.png" width="320" height="320">
    <br>
    <a href="https://discord.gg/p6jjud5"> <img src="https://img.shields.io/discord/454006273751515152.svg"></a>
    &nbsp;
    <a href="https://gtaforums.com/topic/912395-san-andreas-unity/"> <img src="http://i.imgur.com/Fatp2jZ.png" width="50" height="30"></a>
    &nbsp;
    <a href="https://www.youtube.com/channel/UCsslP7vqD06AMh6JlEy0pkg"> <img src="https://upload.wikimedia.org/wikipedia/commons/thumb/0/09/YouTube_full-color_icon_%282017%29.svg/71px-YouTube_full-color_icon_%282017%29.svg.png" width="30" height="21"> </a>
</div>

<br>

San Andreas Unity is an open source recreation of GTA San Andreas in Unity.

This won't be a complete recreation, 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](https://github.com/GTA-ASM/SanAndreasUnity/wiki/About-project).

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](https://github.com/GTA-ASM/SanAndreasUnity/releases/download/v3.2/SanAndreasUnity-3.2-windows.zip), [Linux](https://github.com/GTA-ASM/SanAndreasUnity/releases/download/v3.2/SanAndreasUnity-3.2-linux.zip), [Android](https://github.com/GTA-ASM/SanAndreasUnity/wiki/Running-on-Android) or [Linux server](https://github.com/GTA-ASM/SanAndreasUnity/releases/download/v3.0/SanAndreasUnity-3.0-linuxserver.zip).

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.

Currently, the game doesn't have things like client-side prediction.

If you want to run a dedicated server, take a look at these [instructions](https://github.com/GTA-ASM/SanAndreasUnity/wiki/Command-line).


## Development setup

- clone the project, including submodules: `git clone --depth 1 --recurse-submodules https://github.com/GTA-ASM/SanAndreasUnity`
- open the project with Unity 2018.3
- 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.

## TODO list

Here is an extensive list of [what should be implemented](/Docs/TODO.md).

Can help us to develop this ? In that case, join us on discord so we can discuss about it.

## Screenshots

![](https://cloud.githubusercontent.com/assets/557828/24571348/d964f098-1670-11e7-8759-0160dbf5bcb5.png)

![](https://cloud.githubusercontent.com/assets/557828/24571349/d96b7c24-1670-11e7-997d-ae15913481f8.png)

![](https://i.imgur.com/HX978mr.png)

## Videos

###

[![](http://img.youtube.com/vi/PItR-0FF7JI/0.jpg)](https://www.youtube.com/watch?v=PItR-0FF7JI)

###

[![](http://img.youtube.com/vi/-3GAjTSLUUg/0.jpg)](https://www.youtube.com/watch?v=-3GAjTSLUUg)

###

[![](http://img.youtube.com/vi/GMxJ6u3Jbak/0.jpg)](https://www.youtube.com/watch?v=GMxJ6u3Jbak)

###

[![](http://img.youtube.com/vi/4DpdcawFjG4/0.jpg)](https://www.youtube.com/watch?v=4DpdcawFjG4)