AlmostKoi'sChatGames

# AlmostKoi's Chat Games AlmostKoi's Chat Games is a simple Minecraft plugin designed to make server chat more active by running quick, competitive reaction games. Every few minutes, a game will start in chat, and the first player to type the correct answer wins a reward. The plugin supports multi-threaded server environments like Folia, handles chat inputs asynchronously to avoid lag, and lets players who find it annoying toggle it off. ## Game Modes There are nine different game modes included: - **Unscramble**: A word from the library is scrambled, and players have to figure out what it is. - **Solve**: A simple math equation is generated, and players must solve it. - **Type**: A speed typing game where players must type a specific word. - **Type Random**: A case-sensitive captcha test using a random string of characters. - **Trivia**: Questions loaded from a trivia file. You can configure multiple correct answers. - **Fill in the Blanks**: A word is shown with missing letters, and players must complete it. - **Word Unshuffle**: Shuffled words of a phrase must be put back in the right order. - **Reverse Word Unshuffle**: The spelling and word order of a phrase are reversed. - **Unreverse**: A word is printed backwards, and players have to type it forward. ## Commands and Permissions ### General Commands - `/acg toggle` - Turn chat games visibility on or off for yourself. (Permission: `chatgames.toggle`, defaults to true) ### Admin Commands All admin commands require the `chatgames.admin` permission (defaults to OP). - `/acg forcestart ` - Starts a specific game. If you do not specify a game type, a random one will start. - `/acg reload` - Reloads all configuration files, language options, and libraries. - `/acg info` - Shows current statistics, including library sizes. Other permissions: - `chatgames.see` - Required to see and participate in games if `use-game-permissions` is set to true in the config (defaults to true). ## Placeholders (PlaceholderAPI) You can use these placeholders to display stats in scoreboards, tablists, or chat formats: - `%almostkoischatgames_wins%` - The player's total chat game wins. - `%almostkoischatgames_server_total_wins%` - Total number of games won across the entire server. - `%almostkoischatgames_is_toggled%` - Shows if the player has games visible (true/false). - `%almostkoischatgames_lb_topname_N%` - The name of the player at rank N on the leaderboard. - `%almostkoischatgames_lb_topwins_N%` - The number of wins for the player at rank N on the leaderboard. ## Configuration You can customize almost everything in the config files: - **config.yml**: Change game intervals, lifetime, case-sensitivity, active game modes, and sound effects. - **rewards.yml**: Define what happens when a player wins. You can send private messages, run console or player commands, reward vault economy money, or broadcast a message only to players who have games enabled. - **lang.yml**: Change any message shown to players. Hex/RGB color codes are supported. - **game-library.yml** and **trivia-library.yml**: The files where you add your own words, phrases, and trivia questions.