# devoe09/recoil-shatter architecture

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

- Interactive diagram: https://gitdiagram.com/devoe09/recoil-shatter
- Repository: https://github.com/devoe09/recoil-shatter

## Overview

This is a Unity 3D game project, with runtime scripts for player control and health, combat, hazards, level progression, run management, and UI. The file tree suggests a gameplay loop involving runs and level transitions, but no README or source excerpts were provided, so runtime calls and the initiating workflow cannot be verified. The graph therefore maps the identifiable runtime components without speculative connections.

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_player_combat["Player Combat"]
  node_recoil["Recoil Controller"]
  node_health["Player Health<br/>[PlayerHealth3D.cs]"]
  node_bullet["Bullet Combat<br/>[Bullet3D.cs]"]
end

subgraph group_run["Run Systems"]
  node_run_manager["Run Manager<br/>[RunManager3D.cs]"]
  node_ai_director["AI Director<br/>[AIDirector3D.cs]"]
end

subgraph group_level_world["Level World"]
  node_level_manager["Level Manager<br/>[LevelManager3D.cs]"]
  node_upgrade_manager["Upgrade Manager"]
  node_exit_portal["Exit Portal<br/>[ExitPortal3D.cs]"]
  node_hazard_block["Hazard Block<br/>[HazardBlock3D.cs]"]
  node_moving_hazard["Moving Hazard<br/>[MovingHazard3D.cs]"]
  node_shatter_block["Shatter Block<br/>[ShatterBlock3D.cs]"]
end

subgraph group_presentation["Presentation"]
  node_camera["Top-Down Camera<br/>[TopDownCamera3D.cs]"]
  node_main_menu["Main Menu"]
  node_run_over["Run Over UI<br/>[RunOverUI.cs]"]
  node_speedrun_hud["Speedrun HUD<br/>[SpeedrunHUD3D.cs]"]
end

click node_recoil "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Player/RecoilController3D.cs"
click node_health "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Player/PlayerHealth3D.cs"
click node_bullet "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Combat/Bullet3D.cs"
click node_run_manager "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Run/RunManager3D.cs"
click node_ai_director "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Run/AIDirector3D.cs"
click node_level_manager "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Level/LevelManager3D.cs"
click node_upgrade_manager "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Level/UpgradeManager3D.cs"
click node_exit_portal "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Level/ExitPortal3D.cs"
click node_hazard_block "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/World/HazardBlock3D.cs"
click node_moving_hazard "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/World/MovingHazard3D.cs"
click node_shatter_block "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/World/ShatterBlock3D.cs"
click node_camera "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Camera/TopDownCamera3D.cs"
click node_main_menu "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/UI/MainMenuController3D.cs"
click node_run_over "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/UI/RunOverUI.cs"
click node_speedrun_hud "https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/UI/SpeedrunHUD3D.cs"

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_recoil,node_health,node_bullet toneBlue
class node_run_manager,node_ai_director toneAmber
class node_level_manager,node_upgrade_manager,node_exit_portal,node_hazard_block,node_moving_hazard,node_shatter_block toneMint
class node_camera,node_main_menu,node_run_over,node_speedrun_hud toneRose
```

## Components

### Player Combat

- [Recoil Controller](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Player/RecoilController3D.cs): `Assets/Scripts/Player/RecoilController3D.cs`
- [Player Health](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Player/PlayerHealth3D.cs): `Assets/Scripts/Player/PlayerHealth3D.cs`
- [Bullet Combat](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Combat/Bullet3D.cs): `Assets/Scripts/Combat/Bullet3D.cs`

### Run Systems

- [Run Manager](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Run/RunManager3D.cs): `Assets/Scripts/Run/RunManager3D.cs`
- [AI Director](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Run/AIDirector3D.cs): `Assets/Scripts/Run/AIDirector3D.cs`

### Level World

- [Level Manager](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Level/LevelManager3D.cs): `Assets/Scripts/Level/LevelManager3D.cs`
- [Upgrade Manager](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Level/UpgradeManager3D.cs): `Assets/Scripts/Level/UpgradeManager3D.cs`
- [Exit Portal](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Level/ExitPortal3D.cs): `Assets/Scripts/Level/ExitPortal3D.cs`
- [Hazard Block](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/World/HazardBlock3D.cs): `Assets/Scripts/World/HazardBlock3D.cs`
- [Moving Hazard](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/World/MovingHazard3D.cs): `Assets/Scripts/World/MovingHazard3D.cs`
- [Shatter Block](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/World/ShatterBlock3D.cs): `Assets/Scripts/World/ShatterBlock3D.cs`

### Presentation

- [Top-Down Camera](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/Camera/TopDownCamera3D.cs): `Assets/Scripts/Camera/TopDownCamera3D.cs`
- [Main Menu](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/UI/MainMenuController3D.cs): `Assets/Scripts/UI/MainMenuController3D.cs`
- [Run Over UI](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/UI/RunOverUI.cs): `Assets/Scripts/UI/RunOverUI.cs`
- [Speedrun HUD](https://github.com/devoe09/recoil-shatter/blob/main/Assets/Scripts/UI/SpeedrunHUD3D.cs): `Assets/Scripts/UI/SpeedrunHUD3D.cs`
