🎮 ChatBrawl (Hytale – Chat Games, Race Events & Tournaments Plugin)

ChatBrawl adds fast, fun chat-based minigames, race-style micro events, and lightweight tournaments to your Hytale server that run automatically or can be started manually by admins.

Players compete by typing answers in chat or completing in-game objectives, and winners are instantly rewarded via configurable console commands.

Perfect for keeping chat active, rewarding attention, and adding quick bursts of competition and tournament-style events to your server.

🌍 Language Support

ChatBrawl includes built-in multi-language support with default locales:

English (en)
Spanish (es)
French (fr)
German (de)
Portuguese (Brazil) (pt_br)
Italian (it)
Dutch (nl)
Polish (pl)
Russian (ru)
Turkish (tr)
Swedish (sv)
Norwegian (no)
Danish (da)
Finnish (fi)
Czech (cs)
Hungarian (hu)
Romanian (ro)
Greek (el)
Ukrainian (uk)
Japanese (ja)

All messages are fully customizable using MiniMessage, allowing:

Custom colors
Gradients
Formatting
Hover / click events (if supported by client)

Every announcement, prompt, progress update, and win message can be edited directly in config.toml — no recompiling required.

🎮 Chat Game Modes

Type – First player to type the phrase exactly wins
Scramble – Unscramble a word correctly
Quiz – Answer a simple question correctly

These modes can be chained together to create rapid-fire tournament-style chat competitions.

🏁 Race Game Modes

Race games challenge players to complete real in-game actions. First to finish wins:

Block Race – Mine a configured number of blocks
Hunt Race – Kill a configured number of mobs
Craft Race – Craft a configured number of items
Food Race – Eat food (first to consume wins, or configurable amount)

Each race:

Randomly selects ONE target per round (from your configured lists)
Displays friendly names (ex: Cobalt Pickaxe, Wolf, Bread)
Tracks progress live
Ends instantly when a winner is declared

All race modes are fully configurable:

Target amounts
Allowed blocks / mobs / items / foods
Time limits
Messages (MiniMessage)
Rewards

Race games can run standalone or as part of automated tournament rotations.

🧠 Smart Quiz Rotation (No Repetitive Questions)

Quiz games use a recent-question exclusion system:

Each round selects a QuizEntry that hasn’t been used recently
Questions are tracked internally in a rolling set
Once ~80% of the pool is used, history resets and cycling restarts

Example:

With 200 quiz questions:

ChatBrawl strongly prefers unused questions
Repeats only begin after ~160 have been asked

This keeps gameplay fresh even on long-running servers and extended tournaments.

🏆 Rewards

Executes console commands when a player wins
Fully configurable in config.toml

Default reward:

give <playername> Ingredient_Bar_Gold

Supported placeholders:

<playername>
<uuid>

⏱️ Automation

Games, races, and tournament rotations run automatically on configurable timers
Admins can manually start or stop events anytime

📜 Commands

/cb help

/cb status

/cb start [type|scramble|quiz|block|hunt|craft|food]

/cb stop

/cb reload

/cb top [n]

/cb version

Includes built-in update checking against CurseForge with admin notifications.

🧠 Defaults Included

Preloaded Type phrases
Scramble words
Quiz questions
Starter race targets

All editable via config files — zero rebuild required.

🎨 Chat & UX

MiniMessage-powered formatting
Colored announcements and prompts
Winner highlights
Clear start, progress, win, and timeout messages
Fully translatable + themeable

⚙️ Admin-Friendly

Hot-reloadable configuration
Lightweight and non-intrusive
Clean separation of games, races, tournaments, messages, rewards, and languages
Shared race framework for easy future expansion
Automatic update notifications

ChatBrawl Chat Games & Tournaments