• Appreciate issues in user interface design
• Learn practical aspects of graphical user interface programming
• Learn more about the Java class libraries
• Learn the application of design patterns
• Make a wacky game in the process

This project was done for a object oriented programming course in UNSW. Written by Leonard Lee and Zachary Tan. Special thanks to Well son and Wei ze!! 👍

🎥 Sample gameplay on YouTube

1. Download and set-up Visual Studio Code here 👉 VSCode

2. set up java jdk here 👉 vscode for java

   • download the installer for your Operating System (windows/mac)

3. Go to Extension tab in VSCode and in the search bar look for 'Java Extension Pack'

   • this package includes the java code runner so we can launch the game.
   • details of the extension here 👉 Java Extension Pack

4. That should do it! ⭐ Go to src/unsw/dungeon/FrontendApplication.java ⭐ and click on 'Run' on top of the main function.

❗ IMPORTANT ❗ The set-up is currently tested and working for macOS and Linux.

❗ IMPORTANT ❗ for windows, first download git here, then checkout into the 'windows' branch and follow setup steps 1 - 4.

The client desires an application that lets the user move a player around a dungeon and try to overcome various challenges in order to "complete" the level by reaching some goal.

Here is how the start menu looks like:

Be sure to read the instructions for the game and go on to select the different level maps!

Here's a glimpse as to how they look like!

To be specific, the layout of each dungeon is defined by a grid of squares, each of which may contain one or more entities. The different types of entities are as follows:

Entity	Example	Description
Player		Can be moved up, down, left, and right into adjacent squares, provided another entity doesn't stop them (e.g. a wall).
Wall		Blocks the movement of the player, enemies and boulders.
Exit		If the player goes through it the puzzle is complete.
Treasure		Can be collected by the player.
Door		Exists in conjunction with a single key that can open it. If the player holds the key, they can open the door by moving through it. Once open it remains so. The client will be satisfied if dungeons can be made with up to 3 doors.
Key		Can be picked up by the player when they move into the square containing it. The player can carry only one key at a time, and only one door has a lock that fits the key. It disappears once it is used to open its corresponding door.
Boulder		Acts like a wall in most cases. The only difference being that it can be pushed by the player into adjacent squares. The player is only strong enough to push one boulder at a time.
Floor switch		Switches behave like empty squares, so other entities can appear on top of them. When a boulder is pushed onto a floor switch, it is triggered. Pushing a boulder off the floor switch untriggers it.
Portal		Teleports entities to a corresponding portal.
Enemy		Constantly moves toward the player, stopping if it cannot move any closer. The player dies upon collision with an enemy.
Sword		This can be picked up the player and used to kill enemies. Only one sword can be carried at once. Each sword is only capable of 5 hits and disappears after that. One hit of the sword is sufficient to destroy any enemy.
Invincibility potion		If the player picks this up they become invincible to enemies. Colliding with an enemy should result in their immediate destruction. Because of this, all enemies will run away from the player when they are invincible. The effect of the potion only lasts a limited time.
Invincible mode		This is how morty looks like in invincible mode. (After picking up potion)
Armed mode		This is how morty looks like in armed mode. (After picking up sword)

In addition to its layout, each dungeon also has a goal that defines what must be achieved by the player for the dungeon to be considered complete. Basic goals are:

• Getting to an exit.
• Destroying all enemies.
• Having a boulder on all floor switches.
• Collecting all treasure.

More complex goals are being stated in the side panel in the game Dungeon window.

{ "goal": "AND", "subgoals":
  [ { "goal": "exit" },
    { "goal": "OR", "subgoals":
      [ {"goal": "enemies" },
        {"goal": "treasure" }
      ]
    }
  ]
}

Note that the same basic goal can appear more than once in a statement.

The UI component of this project will be implemented in JavaFX.

The client has given you free reign over the visual design of the program. Included in the starter code are some example assets, but you are free to use different ones. The examples above came from here.

have fun!