y33-j3t / mazerunner-game

Action maze game with mob fighting and player upgrade mechanics built with vanilla Java

Mazerunner Game

Action maze game with mob fighting and player upgrade mechanics made with vanilla Java.

Contents

• Mazerunner Game
  • Contents
  • Introduction
  • Program Description
    • 🏃 Story
    • 🎯 Objective
    • 🛠️ Settings
    • 💻 UI Styling
    • 🔁 Flow
    • 👻 Entities
    • ⌨️ Controls
  • Installation
  • Usage
  • Contributing
  • Credits
  • License

Introduction

Mazerunner game was originally an assignment for a Java programming course. 📚 My team and I decided to add some action and all to the originally boring maze. 😂 Was our first time to ever code any games. 💩 A little buggy, watch out! 😆

Program Description

🏃 Story

Details

Johnny, a renowned Maze Runner, is experienced in hunting for valuables. However, on his previous expedition, he was attacked by the scary Some Tribe in Some Island. When he woke up, he found himself in the middle of a dark scary night. He has no idea where he is. Judging from his intuition, Johnny believes that he is being trapped in the famous GG Maze of Some Island. He needs to escape Some Island as soon as possible but needs to collect all his lost items in GG Maze. As the player, you are Johnny.

🎯 Objective

Details

• Collect all lost items.
• Navigate to the exit after collecting all lost items.
• Survive.

🛠️ Settings

Details

• A maze of size 20 x 20.
• The maze will always have an exit E for Johnny to escape.
• Other than what is visible by Johnny, the maze is be blacked out with # . (Johnny cannot see through walls)
• Johnny is able to move up, down, left and right in the maze depending on whether there are any obstacles or not.
• The lost items are randomly scattered around the maze, represented by @ .
• If Johnny leaves the maze without all the lost items, Johnny is considered a disgrace to the Maze Runner’s community.

💻 UI Styling

Details

• Simple.
• Vintage.
• Console game look-alike.
• Every game component only uses keyboard characters.
• Game screen on the left.
• Game panel on the right.

🔁 Flow

Details

👻 Entities

Details

• J Johnny
• Z Zombie
• * Bullet
• # Fog
• Path
• E Exit
• | Vertical Wall
• --- Horizontal Wall
• @ +1 Lost Item
• $ +5 Gold
• + +5 HP

⌨️ Controls

Details

• W Move Up
• A Move Down
• S Move Right
• D Move Left
• ↑ Shoot Up
• ↓ Shoot Down
• → Shoot Right
• ← Shoot Left
• P Pause

Installation

• Java SE Development Kit 8 (JDK 8)
• NetBeans IDE 8.0.1

Usage

1. Download this repository in a zip file by clicking here or execute this from the terminal:

git clone https://github.com/y33-j3T/Mazerunner-Game.git

2. Open your IDE.
3. Open the project with your IDE.
4. Build and run.

Contributing

Please refer to CONTRIBUTE.md for details. 😍

Credits

A big shoutout to my seniors and friends who made it all happen. 😊

• @ceyeoh0428
• @alvinwong64
• @tankianaun
• @waixiong
• @jiuntian

License

Mazerunner Game is released under the Apache License 2.0.