# mmoineaudev/game-benchmark architecture

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

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

## Overview

This tree contains several game projects; the clearest documented playable workflow is the C++ dungeon crawler. Its app entry point presents a generated dungeon and runs player movement, combat, and progression. The source index confirms that the app references the core dungeon, state, enemy, and leaderboard interfaces. The excerpt does not show most call sites, so those links are dashed and uncited rather than asserted as verified calls.

Main entry points: [`c++_dungeon_crawler/src/app/main.cpp`](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/app/main.cpp) (Game app), [`c++_dungeon_crawler/src/core/dungeon_gen.cpp`](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/dungeon_gen.cpp) (Dungeon generation), [`c++_dungeon_crawler/src/core/state.cpp`](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/state.cpp) (Run state), [`c++_dungeon_crawler/src/render/null_renderer.cpp`](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/render/null_renderer.cpp) (Renderer)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Game runtime"]
  node_appmain["Game app<br/>[main.cpp]"]
  node_game_state["Run state<br/>[state.cpp]"]
  node_renderer["Renderer<br/>[null_renderer.cpp]"]
end

subgraph group_world["Dungeon world"]
  node_dungeon["Dungeon generation<br/>[dungeon_gen.cpp]"]
  node_world_model["World model<br/>[world.hpp]"]
  node_collision["Collision<br/>[collision.hpp]"]
  node_movement["Player movement<br/>[movement.hpp]"]
end

subgraph group_combat["Combat and progression"]
  node_skeletons["Skeleton system"]
  node_boss["Boss encounters<br/>[boss.cpp]"]
  node_hunter["Hunter enemy<br/>[hunter.cpp]"]
  node_drops["Item drops<br/>[drop_system.cpp]"]
  node_leaderboard["Leaderboard<br/>[leaderboard.cpp]"]
end

subgraph group_support["Runtime support"]
  node_diagnostics["Crash diagnostics<br/>[crashdiag.cpp]"]
  node_rng["Random generation<br/>[rng.hpp]"]
end

node_player(("Player"))

node_player -->|"plays"| node_appmain
node_appmain -.->|"uses generation"| node_dungeon
node_appmain -.->|"uses world"| node_world_model
node_appmain -.->|"uses state"| node_game_state
node_appmain -.->|"moves player"| node_movement
node_appmain -.->|"checks collision"| node_collision
node_appmain -.->|"updates enemies"| node_skeletons
node_appmain -.->|"runs encounters"| node_boss
node_appmain -.->|"uses hunter"| node_hunter
node_appmain -.->|"handles drops"| node_drops
node_appmain -.->|"uses leaderboard"| node_leaderboard
node_appmain -.->|"renders game"| node_renderer
node_appmain -.->|"uses diagnostics"| node_diagnostics
node_dungeon -.->|"uses randomness"| node_rng

click node_appmain "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/app/main.cpp"
click node_game_state "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/state.cpp"
click node_renderer "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/render/null_renderer.cpp"
click node_dungeon "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/dungeon_gen.cpp"
click node_world_model "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/include/dc/world.hpp"
click node_collision "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/include/dc/collision.hpp"
click node_movement "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/include/dc/movement.hpp"
click node_skeletons "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/skeleton_system.cpp"
click node_boss "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/boss.cpp"
click node_hunter "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/hunter.cpp"
click node_drops "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/drop_system.cpp"
click node_leaderboard "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/leaderboard.cpp"
click node_diagnostics "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/crashdiag.cpp"
click node_rng "https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/include/dc/rng.hpp"

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_appmain,node_game_state,node_renderer toneBlue
class node_dungeon,node_world_model,node_collision,node_movement toneAmber
class node_skeletons,node_boss,node_hunter,node_drops,node_leaderboard toneMint
class node_diagnostics,node_rng toneRose
class node_player toneIndigo
```

## Components

### Game runtime

- [Game app](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/app/main.cpp): `c++_dungeon_crawler/src/app/main.cpp`
- [Run state](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/state.cpp): `c++_dungeon_crawler/src/core/state.cpp`
- [Renderer](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/render/null_renderer.cpp): `c++_dungeon_crawler/src/render/null_renderer.cpp`

### Dungeon world

- [Dungeon generation](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/dungeon_gen.cpp): `c++_dungeon_crawler/src/core/dungeon_gen.cpp`
- [World model](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/include/dc/world.hpp): `c++_dungeon_crawler/include/dc/world.hpp`
- [Collision](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/include/dc/collision.hpp): `c++_dungeon_crawler/include/dc/collision.hpp`
- [Player movement](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/include/dc/movement.hpp): `c++_dungeon_crawler/include/dc/movement.hpp`

### Combat and progression

- [Skeleton system](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/skeleton_system.cpp): `c++_dungeon_crawler/src/core/skeleton_system.cpp`
- [Boss encounters](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/boss.cpp): `c++_dungeon_crawler/src/core/boss.cpp`
- [Hunter enemy](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/hunter.cpp): `c++_dungeon_crawler/src/core/hunter.cpp`
- [Item drops](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/drop_system.cpp): `c++_dungeon_crawler/src/core/drop_system.cpp`
- [Leaderboard](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/leaderboard.cpp): `c++_dungeon_crawler/src/core/leaderboard.cpp`

### Runtime support

- [Crash diagnostics](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/src/core/crashdiag.cpp): `c++_dungeon_crawler/src/core/crashdiag.cpp`
- [Random generation](https://github.com/mmoineaudev/game-benchmark/blob/master/c%2B%2B_dungeon_crawler/include/dc/rng.hpp): `c++_dungeon_crawler/include/dc/rng.hpp`

### Other components

- **Player**

## Connections

- Player → Game app: plays (evidence: `c++_dungeon_crawler/src/app/main.cpp`)
- Game app → Dungeon generation: uses generation
- Game app → World model: uses world (evidence: `c++_dungeon_crawler/src/app/main.cpp`)
- Game app → Run state: uses state
- Game app → Player movement: moves player (evidence: `c++_dungeon_crawler/src/app/main.cpp`)
- Game app → Collision: checks collision (evidence: `c++_dungeon_crawler/src/app/main.cpp`)
- Game app → Skeleton system: updates enemies
- Game app → Boss encounters: runs encounters
- Game app → Hunter enemy: uses hunter
- Game app → Item drops: handles drops
- Game app → Leaderboard: uses leaderboard
- Game app → Renderer: renders game
- Game app → Crash diagnostics: uses diagnostics
- Dungeon generation → Random generation: uses randomness
