⭐ hChatGame ⭐ [1.16.X-26.X] | PAPI and more support!

⭐ hChatGame ⭐ [1.16.X-26.X] | PAPI and more support! -----

Add an interactive chat game to your server!

hChatGame
Automated Chat Games for Minecraft Servers
━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

hChatGame is an automated chat games plugin 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

Each game type can be enabled or disabled separately.

────────────────────────────────────────

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

Example:

Code (Text):

games:
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"

This mode is useful for server-related questions, tutorials, community events and reward quizzes.

────────────────────────────────────────

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

Players need to guess the correct number in chat. The plugin also includes anti-spam protection for repeated correct attempts.

────────────────────────────────────────

Automatic game cycle
Games can start automatically after a configured interval.

Code (Text):

settings:
timeForNext: 300

The value is specified in seconds.
You can also choose whether the plugin should select games randomly or cycle through enabled game types in order.

Code (Text):

settings:
randomGame: true

────────────────────────────────────────

Manual start
Administrators can manually start the next selected game:

Code (Text):

/hchatgame start

This is useful for staff-hosted events, streams, testing and community contests.

────────────────────────────────────────

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: "!"

If global chat is required, the answer must start with the configured symbol.
Example:

Code (Text):

!20

If a player sends the correct answer without the required symbol, the plugin can run a separate configurable action section.

────────────────────────────────────────

Anti-spam protection
The guess game includes cooldown protection for repeated correct attempts.

Code (Text):

settings:
guessCooldown: 1250

The value is specified in milliseconds.

────────────────────────────────────────

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

Example:

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"

────────────────────────────────────────

Supported action types

Code (Text):

[Message]
[Broadcast]
[Console]
[Player]
[Sound]
[Title]
[ActionBar]
[BossBar]
[Particle]
[Effect]

This allows you to create simple announcements or advanced reward flows without changing the plugin code.

────────────────────────────────────────

Text components
Messages support classic color codes and hex colors.

Code (Text):

&6Gold text
&#FB9C08Hex text

Messages can also include hover and click components.
Example:

Code (Text):

[HoverText:cmd /hchatgame state, text: &fClick to view game state]

Supported click modes:

Code (Text):

cmd
suggest
url

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Commands

Code (Text):

/hchatgame
/hchatgame reload
/hchatgame start
/hchatgame state

Command descriptions:

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

The command supports tab completion for admin subcommands.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Permissions

Code (Text):

hchatgame.admin - access to admin commands
hchatgame.solved - allows a player to win chat games

By default, both permissions are assigned to OP.
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

Available placeholders:

Code (Text):

%hchatgame_winnerPlayerName%
%hchatgame_currentAnswer%
%hchatgame_currentQuestion%
%hchatgame_currentGameIndex%
%hchatgame_gameActive%
%hchatgame_currentGame%
%hchatgame_timeForNext%

These placeholders can be used in scoreboards, TAB, menus, holograms and other plugins that support PlaceholderAPI.

────────────────────────────────────────

Internal placeholders
These placeholders can be used inside plugin actions:

Code (Text):

{player}
{mathProblem}
{ask}
{guessMin}
{guessMax}
{globalSymbol}
{answer}

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

Requirements

Java 16 or newer
Spigot, Paper or Purpur 1.16+
PlaceholderAPI

Paper or Purpur is recommended for the best experience with modern Adventure text components.

━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━

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

The config controls:

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

hChatGame can be used as a lightweight activity system or as a configurable reward event system for your server chat.

View on SpigotMC

Resource Information

Author:

----------

Total Downloads: 299

First Release: Mar 31, 2025

Last Update: May 10, 2026

Category: ---------------

All-Time Rating:

2 ratings

Find more info at t.me...

Version -----

Released: --------------------

Downloads: ------

Version Rating:

----------------------

-- ratings

Ask Questions / Get Support