Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/statute8234/monster-maze

Rating: (8/10): Monster Maze is a Java-based 2D grid game where players navigate, collect items, and battle monsters, using AI for movement and strategic moves.
https://github.com/statute8234/monster-maze

arraylist event iterator jpanel random time timer timertask

Last synced: about 1 month ago
JSON representation

Rating: (8/10): Monster Maze is a Java-based 2D grid game where players navigate, collect items, and battle monsters, using AI for movement and strategic moves.

Awesome Lists containing this project

README

        

# MonsterMaze
Monster Maze is a Java-based 2D grid game where players navigate a maze, collect items, and battle monsters. It features random item spawns, AI for monster movements, and a simple yet engaging gameplay experience.

[![Static Badge](https://img.shields.io/badge/javax.swing.*-green)](https://mvnrepository.com/artifact/javax.swing.*)
[![Static Badge](https://img.shields.io/badge/java.awt.*-orange)](https://mvnrepository.com/artifact/java.awt.*)
[![Static Badge](https://img.shields.io/badge/java.awt.event.*-red)](https://mvnrepository.com/artifact/java.awt.event.*)
[![Static Badge](https://img.shields.io/badge/java.sql.Time-yellow)](https://mvnrepository.com/artifact/java.sql.Time)
[![Static Badge](https://img.shields.io/badge/java.util.ArrayList-blue)](https://mvnrepository.com/artifact/java.util.ArrayList)
[![Static Badge](https://img.shields.io/badge/java.util.Random-red)](https://mvnrepository.com/artifact/java.util.Random)
[![Static Badge](https://img.shields.io/badge/java.util.TimerTask-blue)](https://mvnrepository.com/artifact/java.util.TimerTask)
[![Static Badge](https://img.shields.io/badge/java.util.Iterator-black)](https://mvnrepository.com/artifact/java.util.Iterator)
[![Static Badge](https://img.shields.io/badge/javax.swing.JPanel-black)](https://mvnrepository.com/artifact/javax.swing.JPanel)
[![Static Badge](https://img.shields.io/badge/javax.swing.Timer-blue)](https://mvnrepository.com/artifact/javax.swing.Timer)

## Table of Contents

- [About](#about)
- [Features](#features)
- [Installation](#installation)
- [Usage](#usage)
- [Contributing](#contributing)
- [License](#license)

## About

Monster Maze is a Java-based 2D grid game where players navigate a maze, collect items, and battle monsters. The game features random item spawns, such as food, weapons, and level-up items, with players strategically moving to avoid the monster and collecting items to increase health and damage capabilities. It includes basic AI for monster movements.

## Features

- **Grid-Based Layout:** Explore a 2D grid maze to discover hidden paths and new areas.
- **Random Item Spawns:** Collect food, weapons, and level-up items to enhance your character.
- **Monster AI:** Engage in battles with monsters that have basic AI movements.
- **Strategy and Exploration:** Balance collecting items with avoiding monsters for survival.
- **Engaging Gameplay:** Combines exploration, strategy, and combat in a challenging 2D adventure.

## Installation

To install Monster Maze, follow these steps:

1. Clone the repository using HTTPS:
```bash
git clone https://github.com/{User}/Monster-Maze.git
```
2. Alternatively, clone using SSH:
```bash
git clone [email protected]:{User}/Monster-Maze.git
```
3. Navigate to the project directory:
```bash
cd Monster-Maze
```

## Usage

The Monster Maze GitHub repository structure includes a Java source file, assets, images, README.md, .gitignore, and LICENSE.

- `src/`: Contains the main Java source file.
- `assets/images/`: Stores images for the player, monster, food, weapon, and level-up items.
- `README.md`: Provides an overview of the project and usage instructions.
- `.gitignore`: Specifies files and directories to be ignored by Git.
- `LICENSE`: Includes the project's distribution license.

To run the game, compile and execute the main Java class in the `src` directory.

## Contributing

Contributions are welcome! To contribute to Monster Maze, follow these steps:

1. Fork the repository.
2. Create a new branch:
```bash
git checkout -b feature/YourFeature
```
3. Make your changes and commit them:
```bash
git commit -m "Add new feature"
```
4. Push to the branch:
```bash
git push origin feature/YourFeature
```
5. Create a new Pull Request.

## License

This project is licensed under the MIT License. See the [LICENSE](LICENSE) file for details.