# ionut-valeriu/pokeratz architecture

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

- Interactive diagram: https://gitdiagram.com/ionut-valeriu/pokeratz
- Repository: https://github.com/ionut-valeriu/pokeratz

## Overview

PokeRatz is an SFML game: startup reads configuration and initializes assets, scenes, window, and sound; the game loop forwards input and updates the active scene. Scenes handle gameplay and menu behavior, while entities represent the player, monsters, and world objects. The graph preserves the asset, level-loading, factory, and entity-management subsystems identified by the source index. Edges reflect shown calls or indexed references; unsampled internals are not inferred as call flows.

Main entry points: [`source/Game.cpp`](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Game.cpp) (Game loop), [`source/Factory.cpp`](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Factory.cpp) (Scene and entity factory), [`source/Entity.cpp`](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Entity.cpp) (Entity base), [`source/LevelLoader.cpp`](https://github.com/ionut-valeriu/pokeratz/blob/main/source/LevelLoader.cpp) (Level loader)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_game["Game loop<br/>[Game.cpp]"]
  node_entry["Application entry<br/>[main.cpp]"]
  node_factory["Scene and entity factory<br/>[Factory.cpp]"]
end

subgraph group_scenes["Scenes"]
  node_scene["Scene base<br/>[Scene.cpp]"]
  node_menu["Menu scene<br/>[MenuScene.cpp]"]
  node_play["Play scene<br/>[PlayScene.cpp]"]
end

subgraph group_world["World and entities"]
  node_player["Player<br/>[Player.cpp]"]
  node_monster["Monster<br/>[Monster.cpp]"]
  node_background["Background<br/>[Background.cpp]"]
  node_illusion["Illusion<br/>[Illusion.cpp]"]
  node_entity["Entity base<br/>[Entity.cpp]"]
  node_components["Entity components<br/>[Components.cpp]"]
  node_animation["Animation<br/>[Animation.cpp]"]
  node_entity_manager["Entity manager<br/>[EntityManager.cpp]"]
end

subgraph group_resources["Assets and loading"]
  node_assets["Asset registry<br/>[Assets.cpp]"]
  node_level_loader["Level loader<br/>[LevelLoader.cpp]"]
  node_config["Game configuration<br/>[config.txt]"]
  node_asset_config["Asset configuration<br/>[assets.txt]"]
  node_level_data["Level data<br/>[MainMap.txt]"]
end

node_user(("Player"))

node_entry -->|"constructs"| node_game
node_game -->|"reads configuration"| node_config
node_game -->|"loads assets"| node_assets
node_game -->|"creates scenes"| node_factory
node_game -->|"updates active scene"| node_scene
node_user -->|"provides input"| node_game
node_game -.->|"dispatches scene actions"| node_menu
node_game -.->|"dispatches scene actions"| node_play
node_menu -->|"extends"| node_scene
node_play -->|"extends"| node_scene
node_scene -->|"uses"| node_entity_manager
node_entity_manager -->|"manages"| node_entity
node_entity_manager -.->|"loads through"| node_level_loader
node_level_loader -.->|"loads level data"| node_level_data
node_level_loader -->|"uses"| node_factory
node_level_loader -->|"uses"| node_assets
node_factory -->|"creates"| node_menu
node_factory -->|"creates"| node_play
node_factory -->|"creates"| node_player
node_factory -->|"creates"| node_monster
node_factory -->|"creates"| node_background
node_factory -->|"creates"| node_illusion
node_entity -->|"uses"| node_animation
node_entity -->|"uses"| node_components
node_player -->|"extends"| node_entity
node_monster -->|"extends"| node_entity
node_background -->|"extends"| node_entity
node_illusion -->|"extends"| node_entity
node_game -.->|"reads via asset loader"| node_asset_config

click node_player "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Player.cpp"
click node_monster "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Monster.cpp"
click node_background "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Background.cpp"
click node_illusion "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Illusion.cpp"
click node_entity "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Entity.cpp"
click node_components "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Components.cpp"
click node_animation "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Animation.cpp"
click node_entity_manager "https://github.com/ionut-valeriu/pokeratz/blob/main/source/EntityManager.cpp"
click node_game "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Game.cpp"
click node_entry "https://github.com/ionut-valeriu/pokeratz/blob/main/main.cpp"
click node_scene "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Scene.cpp"
click node_menu "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Scenes/MenuScene.cpp"
click node_play "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Scenes/PlayScene.cpp"
click node_factory "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Factory.cpp"
click node_assets "https://github.com/ionut-valeriu/pokeratz/blob/main/source/Assets.cpp"
click node_level_loader "https://github.com/ionut-valeriu/pokeratz/blob/main/source/LevelLoader.cpp"
click node_config "https://github.com/ionut-valeriu/pokeratz/blob/main/resources/config/config.txt"
click node_asset_config "https://github.com/ionut-valeriu/pokeratz/blob/main/resources/config/assets.txt"
click node_level_data "https://github.com/ionut-valeriu/pokeratz/blob/main/resources/config/MainMap.txt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_game,node_entry,node_factory toneBlue
class node_scene,node_menu,node_play toneAmber
class node_player,node_monster,node_background,node_illusion,node_entity,node_components,node_animation,node_entity_manager toneMint
class node_assets,node_level_loader,node_config,node_asset_config,node_level_data toneRose
class node_user toneIndigo
```

## Components

### Game runtime

- [Game loop](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Game.cpp): `source/Game.cpp`
- [Application entry](https://github.com/ionut-valeriu/pokeratz/blob/main/main.cpp): `main.cpp`
- [Scene and entity factory](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Factory.cpp): `source/Factory.cpp`

### Scenes

- [Scene base](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Scene.cpp): `source/Scene.cpp`
- [Menu scene](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Scenes/MenuScene.cpp): `source/Scenes/MenuScene.cpp`
- [Play scene](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Scenes/PlayScene.cpp): `source/Scenes/PlayScene.cpp`

### World and entities

- [Player](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Player.cpp): `source/Player.cpp`
- [Monster](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Monster.cpp): `source/Monster.cpp`
- [Background](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Background.cpp): `source/Background.cpp`
- [Illusion](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Illusion.cpp): `source/Illusion.cpp`
- [Entity base](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Entity.cpp): `source/Entity.cpp`
- [Entity components](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Components.cpp): `source/Components.cpp`
- [Animation](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Animation.cpp): `source/Animation.cpp`
- [Entity manager](https://github.com/ionut-valeriu/pokeratz/blob/main/source/EntityManager.cpp): `source/EntityManager.cpp`

### Assets and loading

- [Asset registry](https://github.com/ionut-valeriu/pokeratz/blob/main/source/Assets.cpp): `source/Assets.cpp`
- [Level loader](https://github.com/ionut-valeriu/pokeratz/blob/main/source/LevelLoader.cpp): `source/LevelLoader.cpp`
- [Game configuration](https://github.com/ionut-valeriu/pokeratz/blob/main/resources/config/config.txt): `resources/config/config.txt`
- [Asset configuration](https://github.com/ionut-valeriu/pokeratz/blob/main/resources/config/assets.txt): `resources/config/assets.txt`
- [Level data](https://github.com/ionut-valeriu/pokeratz/blob/main/resources/config/MainMap.txt): `resources/config/MainMap.txt`

### Other components

- **Player**

## Connections

- Application entry → Game loop: constructs (evidence: `main.cpp`)
- Game loop → Game configuration: reads configuration (evidence: `source/Game.cpp`)
- Game loop → Asset registry: loads assets (evidence: `source/Game.cpp`)
- Game loop → Scene and entity factory: creates scenes (evidence: `source/Game.cpp`)
- Game loop → Scene base: updates active scene (evidence: `source/Game.cpp`)
- Player → Game loop: provides input (evidence: `source/Game.cpp`)
- Game loop → Menu scene: dispatches scene actions
- Game loop → Play scene: dispatches scene actions
- Menu scene → Scene base: extends
- Play scene → Scene base: extends
- Scene base → Entity manager: uses
- Entity manager → Entity base: manages
- Entity manager → Level loader: loads through
- Level loader → Level data: loads level data
- Level loader → Scene and entity factory: uses (evidence: `source/LevelLoader.cpp`)
- Level loader → Asset registry: uses (evidence: `source/LevelLoader.cpp`)
- Scene and entity factory → Menu scene: creates (evidence: `source/Factory.cpp`)
- Scene and entity factory → Play scene: creates (evidence: `source/Factory.cpp`)
- Scene and entity factory → Player: creates (evidence: `source/Factory.cpp`)
- Scene and entity factory → Monster: creates (evidence: `source/Factory.cpp`)
- Scene and entity factory → Background: creates (evidence: `source/Factory.cpp`)
- Scene and entity factory → Illusion: creates (evidence: `source/Factory.cpp`)
- Entity base → Animation: uses
- Entity base → Entity components: uses
- Player → Entity base: extends
- Monster → Entity base: extends
- Background → Entity base: extends
- Illusion → Entity base: extends
- Game loop → Asset configuration: reads via asset loader
