https://github.com/h-yzeng/retro-minigames
Retro-Minigames is a Java desktop app featuring classic games like Tic-Tac-Toe, Snake, and Pong. It includes user authentication, profile management, and game statistics using MySQL and BCrypt.
https://github.com/h-yzeng/retro-minigames
database database-schema game-development java login-system mysql sql ui-design user-interface
Last synced: 3 months ago
JSON representation
Retro-Minigames is a Java desktop app featuring classic games like Tic-Tac-Toe, Snake, and Pong. It includes user authentication, profile management, and game statistics using MySQL and BCrypt.
- Host: GitHub
- URL: https://github.com/h-yzeng/retro-minigames
- Owner: h-yzeng
- License: mit
- Created: 2024-09-02T04:17:22.000Z (almost 2 years ago)
- Default Branch: master
- Last Pushed: 2024-09-16T03:55:32.000Z (almost 2 years ago)
- Last Synced: 2025-07-13T13:41:45.447Z (12 months ago)
- Topics: database, database-schema, game-development, java, login-system, mysql, sql, ui-design, user-interface
- Language: Java
- Homepage:
- Size: 5.94 MB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
🎮 Retro-Minigames
This project is a collection of retro-styled games built using **Java**. The project also includes a **login system** backed by a MySQL database to store user credentials, high scores, and game statistics. The project is a personal project created to demonstrate Java Proficiency.
## Games Included:
- **Snake** 🐍: A classic arcade game where players control a snake and aim to grow longer without colliding with walls or itself.
- **Pong** 🏓: A two-player table tennis game featuring paddles and a ball. First player to reach 10 points wins!
- **Tic-Tac-Toe** ❌⭕: A two-player strategy game where players alternate placing Xs and Os on a 3x3 grid to win.
## Features:
- **User Authentication**: Users can register, log in, and have their personal data stored securely with hashed passwords.
- **Detailed Game Statistics**: Each player’s high scores and detailed game statistics are tracked and displayed in their profile:
- **Snake**: High score, total apples eaten, games played.
- **Pong**: Total points, games played, games won.
- **Tic-Tac-Toe**: Games played, games won, games drawn.
- **Responsive UI**: Easy-to-use graphical user interface (GUI) built with **Swing**.
## Recent Updates:
- Added **detailed game statistics**: tracks draws in Tic-Tac-Toe, total points in Pong, and more.
- **Sound system integration**: added sound effects for key game events such as scoring, winning, and hitting paddles.
- Added **replay dialogs** for each game that allow players to easily restart or exit after finishing a game.
- Updated `UserProfileScreen` to display detailed game statistics.
- Improved **backend data flow** for user and game management.
## Getting Started
### Prerequisites:
- **Java JDK 8** or higher
- **Eclipse IDE**, **IntelliJ IDEA**, or any Java-supporting IDE
- **Git** for version control
- **MySQL** or any other relational database for data storage
## Libraries Used
- **jbcrypt**: For secure password hashing.
- **mysql-connector**: To connect the project to MySQL.
## Setting Up the Project
1. **Clone the Repository**:
```bash
git clone https://github.com/h-yzeng/retro-games.git
cd retro-games
2. **Database Setup**:
- Make sure you have **MySQL** installed and running.
- Import the SQL script located in `/db/create_tables.sql` to set up the required database schema:
```bash
mysql -u your-username -p retro_games_db < db/create_tables.sql
3. **Configure Database**:
- Update the `DatabaseManager.java` file with your MySQL credentials (username, password, database name).
4. **Compile and Run**:
- Open the project in **Eclipse IDE** or your preferred Java IDE.
- Compile the Java files, ensuring the necessary libraries (`jbcrypt` and `mysql-connector`) are in the classpath.
- Run the `LoginScreen` class as the main entry point to the application.
## How to Play
### Snake:
- Use **WASD** keys to control the snake's movement.
- Collect apples to grow longer. Don’t hit the walls or yourself!
- **Tracked stats**: High score, total apples eaten, games played.
### Pong:
- **W** and **S** keys for Player 1 (left paddle).
- **Up** and **Down** arrow keys for Player 2 (right paddle).
- First to 10 points wins.
- **Tracked stats**: Games played, games won, total points.
### Tic-Tac-Toe:
- Click on the empty grid to place your symbol (X or O).
- Get three in a row to win. A line highlights the winning combination.
- **Tracked stats**: Games played, games won, games drawn.
## Screenshots
### Login Screen and Main Menu
### User Profile with Game Stats
### Gameplay Screenshots: Snake, Pong, and Tic-Tac-Toe
## Authors
- **Henry Zeng** - [h-yzeng](https://github.com/h-yzeng)
## License
This project is licensed under the MIT License - see the [LICENSE](https://github.com/h-yzeng/Retro-Minigames/blob/master/LICENSE) file for details.
## Future Improvements
- Unknown.
