# rodak123/escapees architecture

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

- Interactive diagram: https://gitdiagram.com/rodak123/escapees
- Repository: https://github.com/rodak123/escapees

## Overview

Escapees is a Unity puzzle game in which the player guides escapees through levels by choosing tools and acting on the environment. The documented loop includes level selection and unlocking, spawning escapees, tool use, reaching an exit or failing, and recording level statistics and progress. The README also documents camera controls, sound, menus, and score copying. Source excerpts were not provided, so implementation links below use only documented relationships and existing enclosing asset directories; the tree does not expose gameplay scripts.

Main entry points: [`Assets/_Project`](https://github.com/rodak123/escapees/tree/main/Assets/_Project) (Game Loop), [`Assets/Plugins/WebGL/Clipboard.jslib`](https://github.com/rodak123/escapees/blob/main/Assets/Plugins/WebGL/Clipboard.jslib) (Score Copy), [`Assets/Rodak/Utils/Scripts/CameraLetterbox.cs`](https://github.com/rodak123/escapees/blob/main/Assets/Rodak/Utils/Scripts/CameraLetterbox.cs) (Camera Controls), [`Assets/_Project/Media/Audio`](https://github.com/rodak123/escapees/tree/main/Assets/_Project/Media/Audio) (Game Audio)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_gameplay["Gameplay"]
  node_game_loop["Game Loop"]
  node_escapee_spawner["Escapee Spawner"]
  node_escapees["Escapees"]
  node_tool_selection["Tool Selection"]
  node_tools["Tools"]
  node_level_environment["Level Environment"]
  node_exit["Level Exit"]
  node_game_outcome["Win / Fail"]
end

subgraph group_progress["Menus and Progress"]
  node_main_menu["Main Menu"]
  node_level_select["Level Selection"]
  node_progress_save[("Progress Saving")]
  node_score_copy["Score Copy<br/>[Clipboard.jslib]"]
  node_level_stats["Level Statistics"]
  node_pause_menu["Pause Menu"]
end

subgraph group_presentation["Presentation"]
  node_camera["Camera Controls<br/>[CameraLetterbox.cs]"]
  node_audio["Game Audio"]
end

subgraph group_utilities["Shared Utilities"]
  node_interpolation["Interpolation"]
  node_singleton["Singleton Utilities"]
  node_readonly_attribute["Read-Only Inspector"]
end

node_player(("Player"))

node_player -->|"opens"| node_main_menu
node_player -->|"selects level"| node_level_select
node_level_select -->|"starts level"| node_game_loop
node_level_select -->|"shows stats"| node_level_stats
node_game_loop -->|"spawns"| node_escapee_spawner
node_game_loop -->|"tracks lives"| node_escapees
node_player -->|"picks tools"| node_tool_selection
node_tool_selection -->|"chooses"| node_tools
node_player -->|"uses tools"| node_tools
node_tools -->|"changes terrain"| node_level_environment
node_tools -->|"affects movement"| node_escapees
node_escapees -->|"reach exit"| node_exit
node_game_loop -->|"checks outcome"| node_game_outcome
node_game_outcome -->|"records result"| node_level_stats
node_level_stats -->|"saves progress"| node_progress_save
node_progress_save -->|"unlocks levels"| node_level_select
node_player -->|"pauses"| node_pause_menu
node_pause_menu -->|"resets game"| node_game_loop
node_player -->|"copies score"| node_score_copy
node_game_loop -->|"moves camera"| node_camera
node_game_loop -->|"plays sounds"| node_audio

click node_main_menu "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_level_select "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_progress_save "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_score_copy "https://github.com/rodak123/escapees/blob/main/Assets/Plugins/WebGL/Clipboard.jslib"
click node_game_loop "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_escapee_spawner "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_escapees "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_tool_selection "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_tools "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_level_environment "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_exit "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_game_outcome "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_level_stats "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_pause_menu "https://github.com/rodak123/escapees/tree/main/Assets/_Project"
click node_camera "https://github.com/rodak123/escapees/blob/main/Assets/Rodak/Utils/Scripts/CameraLetterbox.cs"
click node_audio "https://github.com/rodak123/escapees/tree/main/Assets/_Project/Media/Audio"
click node_interpolation "https://github.com/rodak123/escapees/tree/main/Assets/Rodak/Utils/Scripts/Interpolation"
click node_singleton "https://github.com/rodak123/escapees/tree/main/Assets/Rodak/Utils/Scripts/Singleton"
click node_readonly_attribute "https://github.com/rodak123/escapees/tree/main/Assets/ReadOnlyAttribute"

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_loop,node_escapee_spawner,node_escapees,node_tool_selection,node_tools,node_level_environment,node_exit,node_game_outcome toneBlue
class node_main_menu,node_level_select,node_progress_save,node_score_copy,node_level_stats,node_pause_menu toneAmber
class node_camera,node_audio toneMint
class node_interpolation,node_singleton,node_readonly_attribute toneRose
class node_player toneIndigo
```

## Components

### Gameplay

- [Game Loop](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Escapee Spawner](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Escapees](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Tool Selection](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Tools](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Level Environment](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Level Exit](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Win / Fail](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`

### Menus and Progress

- [Main Menu](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Level Selection](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Progress Saving](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Score Copy](https://github.com/rodak123/escapees/blob/main/Assets/Plugins/WebGL/Clipboard.jslib): `Assets/Plugins/WebGL/Clipboard.jslib`
- [Level Statistics](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`
- [Pause Menu](https://github.com/rodak123/escapees/tree/main/Assets/_Project): `Assets/_Project`

### Presentation

- [Camera Controls](https://github.com/rodak123/escapees/blob/main/Assets/Rodak/Utils/Scripts/CameraLetterbox.cs): `Assets/Rodak/Utils/Scripts/CameraLetterbox.cs`
- [Game Audio](https://github.com/rodak123/escapees/tree/main/Assets/_Project/Media/Audio): `Assets/_Project/Media/Audio`

### Shared Utilities

- [Interpolation](https://github.com/rodak123/escapees/tree/main/Assets/Rodak/Utils/Scripts/Interpolation): `Assets/Rodak/Utils/Scripts/Interpolation`
- [Singleton Utilities](https://github.com/rodak123/escapees/tree/main/Assets/Rodak/Utils/Scripts/Singleton): `Assets/Rodak/Utils/Scripts/Singleton`
- [Read-Only Inspector](https://github.com/rodak123/escapees/tree/main/Assets/ReadOnlyAttribute): `Assets/ReadOnlyAttribute`

### Other components

- **Player**

## Connections

- Player → Main Menu: opens (evidence: `README.md`)
- Player → Level Selection: selects level (evidence: `README.md`)
- Level Selection → Game Loop: starts level (evidence: `README.md`)
- Level Selection → Level Statistics: shows stats (evidence: `README.md`)
- Game Loop → Escapee Spawner: spawns (evidence: `README.md`)
- Game Loop → Escapees: tracks lives (evidence: `README.md`)
- Player → Tool Selection: picks tools (evidence: `README.md`)
- Tool Selection → Tools: chooses (evidence: `README.md`)
- Player → Tools: uses tools (evidence: `README.md`)
- Tools → Level Environment: changes terrain (evidence: `README.md`)
- Tools → Escapees: affects movement (evidence: `README.md`)
- Escapees → Level Exit: reach exit (evidence: `README.md`)
- Game Loop → Win / Fail: checks outcome (evidence: `README.md`)
- Win / Fail → Level Statistics: records result (evidence: `README.md`)
- Level Statistics → Progress Saving: saves progress (evidence: `README.md`)
- Progress Saving → Level Selection: unlocks levels (evidence: `README.md`)
- Player → Pause Menu: pauses (evidence: `README.md`)
- Pause Menu → Game Loop: resets game (evidence: `README.md`)
- Player → Score Copy: copies score (evidence: `README.md`)
- Game Loop → Camera Controls: moves camera (evidence: `README.md`)
- Game Loop → Game Audio: plays sounds (evidence: `README.md`)
