https://github.com/christopheralphonse/whackamole_java
https://github.com/christopheralphonse/whackamole_java
Last synced: about 1 year ago
JSON representation
- Host: GitHub
- URL: https://github.com/christopheralphonse/whackamole_java
- Owner: ChristopherAlphonse
- Created: 2023-12-24T01:04:32.000Z (over 2 years ago)
- Default Branch: master
- Last Pushed: 2023-12-30T04:31:23.000Z (over 2 years ago)
- Last Synced: 2025-01-20T20:52:01.302Z (over 1 year ago)
- Language: Java
- Size: 2.4 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Whack-A-Mole - Mario Edition
## Overview
Whack-A-Mole is a classic game with a Mario twist, where players aim to hit the popping Moles while avoiding hitting Piranha Plants. The game features a graphical user interface (GUI) built using Java Swing and utilizes audio feedback for a more immersive experience.
## Features
- 🌟 Mario-themed Whack-A-Mole game.
- 🌟 Score tracking for successful hits.
- 🌟 Audio feedback for wins and losses.
- 🌟 Adjustable difficulty with timer speed control.
- 🌟 Restart option for a new game.
## How to Run
1. 🌟 Clone or download the project from the GitHub repository.
2. 🌟 Open the project in your preferred Java development environment.
3. 🌟 Run the `WhackAMole` class to start the game.
## Gameplay
- 🌟 Moles and Piranha Plants pop up randomly on the game board.
- 🌟 Click on Moles to score points. Avoid clicking on Piranha Plants.
- 🌟 Use the buttons to adjust the game's difficulty by changing the timer speed.
- 🌟 Restart the game at any time by clicking the "Restart Game" button.
## Project Structure
- 🌟 `WhackAMole.java`: Main class containing the game logic.
- 🌟 `/assetsFiles`: Folder containing game assets (icons, audio files).
## Prerequisites
- 🌟 Java Development Kit (JDK)
## Installation
1. 🌟 Clone or download the repository to your local machine.
```bash
git clone https://github.com/ChristopherAlphonse/whackAMole_Java.git
#### 🌟 Run the Main.java to start the game.
```bash
public class Main {
public static void main(String[] args) throws Exception {
WhackAMole WhackAMole = new WhackAMole();
System.out.println("Game Started");
}
}
```
## Game Features
- 🌟 The game board dynamically adjusts to a 3x3 grid, providing a challenging gameplay experience.
- 🌟 Enjoy the game with iconic Mario characters, featuring Monty Mole and Piranha Plant.
- 🌟 The score is displayed at the top of the window, allowing you to track your performance.