https://github.com/eggplant203/kahyeet
Kahyeet! - A desktop multiplayer quiz game inspired by Kahoot, built with Java, featuring a server-client architecture, real-time interactions, and customizable gameplay.
https://github.com/eggplant203/kahyeet
client-server desktop-application java kahoot kahyeet multiplayer-game quiz-game socket-programming
Last synced: 5 months ago
JSON representation
Kahyeet! - A desktop multiplayer quiz game inspired by Kahoot, built with Java, featuring a server-client architecture, real-time interactions, and customizable gameplay.
- Host: GitHub
- URL: https://github.com/eggplant203/kahyeet
- Owner: Eggplant203
- Created: 2024-11-15T09:49:53.000Z (11 months ago)
- Default Branch: master
- Last Pushed: 2025-01-04T02:39:17.000Z (10 months ago)
- Last Synced: 2025-05-08T17:57:02.787Z (5 months ago)
- Topics: client-server, desktop-application, java, kahoot, kahyeet, multiplayer-game, quiz-game, socket-programming
- Language: Java
- Homepage:
- Size: 12.7 MB
- Stars: 0
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Kahyeet Multiplayer Quiz Game
Kahyeet is a multiplayer quiz game inspired by Kahoot. This project consists of two main components - Client and Server, both of which support multiple user interactions and real-time updates. This project directory includes three primary folders: `App`, `Code`, and `Pic`.
## Project Structure
```
Kahyeet_Project
├── App
│ ├── Client
│ │ ├── Kahyeet.exe # Client executable
│ │ └── Sound # Contains sound files for client
│ └── Server
│ ├── Kahyeet_Server.exe # Server executable
│ ├── scores.txt # Stores players' scores
│ └── questions.txt # Stores quiz questions and answers
├── Code
│ ├── Client
│ │ ├── Client.java
│ │ ├── GameUI.java
│ │ ├── LeaderUI.java
│ │ ├── LoginUI.java # Main entry point for client
│ │ ├── Question.java
│ │ ├── Sound.java
│ │ ├── WaitUI.java
│ │ ├── Kahyeet.jar
│ │ ├── bin # Compiled classes
│ │ └── Sound # Contains sound files for client
│ └── Server
│ ├── ClientHandler.java
│ ├── LeaderServer.java
│ ├── Player.java
│ ├── Server.java # Main entry point for server
│ ├── Kahyeet_Server.jar
│ ├── scores.txt
│ ├── questions.txt
│ └── bin # Compiled classes
└── Pic
├── KickPlayer_UI.png
├── Leaderboard.png
├── Player_Login.png
├── Question_UI.png
├── Server_Management.png
└── Waiting_Room.png
```
## Project Files
- **App Folder**: Contains the compiled executables (`Kahyeet.exe` for the client and `Kahyeet_Server.exe` for the server) for immediate execution.
- **Code Folder**: Contains source code files and compiled classes for both the client and server.
- **Pic Folder**: Contains images for documentation.
## Setup Instructions
To run the Java, JAR, and EXE files, ensure you have the following set up:
1. **Install Java Development Kit (JDK)**:
Download and install the [JDK Development Kit](https://www.oracle.com/java/technologies/downloads/), and set up the environment variables properly for Java to function.
2. **Download** and extract the project in a directory without spaces or special characters.
3. **Run Application**:
- Use the `.exe` files in the `App` folder to launch the server and client applications directly.
- For Java developers, you can also use `Kahyeet.jar` and `Kahyeet_Server.jar` in the `Code` folder for running the app in a Java environment.
4. **LAN-Only Gameplay**:
The application is designed to work on a Local Area Network (LAN). However, if you want to connect players over the internet, it is recommended to use **Radmin VPN** to simulate a LAN environment.
Download it here: [Radmin VPN](https://www.radmin-vpn.com/)
## Usage
- **Launch Server**:
- Run `Kahyeet_Server.exe` in `App/Server` or `Kahyeet_Server.jar` in `Code/Server`.
- Server manages player connections, tracks scores, and handles game settings.
- The `scores.txt` file records players' scores, while `questions.txt` holds the quiz content.
- **Launch Client**:
- Run `Kahyeet.exe` in `App/Client` or `Kahyeet.jar` in `Code/Client`.
- Use the `LoginUI` to log in with a unique username and join the game.
### Question Format
Questions in `questions.txt` should follow this format:
```
Question 1
Answer 1
Answer 2
Answer 3
Answer 4_@#
Question 2
Answer 1
Answer 2
Answer 3_@#
Answer 4
...
```
The correct answer for each question is marked with `_@#` after the answer text.
## Screenshots
### Interface Overview
Login Screen
Waiting Room
Server Management
Kick Player Screen
Game Screen
Leaderboard
## Notes
- The server logs player scores to `scores.txt` in the `App/Server` or `Code/Server` directory.
- Disconnected players are marked in the leaderboard and excluded from score saving if kicked.
- The `Sound` folder contains audio files used for background music and effects during gameplay.
Feel free to customize this project as needed for your learning or development purposes!
MADE BY EGGPLANT203🍆 WITH LOVE <3