# thunder-engine-dev/thunder-engine architecture

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

- Interactive diagram: https://gitdiagram.com/thunder-engine-dev/thunder-engine
- Repository: https://github.com/thunder-engine-dev/thunder-engine

## Overview

Thunder Engine is a Godot framework for creating Mario Forever games. The documented creator workflow is to build a game from the template, add a scene rooted in the Level class, and optionally copy map and menu/save-room/credits templates for customization. The tree shows substantial gameplay, interface, and world systems, but no source excerpts were provided; edges therefore show only relationships stated in the README, not inferred runtime calls.

Main entry points: [`scripts/classes/level`](https://github.com/thunder-engine-dev/thunder-engine/tree/main/scripts/classes/level) (Level scenes), [`scenes/map`](https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/map) (World map), [`scenes/main_menu`](https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/main_menu) (Main menu), [`scenes/save_game_room`](https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/save_game_room) (Save room and credits)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_authoring["Game authoring"]
  node_level["Level scenes"]
  node_map["World map"]
  node_mainmenu["Main menu"]
  node_savecredits["Save room and credits"]
end

subgraph group_gameplay["Gameplay systems"]
  node_player["Player characters"]
  node_enemies["Enemies"]
  node_boss["Bowser encounters"]
  node_items["Items and powerups"]
  node_blocks["Interactive blocks"]
end

subgraph group_world["World and encounters"]
  node_platforms["Platforms and terrain"]
  node_warps["Warps and areas"]
  node_fluid["Fluid systems"]
end

subgraph group_interface["Player interface"]
  node_hud["HUD and scoring"]
  node_pause["Pause and menus"]
  node_gameover["Game over flow"]
  node_progress["Progress continuation"]
  node_transitions["Scene transitions"]
end

subgraph group_shared["Shared runtime"]
  node_levelparts["Level part loading"]
  node_camera["Camera areas<br/>[cam_area.gd]"]
  node_audio["Audio areas<br/>[audio_area.gd]"]
  node_modifiers["Physics modifiers"]
end

node_creator(("Game creator"))

node_creator -->|"creates scene"| node_level
node_creator -->|"copies template"| node_map
node_creator -->|"customizes template"| node_mainmenu
node_creator -->|"customizes templates"| node_savecredits

click node_level "https://github.com/thunder-engine-dev/thunder-engine/tree/main/scripts/classes/level"
click node_map "https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/map"
click node_mainmenu "https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/main_menu"
click node_savecredits "https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/save_game_room"
click node_player "https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/players"
click node_enemies "https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/enemies"
click node_boss "https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/bosses/bowser"
click node_items "https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/items"
click node_blocks "https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/bumping_blocks"
click node_platforms "https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/platform"
click node_warps "https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/warps"
click node_fluid "https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/fluid"
click node_hud "https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/hud"
click node_pause "https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/pause"
click node_gameover "https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/game_over"
click node_progress "https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/progress_continue"
click node_transitions "https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/transitions"
click node_levelparts "https://github.com/thunder-engine-dev/thunder-engine/blob/main/components/level_part_loader/level_part_loader.gd"
click node_camera "https://github.com/thunder-engine-dev/thunder-engine/blob/main/components/cam_area/cam_area.gd"
click node_audio "https://github.com/thunder-engine-dev/thunder-engine/blob/main/components/audio_area/audio_area.gd"
click node_modifiers "https://github.com/thunder-engine-dev/thunder-engine/tree/main/node_modifiers"

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_level,node_map,node_mainmenu,node_savecredits toneBlue
class node_player,node_enemies,node_boss,node_items,node_blocks toneAmber
class node_platforms,node_warps,node_fluid toneMint
class node_hud,node_pause,node_gameover,node_progress,node_transitions toneRose
class node_levelparts,node_camera,node_audio,node_modifiers,node_creator toneIndigo
```

## Components

### Game authoring

- [Level scenes](https://github.com/thunder-engine-dev/thunder-engine/tree/main/scripts/classes/level): `scripts/classes/level`
- [World map](https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/map): `scenes/map`
- [Main menu](https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/main_menu): `scenes/main_menu`
- [Save room and credits](https://github.com/thunder-engine-dev/thunder-engine/tree/main/scenes/save_game_room): `scenes/save_game_room`

### Gameplay systems

- [Player characters](https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/players): `objects/players`
- [Enemies](https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/enemies): `objects/enemies`
- [Bowser encounters](https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/bosses/bowser): `objects/bosses/bowser`
- [Items and powerups](https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/items): `objects/items`
- [Interactive blocks](https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/bumping_blocks): `objects/bumping_blocks`

### World and encounters

- [Platforms and terrain](https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/platform): `objects/platform`
- [Warps and areas](https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/warps): `objects/warps`
- [Fluid systems](https://github.com/thunder-engine-dev/thunder-engine/tree/main/objects/fluid): `objects/fluid`

### Player interface

- [HUD and scoring](https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/hud): `components/hud`
- [Pause and menus](https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/pause): `components/pause`
- [Game over flow](https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/game_over): `components/game_over`
- [Progress continuation](https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/progress_continue): `components/progress_continue`
- [Scene transitions](https://github.com/thunder-engine-dev/thunder-engine/tree/main/components/transitions): `components/transitions`

### Shared runtime

- [Level part loading](https://github.com/thunder-engine-dev/thunder-engine/blob/main/components/level_part_loader/level_part_loader.gd): `components/level_part_loader/level_part_loader.gd`
- [Camera areas](https://github.com/thunder-engine-dev/thunder-engine/blob/main/components/cam_area/cam_area.gd): `components/cam_area/cam_area.gd`
- [Audio areas](https://github.com/thunder-engine-dev/thunder-engine/blob/main/components/audio_area/audio_area.gd): `components/audio_area/audio_area.gd`
- [Physics modifiers](https://github.com/thunder-engine-dev/thunder-engine/tree/main/node_modifiers): `node_modifiers`

### Other components

- **Game creator**

## Connections

- Game creator → Level scenes: creates scene (evidence: `README.md`)
- Game creator → World map: copies template (evidence: `README.md`)
- Game creator → Main menu: customizes template (evidence: `README.md`)
- Game creator → Save room and credits: customizes templates (evidence: `README.md`)
