# iulian-hub/runaway-rabbit-decomp architecture

> Architecture diagram of the GitHub repository iulian-hub/runaway-rabbit-decomp, 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/iulian-hub/runaway-rabbit-decomp
- Repository: https://github.com/iulian-hub/runaway-rabbit-decomp

## Overview

This repository contains a legacy BlitzBasic game and a Godot-based clone. The clone’s apparent player journey runs from startup and menus through campaign selection into gameplay, with profiles and level definitions supporting that experience. Gameplay is divided into player, enemy, projectile, and explosion behavior, with HUD and pause UI alongside it. The legacy source exposes corresponding gameplay and menu subsystems. No README text or source excerpts were provided, so relationships are shown only as unverified, dashed links inferred from filenames and tree structure.

Main entry points: [`Functions/gameloop.bb`](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/gameloop.bb) (Legacy game loop), [`runaway-rabbit-clona/scripts/main.gd`](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/main.gd) (Game controller), [`runaway-rabbit-clona/scripts/levels/level_director.gd`](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_director.gd) (Level director), [`runaway-rabbit-clona/scripts/ui/main_menu.gd`](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/main_menu.gd) (Main menu)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_godot_flow["Godot startup and menus"]
  node_main["Game controller<br/>[main.gd]"]
  node_boot["Boot screen<br/>[boot.gd]"]
  node_splash["Splash screen<br/>[splash_screen.gd]"]
  node_main_menu["Main menu<br/>[main_menu.gd]"]
  node_level_select["Level select<br/>[level_select.gd]"]
  node_profile_select["Profile select<br/>[profile_select.gd]"]
  node_instructions["Instructions<br/>[instructions.gd]"]
  node_bitmap_text["Bitmap text<br/>[bitmap_text.gd]"]
end

subgraph group_campaign["Campaign and profiles"]
  node_level_director["Level director<br/>[level_director.gd]"]
  node_level_definition["Level definition"]
  node_level_events["Level events<br/>[level_event.gd]"]
  node_templates["Level templates"]
  node_profiles[("Profile manager<br/>[profile_manager.gd]")]
end

subgraph group_gameplay["Gameplay runtime"]
  node_player["Player<br/>[player.gd]"]
  node_enemy["Enemy<br/>[enemy.gd]"]
  node_projectile["Projectile<br/>[projectile.gd]"]
  node_explosion["Explosion<br/>[explosion.gd]"]
  node_hud["Gameplay HUD<br/>[gameplay_hud.gd]"]
  node_pause_menu["Pause menu"]
  node_backdrop["Gameplay backdrop"]
end

subgraph group_legacy["Legacy BlitzBasic"]
  node_legacy_entry["Legacy entry<br/>[EntryPoint.bb]"]
  node_legacy_loop["Legacy game loop<br/>[gameloop.bb]"]
  node_legacy_levels["Legacy levels<br/>[dolevels.bb]"]
  node_legacy_actors["Legacy actors<br/>[doactors.bb]"]
  node_legacy_players["Legacy players<br/>[doplayers.bb]"]
  node_legacy_enemies["Legacy enemies<br/>[doenemies.bb]"]
  node_legacy_weapons["Legacy weapons<br/>[doweaponshots.bb]"]
  node_legacy_menu["Legacy menus<br/>[domenu.bb]"]
  node_legacy_hud["Legacy HUD<br/>[dohud.bb]"]
  node_legacy_profiles[("Legacy profiles<br/>[saveprofiles.bb]")]
end

