# davidmasu/adventure architecture

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

- Interactive diagram: https://gitdiagram.com/davidmasu/adventure
- Repository: https://github.com/davidmasu/adventure

## Overview

This is a small Java text adventure. A player enters commands in the console; the interface delegates gameplay actions to Adventure, which coordinates the Player with the current Room and its enemies and items. Map builds the connected rooms and populates them with game content. Player handles movement, inventory, consumables, equipment, and attacks; weapons and item subclasses define the available content. The Main source is indexed as referencing the startup components, but its excerpt was not provided, so startup wiring is shown as unverified.

Main entry points: [`src/Player.java`](https://github.com/davidmasu/adventure/blob/main/src/Player.java) (Player state), [`src/Map.java`](https://github.com/davidmasu/adventure/blob/main/src/Map.java) (Map builder), [`src/UserInterface.java`](https://github.com/davidmasu/adventure/blob/main/src/UserInterface.java) (Command interface), [`src/Weapon.java`](https://github.com/davidmasu/adventure/blob/main/src/Weapon.java) (Weapon)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["Command interface"]
  node_main["Startup<br/>[Main.java]"]
  node_ui["Command interface<br/>[UserInterface.java]"]
end

subgraph group_world["World model"]
  node_map["Map builder<br/>[Map.java]"]
  node_room["Room<br/>[Room.java]"]
  node_enemy["Enemy<br/>[Enemy.java]"]
end

subgraph group_gameplay["Gameplay coordination"]
  node_adventure["Adventure coordinator<br/>[Adventure.java]"]
  node_player["Player state<br/>[Player.java]"]
end

subgraph group_content["Items and combat"]
  node_item["Item<br/>[Item.java]"]
  node_food["Food<br/>[Food.java]"]
  node_liquid["Liquid<br/>[Liquid.java]"]
  node_weapon["Weapon<br/>[Weapon.java]"]
  node_melee["Melee weapon<br/>[MeleeWeapon.java]"]
  node_ranged["Ranged weapon<br/>[RangedWeapon.java]"]
  node_equip_result["Equip result<br/>[Equip.java]"]
  node_attack_result["Attack result<br/>[Attack.java]"]
  node_eat_result["Eat result<br/>[EatResult.java]"]
  node_drink_result["Drink result<br/>[DrinkResult.java]"]
end

node_console_user(("Player"))

node_console_user -->|"enters commands"| node_ui
node_ui -->|"requests actions"| node_adventure
node_adventure -->|"delegates actions"| node_player
node_adventure -->|"reads and updates"| node_room
node_adventure -->|"finds target"| node_enemy
node_player -->|"moves and searches"| node_room
node_player -->|"manages inventory"| node_item
node_player -->|"consumes"| node_food
node_player -->|"drinks"| node_liquid
node_player -->|"equips and uses"| node_weapon
node_player -->|"attacks"| node_enemy
node_ui -->|"handles result"| node_equip_result
node_ui -->|"handles result"| node_attack_result
node_ui -->|"handles result"| node_eat_result
node_ui -->|"handles result"| node_drink_result
node_map -->|"builds rooms"| node_room
node_map -->|"places items"| node_item
node_map -->|"places food"| node_food
node_map -->|"places liquids"| node_liquid
node_map -->|"places weapons"| node_weapon
node_map -->|"places enemies"| node_enemy
node_enemy -->|"attacks with"| node_weapon
node_food -->|"extends"| node_item
node_liquid -->|"extends"| node_item
node_weapon -->|"extends"| node_item
node_melee -->|"extends"| node_weapon
node_ranged -->|"extends"| node_weapon
node_main -.->|"startup wiring"| node_map
node_main -.->|"startup wiring"| node_adventure
node_main -.->|"startup wiring"| node_ui

click node_main "https://github.com/davidmasu/adventure/blob/main/src/Main.java"
click node_ui "https://github.com/davidmasu/adventure/blob/main/src/UserInterface.java"
click node_adventure "https://github.com/davidmasu/adventure/blob/main/src/Adventure.java"
click node_player "https://github.com/davidmasu/adventure/blob/main/src/Player.java"
click node_map "https://github.com/davidmasu/adventure/blob/main/src/Map.java"
click node_room "https://github.com/davidmasu/adventure/blob/main/src/Room.java"
click node_enemy "https://github.com/davidmasu/adventure/blob/main/src/Enemy.java"
click node_item "https://github.com/davidmasu/adventure/blob/main/src/Item.java"
click node_food "https://github.com/davidmasu/adventure/blob/main/src/Food.java"
click node_liquid "https://github.com/davidmasu/adventure/blob/main/src/Liquid.java"
click node_weapon "https://github.com/davidmasu/adventure/blob/main/src/Weapon.java"
click node_melee "https://github.com/davidmasu/adventure/blob/main/src/MeleeWeapon.java"
click node_ranged "https://github.com/davidmasu/adventure/blob/main/src/RangedWeapon.java"
click node_equip_result "https://github.com/davidmasu/adventure/blob/main/src/Equip.java"
click node_attack_result "https://github.com/davidmasu/adventure/blob/main/src/Attack.java"
click node_eat_result "https://github.com/davidmasu/adventure/blob/main/src/EatResult.java"
click node_drink_result "https://github.com/davidmasu/adventure/blob/main/src/DrinkResult.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_main,node_ui toneBlue
class node_map,node_room,node_enemy toneAmber
class node_adventure,node_player toneMint
class node_item,node_food,node_liquid,node_weapon,node_melee,node_ranged,node_equip_result,node_attack_result,node_eat_result,node_drink_result toneRose
class node_console_user toneIndigo
```

## Components

### Command interface

- [Startup](https://github.com/davidmasu/adventure/blob/main/src/Main.java): `src/Main.java`
- [Command interface](https://github.com/davidmasu/adventure/blob/main/src/UserInterface.java): `src/UserInterface.java`

### World model

- [Map builder](https://github.com/davidmasu/adventure/blob/main/src/Map.java): `src/Map.java`
- [Room](https://github.com/davidmasu/adventure/blob/main/src/Room.java): `src/Room.java`
- [Enemy](https://github.com/davidmasu/adventure/blob/main/src/Enemy.java): `src/Enemy.java`

### Gameplay coordination

- [Adventure coordinator](https://github.com/davidmasu/adventure/blob/main/src/Adventure.java): `src/Adventure.java`
- [Player state](https://github.com/davidmasu/adventure/blob/main/src/Player.java): `src/Player.java`

### Items and combat

- [Item](https://github.com/davidmasu/adventure/blob/main/src/Item.java): `src/Item.java`
- [Food](https://github.com/davidmasu/adventure/blob/main/src/Food.java): `src/Food.java`
- [Liquid](https://github.com/davidmasu/adventure/blob/main/src/Liquid.java): `src/Liquid.java`
- [Weapon](https://github.com/davidmasu/adventure/blob/main/src/Weapon.java): `src/Weapon.java`
- [Melee weapon](https://github.com/davidmasu/adventure/blob/main/src/MeleeWeapon.java): `src/MeleeWeapon.java`
- [Ranged weapon](https://github.com/davidmasu/adventure/blob/main/src/RangedWeapon.java): `src/RangedWeapon.java`
- [Equip result](https://github.com/davidmasu/adventure/blob/main/src/Equip.java): `src/Equip.java`
- [Attack result](https://github.com/davidmasu/adventure/blob/main/src/Attack.java): `src/Attack.java`
- [Eat result](https://github.com/davidmasu/adventure/blob/main/src/EatResult.java): `src/EatResult.java`
- [Drink result](https://github.com/davidmasu/adventure/blob/main/src/DrinkResult.java): `src/DrinkResult.java`

### Other components

- **Player**

## Connections

- Player → Command interface: enters commands (evidence: `src/UserInterface.java`)
- Command interface → Adventure coordinator: requests actions (evidence: `src/UserInterface.java`)
- Adventure coordinator → Player state: delegates actions (evidence: `src/Adventure.java`)
- Adventure coordinator → Room: reads and updates (evidence: `src/Adventure.java`)
- Adventure coordinator → Enemy: finds target (evidence: `src/Adventure.java`)
- Player state → Room: moves and searches (evidence: `src/Player.java`)
- Player state → Item: manages inventory (evidence: `src/Player.java`)
- Player state → Food: consumes (evidence: `src/Player.java`)
- Player state → Liquid: drinks (evidence: `src/Player.java`)
- Player state → Weapon: equips and uses (evidence: `src/Player.java`)
- Player state → Enemy: attacks (evidence: `src/Player.java`)
- Command interface → Equip result: handles result (evidence: `src/UserInterface.java`)
- Command interface → Attack result: handles result (evidence: `src/UserInterface.java`)
- Command interface → Eat result: handles result (evidence: `src/UserInterface.java`)
- Command interface → Drink result: handles result (evidence: `src/UserInterface.java`)
- Map builder → Room: builds rooms (evidence: `src/Map.java`)
- Map builder → Item: places items (evidence: `src/Map.java`)
- Map builder → Food: places food (evidence: `src/Map.java`)
- Map builder → Liquid: places liquids (evidence: `src/Map.java`)
- Map builder → Weapon: places weapons (evidence: `src/Map.java`)
- Map builder → Enemy: places enemies (evidence: `src/Map.java`)
- Enemy → Weapon: attacks with (evidence: `src/Enemy.java`)
- Food → Item: extends (evidence: `src/Food.java`)
- Liquid → Item: extends (evidence: `src/Liquid.java`)
- Weapon → Item: extends (evidence: `src/Weapon.java`)
- Melee weapon → Weapon: extends (evidence: `src/MeleeWeapon.java`)
- Ranged weapon → Weapon: extends (evidence: `src/RangedWeapon.java`)
- Startup → Map builder: startup wiring (evidence: `src/Main.java`)
- Startup → Adventure coordinator: startup wiring (evidence: `src/Main.java`)
- Startup → Command interface: startup wiring (evidence: `src/Main.java`)
