How kirby-teves/the_riddle_dungeon works
The Riddle Dungeon is a Java Swing escape-room game: the player progresses through six rooms by answering a guardian’s randomized riddle, managing hearts, and ultimately winning or dying. The application switches among menu, gameplay, and map views; gameplay checks answers and advances room state, while saves serialize the game manager. The README also documents difficulty tiers, guardian dialogue, hints, and map tracking. Some panel and entry-point source was only indexed, so uncertain internal links are omitted; documented capabilities remain represented.
Main entry points: Application.java Application Controller · GamePanel.java Game Panel · GameMaster.java Game Master Base · GameManager.java Game Manager
Components 15
Application and UI
- Program Entry
src/mains/Main.java - Application Controller
src/mains/Application.java - Main Menu
src/panels/mainMenuPanel.java - Game Panel
src/panels/GamePanel.java - Map Panel
src/panels/MapPanel.java
Dungeon Gameplay
- Room Challenge
src/model/Room.java - Player Health and Progress
src/model/Player.java
Riddles and Guardians
- Game Master Base
src/gamemasters/GameMaster.java - Six Guardians
src/gamemasters - Riddle Interface
src/model/IRiddle.java - Riddle Values
src/model/RiddleImpl.java - Riddle Configuration
src/.env
Game State and Saves
- Game Manager
src/model/GameManager.java - Save File
src/util/FileManager.java
Other components
- Player
Connections 21
- Player → Application Controller: starts game
README.md - Program Entry → Application Controller: launches
src/mains/Main.java - Application Controller → Game Manager: gets instance
src/mains/Application.java - Application Controller → Main Menu: creates and displays
src/mains/Application.java - Application Controller → Game Panel: creates and displays
src/mains/Application.java - Application Controller → Map Panel: creates and displays
src/mains/Application.java - Main Menu → Application Controller: requests navigation
src/panels/mainMenuPanel.java - Game Panel → Room Challenge: checks answers
src/panels/GamePanel.java - Game Panel → Player Health and Progress: updates gameplay
src/panels/GamePanel.java - Game Panel → Game Manager: saves progress
src/panels/GamePanel.java - Game Panel → Six Guardians: creates room guardians
src/panels/GamePanel.java - Map Panel → Game Manager: reads room progress
src/panels/MapPanel.java - Room Challenge → Game Master Base: gets riddle and greeting
src/model/Room.java - Six Guardians → Game Master Base: inherit behavior
src/gamemasters/Patrick.java - Game Master Base → Riddle Interface: uses
src/gamemasters/GameMaster.java - Game Master Base → Riddle Values: creates fallback
src/gamemasters/GameMaster.java - Six Guardians → Riddle Values: builds riddle pools
src/gamemasters/Patrick.java - Game Master Base → Riddle Configuration: loads values
src/gamemasters/GameMaster.java - Game Manager → Player Health and Progress: owns
src/model/GameManager.java - Game Manager → Save File: saves and loads
src/model/GameManager.java - Player Health and Progress → Save File: deletes save on death
src/model/Player.java