# strumfoalex/pirates-and-treasure architecture

> Architecture diagram of the GitHub repository strumfoalex/pirates-and-treasure, 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/strumfoalex/pirates-and-treasure
- Repository: https://github.com/strumfoalex/pirates-and-treasure

## Overview

This repository is a Java top-down adventure game. The player uses keyboard input to move and act; the game loop updates world state, handles encounters and map events, and renders the resulting scene. The graph includes world/map, combat and interaction, presentation/environment, and save/load capabilities. Several links rely on the SOURCE INDEX or sampled excerpts; unsampled implementation details are not inferred beyond those references.

Main entry points: [`src/main/GamePanel.java`](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/GamePanel.java) (Game loop), [`src/entity/Player.java`](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/entity/Player.java) (Player character), [`src/main/AssetSetter.java`](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/AssetSetter.java) (World placement), [`src/tile/TileManager.java`](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/tile/TileManager.java) (Tile map)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game runtime"]
  node_input["Keyboard input<br/>[KeyHandler.java]"]
  node_loop["Game loop<br/>[GamePanel.java]"]
  node_main["Game launcher<br/>[Main.java]"]
end

subgraph group_world["World and navigation"]
  node_placement["World placement<br/>[AssetSetter.java]"]
  node_tiles["Tile map<br/>[TileManager.java]"]
  node_mapview["World map view<br/>[Map.java]"]
  node_pathfind["Path finding<br/>[PathFinder.java]"]
  node_pathnode["Path node<br/>[Node.java]"]
end

subgraph group_play["Gameplay systems"]
  node_player["Player character<br/>[Player.java]"]
  node_collision["Collision checks"]
  node_events["World events<br/>[EventHandler.java]"]
  node_entities["Actors and objects<br/>[Entity.java]"]
  node_projectile["Projectiles<br/>[Projectile.java]"]
  node_monsters["Monster combat<br/>[MON_Skeleton.java]"]
  node_interactive["Interactive terrain"]
end

subgraph group_state["Presentation and state"]
  node_ui["Game interface<br/>[UI.java]"]
  node_environment["Environment effects"]
  node_lighting["Lighting effects<br/>[Lighting.java]"]
  node_saveload["Save and load<br/>[SaveLoad.java]"]
  node_savedata["Saved game data<br/>[DataStorage.java]"]
end

node_gamer(("Player"))

node_gamer -->|"presses keys"| node_input
node_input -->|"changes game state"| node_loop
node_main -->|"starts game"| node_loop
node_loop -->|"updates"| node_player
node_loop -->|"sets up world"| node_placement
node_loop -->|"checks events"| node_events
node_loop -->|"draws tiles"| node_tiles
node_loop -->|"uses map"| node_mapview
node_loop -->|"updates effects"| node_environment
node_loop -->|"delegates saves"| node_saveload
node_loop -->|"uses checks"| node_collision
node_loop -->|"creates finder"| node_pathfind
node_loop -->|"updates tiles"| node_interactive
node_loop -.->|"renders interface"| node_ui
node_player -->|"reads controls"| node_input
node_player -.->|"checks collisions"| node_collision
node_projectile -->|"checks hits"| node_collision
node_projectile -->|"damages player"| node_player
node_monsters -->|"extends behavior"| node_entities
node_monsters -->|"targets player"| node_player
node_events -->|"changes stats"| node_player
node_events -->|"resets monsters"| node_placement
node_tiles -->|"provides tile grid"| node_mapview
node_tiles -->|"draws path"| node_pathfind
node_pathfind -->|"uses nodes"| node_pathnode
node_environment -->|"updates and draws"| node_lighting
node_saveload -->|"stores game state"| node_savedata
node_placement -->|"creates monsters"| node_monsters
node_placement -->|"places terrain"| node_interactive
node_loop -->|"updates actors"| node_entities

