ChatBrawl Chat Games & Tournaments

🎮 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