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.0/SanAndreasUnity-3.0-windows.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](https://github.com/GTA-ASM/SanAndreasUnity/wiki/Running-on-Linux), Windows, Mac, Android and [PS Vita](https://github.com/GTA-ASM/SanAndreasUnity/wiki/Building-for-PS-Vita). 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.

Our official server:

- IP: 34.90.25.177

- Port number: 7777 for Main scene, 7778 for Demo scene


## 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)