node_boot -.->|"leads to"| node_splash
node_splash -.->|"leads to"| node_main_menu
node_main_menu -.->|"opens"| node_profile_select
node_main_menu -.->|"opens"| node_instructions
node_profile_select -.->|"uses profiles"| node_profiles
node_main_menu -.->|"opens"| node_level_select
node_level_select -.->|"starts campaign"| node_level_director
node_level_director -.->|"uses definition"| node_level_definition
node_level_director -.->|"uses templates"| node_templates
node_level_director -.->|"uses events"| node_level_events
node_main -.->|"coordinates"| node_level_director
node_main -.->|"coordinates"| node_player
node_main -.->|"coordinates"| node_enemy
node_main -.->|"coordinates"| node_hud
node_main -.->|"coordinates"| node_backdrop
node_main -.->|"coordinates"| node_pause_menu
node_player -.->|"uses"| node_projectile
node_enemy -.->|"uses"| node_projectile
node_enemy -.->|"uses"| node_explosion
node_legacy_entry -.->|"starts"| node_legacy_loop
node_legacy_loop -.->|"updates"| node_legacy_levels
node_legacy_loop -.->|"updates"| node_legacy_actors
node_legacy_loop -.->|"updates"| node_legacy_players
node_legacy_loop -.->|"updates"| node_legacy_enemies
node_legacy_loop -.->|"updates"| node_legacy_weapons
node_legacy_loop -.->|"updates"| node_legacy_menu
node_legacy_loop -.->|"updates"| node_legacy_hud
node_legacy_menu -.->|"uses profiles"| node_legacy_profiles

