# digitalextinction/game architecture

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

- Interactive diagram: https://gitdiagram.com/digitalextinction/game
- Repository: https://github.com/digitalextinction/game

## Overview

##### Main Components

a. Core Game Engine Layer:
- Bevy Engine Integration
- Core Systems (crates/core)
- Game State Management
- Asset Management

b. Gameplay Systems:
- Combat System (crates/combat)
- Movement System (crates/movement)
- Construction System (crates/construction)
- Energy System (crates/energy)
- Pathing System (crates/pathing)
- Spawner System (crates/spawner)

c. Multiplayer Architecture:
- Lobby Server (crates/lobby)
- Connector Server (crates/connector)
- Networking Layer (crates/net)
- Message System (crates/messages)

d. User Interface:
- Controller System (crates/controller)
- GUI System (crates/gui)
- Menu System (crates/menu)
- HUD Components

e. World Systems:
- Terrain System (crates/terrain)
- Object Management (crates/objects)
- System (crates/map)

**┌─────────────────────────────────────────────┐**
- User Interface               │
- (GUI, HUD, Menu, Controller Components)    │
- ┤
- Gameplay Systems               │
- (Combat, Movement, Construction, Energy, etc)│
- ┤
- World Systems                 │
- (Terrain, Objects, Maps, Pathing)      │
- ┤
- Core Game Engine               │
- (Bevy Integration, State Management)     │
- ┤
- Multiplayer Infrastructure        │
- (Lobby, Connector, Networking)          │
- ┘

##### Key Relationships to Highlight

- Data flow between multiplayer components (Lobby → Connector → Game Instance)
- How the Controller system interfaces with both UI and Gameplay systems
- Demonstrate the relationship between Movement and Pathing systems
- How the Combat system interacts with Object Management and Energy systems

##### Implementation Details

- Brief notes about key technologies (Rust, Bevy, etc.)

## Diagram (Mermaid)

```mermaid
graph TB
    %% Styles
    classDef core fill:#b3d1ff,stroke:#333
    classDef gameplay fill:#90EE90,stroke:#333
    classDef ui fill:#FFE5B4,stroke:#333
    classDef world fill:#DDA0DD,stroke:#333
    classDef network fill:#FFB6C1,stroke:#333
    classDef support fill:#E6E6FA,stroke:#333

    %% Core Engine Layer
    subgraph CoreEngine
        Bevy[Bevy Engine]
        CoreSys[Core Systems]
        AssetMgmt[Asset Management]
        GameState[Game State]
    end

    %% Gameplay Systems Layer
    subgraph GameplaySystems
        Combat[Combat System]
        Movement[Movement System]
        Construction[Construction System]
        Energy[Energy System]
        Pathing[Pathing System]
        Spawner[Spawner System]
    end

    %% UI Layer
    subgraph UserInterface
        Controller[Controller System]
        GUI[GUI System]
        Menu[Menu System]
        HUD[HUD Components]
    end

    %% World Systems Layer
    subgraph WorldSystems
        Terrain[Terrain System]
        Objects[Object Management]
        Map[Map System]
    end

    %% Multiplayer Layer
    subgraph MultiplayerInfra
        Lobby[Lobby Server]
        Connector[Connector Server]
        Network[Networking Layer]
        Messages[Message System]
        MPCore[Multiplayer Core]
    end

    %% Support Systems
    subgraph SupportSystems
        Audio[Audio System]
        Config[Configuration]
        Camera[Camera System]
        Logging[Logging System]
    end

    %% Relationships
    CoreSys --> GameState
    CoreSys --> AssetMgmt
    Movement --> Pathing
    Combat --> Objects
    Combat --> Energy
    Controller --> GUI
    Controller --> Combat
    Lobby --> Connector
    Connector --> Network
    Network --> Messages
    Messages --> MPCore
    Objects --> Map
    Objects --> Terrain

    %% Click Events
    click CoreSys "https://github.com/DigitalExtinction/Game/tree/main/crates/core"
    click AssetMgmt "https://github.com/DigitalExtinction/Game/blob/main/crates/core/src/assets.rs"
    click GameState "https://github.com/DigitalExtinction/Game/blob/main/crates/core/src/gamestate.rs"
    click Combat "https://github.com/DigitalExtinction/Game/tree/main/crates/combat"
    click Movement "https://github.com/DigitalExtinction/Game/tree/main/crates/movement"
    click Construction "https://github.com/DigitalExtinction/Game/tree/main/crates/construction"
    click Energy "https://github.com/DigitalExtinction/Game/tree/main/crates/energy"
    click Pathing "https://github.com/DigitalExtinction/Game/tree/main/crates/pathing"
    click Spawner "https://github.com/DigitalExtinction/Game/tree/main/crates/spawner"
    click Lobby "https://github.com/DigitalExtinction/Game/tree/main/crates/lobby"
    click Connector "https://github.com/DigitalExtinction/Game/tree/main/crates/connector"
    click Network "https://github.com/DigitalExtinction/Game/tree/main/crates/net"
    click Messages "https://github.com/DigitalExtinction/Game/tree/main/crates/messages"
    click MPCore "https://github.com/DigitalExtinction/Game/tree/main/crates/multiplayer"
    click Controller "https://github.com/DigitalExtinction/Game/tree/main/crates/controller"
    click GUI "https://github.com/DigitalExtinction/Game/tree/main/crates/gui"
    click Menu "https://github.com/DigitalExtinction/Game/tree/main/crates/menu"
    click HUD "https://github.com/DigitalExtinction/Game/tree/main/crates/controller/src/hud"
    click Terrain "https://github.com/DigitalExtinction/Game/tree/main/crates/terrain"
    click Objects "https://github.com/DigitalExtinction/Game/tree/main/crates/objects"
    click Map "https://github.com/DigitalExtinction/Game/tree/main/crates/map"
    click Audio "https://github.com/DigitalExtinction/Game/tree/main/crates/audio"
    click Config "https://github.com/DigitalExtinction/Game/tree/main/crates/conf"
    click Camera "https://github.com/DigitalExtinction/Game/tree/main/crates/camera"
    click Logging "https://github.com/DigitalExtinction/Game/tree/main/crates/log"

    %% Style Applications
    class CoreSys,AssetMgmt,GameState,Bevy core
    class Combat,Movement,Construction,Energy,Pathing,Spawner gameplay
    class Controller,GUI,Menu,HUD ui
    class Terrain,Objects,Map world
    class Lobby,Connector,Network,Messages,MPCore network
    class Audio,Config,Camera,Logging support
```
