ChatMiniGames
A fully configurable chat minigames plugin with 9 minigame modes
ChatMinigames is a high-performance, fully configurable chat minigames plugin for Unturned RocketMod.
It automatically broadcasts interactive chat games at scheduled intervals, testing players on trivia, quick math, unscrambling, typing speed, item IDs, and number guessing. The first player to answer wins configurable rewards including Uconomy money, Unturned experience, items, and console commands scaled by difficulty with optional speed bonuses.
Features
-
9 Built-in Minigame Types:
- Quick Math (
Math): Difficulty-scaled arithmetic (+,-,*,/, and two-step expressions like(14 * 8) + 25). - Word Unscramble (
Unscramble): Multi-word and single-word scrambler with word pools per difficulty. - Trivia Challenge (
Trivia): Curated trivia questions with support for multiple accepted answers and hints. - Reaction Test (
Reaction): Fast-typing challenge with random alphanumeric codes or custom roleplay/game phrases. - Reverse Word (
Reverse): Word backwards typing challenge. - Fill in the Blank (
FillInTheBlank): Masked words (e.g.M _ P _ E _ T _ I K E) with progressive hints that reveal additional letters. - Guess the Number (
GuessTheNumber): Interactive number guessing with real-time HIGHER / LOWER hints, dynamic range narrowing, and spam cooldowns. - Unturned Knowledge / Item ID Quiz (
UnturnedQuiz): Live serverItemAssetqueries (asking for item names by ID or IDs by item name) + custom Unturned lore questions. - Number Sequence (
Sequence): Pattern completion (arithmetic, geometric, increasing-gap, Fibonacci, and custom sequences).
- Quick Math (
-
Dual Answering Support:
- Players can submit answers directly in regular chat OR via the
/answer <response>command. - Option to suppress the winning message from normal chat so it doesn't clutter public discussion.
- Players can submit answers directly in regular chat OR via the
-
Clean Multi-File Configuration:
- Main settings, schedule, and rewards live in
ChatMinigames.configuration.xml. - Every minigame has its own clean, editable JSON file in
Plugins/ChatMinigames/Games/(Math.json,Trivia.json,Unscramble.json, etc.).
- Main settings, schedule, and rewards live in
-
Difficulty-Tiered Rewards (
Easy,Medium,Hard):- Uconomy Money: Min/max balance ranges with soft-dependency protection (works even if Uconomy is not installed).
- Unturned Experience: Configurable min/max EXP awards.
- Speed Bonus: Optional multiplier (e.g.,
1.5xmoney & EXP) if solved within a target time window. - Item Drops: Supports
WeightedRandom,RandomOne,All, orNonemodes with drop chances and min/max quantity stacks. - Console Commands: Execute reward commands with
{SteamID},{PlayerName},{Difficulty}, and{GameType}placeholders.
-
Automated Scheduling & Mid-Game Hints:
- Random interval timers between games (
MinIntervalSecondstoMaxIntervalSeconds). - Online player threshold requirement (
MinimumPlayersOnline). - Dynamic mid-game hints triggered at a configurable fraction of the game's duration.
- Random interval timers between games (
-
Player Statistics & Leaderboard:
- Asynchronously tracks total wins, wins by difficulty tier, fastest solve times, and total money/EXP earned.
- Stored cleanly in
Plugins/ChatMinigames/PlayerStats.json.
-
Full Rich Text Formatting:
- Unity rich text formatting (
<color>,<b>,<i>) supported everywhere in chat broadcasts, badges, and commands.
- Unity rich text formatting (
Commands
| Command | Aliases | Description | Default Allowed |
|---|---|---|---|
/answer <response> | /ans, /a | Submit an answer to the active chat minigame. | Players |
/chatgame current | /cg, /minigame | Display the active question or time until the next game. | Everyone |
/chatgame stats [player] | /cg stats | View win counts by difficulty, best solve time, and total earnings. | Everyone |
/chatgame top | /cg top, /cg lb | Display the server's Top 5 chat minigame winners. | Everyone |
/chatgame list | /cg list | List all 9 minigame types and their enabled/disabled status. | Everyone |
/chatgame start [type] [diff] | /cg start | Force-start a specific or random minigame and difficulty. | Admins |
/chatgame skip | /cg skip | Skip the active minigame and immediately start a new one. | Admins |
/chatgame stop | /cg stop, /cg cancel | Cancel the active minigame. | Admins |
/chatgame reload | /cg reload | Reload the main XML configuration, all Games/*.json files, and player stats. | Admins |
Permissions
| Permission | Description | Recommended Roles |
|---|---|---|
chatminigames.answer | Allows submitting answers via /answer. | default, vip |
chatminigames.chatgame | Allows running player-facing /chatgame commands (current, stats, top, list). | default, vip |
chatminigames.admin | Full administrative control to start, skip, cancel, or reload games. | admin |
Configuration Layout
1. Main Configuration (ChatMinigames.configuration.xml)
Controls server level scheduling, game toggles, and reward tiers:
<?xml version="1.0" encoding="utf-8"?>
<ChatMinigamesConfiguration xmlns:xsd="http://www.w3.org/2001/XMLSchema" xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance">
<Schedule>
<!-- Automatic game interval in seconds -->
<EnableAutoSchedule>true</EnableAutoSchedule>
<MinIntervalSeconds>180</MinIntervalSeconds>
<MaxIntervalSeconds>300</MaxIntervalSeconds>
<MinimumPlayersOnline>1</MinimumPlayersOnline>
<!-- Broadcast a hint halfway through the game duration -->
<EnableMidGameHints>true</EnableMidGameHints>
<HintTimeFraction>0.5</HintTimeFraction>
</Schedule>
<General>
<GamesConfigFolder>Games</GamesConfigFolder>
<AllowDirectChatAnswer>true</AllowDirectChatAnswer>
<AllowCommandAnswer>true</AllowCommandAnswer>
<SuppressWinningChatMessage>false</SuppressWinningChatMessage>
<ChatIconUrl>https://i.imgur.com/8Q9Z5Zm.png</ChatIconUrl>
<DefaultMessageColor>#FFCC00</DefaultMessageColor>
<StartSoundEffectId>0</StartSoundEffectId>
<WinSoundEffectId>0</WinSoundEffectId>
<EnableStatsTracking>true</EnableStatsTracking>
</General>
<!-- Enable, disable, or adjust selection weights for each game type -->
<GameTypes>
<Game GameType="Math" Enabled="true" ConfigFile="Math.json" SelectionWeight="120" DurationSeconds="40" CaseSensitive="false">
<DisplayName>Quick Math</DisplayName>
<EasyWeight>50</EasyWeight>
<MediumWeight>35</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
<Game GameType="Unscramble" Enabled="true" ConfigFile="Unscramble.json" SelectionWeight="110" DurationSeconds="45" CaseSensitive="false">
<DisplayName>Word Unscramble</DisplayName>
<EasyWeight>50</EasyWeight>
<MediumWeight>35</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
<Game GameType="Trivia" Enabled="true" ConfigFile="Trivia.json" SelectionWeight="100" DurationSeconds="45" CaseSensitive="false">
<DisplayName>Trivia Challenge</DisplayName>
<EasyWeight>45</EasyWeight>
<MediumWeight>40</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
<Game GameType="Reaction" Enabled="true" ConfigFile="Reaction.json" SelectionWeight="110" DurationSeconds="30" CaseSensitive="true">
<DisplayName>Reaction Test</DisplayName>
<EasyWeight>50</EasyWeight>
<MediumWeight>35</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
<Game GameType="Reverse" Enabled="true" ConfigFile="Reverse.json" SelectionWeight="90" DurationSeconds="40" CaseSensitive="false">
<DisplayName>Reverse Word</DisplayName>
<EasyWeight>50</EasyWeight>
<MediumWeight>35</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
<Game GameType="FillInTheBlank" Enabled="true" ConfigFile="FillInTheBlank.json" SelectionWeight="95" DurationSeconds="45" CaseSensitive="false">
<DisplayName>Fill in the Blank</DisplayName>
<EasyWeight>50</EasyWeight>
<MediumWeight>35</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
<Game GameType="GuessTheNumber" Enabled="true" ConfigFile="GuessTheNumber.json" SelectionWeight="85" DurationSeconds="60" CaseSensitive="false">
<DisplayName>Guess the Number</DisplayName>
<EasyWeight>50</EasyWeight>
<MediumWeight>35</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
<Game GameType="UnturnedQuiz" Enabled="true" ConfigFile="UnturnedQuiz.json" SelectionWeight="100" DurationSeconds="45" CaseSensitive="false">
<DisplayName>Unturned Knowledge</DisplayName>
<EasyWeight>45</EasyWeight>
<MediumWeight>40</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
<Game GameType="Sequence" Enabled="true" ConfigFile="Sequence.json" SelectionWeight="85" DurationSeconds="45" CaseSensitive="false">
<DisplayName>Number Sequence</DisplayName>
<EasyWeight>50</EasyWeight>
<MediumWeight>35</MediumWeight>
<HardWeight>15</HardWeight>
</Game>
</GameTypes>
<!-- Difficulty-tiered reward pools (Easy, Medium, Hard) -->
<RewardTiers>
<Tier Difficulty="Easy">
<EnableUconomyMoney>true</EnableUconomyMoney>
<MinMoney>100</MinMoney>
<MaxMoney>250</MaxMoney>
<CurrencySymbol>$</CurrencySymbol>
<EnableExperience>true</EnableExperience>
<MinExperience>25</MinExperience>
<MaxExperience>60</MaxExperience>
<EnableSpeedBonus>true</EnableSpeedBonus>
<SpeedBonusMaxSeconds>5</SpeedBonusMaxSeconds>
<SpeedBonusMultiplier>1.5</SpeedBonusMultiplier>
<ItemRewardMode>WeightedRandom</ItemRewardMode>
<ItemDropChancePercent>35</ItemDropChancePercent>
<Items>
<Item ItemId="15" DisplayName="Medkit" MinAmount="1" MaxAmount="2" Weight="50" />
<Item ItemId="81" DisplayName="MRE" MinAmount="1" MaxAmount="2" Weight="50" />
</Items>
<ConsoleCommands />
</Tier>
</RewardTiers>
</ChatMinigamesConfiguration>
2. Dedicated Game Config Files (Plugins/ChatMinigames/Games/)
Questions, phrases, and word pools are kept in separate .json files for clean, effortless editing:
| File | What It Configures |
|---|---|
Math.json | Min/max number ranges and multiplication factors per difficulty tier. |
Unscramble.json | EasyWords, MediumWords, and HardWords word pools for unscrambling. |
Trivia.json | List of questions with Difficulty, Question, accepted Answers, and Hint. |
Reaction.json | RandomCodeChance, character set, code lengths, and custom roleplay phrases. |
Reverse.json | Word lists to type backwards for each difficulty. |
FillInTheBlank.json | Reveal ratios (RevealRatioEasy, etc.) and words with progressive hints. |
GuessTheNumber.json | Number bounds (1 to 50/150/400), Higher/Lower hints, and guess cooldowns. |
UnturnedQuiz.json | Live server ItemAsset querying toggles, CuratedItemIds, and lore questions. |
Sequence.json | Auto-generated sequences and custom number pattern questions. |
Minigames Pack
The pack you need to spice up the chat and give users games within a game
Bundle Price:
ChatMiniGames
Latest Changes
v1.1.0