Dungeon Crawler

A JavaFX dungeon crawler built with a model-view-controller (MVC) architecture. Guide the hero through randomly generated dungeon levels, collect treasure, defeat enemies with the sword power-up, and reach the exit.

Requirements

• Java 24 or later
• Maven

Run

From the project directory, run:

mvn javafx:run

You can also build the project and its runnable jar with:

mvn package

Controls

• Use the on-screen arrow buttons or the arrow keys to move.
• WASD keys are also supported.
• Start a game from the title screen.
• Toggle hard mode and switch between dungeon and forest themes from the title screen.

Project Structure

• model: game state, board logic, pieces, collisions, and observer support
• controller: translates player actions into model commands
• view: JavaFX rendering and user interface
• Main.java: application entry point

The main class is edu.unc.comp301.Main.