# ungureanueduard/shooting-mush architecture

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

- Interactive diagram: https://gitdiagram.com/ungureanueduard/shooting-mush
- Repository: https://github.com/ungureanueduard/shooting-mush

## Overview

##### Project type and purpose
- This is a full-stack desktop game built on the LibGDX framework.
- It comprises two Gradle modules:
– core: contains the cross-platform game logic
– desktop: contains the platform-specific launcher

##### File structure
- assets/: all game assets (textures, maps, sounds, fonts, cutscenes)
- core/src/com/mygdx/game/: game code organized by feature
– Game entry points (MyGdxGame, GameScene)
– animations_effects, combat_system, cutscene, entities, game_modes, network, pool_managers, ui_screens, utilities_resources
- desktop/src/com/mygdx/game/DesktopLauncher.java: bootstraps the game on desktop
- build.gradle files: define dependencies and Gradle tasks

##### Architectural patterns
- Layered game-loop architecture: Input → Update (GameScene, Managers, Entities) → Render → Output
- Feature modules:
– Combat system uses A* pathfinding, bullets, wave management
– Cutscene manager drives scripted events
– Pool managers optimize object reuse for bullets, enemies, particles
– UI screens handle menus, loading, end screens
– Utilities (Assets, Settings, MySQLHelper) abstract resource loading and persistence

##### Main components and their interactions
a. Platform Layer
– DesktopLauncher: initializes LWJGL backend and hands control to MyGdxGame
b. Core Engine
– MyGdxGame / GameScene: main game loop and scene management
– AssetManager (Assets.java): loads textures, sounds, tile maps
– Input Processor: captures WASD and mouse events
– Update modules:
- CombatSystem (AStarPathfinder, Bullet, Wave)
- EntityManager (enemies, NPCs, turrets)
- CutsceneManager (CutsceneEvent, specific event classes)
- PoolManagers (CharacterBulletsManager, EnemyManager, etc.)
- UI Screens (MainMenuScreen, LoadingScreen, EndGameScreens)
– Rendering modules: Sprite batches, tile-map renderer
– Persistence/Networking: MySQLHelper (score saving), Network.java (multiplayer or coop)
c. Assets & External Services
– Tiled maps (.tmx), fonts, audio files
– External libraries: LibGDX core, LWJGL, Gradle

##### Architectural patterns and design principles
- Separation of concerns: each feature area (combat, UI, cutscene, pooling) lives in its own package
- Dependency injection via AssetManager and Settings
- Object pooling for performance
- Event-driven cutscene system

## Diagram (Mermaid)

```mermaid
graph TD
    %% Platform Layer
    subgraph "Platform Layer"
        DesktopLauncher["DesktopLauncher"]:::platform
    end

    %% Core Engine - Entry Points
    subgraph "Core Engine"
        direction TB
        MyGdxGame["MyGdxGame"]:::engine
        GameScene["GameScene"]:::engine
        Input["Input Processor"]:::engine
        AssetManager["AssetManager"]:::resource
        Settings["Settings"]:::resource
        MySQLHelper["MySQLHelper"]:::resource
        Network["Network"]:::engine
        CombatSystem["CombatSystem"]:::engine
        AStar["AStarPathfinder"]:::engine
        PoolManagers["Pool Managers"]:::engine
        CutsceneManager["CutsceneManager"]:::engine
        UIScreens["UI Screens"]:::engine
        Rendering["Rendering"]:::engine
    end

    %% Assets & External
    subgraph "Assets & External"
        Assets["External Assets (textures, maps, audio, fonts)"]:::external
        Libs["External Libraries (LibGDX, LWJGL, Gradle)"]:::external
    end

    %% Connections
    DesktopLauncher -->|"initialize"| MyGdxGame
    MyGdxGame -->|"start loop"| GameScene
    Input -->|"captures events"| GameScene
    GameScene -->|"loads resources"| AssetManager
    GameScene -->|"accesses"| Settings
    GameScene -->|"persists via"| MySQLHelper
    GameScene -->|"connects to"| Network
    GameScene -->|"updates"| CombatSystem
    CombatSystem -->|"uses pathfinding"| AStar
    GameScene -->|"manages pools"| PoolManagers
    GameScene -->|"drives"| CutsceneManager
    GameScene -->|"updates UI"| UIScreens
    GameScene -->|"renders via"| Rendering
    AssetManager -->|"provides assets"| Rendering
    Assets -->|"loaded by"| AssetManager
    Libs -->|"used by"| DesktopLauncher

    %% Click Events
    click DesktopLauncher "https://github.com/ungureanueduard/shooting-mush/blob/master/desktop/src/com/mygdx/game/DesktopLauncher.java"
    click MyGdxGame "https://github.com/ungureanueduard/shooting-mush/blob/master/core/src/com/mygdx/game/MyGdxGame.java"
    click GameScene "https://github.com/ungureanueduard/shooting-mush/blob/master/core/src/com/mygdx/game/GameScene.java"
    click AssetManager "https://github.com/ungureanueduard/shooting-mush/blob/master/core/src/com/mygdx/game/utilities_resources/Assets.java"
    click Settings "https://github.com/ungureanueduard/shooting-mush/blob/master/core/src/com/mygdx/game/utilities_resources/Settings.java"
    click MySQLHelper "https://github.com/ungureanueduard/shooting-mush/blob/master/core/src/com/mygdx/game/utilities_resources/MySQLHelper.java"
    click Network "https://github.com/ungureanueduard/shooting-mush/blob/master/core/src/com/mygdx/game/newtork/Network.java"
    click AStar "https://github.com/ungureanueduard/shooting-mush/blob/master/core/src/com/mygdx/game/combat_system/AStarPathfinder.java"

    %% Styles
    classDef platform fill:#cce5ff,stroke:#004085;
    classDef engine fill:#d4edda,stroke:#155724;
    classDef resource fill:#fff3cd,stroke:#856404;
    classDef external fill:#e2e3e5,stroke:#6c757d;
```
