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 [gametype] - 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.