# nicecraftz/dungeongrinder architecture

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

- Interactive diagram: https://gitdiagram.com/nicecraftz/dungeongrinder
- Repository: https://github.com/nicecraftz/dungeongrinder

## Overview

DungeonGrinder is a JavaFX dungeon crawler with keyboard movement, creature goals/pathfinding, asset-backed rendering, debug/status overlays, and procedurally generated rooms for effectively unbounded exploration. The principal flow is keyboard input into game-loop coordination, then entity/world updates and rendering; reaching a door invokes room transition handling. README capabilities guide inclusion of goals and asset registration despite limited source excerpts. Edges below use shown calls, SOURCE INDEX references, or README statements; unsampled implementation details are not asserted.

Main entry points: [`src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java) (Game Controller), [`src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/WorldEnvironment.java`](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/WorldEnvironment.java) (World Environment), [`src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/RoomController.java`](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/RoomController.java) (Room Transitions), [`src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/InputController.java`](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/InputController.java) (Input Routing)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Game Runtime"]
  node_gamecontroller["Game Controller"]
  node_gameloop["Game Loop"]
  node_roomcontroller["Room Transitions"]
  node_creaturecontroller["Creature Updates"]
  node_launcher["Application Startup"]
end

subgraph group_controls["Input and UI"]
  node_input["Input Routing"]
  node_movementinput["Movement Commands"]
  node_actioninput["Action Commands"]
  node_gameview["Dungeon Rendering<br/>[GameView.java]"]
  node_debug["Debug Overlay"]
  node_debugview["Debug View"]
  node_status["Status UI"]
  node_statusview["Status View<br/>[StatusView.java]"]
end

subgraph group_world["World and Entities"]
  node_player["Player<br/>[Player.java]"]
  node_worldenv["World Environment"]
  node_room["Room Generation<br/>[RoomGenerator.java]"]
  node_roomdata["Room and Tiles<br/>[GameRoom.java]"]
  node_entity["Entity Model<br/>[Entity.java]"]
  node_creatures["Creature Goals<br/>[Creature.java]"]
  node_pathfinding["Pathfinding"]
  node_container["Entity Container"]
end

subgraph group_engine["Game Engine"]
  node_movement["Movement Physics"]
  node_assets["Asset Registry<br/>[AssetRegistry.java]"]
end

node_keyboard(("Player"))

node_keyboard -->|"presses keys"| node_input
node_input -->|"routes input"| node_movementinput
node_input -->|"routes input"| node_actioninput
node_movementinput -->|"sets velocity"| node_player
node_actioninput -->|"acts on"| node_player
node_gamecontroller -->|"processes input"| node_input
node_gamecontroller -->|"ticks creatures"| node_creaturecontroller
node_gamecontroller -->|"updates motion"| node_movement
node_gamecontroller -->|"checks doors"| node_roomcontroller
node_gamecontroller -->|"reads world"| node_worldenv
node_gamecontroller -->|"renders world"| node_gameview
node_gamecontroller -->|"updates overlay"| node_debug
node_gamecontroller -->|"updates status"| node_status
node_movement -.->|"checks walkability"| node_worldenv
node_creaturecontroller -->|"iterates entities"| node_container
node_creaturecontroller -->|"ticks creatures"| node_creatures
node_creatures -.->|"finds paths"| node_pathfinding
node_roomcontroller -->|"reads and sets room"| node_worldenv
node_roomcontroller -->|"repositions player"| node_player
node_roomcontroller -->|"creates next room"| node_roomdata
node_roomdata -.->|"generates layout"| node_room
node_gameview -->|"reads tiles/entities"| node_worldenv
node_gameview -->|"loads tile images"| node_assets
node_debug -->|"reads world state"| node_worldenv
node_debug -->|"updates fields"| node_debugview
node_status -->|"reads player"| node_player
node_status -->|"updates display"| node_statusview
node_launcher -->|"starts game"| node_gamecontroller
node_gameloop -->|"ticks game"| node_gamecontroller

click node_player "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/player/Player.java"
click node_worldenv "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/WorldEnvironment.java"
click node_room "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/room/RoomGenerator.java"
click node_roomdata "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/room/GameRoom.java"
click node_entity "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/Entity.java"
click node_creatures "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/creature/Creature.java"
click node_pathfinding "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/pathfinder/SimplePathFinder.java"
click node_container "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/EntityContainer.java"
click node_gamecontroller "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java"
click node_gameloop "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameLoopController.java"
click node_roomcontroller "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/RoomController.java"
click node_creaturecontroller "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/CreatureController.java"
click node_input "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/InputController.java"
click node_movementinput "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/MovementInputController.java"
click node_actioninput "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/ActionInputController.java"
click node_movement "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/engine/physics/MovementSystem.java"
click node_gameview "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/GameView.java"
click node_assets "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/engine/asset/AssetRegistry.java"
click node_debug "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/DebugOverlayController.java"
click node_debugview "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/DebugOverlayView.java"
click node_status "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/StatusController.java"
click node_statusview "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/StatusView.java"
click node_launcher "https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/DungeonGrinderApplication.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_gamecontroller,node_gameloop,node_roomcontroller,node_creaturecontroller,node_launcher toneBlue
class node_input,node_movementinput,node_actioninput,node_gameview,node_debug,node_debugview,node_status,node_statusview toneAmber
class node_player,node_worldenv,node_room,node_roomdata,node_entity,node_creatures,node_pathfinding,node_container toneMint
class node_movement,node_assets toneRose
class node_keyboard toneIndigo
```

## Components

### Game Runtime

- [Game Controller](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`
- [Game Loop](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameLoopController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameLoopController.java`
- [Room Transitions](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/RoomController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/RoomController.java`
- [Creature Updates](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/CreatureController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/CreatureController.java`
- [Application Startup](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/DungeonGrinderApplication.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/DungeonGrinderApplication.java`

### Input and UI

- [Input Routing](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/InputController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/InputController.java`
- [Movement Commands](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/MovementInputController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/MovementInputController.java`
- [Action Commands](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/ActionInputController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/ActionInputController.java`
- [Dungeon Rendering](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/GameView.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/GameView.java`
- [Debug Overlay](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/DebugOverlayController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/DebugOverlayController.java`
- [Debug View](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/DebugOverlayView.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/DebugOverlayView.java`
- [Status UI](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/StatusController.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/StatusController.java`
- [Status View](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/StatusView.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/StatusView.java`

### World and Entities

- [Player](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/player/Player.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/player/Player.java`
- [World Environment](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/WorldEnvironment.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/WorldEnvironment.java`
- [Room Generation](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/room/RoomGenerator.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/room/RoomGenerator.java`
- [Room and Tiles](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/room/GameRoom.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/room/GameRoom.java`
- [Entity Model](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/Entity.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/Entity.java`
- [Creature Goals](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/creature/Creature.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/entity/creature/Creature.java`
- [Pathfinding](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/pathfinder/SimplePathFinder.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/pathfinder/SimplePathFinder.java`
- [Entity Container](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/EntityContainer.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/EntityContainer.java`

### Game Engine

- [Movement Physics](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/engine/physics/MovementSystem.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/engine/physics/MovementSystem.java`
- [Asset Registry](https://github.com/nicecraftz/dungeongrinder/blob/main/src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/engine/asset/AssetRegistry.java): `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/engine/asset/AssetRegistry.java`

### Other components

- **Player**

## Connections

- Player → Input Routing: presses keys (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/InputController.java`)
- Input Routing → Movement Commands: routes input (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/InputController.java`)
- Input Routing → Action Commands: routes input (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/InputController.java`)
- Movement Commands → Player: sets velocity (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/MovementInputController.java`)
- Action Commands → Player: acts on (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/input/ActionInputController.java`)
- Game Controller → Input Routing: processes input (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`)
- Game Controller → Creature Updates: ticks creatures (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`)
- Game Controller → Movement Physics: updates motion (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`)
- Game Controller → Room Transitions: checks doors (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`)
- Game Controller → World Environment: reads world (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`)
- Game Controller → Dungeon Rendering: renders world (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`)
- Game Controller → Debug Overlay: updates overlay (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`)
- Game Controller → Status UI: updates status (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameController.java`)
- Movement Physics → World Environment: checks walkability (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/engine/physics/MovementSystem.java`)
- Creature Updates → Entity Container: iterates entities (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/CreatureController.java`)
- Creature Updates → Creature Goals: ticks creatures (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/CreatureController.java`)
- Creature Goals → Pathfinding: finds paths
- Room Transitions → World Environment: reads and sets room (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/RoomController.java`)
- Room Transitions → Player: repositions player (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/RoomController.java`)
- Room Transitions → Room and Tiles: creates next room (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/world/RoomController.java`)
- Room and Tiles → Room Generation: generates layout (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/domain/world/room/GameRoom.java`)
- Dungeon Rendering → World Environment: reads tiles/entities (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/GameView.java`)
- Dungeon Rendering → Asset Registry: loads tile images (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/view/GameView.java`)
- Debug Overlay → World Environment: reads world state (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/DebugOverlayController.java`)
- Debug Overlay → Debug View: updates fields (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/DebugOverlayController.java`)
- Status UI → Player: reads player (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/StatusController.java`)
- Status UI → Status View: updates display (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/StatusController.java`)
- Application Startup → Game Controller: starts game (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/DungeonGrinderApplication.java`)
- Game Loop → Game Controller: ticks game (evidence: `src/main/java/it/unicam/cs/mpgc/rpg129874/dungeongrinder/controller/GameLoopController.java`)