click node_player "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/entity/Player.java"
click node_input "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/KeyHandler.java"
click node_loop "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/GamePanel.java"
click node_collision "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/CollisionChecker.java"
click node_placement "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/AssetSetter.java"
click node_events "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/EventHandler.java"
click node_tiles "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/tile/TileManager.java"
click node_mapview "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/tile/Map.java"
click node_pathfind "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/ai/PathFinder.java"
click node_pathnode "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/ai/Node.java"
click node_entities "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/entity/Entity.java"
click node_projectile "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/entity/Projectile.java"
click node_monsters "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/monster/MON_Skeleton.java"
click node_interactive "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/tile_interactive/InteractiveTile.java"
click node_ui "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/UI.java"
click node_environment "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/environment/EnvironmentManager.java"
click node_lighting "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/environment/Lighting.java"
click node_saveload "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/data/SaveLoad.java"
click node_savedata "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/data/DataStorage.java"
click node_main "https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/Main.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_input,node_loop,node_main toneBlue
class node_placement,node_tiles,node_mapview,node_pathfind,node_pathnode toneAmber
class node_player,node_collision,node_events,node_entities,node_projectile,node_monsters,node_interactive toneMint
class node_ui,node_environment,node_lighting,node_saveload,node_savedata toneRose
class node_gamer toneIndigo
```

## Components

### Game runtime

- [Keyboard input](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/KeyHandler.java): `src/main/KeyHandler.java`
- [Game loop](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/GamePanel.java): `src/main/GamePanel.java`
- [Game launcher](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/Main.java): `src/main/Main.java`

### World and navigation

- [World placement](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/AssetSetter.java): `src/main/AssetSetter.java`
- [Tile map](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/tile/TileManager.java): `src/tile/TileManager.java`
- [World map view](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/tile/Map.java): `src/tile/Map.java`
- [Path finding](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/ai/PathFinder.java): `src/ai/PathFinder.java`
- [Path node](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/ai/Node.java): `src/ai/Node.java`

### Gameplay systems

- [Player character](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/entity/Player.java): `src/entity/Player.java`
- [Collision checks](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/CollisionChecker.java): `src/main/CollisionChecker.java`
- [World events](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/EventHandler.java): `src/main/EventHandler.java`
- [Actors and objects](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/entity/Entity.java): `src/entity/Entity.java`
- [Projectiles](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/entity/Projectile.java): `src/entity/Projectile.java`
- [Monster combat](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/monster/MON_Skeleton.java): `src/monster/MON_Skeleton.java`
- [Interactive terrain](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/tile_interactive/InteractiveTile.java): `src/tile_interactive/InteractiveTile.java`

### Presentation and state

- [Game interface](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/main/UI.java): `src/main/UI.java`
- [Environment effects](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/environment/EnvironmentManager.java): `src/environment/EnvironmentManager.java`
- [Lighting effects](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/environment/Lighting.java): `src/environment/Lighting.java`
- [Save and load](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/data/SaveLoad.java): `src/data/SaveLoad.java`
- [Saved game data](https://github.com/strumfoalex/pirates-and-treasure/blob/master/src/data/DataStorage.java): `src/data/DataStorage.java`

### Other components

- **Player**

## Connections

- Player → Keyboard input: presses keys (evidence: `src/main/KeyHandler.java`)
- Keyboard input → Game loop: changes game state (evidence: `src/main/KeyHandler.java`)
- Game launcher → Game loop: starts game (evidence: `src/main/Main.java`)
- Game loop → Player character: updates (evidence: `src/main/GamePanel.java`)
- Game loop → World placement: sets up world (evidence: `src/main/GamePanel.java`)
- Game loop → World events: checks events (evidence: `src/main/GamePanel.java`)
- Game loop → Tile map: draws tiles (evidence: `src/main/GamePanel.java`)
- Game loop → World map view: uses map (evidence: `src/main/GamePanel.java`)
- Game loop → Environment effects: updates effects (evidence: `src/main/GamePanel.java`)
- Game loop → Save and load: delegates saves (evidence: `src/main/GamePanel.java`)
- Game loop → Collision checks: uses checks (evidence: `src/main/GamePanel.java`)
- Game loop → Path finding: creates finder (evidence: `src/main/GamePanel.java`)
- Game loop → Interactive terrain: updates tiles (evidence: `src/main/GamePanel.java`)
- Game loop → Game interface: renders interface (evidence: `src/main/UI.java`)
- Player character → Keyboard input: reads controls (evidence: `src/entity/Player.java`)
- Player character → Collision checks: checks collisions
- Projectiles → Collision checks: checks hits (evidence: `src/entity/Projectile.java`)
- Projectiles → Player character: damages player (evidence: `src/entity/Projectile.java`)
- Monster combat → Actors and objects: extends behavior (evidence: `src/monster/MON_Skeleton.java`)
- Monster combat → Player character: targets player (evidence: `src/monster/MON_Skeleton.java`)
- World events → Player character: changes stats (evidence: `src/main/EventHandler.java`)
- World events → World placement: resets monsters (evidence: `src/main/EventHandler.java`)
- Tile map → World map view: provides tile grid (evidence: `src/tile/Map.java`)
- Tile map → Path finding: draws path (evidence: `src/tile/TileManager.java`)
- Path finding → Path node: uses nodes (evidence: `src/ai/PathFinder.java`)
- Environment effects → Lighting effects: updates and draws (evidence: `src/environment/EnvironmentManager.java`)
- Save and load → Saved game data: stores game state (evidence: `src/data/SaveLoad.java`)
- World placement → Monster combat: creates monsters (evidence: `src/main/AssetSetter.java`)
- World placement → Interactive terrain: places terrain (evidence: `src/main/AssetSetter.java`)
- Game loop → Actors and objects: updates actors (evidence: `src/main/GamePanel.java`)
