# kh-returngame/rg2_raisingtier architecture

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

- Interactive diagram: https://gitdiagram.com/kh-returngame/rg2_raisingtier
- Repository: https://github.com/kh-returngame/rg2_raisingtier

## Overview

##### Project Type and Purpose
- This is a Unity-based 2D game project (“Rasing Tier”) built with the Universal Render Pipeline (URP).
- It’s a physics-driven slingshot game where the player launches “tier” objects, merges them on collision, accumulates points, and tracks lives.

##### File-Structure Analysis
Top-level folders indicate a typical Unity layout:
- Assets/
· Scenes/ (How.unity, Main.unity, Opening.unity, Setting.unity)
· Scripts/ (ContainerBoundary.cs, GameManager.cs, GameOverPanel.cs, Launcher.cs, SceneLoader.cs, SettingsManager.cs, Tier.cs)
· Prefabs/ (Tier.prefab)
· Materials, Sprites, TextMesh Pro assets, InputSystem configurations
- Packages/ (manifest.json, packages-lock.json)
- ProjectSettings/ (Unity project settings for graphics, physics, input, URP, etc.)
- README.md

Architectural patterns:
- Single Unity executable with multiple Scenes (Opening, Main gameplay, How-to, Settings, GameOver panel overlay).
- Script components attached to GameObjects:
· Launcher: handles drag & release input.
· Tier: physics object with merge logic.
· GameManager: game state, score, lives.
· SceneLoader: scene transitions.
· SettingsManager: audio/graphics settings.
· ContainerBoundary: detect out-of-bounds and decrement lives.

##### Key Insights from README
- Core gameplay loop: launch → physics simulation → collision/merge → score update → lives check → game over.
- Input via Unity’s new Input System (InputSystem_Actions.inputactions).
- UI panels for score, lives, game over.
- URP2D for 2D rendering.

a. Main Components
1. Unity Engine Core (Runtime)
2. Scenes:
- Opening Scene
- Main Scene (Gameplay)
- How-To Scene
- Settings Scene
3. GameObjects & Managers:
- Launcher (Input System)
- Tier Prefab (Collider/Rigidbody2D + Tier script)
- ContainerBoundary
- GameManager
- UI Canvas (Score, Lives, GameOverPanel)
- SettingsManager
- SceneLoader
4. Asset Pipelines:
- Sprites & Materials
- TextMesh Pro subsystem
5. External/Unity Services:
- Input System Package
- URP Rendering Pipeline

b. Relationships & Interactions
- Player Input → Launcher → instantiates/forces Tier prefab into Main Scene
- Tier Prefab collides with other Tier instances → Tier.cs merges them → GameManager.UpdateScore()
- ContainerBoundary detects out-of-bounds → GameManager.LoseLife()
- GameManager monitors lives → triggers GameOverPanel UI or persists to SceneLoader
- SettingsManager reads/writes to PlayerPrefs (or equivalent) → affects AudioManager/GraphicsSettings at runtime
- SceneLoader handles menu navigation and scene transitions

c. Architectural Patterns & Principles
- Component-based architecture (Unity standard): small MonoBehaviour scripts attached to GameObjects
- Scene separation for UI/flow control
- Singletons (e.g., GameManager, SettingsManager) for global state
- Event-driven triggers (collision events, input events)
- MVC-style separation: Scripts manage logic; Prefabs/Scenes manage visuals

