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.

Features

• Multiple Game Types:

  • Trivia - Answer trivia questions correctly
  • Math - Solve math problems
  • Unscramble - Unscramble words
  • Reaction - Click buttons quickly (with customizable variants)

• Automatic Game Scheduling - Games start automatically at configurable intervals

• Customizable Rewards - Configure commands to run when players win (economy rewards, items, etc.)

• Fully Configurable - Customize questions, timeouts, rewards, and messages

• PlaceholderAPI Support - Use placeholders in messages

• Multi-language Support - Customize all messages in language.yml

Requirements

• Minecraft Server: Paper/Spigot 1.16+
• Optional Dependencies:
  • VaultUnlocked (or Vault) - For economy rewards
  • PlaceholderAPI - For placeholder support

Games

ChatGames includes four game types by default:

• Trivia: Players answer trivia questions.
• Math: Players solve math problems.
• Unscramble: Players unscramble a given word.
• Reaction: Players must click a message in chat as fast as possible.

Examples

Configuration

Main Config (config.yml)

# Game control settings
min-players: 1          # Minimum players online to start games
game-interval: 300      # Seconds between games (300 = 5 minutes)
logging: "FULL"         # Log level: FULL, PARTIAL, NONE

Game Configuration

Each game has its own config file in plugins/ChatGames/games/:

• trivia.yml - Trivia questions and answers
• math.yml - Math problems
• unscramble.yml - Words to scramble
• reaction.yml - Clickable button variants

Example game config structure:

name: "Math"
descriptor: "solve"
timeout: 30

reward-commands:
  - eco give %player% 250
  - give %player% diamond 1

questions:
  - ["What is 1+4", "5"]
  - ["What is 10 + 12", "22"]

Placeholders in rewards:

• %player% - Winner's username
• {player} - Winner's username (alternative format)

Language Configuration (language.yml)

Customize all plugin messages. Available placeholders:

• {prefix} - Plugin prefix
• {player} - Player name
• {name} - Game name
• {descriptor} - Game descriptor (e.g., "solve", "unscramble")
• {question} - The question/challenge
• {answer} - The correct answer
• {timeout} - Timeout in seconds
• \n - New line

Commands

The main command is /chatgames with aliases /chatgame and /cg.

Command	Permission	Description
/cg reload	chatgames.reload	Reload all configurations
/cg start <game>	chatgames.start	Manually start a game
/cg stop	chatgames.stop	Stop the current game
/cg list	chatgames.list	List all available games
/cg info	chatgames.info	Show plugin information
/cg toggle	chatgames.toggle	Toggle automatic games on or off

Permissions

Permission	Description
chatgames.reload	Allows reloading the plugin
chatgames.start	Allows manually starting a game
chatgames.stop	Allows stopping the current game
chatgames.list	Allows listing all available games
chatgames.info	Allows viewing plugin information
chatgames.toggle	Allows toggling automatic games

Setting Up Rewards

With VaultUnlocked (or Vault)

reward-commands:
  - eco give %player% 250

With Items

reward-commands:
  - give %player% diamond 5
  - give %player% emerald 10

Multiple Commands

You can run multiple commands per win:

reward-commands:
  - eco give %player% 500
  - give %player% golden_apple 3
  - lp user %player% permission set special.perk true

Adding Custom Questions

Trivia Game

Edit games/trivia.yml:

questions:
  - ["What is the capital of France?", "Paris"]
  - ["What year did WW2 end?", "1945"]

Math Game

Edit games/math.yml:

questions:
  - ["What is 15 + 27?", "42"]
  - ["If x + 5 = 12, what is x?", "7"]

Unscramble Game

Edit games/unscramble.yml:

words:
  - "minecraft"
  - "diamond"
  - "adventure"

Reaction Game

Edit games/reaction.yml:

The Reaction game supports multiple variants - each with its own clickable button text. Players compete to click the correct button!

variants:
  # Simple click game - click anywhere to win
  - name: "Click Game"
    challenge: "&a&lClick Me!"
    answer: ""

  # Button challenge - players must click the correct button
  - name: "Color Game"
    challenge: "&c[Red] &a[Green] &d[Purple] &7- Click the &aGreen &7button"
    answer: "[Green]"

  - name: "Number Game"
    challenge: "&e[1] &e[2] &e[3] &e[4] &e[5] &7- Click number &e3"
    answer: "[3]"

  - name: "Direction"
    challenge: "&f[North] &f[South] &f[East] &f[West] &7- Click &fNorth"
    answer: "[North]"

Variant fields:

• name - Display name for the variant type
• challenge - The text shown to players. Text in [brackets] becomes clickable buttons
• answer - The correct button to click (e.g., "[Green]"). Leave empty "" for games where any click wins

Creating button challenges:

• Put button text in [brackets] to make them clickable
• Use color codes before brackets to color the buttons (e.g., &c[Red])
• Set the answer field to the exact button text that should win (e.g., "[Green]")
• Players who click the wrong button will not win

When a Reaction game starts, the plugin randomly selects one variant. Add as many custom variants as you want!