🎮 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.

xoxocraftNeoForge