{"id":27992087,"url":"https://github.com/eggplant203/kahyeet","last_synced_at":"2025-05-08T17:57:08.140Z","repository":{"id":262971579,"uuid":"888940441","full_name":"Eggplant203/Kahyeet","owner":"Eggplant203","description":"Kahyeet! - A desktop multiplayer quiz game inspired by Kahoot, built with Java, featuring a server-client architecture, real-time interactions, and customizable gameplay.","archived":false,"fork":false,"pushed_at":"2025-01-04T02:39:17.000Z","size":13280,"stargazers_count":0,"open_issues_count":0,"forks_count":1,"subscribers_count":1,"default_branch":"master","last_synced_at":"2025-05-08T17:57:02.787Z","etag":null,"topics":["client-server","desktop-application","java","kahoot","kahyeet","multiplayer-game","quiz-game","socket-programming"],"latest_commit_sha":null,"homepage":"","language":"Java","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/Eggplant203.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-11-15T09:49:53.000Z","updated_at":"2025-01-04T02:39:20.000Z","dependencies_parsed_at":null,"dependency_job_id":"38465983-de34-496e-a29f-4ffd09e212bb","html_url":"https://github.com/Eggplant203/Kahyeet","commit_stats":null,"previous_names":["eggplant203/kahyeet"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eggplant203%2FKahyeet","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eggplant203%2FKahyeet/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eggplant203%2FKahyeet/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Eggplant203%2FKahyeet/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Eggplant203","download_url":"https://codeload.github.com/Eggplant203/Kahyeet/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":253124196,"owners_count":21857611,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["client-server","desktop-application","java","kahoot","kahyeet","multiplayer-game","quiz-game","socket-programming"],"created_at":"2025-05-08T17:57:07.683Z","updated_at":"2025-05-08T17:57:08.130Z","avatar_url":"https://github.com/Eggplant203.png","language":"Java","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Kahyeet Multiplayer Quiz Game\n\nKahyeet 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`.\n\n## Project Structure\n\n```\nKahyeet_Project\n├── App\n│   ├── Client\n│   │   ├── Kahyeet.exe                # Client executable\n│   │   └── Sound                      # Contains sound files for client\n│   └── Server\n│       ├── Kahyeet_Server.exe         # Server executable\n│       ├── scores.txt                 # Stores players' scores\n│       └── questions.txt              # Stores quiz questions and answers\n├── Code\n│   ├── Client\n│   │   ├── Client.java\n│   │   ├── GameUI.java\n│   │   ├── LeaderUI.java\n│   │   ├── LoginUI.java               # Main entry point for client\n│   │   ├── Question.java\n│   │   ├── Sound.java\n│   │   ├── WaitUI.java\n│   │   ├── Kahyeet.jar\n│   │   ├── bin                        # Compiled classes\n│   │   └── Sound                      # Contains sound files for client\n│   └── Server\n│       ├── ClientHandler.java\n│       ├── LeaderServer.java\n│       ├── Player.java\n│       ├── Server.java                # Main entry point for server\n│       ├── Kahyeet_Server.jar\n│       ├── scores.txt\n│       ├── questions.txt\n│       └── bin                        # Compiled classes\n└── Pic\n    ├── KickPlayer_UI.png\n    ├── Leaderboard.png\n    ├── Player_Login.png\n    ├── Question_UI.png\n    ├── Server_Management.png\n    └── Waiting_Room.png\n```\n\n## Project Files\n\n- **App Folder**: Contains the compiled executables (`Kahyeet.exe` for the client and `Kahyeet_Server.exe` for the server) for immediate execution.\n- **Code Folder**: Contains source code files and compiled classes for both the client and server.\n- **Pic Folder**: Contains images for documentation.\n\n## Setup Instructions\n\nTo run the Java, JAR, and EXE files, ensure you have the following set up:\n1. **Install Java Development Kit (JDK)**:\n   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.\n2. **Download** and extract the project in a directory without spaces or special characters.\n3. **Run Application**:\n   - Use the `.exe` files in the `App` folder to launch the server and client applications directly.\n   - 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.\n4. **LAN-Only Gameplay**:\n   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.\n   Download it here: [Radmin VPN](https://www.radmin-vpn.com/)\n\n## Usage\n\n- **Launch Server**:\n   - Run `Kahyeet_Server.exe` in `App/Server` or `Kahyeet_Server.jar` in `Code/Server`.\n   - Server manages player connections, tracks scores, and handles game settings.\n   - The `scores.txt` file records players' scores, while `questions.txt` holds the quiz content.\n   \n- **Launch Client**:\n   - Run `Kahyeet.exe` in `App/Client` or `Kahyeet.jar` in `Code/Client`.\n   - Use the `LoginUI` to log in with a unique username and join the game.\n\n### Question Format\n\nQuestions in `questions.txt` should follow this format:\n\n```\nQuestion 1\nAnswer 1\nAnswer 2\nAnswer 3\nAnswer 4_@#\n\nQuestion 2\nAnswer 1\nAnswer 2\nAnswer 3_@#\nAnswer 4\n\n...\n```\n\nThe correct answer for each question is marked with `_@#` after the answer text.\n\n## Screenshots\n\n### Interface Overview\n\n\u003ctable\u003e\n  \u003ctr\u003e\n    \u003cth style=\"text-align:center;\"\u003eLogin Screen\u003c/th\u003e\n    \u003cth style=\"text-align:center;\"\u003eWaiting Room\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd style=\"text-align:center;\"\u003e\n      \u003cimg src=\"KAHYEET/Pic/Player_Login.png\" alt=\"Login Screen\" width=\"400\" /\u003e\n    \u003c/td\u003e\n    \u003ctd style=\"text-align:center;\"\u003e\n      \u003cimg src=\"KAHYEET/Pic/Waiting_Room.png\" alt=\"Waiting Room\" width=\"400\" /\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003cth style=\"text-align:center;\"\u003eServer Management\u003c/th\u003e\n    \u003cth style=\"text-align:center;\"\u003eKick Player Screen\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd style=\"text-align:center;\"\u003e\n      \u003cimg src=\"KAHYEET/Pic/Server_Management.png\" alt=\"Server Management\" width=\"400\" /\u003e\n    \u003c/td\u003e\n    \u003ctd style=\"text-align:center;\"\u003e\n      \u003cimg src=\"KAHYEET/Pic/KickPlayer_UI.png\" alt=\"Kick Player Screen\" width=\"400\" /\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003cth style=\"text-align:center;\"\u003eGame Screen\u003c/th\u003e\n    \u003cth style=\"text-align:center;\"\u003eLeaderboard\u003c/th\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd style=\"text-align:center;\"\u003e\n      \u003cimg src=\"KAHYEET/Pic/Question_UI.png\" alt=\"Game Screen\" width=\"400\" /\u003e\n    \u003c/td\u003e\n    \u003ctd style=\"text-align:center;\"\u003e\n      \u003cimg src=\"KAHYEET/Pic/Leaderboard.png\" alt=\"Leaderboard\" width=\"400\" /\u003e\n    \u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## Notes\n\n- The server logs player scores to `scores.txt` in the `App/Server` or `Code/Server` directory.\n- Disconnected players are marked in the leaderboard and excluded from score saving if kicked.\n- The `Sound` folder contains audio files used for background music and effects during gameplay.\n\nFeel free to customize this project as needed for your learning or development purposes!\n\nMADE BY EGGPLANT203🍆 WITH LOVE \u003c3","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feggplant203%2Fkahyeet","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Feggplant203%2Fkahyeet","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Feggplant203%2Fkahyeet/lists"}