# copolio/forager-clone architecture

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

- Interactive diagram: https://gitdiagram.com/copolio/forager-clone
- Repository: https://github.com/copolio/forager-clone

## Overview

##### Main Architectural Components

a) Core Game Engine Layer:
- Game Framework (gameNode, mainGame)
- Scene Management System (sceneManager)
- Resource Management Systems:
- TextureManager
- SoundManager (FMOD integration)
- ImageManager

b) Game Logic Layer:
- Player Systems (ForagerPlayer, ForagerStatManager)
- Unit Management (UnitManager)
- Item Systems (ItemDatabase, ItemManager)
- Building Systems (construction, building)
- Spawn Management (SpawnManager)

c) Technical Services Layer:
- Input Handler (input)
- Time Management (timeManager)
- Save System (saveManager)
- Camera System (cameraManager)

**[Core Engine Layer]**
- ↑↓
**[Game Logic Layer]**
- ↑↓
**[Technical Services Layer]**
- ↑↓
**[Resource Layer]**

##### Component Relationships

Key interactions:
- Scene flow between different game states (startScene → loadingScene → gameScene)
- Resource loading and management paths
- Event and input handling flow
- Entity management and update cycles

##### Specific Implementation Details

Crucial elements:
- FMOD audio system integration
- Windows API rendering pipeline
- Save/Load system data flow
- Entity interaction systems
- Resource management for images/sounds

##### Design Patterns to Highlight

Architectural patterns:
- Singleton patterns (for managers)
- Scene management state machine
- Component-based entity system
- Observer pattern for event handling

Create distinct sections for:
a) Core Systems:
**[Scene Manager] ←→ [Game Node] ←→ [Main Game]**
- ↓
**[Resource Managers (Image/Sound/Texture)]**

b) Gameplay Systems:
**[Player Manager] ←→ [Unit Manager] ←→ [Spawn Manager]**
- ↓
**[Item/Building Systems] ←→ [Interaction Manager]**

## Diagram (Mermaid)

```mermaid
graph TB
    %% Style Definitions
    classDef core fill:#b3d9ff,stroke:#333,stroke-width:2px
    classDef gameLogic fill:#90EE90,stroke:#333,stroke-width:2px
    classDef technical fill:#FFB366,stroke:#333,stroke-width:2px
    classDef resource fill:#FFFF99,stroke:#333,stroke-width:2px

    %% Core Engine Layer
    subgraph CoreEngine
        GameNode["Game Node"]
        MainGame["Main Game"]
        SceneManager["Scene Manager"]
        
        GameNode --> MainGame
        MainGame --> SceneManager
    end

    %% Scene Management
    subgraph Scenes
        StartScene["Start Scene"]
        LoadingScene["Loading Scene"]
        GameScene["Game Scene"]
        
        SceneManager --> StartScene
        StartScene --> LoadingScene
        LoadingScene --> GameScene
    end

    %% Game Logic Layer
    subgraph GameLogic
        Player["Forager Player"]
        StatManager["Stat Manager"]
        UnitManager["Unit Manager"]
        SpawnManager["Spawn Manager"]
        
        Player --> StatManager
        UnitManager --> SpawnManager
    end

    %% Item and Building Systems
    subgraph Systems
        ItemDB["Item Database"]
        ItemManager["Item Manager"]
        Building["Building System"]
        Construction["Construction"]
        BuildingInteraction["Building Interaction"]
        
        ItemDB --> ItemManager
        Building --> Construction
        Construction --> BuildingInteraction
    end

    %% Technical Services Layer
    subgraph TechnicalServices
        InputHandler["Input Handler"]
        TimeManager["Time Manager"]
        SaveManager["Save Manager"]
        CameraManager["Camera Manager"]
    end

    %% Resource Management Layer
    subgraph ResourceManagement
        ImageManager["Image Manager"]
        SoundManager["Sound Manager"]
        TextureManager["Texture Manager"]
        FMOD["FMOD System"]
        
        SoundManager --> FMOD
    end

    %% Cross-layer connections
    GameScene --> Player
    GameScene --> UnitManager
    Player --> InputHandler
    GameLogic --> SaveManager
    ResourceManagement --> LoadingScene
    TechnicalServices --> GameScene

    %% Click events for component mapping
    click GameNode "https://github.com/copolio/Forager-Clone/blob/master/gameNode.cpp"
    click MainGame "https://github.com/copolio/Forager-Clone/blob/master/mainGame.cpp"
    click SceneManager "https://github.com/copolio/Forager-Clone/blob/master/sceneManager.cpp"
    click StartScene "https://github.com/copolio/Forager-Clone/blob/master/startScene.cpp"
    click LoadingScene "https://github.com/copolio/Forager-Clone/blob/master/loadingScene.cpp"
    click GameScene "https://github.com/copolio/Forager-Clone/blob/master/gameScene.cpp"
    click ImageManager "https://github.com/copolio/Forager-Clone/blob/master/imageManager.cpp"
    click SoundManager "https://github.com/copolio/Forager-Clone/blob/master/soundManager.cpp"
    click TextureManager "https://github.com/copolio/Forager-Clone/blob/master/TextureManager.cpp"
    click Player "https://github.com/copolio/Forager-Clone/blob/master/ForagerPlayer.cpp"
    click StatManager "https://github.com/copolio/Forager-Clone/blob/master/ForagerStatManager.cpp"
    click UnitManager "https://github.com/copolio/Forager-Clone/blob/master/UnitManager.cpp"
    click ItemDB "https://github.com/copolio/Forager-Clone/blob/master/ItemDatabase.cpp"
    click ItemManager "https://github.com/copolio/Forager-Clone/blob/master/item_Manager.cpp"
    click Building "https://github.com/copolio/Forager-Clone/blob/master/building.cpp"
    click Construction "https://github.com/copolio/Forager-Clone/blob/master/construction.cpp"
    click BuildingInteraction "https://github.com/copolio/Forager-Clone/blob/master/buildinginteraction.cpp"
    click SpawnManager "https://github.com/copolio/Forager-Clone/blob/master/SpawnManager.cpp"
    click InputHandler "https://github.com/copolio/Forager-Clone/blob/master/input.cpp"
    click TimeManager "https://github.com/copolio/Forager-Clone/blob/master/timeManager.cpp"
    click SaveManager "https://github.com/copolio/Forager-Clone/blob/master/saveManager.cpp"
    click CameraManager "https://github.com/copolio/Forager-Clone/blob/master/cameraManager.cpp"
    click FMOD "https://github.com/copolio/Forager-Clone/tree/master/FMOD"

    %% Style applications
    class GameNode,MainGame,SceneManager core
    class Player,StatManager,UnitManager,SpawnManager gameLogic
    class InputHandler,TimeManager,SaveManager,CameraManager technical
    class ImageManager,SoundManager,TextureManager,FMOD resource
```
