๐ฎ 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
Privacy & Data
XoxoCraft runs entirely on your computer and does not collect or send any data automatically. No telemetry, no tracking, no background data collection. Your Twitch credentials (OAuth tokens) stay only on your PC and are never sent to anyone except Twitch itself.
The only exception is fully optional and opt-in: the "Send my logs" button (under Options → More XoxoCraft Options) lets you voluntarily send your session log to the author for debugging. It never sends anything unless you press it and accept the consent screen.
- What is sent: only
session_log.txt(commands and game events) — never your tokens or config. - Viewer usernames are pseudonymized before sending (e.g.
viewer_a1b2), so no real identities leave your machine. - Purpose: debugging only. You can request deletion of your logs at any time.
๐ Full privacy policy: https://xoxocraft.pages.dev/privacy
Made with โค๏ธ for the XoxoCraft Twitch community.