# mhao2956/last-citadel architecture

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

- Interactive diagram: https://gitdiagram.com/mhao2956/last-citadel
- Repository: https://github.com/mhao2956/last-citadel

## Overview

Last-Citadel is a Java tower-defense game. The player enters through the menu, starts a wave-based defense session, places and upgrades towers, and reaches a win or loss scene; a separate editor supports creating levels. The graph captures the game loop, gameplay managers and entities, level editing and persistence, UI, and audio. The README provides no capability detail, so subsystem relationships rely on the supplied source excerpts and SOURCE INDEX; unsampled implementation details are not asserted.

Main entry points: [`src/main/Game.java`](https://github.com/mhao2956/last-citadel/blob/main/src/main/Game.java) (Game loop), [`src/scenes/Playing.java`](https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Playing.java) (Playing scene), [`src/scenes/Menu.java`](https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Menu.java) (Menu), [`src/managers/ProjectileManager.java`](https://github.com/mhao2956/last-citadel/blob/main/src/managers/ProjectileManager.java) (Projectile manager)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Game application"]
  node_game["Game loop<br/>[Game.java]"]
  node_screen["Input screen<br/>[GameScreen.java]"]
  node_states["Game states<br/>[GameStates.java]"]
  node_render["State renderer<br/>[Render.java]"]
  node_menu["Menu<br/>[Menu.java]"]
  node_settings["Settings<br/>[Settings.java]"]
  node_outcomes["Win and loss<br/>[GameWin.java]"]
end

subgraph group_play["Defense gameplay"]
  node_playing["Playing scene<br/>[Playing.java]"]
  node_waves["Wave manager<br/>[WaveManager.java]"]
  node_enemies["Enemy manager<br/>[EnemyManager.java]"]
  node_factory["Enemy factory<br/>[EnemyFactory.java]"]
  node_enemy["Enemy types<br/>[Enemy.java]"]
  node_towers["Tower manager<br/>[TowerManager.java]"]
  node_projectiles["Projectile manager"]
  node_tower["Tower model<br/>[Tower.java]"]
  node_projectile["Projectile model<br/>[Projectile.java]"]
  node_actionbar["Gameplay controls<br/>[ActionBar.java]"]
end

subgraph group_level["Level authoring"]
  node_editor["Level editor<br/>[Editing.java]"]
  node_tiles["Tile manager<br/>[TileManager.java]"]
  node_tile["Tile model<br/>[Tile.java]"]
  node_pathpoint["Path points<br/>[PathPoint.java]"]
end

subgraph group_support["Assets and services"]
  node_storage[("Level storage<br/>[LoadSave.java]")]
  node_audio["Audio player<br/>[AudioPlayer.java]"]
  node_ui["Buttons<br/>[MyButton.java]"]
end

node_player(("Player"))

node_player -->|"sends input"| node_screen
node_screen -->|"forwards input"| node_game
node_game -->|"creates"| node_screen
node_game -->|"creates"| node_render
node_game -->|"creates"| node_menu
node_game -->|"creates"| node_playing
node_game -->|"creates"| node_settings
node_game -->|"creates"| node_editor
node_game -->|"creates"| node_outcomes
node_menu -->|"sets state"| node_states
node_menu -->|"uses buttons"| node_ui
node_menu -->|"plays effects"| node_audio
node_render -->|"reads state"| node_game
node_game -->|"checks state"| node_states
node_game -->|"controls music"| node_audio
node_playing -->|"updates waves"| node_waves
node_playing -->|"spawns enemies"| node_enemies
node_playing -->|"manages towers"| node_towers
node_playing -->|"updates projectiles"| node_projectiles
node_playing -->|"updates controls"| node_actionbar
node_enemies -->|"creates enemies"| node_factory
node_factory -->|"instantiates types"| node_enemy
node_enemies -->|"moves and draws"| node_enemy
node_towers -->|"manages towers"| node_tower
node_projectiles -->|"manages shots"| node_projectile
node_projectiles -->|"targets enemies"| node_enemy
node_projectiles -->|"reads tower stats"| node_tower
node_actionbar -->|"updates gameplay"| node_playing
node_actionbar -->|"selects towers"| node_tower
node_editor -->|"saves levels"| node_storage
node_editor -->|"uses tiles"| node_tiles
node_editor -->|"sets path"| node_pathpoint
node_tiles -->|"loads assets"| node_storage
node_tiles -->|"manages tiles"| node_tile
node_playing -->|"loads level"| node_storage
node_playing -->|"changes scene"| node_outcomes
node_outcomes -->|"uses buttons"| node_ui
node_ui -->|"loads images"| node_storage

click node_game "https://github.com/mhao2956/last-citadel/blob/main/src/main/Game.java"
click node_screen "https://github.com/mhao2956/last-citadel/blob/main/src/main/GameScreen.java"
click node_states "https://github.com/mhao2956/last-citadel/blob/main/src/main/GameStates.java"
click node_render "https://github.com/mhao2956/last-citadel/blob/main/src/main/Render.java"
click node_menu "https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Menu.java"
click node_settings "https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Settings.java"
click node_playing "https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Playing.java"
click node_waves "https://github.com/mhao2956/last-citadel/blob/main/src/managers/WaveManager.java"
click node_enemies "https://github.com/mhao2956/last-citadel/blob/main/src/managers/EnemyManager.java"
click node_factory "https://github.com/mhao2956/last-citadel/blob/main/src/managers/EnemyFactory.java"
click node_enemy "https://github.com/mhao2956/last-citadel/blob/main/src/enemies/Enemy.java"
click node_towers "https://github.com/mhao2956/last-citadel/blob/main/src/managers/TowerManager.java"
click node_projectiles "https://github.com/mhao2956/last-citadel/blob/main/src/managers/ProjectileManager.java"
click node_tower "https://github.com/mhao2956/last-citadel/blob/main/src/objects/Tower.java"
click node_projectile "https://github.com/mhao2956/last-citadel/blob/main/src/objects/Projectile.java"
click node_actionbar "https://github.com/mhao2956/last-citadel/blob/main/src/ui/ActionBar.java"
click node_editor "https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Editing.java"
click node_tiles "https://github.com/mhao2956/last-citadel/blob/main/src/managers/TileManager.java"
click node_tile "https://github.com/mhao2956/last-citadel/blob/main/src/objects/Tile.java"
click node_pathpoint "https://github.com/mhao2956/last-citadel/blob/main/src/objects/PathPoint.java"
click node_storage "https://github.com/mhao2956/last-citadel/blob/main/src/helpz/LoadSave.java"
click node_audio "https://github.com/mhao2956/last-citadel/blob/main/src/helpz/AudioPlayer.java"
click node_ui "https://github.com/mhao2956/last-citadel/blob/main/src/ui/MyButton.java"
click node_outcomes "https://github.com/mhao2956/last-citadel/blob/main/src/scenes/GameWin.java"

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,node_screen,node_states,node_render,node_menu,node_settings,node_outcomes toneBlue
class node_playing,node_waves,node_enemies,node_factory,node_enemy,node_towers,node_projectiles,node_tower,node_projectile,node_actionbar toneAmber
class node_editor,node_tiles,node_tile,node_pathpoint toneMint
class node_storage,node_audio,node_ui toneRose
class node_player toneIndigo
```

## Components

### Game application

- [Game loop](https://github.com/mhao2956/last-citadel/blob/main/src/main/Game.java): `src/main/Game.java`
- [Input screen](https://github.com/mhao2956/last-citadel/blob/main/src/main/GameScreen.java): `src/main/GameScreen.java`
- [Game states](https://github.com/mhao2956/last-citadel/blob/main/src/main/GameStates.java): `src/main/GameStates.java`
- [State renderer](https://github.com/mhao2956/last-citadel/blob/main/src/main/Render.java): `src/main/Render.java`
- [Menu](https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Menu.java): `src/scenes/Menu.java`
- [Settings](https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Settings.java): `src/scenes/Settings.java`
- [Win and loss](https://github.com/mhao2956/last-citadel/blob/main/src/scenes/GameWin.java): `src/scenes/GameWin.java`

### Defense gameplay

- [Playing scene](https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Playing.java): `src/scenes/Playing.java`
- [Wave manager](https://github.com/mhao2956/last-citadel/blob/main/src/managers/WaveManager.java): `src/managers/WaveManager.java`
- [Enemy manager](https://github.com/mhao2956/last-citadel/blob/main/src/managers/EnemyManager.java): `src/managers/EnemyManager.java`
- [Enemy factory](https://github.com/mhao2956/last-citadel/blob/main/src/managers/EnemyFactory.java): `src/managers/EnemyFactory.java`
- [Enemy types](https://github.com/mhao2956/last-citadel/blob/main/src/enemies/Enemy.java): `src/enemies/Enemy.java`
- [Tower manager](https://github.com/mhao2956/last-citadel/blob/main/src/managers/TowerManager.java): `src/managers/TowerManager.java`
- [Projectile manager](https://github.com/mhao2956/last-citadel/blob/main/src/managers/ProjectileManager.java): `src/managers/ProjectileManager.java`
- [Tower model](https://github.com/mhao2956/last-citadel/blob/main/src/objects/Tower.java): `src/objects/Tower.java`
- [Projectile model](https://github.com/mhao2956/last-citadel/blob/main/src/objects/Projectile.java): `src/objects/Projectile.java`
- [Gameplay controls](https://github.com/mhao2956/last-citadel/blob/main/src/ui/ActionBar.java): `src/ui/ActionBar.java`

### Level authoring

- [Level editor](https://github.com/mhao2956/last-citadel/blob/main/src/scenes/Editing.java): `src/scenes/Editing.java`
- [Tile manager](https://github.com/mhao2956/last-citadel/blob/main/src/managers/TileManager.java): `src/managers/TileManager.java`
- [Tile model](https://github.com/mhao2956/last-citadel/blob/main/src/objects/Tile.java): `src/objects/Tile.java`
- [Path points](https://github.com/mhao2956/last-citadel/blob/main/src/objects/PathPoint.java): `src/objects/PathPoint.java`

### Assets and services

- [Level storage](https://github.com/mhao2956/last-citadel/blob/main/src/helpz/LoadSave.java): `src/helpz/LoadSave.java`
- [Audio player](https://github.com/mhao2956/last-citadel/blob/main/src/helpz/AudioPlayer.java): `src/helpz/AudioPlayer.java`
- [Buttons](https://github.com/mhao2956/last-citadel/blob/main/src/ui/MyButton.java): `src/ui/MyButton.java`

### Other components

- **Player**

## Connections

- Player → Input screen: sends input (evidence: `src/main/GameScreen.java`)
- Input screen → Game loop: forwards input (evidence: `src/main/GameScreen.java`)
- Game loop → Input screen: creates (evidence: `src/main/Game.java`)
- Game loop → State renderer: creates (evidence: `src/main/Game.java`)
- Game loop → Menu: creates (evidence: `src/main/Game.java`)
- Game loop → Playing scene: creates (evidence: `src/main/Game.java`)
- Game loop → Settings: creates (evidence: `src/main/Game.java`)
- Game loop → Level editor: creates (evidence: `src/main/Game.java`)
- Game loop → Win and loss: creates (evidence: `src/main/Game.java`)
- Menu → Game states: sets state (evidence: `src/scenes/Menu.java`)
- Menu → Buttons: uses buttons (evidence: `src/scenes/Menu.java`)
- Menu → Audio player: plays effects (evidence: `src/scenes/Menu.java`)
- State renderer → Game loop: reads state (evidence: `src/main/Render.java`)
- Game loop → Game states: checks state (evidence: `src/main/Game.java`)
- Game loop → Audio player: controls music (evidence: `src/main/Game.java`)
- Playing scene → Wave manager: updates waves (evidence: `src/scenes/Playing.java`)
- Playing scene → Enemy manager: spawns enemies (evidence: `src/scenes/Playing.java`)
- Playing scene → Tower manager: manages towers (evidence: `src/scenes/Playing.java`)
- Playing scene → Projectile manager: updates projectiles (evidence: `src/scenes/Playing.java`)
- Playing scene → Gameplay controls: updates controls (evidence: `src/scenes/Playing.java`)
- Enemy manager → Enemy factory: creates enemies (evidence: `src/managers/EnemyManager.java`)
- Enemy factory → Enemy types: instantiates types (evidence: `src/managers/EnemyFactory.java`)
- Enemy manager → Enemy types: moves and draws (evidence: `src/managers/EnemyManager.java`)
- Tower manager → Tower model: manages towers (evidence: `src/managers/TowerManager.java`)
- Projectile manager → Projectile model: manages shots (evidence: `src/managers/ProjectileManager.java`)
- Projectile manager → Enemy types: targets enemies (evidence: `src/managers/ProjectileManager.java`)
- Projectile manager → Tower model: reads tower stats (evidence: `src/managers/ProjectileManager.java`)
- Gameplay controls → Playing scene: updates gameplay (evidence: `src/ui/ActionBar.java`)
- Gameplay controls → Tower model: selects towers (evidence: `src/ui/ActionBar.java`)
- Level editor → Level storage: saves levels (evidence: `src/scenes/Editing.java`)
- Level editor → Tile manager: uses tiles (evidence: `src/scenes/Editing.java`)
- Level editor → Path points: sets path (evidence: `src/scenes/Editing.java`)
- Tile manager → Level storage: loads assets (evidence: `src/managers/TileManager.java`)
- Tile manager → Tile model: manages tiles (evidence: `src/managers/TileManager.java`)
- Playing scene → Level storage: loads level (evidence: `src/scenes/Playing.java`)
- Playing scene → Win and loss: changes scene (evidence: `src/scenes/Playing.java`)
- Win and loss → Buttons: uses buttons (evidence: `src/scenes/GameWin.java`)
- Buttons → Level storage: loads images (evidence: `src/ui/MyButton.java`)
