hChatGame
Automated Chat Games for Minecraft Servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
hChatGame is an automated chat games plugin for Minecraft servers.
Automated Chat Games for Minecraft Servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Create interactive chat events where players solve math examples, answer custom questions or guess a random number. The winner can receive rewards through configurable actions, including messages, broadcasts, console commands, sounds, titles, action bars, boss bars, particles and effects.
The plugin is useful for servers that want more chat activity, automatic mini-events, reward-based engagement and quick interactive events without arenas or manual staff control.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Features
Three game types
hChatGame includes three built-in chat game modes:
- Math examples
- Custom questions
- Guess-the-number games
────────────────────────────────────────
Math games
The math game generates a random example based on your configuration.
You can configure:
- Minimum number
- Maximum number
- Amount of numbers in the example
- Addition
- Subtraction
- Multiplication
- Division
Code (Text):
games:
math:
enable: true
minInt: 10
maxInt: 75
int: 2
division: false
multiplication: false
addition: true
subtraction: true
math:
enable: true
minInt: 10
maxInt: 75
int: 2
division: false
multiplication: false
addition: true
subtraction: true
────────────────────────────────────────
Question games
The asks game uses custom questions from the configuration.
Each question can have one or multiple accepted answers. Multiple answers are separated with :.
Example:
Code (Text):
games:
asks:
enable: true
ask_1:
ask: "How much health does a default player have?"
answer: "20"
ask_2:
ask: "What command opens the menu?"
answer: "/menu:/m"
asks:
enable: true
ask_1:
ask: "How much health does a default player have?"
answer: "20"
ask_2:
ask: "What command opens the menu?"
answer: "/menu:/m"
────────────────────────────────────────
Guess games
The guess game chooses a random number from a configured range.
Example:
Code (Text):
games:
guess:
enable: true
name: "Guess the number"
minInt: 0
maxInt: 25
guess:
enable: true
name: "Guess the number"
minInt: 0
maxInt: 25
────────────────────────────────────────
Automatic game cycle
Games can start automatically after a configured interval.
Code (Text):
settings:
timeForNext: 300
timeForNext: 300
You can also choose whether the plugin should select games randomly or cycle through enabled game types in order.
Code (Text):
settings:
randomGame: true
randomGame: true
────────────────────────────────────────
Manual start
Administrators can manually start the next selected game:
Code (Text):
/hchatgame start
────────────────────────────────────────
Global chat support
Each game type can require answers to be sent through a global chat prefix.
Example:
Code (Text):
games:
asks:
global:
chat:
enable: true
symbol: "!"
asks:
global:
chat:
enable: true
symbol: "!"
Example:
Code (Text):
!20
────────────────────────────────────────
Anti-spam protection
The guess game includes cooldown protection for repeated correct attempts.
Code (Text):
settings:
guessCooldown: 1250
guessCooldown: 1250
────────────────────────────────────────
Flexible action system
hChatGame uses a flexible action system for game starts, wins, permission errors, admin messages and anti-spam responses.
Action sections include:
Code (Text):
actions.startMathGame
actions.endMathGame
actions.startAsksGame
actions.endAsksGame
actions.startGuessGame
actions.endGuessGame
actions.noPermsSolved
actions.antiSpamGuessGame
actions.globalChatRequired
actions.noAdminPerms
actions.adminCommandHelp
actions.configReloaded
actions.gameState
actions.endMathGame
actions.startAsksGame
actions.endAsksGame
actions.startGuessGame
actions.endGuessGame
actions.noPermsSolved
actions.antiSpamGuessGame
actions.globalChatRequired
actions.noAdminPerms
actions.adminCommandHelp
actions.configReloaded
actions.gameState
Code (Text):
actions:
startMathGame:
- "[Broadcast] &6Chat game started!"
- "[Broadcast] &fSolve: &e{mathProblem}"
endMathGame:
- "[Sound] ENTITY_EXPERIENCE_ORB_PICKUP:0.5:1.0"
- "[Broadcast] &e{player} &fwon the chat game!"
- "[Console] eco give {player} 1000"
startMathGame:
- "[Broadcast] &6Chat game started!"
- "[Broadcast] &fSolve: &e{mathProblem}"
endMathGame:
- "[Sound] ENTITY_EXPERIENCE_ORB_PICKUP:0.5:1.0"
- "[Broadcast] &e{player} &fwon the chat game!"
- "[Console] eco give {player} 1000"
────────────────────────────────────────
Supported action types
Code (Text):
[Message]
[Broadcast]
[Console]
[Player]
[Sound]
[Title]
[ActionBar]
[BossBar]
[Particle]
[Effect]
[Broadcast]
[Console]
[Player]
[Sound]
[Title]
[ActionBar]
[BossBar]
[Particle]
[Effect]
────────────────────────────────────────
Text components
Messages support classic color codes and hex colors.
Code (Text):
&6Gold text
&#FB9C08Hex text
&#FB9C08Hex text
Example:
Code (Text):
[HoverText:cmd /hchatgame state, text: &fClick to view game state]
Code (Text):
cmd
suggest
url
suggest
url
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Commands
Code (Text):
/hchatgame
/hchatgame reload
/hchatgame start
/hchatgame state
/hchatgame reload
/hchatgame start
/hchatgame state
Code (Text):
/hchatgame - shows the admin help menu
/hchatgame reload - reloads the plugin configuration
/hchatgame start - starts the next selected game
/hchatgame state - shows the current game state
/hchatgame reload - reloads the plugin configuration
/hchatgame start - starts the next selected game
/hchatgame state - shows the current game state
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Permissions
Code (Text):
hchatgame.admin - access to admin commands
hchatgame.solved - allows a player to win chat games
hchatgame.solved - allows a player to win chat games
Important: give hchatgame.solved to players or groups that should be able to win games and receive rewards.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
PlaceholderAPI
hChatGame requires PlaceholderAPI and registers its own placeholders.
Identifier:
Code (Text):
hchatgame
Code (Text):
%hchatgame_winnerPlayerName%
%hchatgame_currentAnswer%
%hchatgame_currentQuestion%
%hchatgame_currentGameIndex%
%hchatgame_gameActive%
%hchatgame_currentGame%
%hchatgame_timeForNext%
%hchatgame_currentAnswer%
%hchatgame_currentQuestion%
%hchatgame_currentGameIndex%
%hchatgame_gameActive%
%hchatgame_currentGame%
%hchatgame_timeForNext%
────────────────────────────────────────
Internal placeholders
These placeholders can be used inside plugin actions:
Code (Text):
{player}
{mathProblem}
{ask}
{guessMin}
{guessMax}
{globalSymbol}
{answer}
{mathProblem}
{ask}
{guessMin}
{guessMax}
{globalSymbol}
{answer}
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Requirements
- Java 16 or newer
- Spigot, Paper or Purpur 1.16+
- PlaceholderAPI
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Installation
- Install PlaceholderAPI.
- Place hChatGame.jar into your server's plugins folder.
- Restart the server.
- Open plugins/hChatGame/config.yml.
- Configure game types, interval, rewards and messages.
- Give players the permission hchatgame.solved.
- Reload the plugin or restart the server.
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Configuration
Main configuration file:
Code (Text):
plugins/hChatGame/config.yml
- Game interval
- Random or ordered game selection
- Math game settings
- Custom question list
- Guess game range
- Global chat requirement
- Anti-spam cooldown
- Action messages
- Rewards
- Sound defaults
- Title defaults
- Boss bar defaults
- Particle defaults
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━
Use Cases
- Automatic chat events
- Reward quizzes
- Math competitions
- Server knowledge questions
- Guess-the-number events
- Community activity boosts
- Daily reward events
- Staff-hosted chat contests
- Scoreboard and TAB status displays
Quick facts
- Edition: Minecraft Java
- File type: .jar
- Minecraft versions listed: 1.16, 1.17, 1.18
- How to install: Install the matching mod loader (Forge, Fabric or NeoForge) for your Minecraft version. → Download the .jar. → Put it in the .minecraft/mods folder and launch that loader profile.
- Where to get it: Opens on Spigot — not every file is mirrored on our own servers.
Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.
⭐ hChatGame ⭐ [1.16.X-26.X] | PAPI and more support! is a free Minecraft Java mod. Compatible with Minecraft 1.16, 1.17, 1.18, 1.19 and newer. Downloaded 352 times (via Spigot). Download it and open it directly in the game.