# in0finite/sanandreasunity architecture

> Architecture diagram of the GitHub repository in0finite/sanandreasunity, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-06-10). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/in0finite/sanandreasunity
- Repository: https://github.com/in0finite/sanandreasunity

## Overview

##### Project type and purpose
- San Andreas Unity is an open-source reimplementation of the GTA San Andreas engine in Unity. Its focus is on gameplay fidelity, multiplayer support, and a modular plugin system for game modes and modding.

##### File structure
- Top-level directories:
- Assets – Unity assets (Materials, Prefabs, Resources, Scenes, Scripts, Shaders, Sprites, Textures)
- Scripts/Importing – loaders and converters for GTA data formats (audio, collision, models, animations, items, etc.)
- Scripts/Behaviours – runtime gameplay logic (GameManager, WorldManager, Ped/Vehicle controllers, AI state machines, UI managers)
- Scripts/Networking – Mirror-based sync code (CustomNetworkManager, PedSync, VehicleSync, MasterServerClient)
- Scripts/UI, Scripts/Chat, Scripts/Commands – front-end interfaces and in-game console/commands
- Scripts/Editor – custom Unity Editor windows and tools (NavMeshGenerator, AssetExporter, FrameInspector)
- ProjectSettings, Packages – Unity engine configuration
- Docs – design notes (multiplayer, performance, import flow)

