# extro181/pirategame architecture

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

- Interactive diagram: https://gitdiagram.com/extro181/pirategame
- Repository: https://github.com/extro181/pirategame

## Overview

Throne of the Drowned is a procedurally generated browser Soulslike: the player explores a world of islands and seas, fights enemies and bosses, sails and progresses through the story, then reaches the endgame and New Game+. At runtime, the Bevy app initializes the game, world, generated art, and presentation systems; the game scene coordinates simulation and progression, while the HUD and custom renderer present the result. The README documents broad gameplay capabilities; unsampled modules are represented by their supported paths, with uncertain connections omitted.

Main entry points: [`src/game/mod.rs`](https://github.com/extro181/pirategame/blob/main/src/game/mod.rs) (Game scene), [`src/main.rs`](https://github.com/extro181/pirategame/blob/main/src/main.rs) (Bevy app), [`src/gfx/mod.rs`](https://github.com/extro181/pirategame/blob/main/src/gfx/mod.rs) (Pixel renderer), [`src/game/actors.rs`](https://github.com/extro181/pirategame/blob/main/src/game/actors.rs) (Combat and actors)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Runtime and state"]
  node_app["Bevy app<br/>[main.rs]"]
  node_save[("Profiles and saves<br/>[save.rs]")]
end

subgraph group_gameplay["Gameplay systems"]
  node_game["Game scene<br/>[mod.rs]"]
  node_actors["Combat and actors<br/>[actors.rs]"]
  node_bosses["Boss encounters<br/>[boss.rs]"]
  node_endgame["Endgame encounter<br/>[endboss.rs]"]
  node_seamon["Sea monsters<br/>[seamon.rs]"]
  node_ship["Ship and sailing<br/>[ship.rs]"]
  node_data["Game data<br/>[data.rs]"]
  node_input["Input actions<br/>[input.rs]"]
end

subgraph group_world["World and exploration"]
  node_worldgen["World generation<br/>[mod.rs]"]
  node_wild["Wild islands<br/>[wild.rs]"]
  node_worldview["World view<br/>[view.rs]"]
end

subgraph group_presentation["Presentation"]
  node_hud["Game HUD<br/>[hud.rs]"]
  node_menu["Menus<br/>[menu.rs]"]
  node_renderer["Pixel renderer<br/>[mod.rs]"]
  node_effects["Pixel effects<br/>[pfx.rs]"]
  node_audio["Audio and music<br/>[audio.rs]"]
end

subgraph group_art["Procedural art"]
  node_art_runtime["Game art atlas<br/>[art.rs]"]
  node_art_canvas["Art canvas<br/>[canvas.rs]"]
  node_art_color["Color utilities<br/>[color.rs]"]
  node_art_noise["Noise utilities<br/>[noise.rs]"]
  node_art_chars["Character art<br/>[chars.rs]"]
  node_art_structures["Structure art<br/>[structures.rs]"]
end

node_player(("Player"))

node_player -->|"starts game"| node_app
node_app -->|"initializes"| node_game
node_app -->|"creates world"| node_worldgen
node_app -->|"initializes art"| node_art_runtime
node_app -->|"configures"| node_renderer
node_app -->|"initializes"| node_audio
node_app -->|"loads and saves"| node_save
node_app -->|"starts UI"| node_menu
node_game -->|"uses world"| node_worldgen
node_game -->|"creates bosses"| node_bosses
node_game -->|"manages actors"| node_actors
node_game -->|"uses game data"| node_data
node_actors -->|"reads definitions"| node_data
node_actors -->|"reads actions"| node_input
node_actors -->|"queries world"| node_worldgen
node_bosses -->|"uses actor data"| node_actors
node_game -->|"updates sea life"| node_seamon
node_game -.->|"handles sailing"| node_ship
node_game -->|"runs endgame"| node_endgame
node_game -->|"persists progress"| node_save
node_worldgen -->|"builds islands"| node_wild
node_worldgen -->|"provides world"| node_worldview
node_worldview -->|"draws through"| node_renderer
node_worldview -->|"uses sprites"| node_art_runtime
node_hud -->|"reads game state"| node_game
node_hud -->|"draws UI"| node_renderer
node_hud -->|"reads actions"| node_input
node_menu -->|"reads and writes"| node_save
node_menu -->|"draws menus"| node_renderer
node_game -->|"uses effects"| node_effects
node_effects -->|"uploads frames"| node_renderer
node_art_runtime -->|"uploads atlas"| node_renderer
node_art_chars -->|"draws on"| node_art_canvas
node_art_canvas -->|"uses colors"| node_art_color
node_art_canvas -->|"uses noise"| node_art_noise
node_art_structures -->|"draws on"| node_art_canvas

click node_app "https://github.com/extro181/pirategame/blob/main/src/main.rs"
click node_save "https://github.com/extro181/pirategame/blob/main/src/save.rs"
click node_game "https://github.com/extro181/pirategame/blob/main/src/game/mod.rs"
click node_actors "https://github.com/extro181/pirategame/blob/main/src/game/actors.rs"
click node_bosses "https://github.com/extro181/pirategame/blob/main/src/game/boss.rs"
click node_endgame "https://github.com/extro181/pirategame/blob/main/src/game/endboss.rs"
click node_seamon "https://github.com/extro181/pirategame/blob/main/src/game/seamon.rs"
click node_ship "https://github.com/extro181/pirategame/blob/main/src/game/ship.rs"
click node_data "https://github.com/extro181/pirategame/blob/main/src/game/data.rs"
click node_input "https://github.com/extro181/pirategame/blob/main/src/game/input.rs"
click node_worldgen "https://github.com/extro181/pirategame/blob/main/src/world/mod.rs"
click node_wild "https://github.com/extro181/pirategame/blob/main/src/world/wild.rs"
click node_worldview "https://github.com/extro181/pirategame/blob/main/src/world/view.rs"
click node_hud "https://github.com/extro181/pirategame/blob/main/src/ui/hud.rs"
click node_menu "https://github.com/extro181/pirategame/blob/main/src/ui/menu.rs"
click node_renderer "https://github.com/extro181/pirategame/blob/main/src/gfx/mod.rs"
click node_effects "https://github.com/extro181/pirategame/blob/main/src/pfx.rs"
click node_audio "https://github.com/extro181/pirategame/blob/main/src/audio.rs"
click node_art_runtime "https://github.com/extro181/pirategame/blob/main/src/art.rs"
click node_art_canvas "https://github.com/extro181/pirategame/blob/main/crates/art/src/canvas.rs"
click node_art_color "https://github.com/extro181/pirategame/blob/main/crates/art/src/color.rs"
click node_art_noise "https://github.com/extro181/pirategame/blob/main/crates/art/src/noise.rs"
click node_art_chars "https://github.com/extro181/pirategame/blob/main/crates/art/src/chars.rs"
click node_art_structures "https://github.com/extro181/pirategame/blob/main/crates/art/src/structures.rs"

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_app,node_save toneBlue
class node_game,node_actors,node_bosses,node_endgame,node_seamon,node_ship,node_data,node_input toneAmber
class node_worldgen,node_wild,node_worldview toneMint
class node_hud,node_menu,node_renderer,node_effects,node_audio toneRose
class node_art_runtime,node_art_canvas,node_art_color,node_art_noise,node_art_chars,node_art_structures,node_player toneIndigo
```

## Components

### Runtime and state

- [Bevy app](https://github.com/extro181/pirategame/blob/main/src/main.rs): `src/main.rs`
- [Profiles and saves](https://github.com/extro181/pirategame/blob/main/src/save.rs): `src/save.rs`

### Gameplay systems

- [Game scene](https://github.com/extro181/pirategame/blob/main/src/game/mod.rs): `src/game/mod.rs`
- [Combat and actors](https://github.com/extro181/pirategame/blob/main/src/game/actors.rs): `src/game/actors.rs`
- [Boss encounters](https://github.com/extro181/pirategame/blob/main/src/game/boss.rs): `src/game/boss.rs`
- [Endgame encounter](https://github.com/extro181/pirategame/blob/main/src/game/endboss.rs): `src/game/endboss.rs`
- [Sea monsters](https://github.com/extro181/pirategame/blob/main/src/game/seamon.rs): `src/game/seamon.rs`
- [Ship and sailing](https://github.com/extro181/pirategame/blob/main/src/game/ship.rs): `src/game/ship.rs`
- [Game data](https://github.com/extro181/pirategame/blob/main/src/game/data.rs): `src/game/data.rs`
- [Input actions](https://github.com/extro181/pirategame/blob/main/src/game/input.rs): `src/game/input.rs`

### World and exploration

- [World generation](https://github.com/extro181/pirategame/blob/main/src/world/mod.rs): `src/world/mod.rs`
- [Wild islands](https://github.com/extro181/pirategame/blob/main/src/world/wild.rs): `src/world/wild.rs`
- [World view](https://github.com/extro181/pirategame/blob/main/src/world/view.rs): `src/world/view.rs`

### Presentation

- [Game HUD](https://github.com/extro181/pirategame/blob/main/src/ui/hud.rs): `src/ui/hud.rs`
- [Menus](https://github.com/extro181/pirategame/blob/main/src/ui/menu.rs): `src/ui/menu.rs`
- [Pixel renderer](https://github.com/extro181/pirategame/blob/main/src/gfx/mod.rs): `src/gfx/mod.rs`
- [Pixel effects](https://github.com/extro181/pirategame/blob/main/src/pfx.rs): `src/pfx.rs`
- [Audio and music](https://github.com/extro181/pirategame/blob/main/src/audio.rs): `src/audio.rs`

### Procedural art

- [Game art atlas](https://github.com/extro181/pirategame/blob/main/src/art.rs): `src/art.rs`
- [Art canvas](https://github.com/extro181/pirategame/blob/main/crates/art/src/canvas.rs): `crates/art/src/canvas.rs`
- [Color utilities](https://github.com/extro181/pirategame/blob/main/crates/art/src/color.rs): `crates/art/src/color.rs`
- [Noise utilities](https://github.com/extro181/pirategame/blob/main/crates/art/src/noise.rs): `crates/art/src/noise.rs`
- [Character art](https://github.com/extro181/pirategame/blob/main/crates/art/src/chars.rs): `crates/art/src/chars.rs`
- [Structure art](https://github.com/extro181/pirategame/blob/main/crates/art/src/structures.rs): `crates/art/src/structures.rs`

### Other components

- **Player**

## Connections

- Player → Bevy app: starts game (evidence: `README.md`)
- Bevy app → Game scene: initializes (evidence: `src/main.rs`)
- Bevy app → World generation: creates world (evidence: `src/main.rs`)
- Bevy app → Game art atlas: initializes art (evidence: `src/main.rs`)
- Bevy app → Pixel renderer: configures (evidence: `src/main.rs`)
- Bevy app → Audio and music: initializes (evidence: `src/main.rs`)
- Bevy app → Profiles and saves: loads and saves (evidence: `src/main.rs`)
- Bevy app → Menus: starts UI (evidence: `src/main.rs`)
- Game scene → World generation: uses world (evidence: `src/game/mod.rs`)
- Game scene → Boss encounters: creates bosses (evidence: `src/game/mod.rs`)
- Game scene → Combat and actors: manages actors (evidence: `src/game/mod.rs`)
- Game scene → Game data: uses game data (evidence: `src/game/mod.rs`)
- Combat and actors → Game data: reads definitions (evidence: `src/game/actors.rs`)
- Combat and actors → Input actions: reads actions (evidence: `src/game/actors.rs`)
- Combat and actors → World generation: queries world (evidence: `src/game/actors.rs`)
- Boss encounters → Combat and actors: uses actor data (evidence: `src/game/boss.rs`)
- Game scene → Sea monsters: updates sea life (evidence: `src/game/seamon.rs`)
- Game scene → Ship and sailing: handles sailing (evidence: `src/game/mod.rs`)
- Game scene → Endgame encounter: runs endgame (evidence: `src/game/endboss.rs`)
- Game scene → Profiles and saves: persists progress (evidence: `src/save.rs`)
- World generation → Wild islands: builds islands (evidence: `src/world/mod.rs`)
- World generation → World view: provides world (evidence: `src/world/view.rs`)
- World view → Pixel renderer: draws through (evidence: `src/world/view.rs`)
- World view → Game art atlas: uses sprites (evidence: `src/world/view.rs`)
- Game HUD → Game scene: reads game state (evidence: `src/ui/hud.rs`)
- Game HUD → Pixel renderer: draws UI (evidence: `src/ui/hud.rs`)
- Game HUD → Input actions: reads actions (evidence: `src/ui/hud.rs`)
- Menus → Profiles and saves: reads and writes (evidence: `src/ui/menu.rs`)
- Menus → Pixel renderer: draws menus (evidence: `src/ui/menu.rs`)
- Game scene → Pixel effects: uses effects (evidence: `src/game/mod.rs`)
- Pixel effects → Pixel renderer: uploads frames (evidence: `src/pfx.rs`)
- Game art atlas → Pixel renderer: uploads atlas (evidence: `src/art.rs`)
- Character art → Art canvas: draws on (evidence: `crates/art/src/chars.rs`)
- Art canvas → Color utilities: uses colors (evidence: `crates/art/src/canvas.rs`)
- Art canvas → Noise utilities: uses noise (evidence: `crates/art/src/canvas.rs`)
- Structure art → Art canvas: draws on (evidence: `crates/art/src/structures.rs`)