d. Technologies & Frameworks
- Unity 2021+ (C# MonoBehaviour)
- Universal Render Pipeline (2D Renderer)
- TextMesh Pro for UI text
- Unity Input System package
- 2D Physics (Collider2D, Rigidbody2D)

##### Final Advice
- Keep the Main Scene’s game loop front and center to reflect runtime flow.

## Diagram (Mermaid)

```mermaid
flowchart TD
    %% Scenes
    subgraph "Scenes" 
        direction TB
        OpeningScene["Opening Scene"]:::scenes
        MainScene["Main Scene (Gameplay)"]:::scenes
        HowToScene["How-To Scene"]:::scenes
        SettingsScene["Settings Scene"]:::scenes
    end

    %% Runtime Components
    subgraph "Runtime Components"
        direction TB
        LauncherComp["Launcher"]:::logic
        TierComp["Tier"]:::logic
        BoundaryComp["ContainerBoundary"]:::logic
        GameManagerComp["GameManager"]:::logic
        GameOverComp["GameOverPanel"]:::logic
        SceneLoaderComp["SceneLoader"]:::logic
        SettingsManagerComp["SettingsManager"]:::logic
    end

    %% Engine Systems
    subgraph "Engine & Subsystems"
        direction TB
        InputSystemComp["Input System"]:::engine
        Physics2DComp["2D Physics Engine"]:::engine
        URP2DComp["URP 2D Renderer"]:::engine
        UniversalRPComp["Universal Render Pipeline"]:::engine
    end

    %% Assets & Resources
    subgraph "Asset Pipelines & Resources"
        direction TB
        TierPrefab["Tier Prefab"]:::assets
        BouncyMat["Bouncy Material"]:::assets
        SpritesRes["Sprites Folder"]:::assets
        TextMeshProRes["TextMesh Pro Assets"]:::assets
        PlayerPrefsStore["PlayerPrefs (Settings)"]:::data
    end

    %% Packages
    subgraph "Packages"
        direction TB
        Manifest["manifest.json"]:::packages
    end

    %% Flow & Relationships
    Player["Player"]:::external -->|"OnDrag/Release"| InputSystemComp
    InputSystemComp -->|"Invoke OnDrag"| LauncherComp
    LauncherComp -->|"Instantiate & Force"| TierPrefab
    TierPrefab --> Physics2DComp
    Physics2DComp -->|"OnCollisionEnter2D"| TierComp
    TierComp -->|"Merge Logic & UpdateScore()"| GameManagerComp
    BoundaryComp -->|"Out-of-bounds Event"| GameManagerComp
    GameManagerComp -->|"Update UI"| GameOverComp
    GameManagerComp -->|"Lives<=0"| SceneLoaderComp
    SceneLoaderComp -->|"Load Main/Opening/How/Settings"| OpeningScene
    SceneLoaderComp --> MainScene
    SceneLoaderComp --> HowToScene
    SceneLoaderComp --> SettingsScene
    SettingsManagerComp -->|"Read/Write"| PlayerPrefsStore
    SettingsManagerComp -->|"Apply Settings"| Audio["AudioManager"]:::engine
    SettingsManagerComp -->|"Apply Settings"| UniversalRPComp
    URP2DComp -.-> UniversalRPComp
    TierPrefab --> BouncyMat
    TierPrefab --> SpritesRes
    GameOverComp --> TextMeshProRes
    Manifest --> InputSystemComp
    Manifest --> URP2DComp

    %% Click Events
    click OpeningScene "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scenes/Opening.unity"
    click MainScene "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scenes/Main.unity"
    click HowToScene "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scenes/How.unity"
    click SettingsScene "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scenes/Setting.unity"
    click TierPrefab "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Prefabs/Tier.prefab"
    click LauncherComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scripts/Launcher.cs"
    click TierComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scripts/Tier.cs"
    click BoundaryComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scripts/ContainerBoundary.cs"
    click GameManagerComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scripts/GameManager.cs"
    click GameOverComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scripts/GameOverPanel.cs"
    click SceneLoaderComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scripts/SceneLoader.cs"
    click SettingsManagerComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Scripts/SettingsManager.cs"
    click InputSystemComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/InputSystem_Actions.inputactions"
    click URP2DComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Settings/Renderer2D.asset"
    click UniversalRPComp "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Settings/UniversalRP.asset"
    click BouncyMat "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Assets/Materials/Bouncy.physicsMaterial2D"
    click SpritesRes "https://github.com/kh-returngame/rg2_raisingtier/tree/main/Assets/Resources/Sprites"
    click TextMeshProRes "https://github.com/kh-returngame/rg2_raisingtier/tree/main/Assets/TextMesh Pro"
    click Manifest "https://github.com/kh-returngame/rg2_raisingtier/blob/main/Packages/manifest.json"

    %% Styles
    classDef scenes fill:#AED6F1,stroke:#1B4F72,color:#1B2631;
    classDef logic fill:#A9DFBF,stroke:#186A3B,color:#1B2631;
    classDef engine fill:#F9E79F,stroke:#B7950B,color:#1B2631;
    classDef assets fill:#D7BDE2,stroke:#6C3483,color:#1B2631;
    classDef data fill:#F5CBA7,stroke:#934B00,color:#1B2631;
    classDef packages fill:#D5DBDB,stroke:#424949,color:#1B2631;
    classDef external fill:#FADBD8,stroke:#922B21,color:#1B2631;
```