##### README for additional insights
- Uses Unity 2020.3+, Mono/IL2CPP backends
- Supports dedicated server, host, and client modes
- Plugins (game modes) load as C# DLLs
- Original GTA installation is an external dependency (importer asks for its path)

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% External Systems
    subgraph "External Systems"
        GDATA["GTA RPF Archives"]:::external
        UNITY["Unity Engine\n(Rendering, Physics, Input)"]:::external
    end

    %% Importer Subsystem
    subgraph "Importer Subsystem" 
        direction TB
        AM["ArchiveManager"]:::importer
        AI["Audio Importers"]:::importer
        CI["Collision Importers"]:::importer
        CONV["Geometry/Texture Converters"]:::importer
        GXT["GXT Importer"]:::importer
        ITEMS["Item Importers"]:::importer
        RW["RenderWare Parsers"]:::importer
        VI["Vehicle Importers"]:::importer
        WI["Weapon Importers"]:::importer
    end

    %% Editor Tools
    subgraph "Editor Tools"
        direction TB
        AE["AssetExporter"]:::buildtools
        AEW["AssetExporterWindow"]:::buildtools
        NG["NavMeshGenerator"]:::buildtools
        NGW["NavMeshGeneratorWindow"]:::buildtools
        NGC["NavMeshGeneratorCommandLine"]:::buildtools
        FI["FrameInspector"]:::buildtools
        PI["PedAIInspector"]:::buildtools
        SGI["StaticGeometryInspector"]:::buildtools
        WFI["WaterFaceInfoInspector"]:::buildtools
    end

    %% Core Runtime
    subgraph "Core Runtime"
        direction TB
        SC["Scenes"]:::runtime
        SC1["Startup Scene"]:::runtime
        SC2["Main Scene"]:::runtime
        SC3["Demo Scene"]:::runtime
        GM["GameManager"]:::runtime
        subgraph "Managers"
            direction TB
            WM["WorldManager"]:::runtime
            PMgr["PedManager"]:::runtime
            VMgr["VehicleManager"]:::runtime
            UIM["UIManager"]:::runtime
            AMgr["AudioManager"]:::runtime
            PFM["PathfindingManager"]:::runtime
        end
        subgraph "Behaviour Modules"
            direction TB
            PB["Ped Behaviours"]:::runtime
            VB["Vehicle Behaviours"]:::runtime
            WB["Weapon Behaviours"]:::runtime
            WB2["World System Modules"]:::runtime
        end
        subgraph "Settings"
            direction TB
            CS["CameraSettings"]:::runtime
            IS["InputSettings"]:::runtime
            NS["NetSettings"]:::runtime
            MS["MiscSettings"]:::runtime
            QS["QualitySettings"]:::runtime
            SS["SoundSettings"]:::runtime
            WS["WorldSettings"]:::runtime
        end
    end

    %% Networking Layer
    subgraph "Networking Layer"
        direction TB
        CNM["CustomNetworkManager"]:::networking
        MSC["MasterServerClient"]:::networking
        PSYNC["PedSync"]:::networking
        VSYNC["VehicleSync"]:::networking
        WSYNC["WeaponSync"]:::networking
        NDM["NetworkDiscoveryManager"]:::networking
        TS["TransformSyncer"]:::networking
    end

    %% Plugin System
    subgraph "Plugin System"
        direction TB
        PMGR["PluginManager"]:::runtime
        GMM["GameModeManager"]:::runtime
    end

    %% Data Flows
    GDATA -->|"GTA RPF archives"| AM
    AM --> AI & CI & CONV & GXT & ITEMS & RW & VI & WI
    AI & CI & CONV & GXT & ITEMS & RW & VI & WI -->|"Unity AssetDatabase"| UNITY

    %% Build-time tools integration
    UNITY -->|"Provides Assets"| AE & NG & FI
    AE & AEW & NG & NGW & NGC & FI & PI & SGI & WFI -->|"Export/Processing"| UNITY

    %% Runtime startup
    SC1 & SC2 & SC3 -->|loads| GM
    GM --> WM & PMgr & VMgr & UIM & AMgr & PFM
    WM --> WB2
    PMgr --> PB
    VMgr --> VB
    WB2 & PB & VB -->|"simulate"| UNITY
    PB & VB & WB -->|"trigger SFX"| AMgr
    UIM <-- GM
    PB & VB & WB <--> PSYNC & VSYNC & WSYNC
    CNM & NDM & MSC -->|discovery/RPCs| PSYNC & VSYNC & WSYNC & TS
    TS --> UNITY

    %% Input flow
    UNITY -->|"Player Input"| GM

    %% Plugin hooks
    GMM & PMGR --> GM & WM & PMgr & VMgr

    %% Settings
    CS & IS & NS & MS & QS & SS & WS --> GM & WM & PMgr & VMgr & UIM & AMgr

    %% Click Events - Importer Subsystem
    click AM "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Importing/Archive/ArchiveManager.cs"
    click AI "https://github.com/in0finite/sanandreasunity/tree/dev/Assets/Scripts/Importing/Audio/"
    click CI "https://github.com/in0finite/sanandreasunity/tree/dev/Assets/Scripts/Importing/Collision/"
    click CONV "https://github.com/in0finite/sanandreasunity/tree/dev/Assets/Scripts/Importing/Conversion/"
    click GXT "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Importing/GXT/GXT.cs"
    click ITEMS "https://github.com/in0finite/sanandreasunity/tree/dev/Assets/Scripts/Importing/Items/"
    click RW "https://github.com/in0finite/sanandreasunity/tree/dev/Assets/Scripts/Importing/RenderWareStream/"
    click VI "https://github.com/in0finite/sanandreasunity/tree/dev/Assets/Scripts/Importing/Vehicles/"
    click WI "https://github.com/in0finite/sanandreasunity/tree/dev/Assets/Scripts/Importing/Weapons/"

    %% Click Events - Editor Tools
    click AE "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Editor/AssetExporter.cs"
    click AEW "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Editor/AssetExporterWindow.cs"
    click NG "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Editor/NavMeshGenerator.cs"
    click NGW "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Editor/NavMeshGeneratorWindow.cs"
    click NGC "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Editor/NavMeshGeneratorCommandLine.cs"
    click FI "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Editor/FrameInspector.cs"

    %% Click Events - Core Runtime Managers
    click GM "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Behaviours/GameManager.cs"
    click WM "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Behaviours/World/WorldManager.cs"
    click PMgr "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Behaviours/PedManager.cs"
    click VMgr "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Behaviours/Vehicles/VehicleManager.cs"
    click UIM "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Behaviours/UIManager.cs"
    click AMgr "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Behaviours/Audio/AudioManager.cs"
    click PFM "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Behaviours/PathfindingManager.cs"

    %% Click Events - Networking
    click CNM "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Networking/CustomNetworkManager.cs"
    click MSC "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Networking/MasterServerClient.cs"
    click PSYNC "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Networking/PedSync.cs"
    click VSYNC "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Networking/VehicleSync.cs"
    click WSYNC "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Networking/WeaponSync.cs"
    click NDM "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Networking/NetworkDiscoveryManager.cs"
    click TS "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Networking/TransformSyncer.cs"

    %% Click Events - Plugin System
    click PMGR "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Behaviours/PluginManager.cs"
    click GMM "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/GameModes/GameModeManager.cs"

    %% Click Events - Scenes
    click SC1 "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scenes/Startup.unity"
    click SC2 "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scenes/Main.unity"
    click SC3 "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scenes/Demo.unity"

    %% Click Events - Settings
    click CS "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Settings/CameraSettings.cs"
    click IS "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Settings/InputSettings.cs"
    click NS "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Settings/NetSettings.cs"
    click MS "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Settings/MiscSettings.cs"
    click QS "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Settings/QualitySettings.cs"
    click SS "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Settings/SoundSettings.cs"
    click WS "https://github.com/in0finite/sanandreasunity/blob/dev/Assets/Scripts/Settings/WorldSettings.cs"

    classDef importer fill:#cfe2f3,stroke:#6aa2c9
    classDef buildtools fill:#cfe2f3,stroke:#6aa2c9
    classDef runtime fill:#d9ead3,stroke:#6aa84f
    classDef networking fill:#ffe599,stroke:#d79b00
    classDef external fill:#cccccc,stroke:#888888
```