click node_player "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/player.gd"
click node_enemy "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/enemy.gd"
click node_projectile "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/projectile.gd"
click node_explosion "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/explosion.gd"
click node_level_director "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_director.gd"
click node_level_definition "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_definition.gd"
click node_level_events "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_event.gd"
click node_templates "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_template_library.gd"
click node_profiles "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/autoload/profile_manager.gd"
click node_main "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/main.gd"
click node_boot "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/boot.gd"
click node_splash "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/splash_screen.gd"
click node_main_menu "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/main_menu.gd"
click node_level_select "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/level_select.gd"
click node_profile_select "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/profile_select.gd"
click node_instructions "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/instructions.gd"
click node_hud "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/gameplay_hud.gd"
click node_pause_menu "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/gameplay_pause_menu.gd"
click node_backdrop "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/gameplay_backdrop.gd"
click node_bitmap_text "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/bitmap_text.gd"
click node_legacy_entry "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/EntryPoint.bb"
click node_legacy_loop "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/gameloop.bb"
click node_legacy_levels "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/dolevels.bb"
click node_legacy_actors "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/doactors.bb"
click node_legacy_players "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/doplayers.bb"
click node_legacy_enemies "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/doenemies.bb"
click node_legacy_weapons "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/doweaponshots.bb"
click node_legacy_menu "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/domenu.bb"
click node_legacy_hud "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/dohud.bb"
click node_legacy_profiles "https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/saveprofiles.bb"

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_main,node_boot,node_splash,node_main_menu,node_level_select,node_profile_select,node_instructions,node_bitmap_text toneBlue
class node_level_director,node_level_definition,node_level_events,node_templates,node_profiles toneAmber
class node_player,node_enemy,node_projectile,node_explosion,node_hud,node_pause_menu,node_backdrop toneMint
class node_legacy_entry,node_legacy_loop,node_legacy_levels,node_legacy_actors,node_legacy_players,node_legacy_enemies,node_legacy_weapons,node_legacy_menu,node_legacy_hud,node_legacy_profiles toneRose
```

## Components

### Godot startup and menus

- [Game controller](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/main.gd): `runaway-rabbit-clona/scripts/main.gd`
- [Boot screen](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/boot.gd): `runaway-rabbit-clona/scripts/ui/boot.gd`
- [Splash screen](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/splash_screen.gd): `runaway-rabbit-clona/scripts/ui/splash_screen.gd`
- [Main menu](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/main_menu.gd): `runaway-rabbit-clona/scripts/ui/main_menu.gd`
- [Level select](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/level_select.gd): `runaway-rabbit-clona/scripts/ui/level_select.gd`
- [Profile select](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/profile_select.gd): `runaway-rabbit-clona/scripts/ui/profile_select.gd`
- [Instructions](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/instructions.gd): `runaway-rabbit-clona/scripts/ui/instructions.gd`
- [Bitmap text](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/bitmap_text.gd): `runaway-rabbit-clona/scripts/ui/bitmap_text.gd`

### Campaign and profiles

- [Level director](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_director.gd): `runaway-rabbit-clona/scripts/levels/level_director.gd`
- [Level definition](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_definition.gd): `runaway-rabbit-clona/scripts/levels/level_definition.gd`
- [Level events](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_event.gd): `runaway-rabbit-clona/scripts/levels/level_event.gd`
- [Level templates](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/levels/level_template_library.gd): `runaway-rabbit-clona/scripts/levels/level_template_library.gd`
- [Profile manager](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/autoload/profile_manager.gd): `runaway-rabbit-clona/scripts/autoload/profile_manager.gd`

### Gameplay runtime

- [Player](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/player.gd): `runaway-rabbit-clona/scripts/player.gd`
- [Enemy](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/enemy.gd): `runaway-rabbit-clona/scripts/enemy.gd`
- [Projectile](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/projectile.gd): `runaway-rabbit-clona/scripts/projectile.gd`
- [Explosion](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/explosion.gd): `runaway-rabbit-clona/scripts/explosion.gd`
- [Gameplay HUD](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/gameplay_hud.gd): `runaway-rabbit-clona/scripts/ui/gameplay_hud.gd`
- [Pause menu](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/gameplay_pause_menu.gd): `runaway-rabbit-clona/scripts/ui/gameplay_pause_menu.gd`
- [Gameplay backdrop](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/runaway-rabbit-clona/scripts/ui/gameplay_backdrop.gd): `runaway-rabbit-clona/scripts/ui/gameplay_backdrop.gd`

### Legacy BlitzBasic

- [Legacy entry](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/EntryPoint.bb): `Functions/EntryPoint.bb`
- [Legacy game loop](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/gameloop.bb): `Functions/gameloop.bb`
- [Legacy levels](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/dolevels.bb): `Functions/dolevels.bb`
- [Legacy actors](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/doactors.bb): `Functions/doactors.bb`
- [Legacy players](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/doplayers.bb): `Functions/doplayers.bb`
- [Legacy enemies](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/doenemies.bb): `Functions/doenemies.bb`
- [Legacy weapons](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/doweaponshots.bb): `Functions/doweaponshots.bb`
- [Legacy menus](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/domenu.bb): `Functions/domenu.bb`
- [Legacy HUD](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/dohud.bb): `Functions/dohud.bb`
- [Legacy profiles](https://github.com/iulian-hub/runaway-rabbit-decomp/blob/main/Functions/saveprofiles.bb): `Functions/saveprofiles.bb`

## Connections

- Boot screen → Splash screen: leads to
- Splash screen → Main menu: leads to
- Main menu → Profile select: opens
- Main menu → Instructions: opens
- Profile select → Profile manager: uses profiles
- Main menu → Level select: opens
- Level select → Level director: starts campaign
- Level director → Level definition: uses definition
- Level director → Level templates: uses templates
- Level director → Level events: uses events
- Game controller → Level director: coordinates
- Game controller → Player: coordinates
- Game controller → Enemy: coordinates
- Game controller → Gameplay HUD: coordinates
- Game controller → Gameplay backdrop: coordinates
- Game controller → Pause menu: coordinates
- Player → Projectile: uses
- Enemy → Projectile: uses
- Enemy → Explosion: uses
- Legacy entry → Legacy game loop: starts
- Legacy game loop → Legacy levels: updates
- Legacy game loop → Legacy actors: updates
- Legacy game loop → Legacy players: updates
- Legacy game loop → Legacy enemies: updates
- Legacy game loop → Legacy weapons: updates
- Legacy game loop → Legacy menus: updates
- Legacy game loop → Legacy HUD: updates
- Legacy menus → Legacy profiles: uses profiles
