๐ฎ XoxoCraft — Twitch Chat Controls Your Minecraft
XoxoCraft is a NeoForge mod that bridges your Twitch chat directly into Minecraft. Your viewers type commands, and things happen — instantly, in real-time, on your stream.
โก 80+ Twitch Commands
Give your chat the power to wreak havoc (or help you out):
- ๐ฃ Spawn TNT, mobs, phantoms, or a Warden
- ๐ Invert your controls, steal your items, or strip your armor
- ๐ Rain TNT, anvils, or arrows for up to 60 seconds
- ๐ช Enchant, curse, repair, or destroy your held item
- ๐งจ Trigger explosions, lightning storms, lava traps, and more
- ๐ฒ
!random— executes a completely random command every time - ๐ฐ
!lottery— 10 weighted outcomes from jackpot to total ruin
๐๏ธ 13 Automated Mini-Game Events
Every 30 minutes, a random mini-game is automatically triggered in a custom void dimension:
| Event | Description |
|---|---|
| ๐ Parkour | 5-minute score attack with diamond milestones |
| ๐ฅ Sumo | 60s on a 9×9 platform — chat uses knockback commands |
| ๐ฏ Dropper | Fall through 7 increasingly difficult rings |
| โ๏ธ Spleef | 11×11 snow floor that auto-disappears in 3 phases |
| โ๏ธ Elytra | Fly through 10 rings in 90 seconds with random wind |
| ๐ฃ Minefield | Cross a hidden TNT grid — 3 difficulty levels |
| ๐ฆ Squid Game | 24 rows of glass panels, 5 attempts, persistent layout |
| ๐ญ Simon Says | 10 rounds of follow-the-command before time runs out |
| ๐จ Color Run | 20 rounds — stand on the right colored zone in 4 seconds |
| ๐ง Memory | Growing color sequences — 3 lives, how far can you go? |
| ๐บ๏ธ Labyrinth | Procedurally generated maze — 3 difficulty sizes |
| ๐น Dodge Ball | Dodge arrows from all directions for 60 seconds |
| โฌ๏ธ Falling Objects | Collect gold, dodge magma — 3 escalating phases |
Each event has tiered rewards and penalties based on performance.
๐ง Features
- ๐ด Live Twitch integration via IRC — zero delay
- ๐๏ธ Viewer count BossBar — always visible at the top
- ๐ฌ In-game Twitch chat panel (press Tab)
- โฑ๏ธ Per-command cooldowns — fully configurable in-game
- ๐ธ 50 Bits bypass — viewers can skip any cooldown with bits
- ๐ Sub/Resub rewards — configurable commands on subscription
- ๐ณ๏ธ Sub Gift Vote — chat votes on which command gets triggered
- ๐ Session log — every command saved to a local log file
- ๐ Food & inventory locked during all events
- ๐ Exact return teleport — always back to where you were
- โ๏ธ In-game cooldown editor — no config file editing needed
- ๐ Auto token refresh — OAuth stays alive without restarting
๐ Getting Started
- Create a Twitch app at dev.twitch.tv (OAuth Redirect:
http://localhost:3000/callback) - Launch Minecraft — the setup wizard will guide you through the configuration
- Connect your Twitch channel and let the chaos begin
๐ Requirements
- Minecraft 1.21.1
- NeoForge 21.1.172+
- Java 21
Made with โค๏ธ for the XoxoCraft Twitch community.

