# kasnervlad/projectgun architecture

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

- Interactive diagram: https://gitdiagram.com/kasnervlad/projectgun
- Repository: https://github.com/kasnervlad/projectgun

## Overview

##### Project Type and Purpose
- This is a Unity-based game project (ProjectGun) that uses Unity’s Starter Assets (First-Person, Third-Person, Mobile), custom scripts (inventory, save/load, weapon system, UI), environment art, and Unity’s render pipelines.
- The minimal README suggests it’s likely an FPS (or hybrid) sample demonstrating player movement, inventory, weapon handling, and persistent data.

##### File Structure
- Top‐Level:
- Assets/ – all game content (Scenes, StarterAssets, custom Scripts, Art, Prefabs)
- Packages/ & ProjectSettings/ – Unity configuration and package manifests
- README.md, .gitignore, .gitattributes
- Key Directories under Assets/StarterAssets:
- FirstPersonController/ThirdPersonController/Mobile – movement controllers & input setups
- Environment – scene geometry, materials, prefabs
- InputSystem – Unity InputActions definitions
- StarterAssets Settings – URP/HDRP asset configs
- Scripts subfolders:
– PlayerActions, WeaponSystem, SOLIDInventory, SaveSystem, Custom utilities
- The pattern is a modular game architecture: each subsystem isolated under its own folder.

## Diagram (Mermaid)

```mermaid
graph TD

    %% Engine Core
    EngineCore["Unity Engine Core"]:::engine

    %% Resource Layer
    subgraph "Resource Layer"
        direction TB
        SceneAssets["Scene Graph & Assets"]:::assets
        EnvArt["Environment Art"]:::assets
        EnvPrefabs["Environment Prefabs"]:::assets
    end

    subgraph "Configuration"
        direction TB
        RenderPipelines["Render Pipeline Profiles"]:::config
        StarterSettings["StarterAssets Settings"]:::config
        ExternalDeps["External Dependencies"]:::config
    end

    %% Input and Controllers
    subgraph "Input & Controllers"
        direction TB
        InputSystem["Input System Module"]:::code
        FPSController["First-Person Player Controller"]:::code
        TPSController["Third-Person Player Controller"]:::code
    end

    %% Game Systems
    subgraph "Game Systems"
        direction TB
        WeaponSystem["Weapon System"]:::code
        InventorySystem["Inventory System"]:::code
        SaveSystem["Save/Load Subsystem"]:::code
    end

    %% UI Layer
    subgraph "UI Module"
        direction TB
        UILoading["Loading Screen Logic"]:::code
        UIMobile["Mobile Controls Prefabs"]:::assets
    end

    %% Connections
    EngineCore -->|provides Rendering/Physics| SceneAssets
    EngineCore -->|provides Rendering/Physics| EnvArt
    EngineCore -->|provides Rendering/Physics| EnvPrefabs
    EngineCore -->|core services| InputSystem
    EngineCore -->|core services| FPSController
    EngineCore -->|core services| TPSController
    EngineCore -->|core services| WeaponSystem
    EngineCore -->|core services| InventorySystem
    EngineCore -->|core services| SaveSystem
    EngineCore -->|core services| UILoading
    EngineCore -->|core services| UIMobile

    SceneAssets -->|loaded by| FPSController
    SceneAssets -->|loaded by| TPSController
    EnvArt -->|used by| SceneAssets
    EnvPrefabs -->|used by| SceneAssets

    RenderPipelines -->|configures rendering| EngineCore
    StarterSettings -->|configures rendering| EngineCore
    ExternalDeps -->|packages loaded by| EngineCore

    InputSystem -->|drives movement| FPSController
    InputSystem -->|drives movement| TPSController
    InputSystem -->|feeds UI input| UILoading
    InputSystem -->|feeds UI input| UIMobile

    FPSController -->|triggers fire events| WeaponSystem
    FPSController -->|triggers inventory events| InventorySystem
    FPSController -->|triggers save events| SaveSystem

    WeaponSystem -->|uses inventory data| InventorySystem
    InventorySystem -->|updates UI| UILoading
    InventorySystem -->|updates UI| UIMobile

    SaveSystem -->|reads/writes| SaveData["JSON Save Files"]:::data
    SaveData -->|stored at| ExternalDeps

    %% Click Events
    click SceneAssets "https://github.com/kasnervlad/projectgun/blob/main/Assets/Scenes/SampleScene.unity"
    click EnvArt "https://github.com/kasnervlad/projectgun/tree/main/Assets/StarterAssets/Environment/Art"
    click EnvPrefabs "https://github.com/kasnervlad/projectgun/tree/main/Assets/StarterAssets/Environment/Prefabs"
    click RenderPipelines "https://github.com/kasnervlad/projectgun/tree/main/Assets/StarterAssets/Environment/RenderPipelineProfiles"
    click StarterSettings "https://github.com/kasnervlad/projectgun/tree/main/Assets/StarterAssets/Settings"
    click ExternalDeps "https://github.com/kasnervlad/projectgun/blob/main/Packages/manifest.json"
    click InputSystem "https://github.com/kasnervlad/projectgun/blob/main/Assets/StarterAssets/InputSystem/InputInitialization.cs"
    click FPSController "https://github.com/kasnervlad/projectgun/blob/main/Assets/StarterAssets/FirstPersonController/Scripts/FPScontrollerScripts/FirstPersonController.cs"
    click TPSController "https://github.com/kasnervlad/projectgun/blob/main/Assets/StarterAssets/ThirdPersonController/Scripts/ThirdPersonController.cs"
    click WeaponSystem "https://github.com/kasnervlad/projectgun/blob/main/Assets/StarterAssets/FirstPersonController/Scripts/WeaponSystem/Weapon.cs"
    click InventorySystem "https://github.com/kasnervlad/projectgun/blob/main/Assets/StarterAssets/FirstPersonController/Scripts/SOLIDInventory/InventorySystem2.cs"
    click UILoading "https://github.com/kasnervlad/projectgun/blob/main/Assets/StarterAssets/FirstPersonController/Scripts/DownloadScreen/LoadingScreenLogic.cs"
    click UIMobile "https://github.com/kasnervlad/projectgun/tree/main/Assets/StarterAssets/Mobile/Prefabs"
    click SaveSystem "https://github.com/kasnervlad/projectgun/blob/main/Assets/StarterAssets/FirstPersonController/Scripts/SaveSystem/SaveManager.cs"

    %% Styles
    classDef engine fill:#CDA4DE,stroke:#333,stroke-width:1px;
    classDef assets fill:#FFD3B6,stroke:#333,stroke-width:1px;
    classDef code fill:#BBE1FA,stroke:#333,stroke-width:1px;
    classDef data fill:#A8E6CF,stroke:#333,stroke-width:1px;
    classDef config fill:#FFB7B2,stroke:#333,stroke-width:1px;
```
