Chat Games

# ChatGames A Minecraft plugin that adds interactive chat-based minigames to engage your server's players with trivia, math challenges, word scrambles, and reaction games. ## Why use ChatGames? - Instant, lightweight chat minigames that keep your chat active. - Multi-platform: same core works across Spigot, Paper, Folia, and Sponge via a platform abstraction layer. - Fully configurable games, schedules, messages and reward commands. - Small, well-documented, and easy to extend. ## Features - **Multiple Game Types:** - **Trivia** - Answer trivia questions correctly - **Math** - Solve math problems - **Unscramble** - Unscramble words - **Multiple Choice** - Pick the correct answer from several options - **Reaction** - Respond quickly - **Automatic Game Scheduling** - Games start automatically at configurable intervals - **Customizable Rewards** - Configure commands to run when players win (economy rewards, items, etc.) ## Quick Install 1. Drop the plugin `.jar` into your server's `plugins/` folder. 2. Start the server once to generate default configurations. 3. Edit `config.yml`, `en-us.yml`, and the individual game files. ## Configuration ### Main Configuration <details> <summary>config.yml</summary> ```yml # ChatGames Configuration # https://github.com/RareHyperIon/ChatGames # Available: en-us language: en-us # Interval between automatic games (in seconds) game-interval: 300 # Minimum players online to start automatic games minimum-players: 1 # Whether to automatically start games at intervals automatic-games: true # Cooldown after wrong answer in multiple choice (in ticks, 20 ticks = 1 second) answer-cooldown-ticks: 60 # Enable debug logging debug: false ``` </details> <details> <summary>language/en-us.yml</summary> ```yml # ChatGames Language File - English (US) # Message shown when a player tries to use a command they don't have access to permission: "<red>You don't have permission to use this command.</red>" # Message shown when ChatGames has been successfully reloaded reload: "<green>Successfully reloaded ChatGames!</green>" # Cooldown message when player tries to answer too quickly after wrong answer cooldown: "<red>You cannot answer this question as you've already tried recently.</red>" ``` </details> ### Game Configuration <details> <summary>games/math.yml</summary> ```yml name: math display-name: "<gold>Math Wizard</gold>" timeout: 60 # The time players have to win the game. (in seconds) reward-commands: - "give {player} diamond {rand:1-3}" messages: start: | <gold><bold>MATH WIZARD</bold></gold> <gray>Solve the equation below!</gray> {question} win: | <green><bold>✓</bold> <yellow>{player}</yellow> solved it!</green> <gray>Answer: <white>{answer}</white></gray> timeout: | <red><bold>✗</bold> Time's up!</red> <gray>Answer: <white>{answer}</white></gray> questions: - - - - - - - - ``` </details> <details> <summary>games/multiple-choice.yml</summary> ```yml name: multiple choice display-name: "<green>Multiple Choice</green>" timeout: 45 # The time players have to win the game. (in seconds) cooldown: 60 # Ticks to wait after wrong answer (60 ticks = 3 seconds) reward-commands: - "give {player} emerald {rand:1-3}" messages: start: | <green><bold>MULTIPLE CHOICE</bold></green> <gray>Type the correct letter!</gray> {question} win: | <green><bold>✓</bold> <yellow>{player}</yellow> chose correctly!</green> <gray>Answer: <white>{answer}</white></gray> timeout: | <red><bold>✗</bold> Nobody answered!</red> <gray>Correct: <white>{answer}</white></gray> questions: q1: question: "<yellow>What is the largest planet in our solar system?</yellow>" answers: - "A. Earth" - "B. Jupiter" - "C. Saturn" - "D. Mars" correct-answer: "B" q2: question: "<yellow>Which programming language is Minecraft written in?</yellow>" answers: - "A. Python" - "B. C++" - "C. Java" - "D. JavaScript" correct-answer: "C" q3: question: "<yellow>What is 2 + 2 × 2?</yellow>" answers: - "A. 6" - "B. 8" - "C. 4" - "D. 10" correct-answer: "A" q4: question: "<yellow>Which mob drops blaze rods?</yellow>" answers: - "A. Ghast" - "B. Blaze" - "C. Wither Skel