simonthorell/rock-paper-scissor

Game developed in Java featuring a graphical user interface that enables players to engage remotely through MQTT, utilizing either Arduino or a Python script.

Java Multiplayer Game with MQTT

Overview

This project is a multiplayer game developed in Java, featuring a graphical user interface (GUI) and remote gameplay capabilities using MQTT (Message Queuing Telemetry Transport). The game allows players to engage with each other remotely, with support for both Arduino and Python scripts for enhanced gameplay.

Features

• Graphical User Interface: A user-friendly GUI for an engaging gaming experience.
• Remote Multiplayer Gameplay: Players can join and play the game remotely via MQTT protocol.
• Arduino and Python Script Support: Compatibility with Arduino and Python scripts for diverse gameplay options.
• Game Logic: Implements rock-paper-scissors game logic with a unique twist.
• Score Tracking and Ranking: Players' scores are tracked, and a ranking system is implemented to display player standings.

How to Play

1. Ensure that MQTT broker/server is set up and running.
2. Start the game application.
3. Choose between single-player or multiplayer mode.
4. In multiplayer mode, wait for other players to join.
5. Follow the on-screen instructions to play the game.
6. The game tracks each player's score and displays the winner at the end of each round.

Requirements

• Java Runtime Environment (JRE)
• MQTT broker/server setup
• (Optional) Arduino or Python environment for advanced gameplay features

Installation

1. Clone or download this repository to your local machine.
2. Navigate to the directory containing the game files.
3. Compile and run the Java files.
4. Ensure that the MQTT broker is correctly configured and running if playing in multiplayer mode.

Contributing

Contributions to the project are welcome! Feel free to fork the repository, make changes, and submit pull requests. We appreciate any feedback or improvements you can provide.

License

This project is open-source and available under MIT License.

Acknowledgments

Special thanks to all contributors and players who have tested and improved this game.

Enjoy the game and may the best player win!