# barrosfilipe/pokered architecture

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

- Interactive diagram: https://gitdiagram.com/barrosfilipe/pokered
- Repository: https://github.com/barrosfilipe/pokered

## Overview

##### Main Components

a) Core Game Engine Components:
- Memory Management System (RAM/VRAM/SRAM)
- Audio Engine (audio/*.asm)
- Graphics Engine (gfx/*)
- Input Handler (engine/joypad.asm)
- Battle System (engine/battle/*)
- Event System (engine/events/*)
- Engine (maps/*)

b) Data Management:
- Pokémon Data (data/pokemon/*)
- Item System (data/items/*)
- Move System (data/moves/*)
- Text Engine (text/*)
- Script Engine (scripts/*)

##### Key Relationships

- Data flow between components
- System dependencies
- Event triggers
- Memory access patterns

##### Specific Implementation Details

**[Game Loop Controller]**
- ↓
**[Scene Manager] ←→ [Event Handler]**
- ↙     ↓     ↘
**[Battle] [Overworld] [Menus]**
- ↓         ↓         ↓
**[Data Management Layer]**
- ↓
**[Hardware Interface Layer]**

##### Important Subsystems

- Battle System (engine/battle/*)
- System (maps/*)
- Audio System (audio/*)
- Data Storage (data/*)

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph Game_Control
        GameLoop[Game Loop Controller]:::core
        SceneManager[Scene Manager]:::core
        EventHandler[Event Handler]:::core
        click EventHandler "https://github.com/barrosfilipe/pokered/tree/master/engine/events/"
    end

    subgraph Game_Systems
        Battle[Battle System]:::gameplay
        click Battle "https://github.com/barrosfilipe/pokered/tree/master/engine/battle/"
        Overworld[Overworld System]:::gameplay
        MenuSystem[Menu System]:::gameplay
    end

    subgraph Core_Engines
        GraphicsEngine[Graphics Engine]:::engine
        click GraphicsEngine "https://github.com/barrosfilipe/pokered/tree/master/gfx/"
        AudioEngine[Audio Engine]:::engine
        click AudioEngine "https://github.com/barrosfilipe/pokered/tree/master/audio/"
        InputHandler[Input Handler]:::engine
        click InputHandler "https://github.com/barrosfilipe/pokered/blob/master/engine/joypad.asm"
        MapEngine[Map Engine]:::engine
        click MapEngine "https://github.com/barrosfilipe/pokered/tree/master/maps/"
    end

    subgraph Data_Management
        PokemonData[Pokemon Data]:::data
        click PokemonData "https://github.com/barrosfilipe/pokered/tree/master/data/pokemon/"
        ItemSystem[Item System]:::data
        click ItemSystem "https://github.com/barrosfilipe/pokered/tree/master/data/items/"
        MoveSystem[Move System]:::data
        click MoveSystem "https://github.com/barrosfilipe/pokered/tree/master/data/moves/"
        TextEngine[Text Engine]:::data
        click TextEngine "https://github.com/barrosfilipe/pokered/tree/master/text/"
        ScriptEngine[Script Engine]:::data
        click ScriptEngine "https://github.com/barrosfilipe/pokered/tree/master/scripts/"
    end

    subgraph Hardware_Interface
        MemoryMgmt[Memory Management]:::hardware
        click MemoryMgmt "https://github.com/barrosfilipe/pokered/blob/master/home/bankswitch.asm"
        RAM[RAM/VRAM/SRAM]:::hardware
        click RAM "https://github.com/barrosfilipe/pokered/tree/master/ram/"
    end

    %% Connections
    GameLoop --> SceneManager
    SceneManager <--> EventHandler
    SceneManager --> Battle
    SceneManager --> Overworld
    SceneManager --> MenuSystem

    Battle --> PokemonData
    Battle --> MoveSystem
    Battle --> ItemSystem
    
    Overworld --> MapEngine
    Overworld --> ScriptEngine
    
    MenuSystem --> TextEngine
    
    Battle & Overworld & MenuSystem --> GraphicsEngine
    Battle & Overworld & MenuSystem --> AudioEngine
    Battle & Overworld & MenuSystem --> InputHandler
    
    GraphicsEngine & AudioEngine & InputHandler --> MemoryMgmt
    MemoryMgmt --> RAM

    %% Styles
    classDef core fill:#3498db,stroke:#2980b9,color:white
    classDef gameplay fill:#9b59b6,stroke:#8e44ad,color:white
    classDef engine fill:#e74c3c,stroke:#c0392b,color:white
    classDef data fill:#2ecc71,stroke:#27ae60,color:white
    classDef hardware fill:#f1c40f,stroke:#f39c12,color:black

    %% Legend
    subgraph Legend
        L1[Core Components]:::core
        L2[Gameplay Systems]:::gameplay
        L3[Engine Components]:::engine
        L4[Data Systems]:::data
        L5[Hardware Interface]:::hardware
    end
```
