Chaos ProtocolDocumentation

Chaos Protocol Setup Guide

Complete guide to installing, configuring, and using Chaos Protocol for your Twitch streams.

1. Installation

Requirements

  • Minecraft Java Edition 1.20.1 or later
  • Fabric Loader 0.15.0 or later
  • Fabric API (matching your Minecraft version)

Step-by-Step Installation

  1. 1

    Install Fabric Loader

    Download and run the Fabric Installer. Select your Minecraft version and click "Install".

  2. 2

    Download Fabric API

    Get Fabric API from Modrinth and place it in your mods folder.

  3. 3

    Download Chaos Protocol

    Get the latest version from Modrinth and place it in your mods folder.

  4. 4

    Launch Minecraft

    Open the Minecraft Launcher, select the Fabric profile, and click Play.

Mods folder location:

Windows: %appdata%\.minecraft\mods

macOS: ~/Library/Application Support/minecraft/mods

Linux: ~/.minecraft/mods

2. Account Setup

  1. 1

    Create an Account

    Go to minecraftaimods.com/register and create an account using your email.

  2. 2

    Choose Your Plan

    Select the Free tier to get started, or upgrade to Pro for AI features.

    Free

    20+ preset events

    Pro - $9.99/mo

    AI events + analytics

  3. 3

    Get Your License Key

    After signing up, go to your Dashboard and copy your license key.

3. Twitch Connection

Chaos Protocol connects to your Twitch chat to receive viewer votes and trigger events. Here's how to set it up:

  1. 1

    Set Your Channel Name

    In the mod config, set twitchChannel to your Twitch username (lowercase).

  2. 2

    Start Your Stream

    Go live on Twitch, then launch Minecraft with the mod installed.

  3. 3

    Activate Chaos Mode

    In-game, run /chaos start to begin receiving votes.

Chat Integration

The mod reads your Twitch chat directly. No bot setup required! Viewers vote by typing numbers (1, 2, 3) in chat during voting rounds.

4. Mod Configuration

After first launch, a config file is created. Edit it to customize your experience:

config/chaosprotocol.json

{
  "licenseKey": "YOUR_LICENSE_KEY_HERE",
  "twitchChannel": "your_twitch_username",
  "enableAIEvents": false,
  "enableDramaMeter": true,
  "enableClipDetection": false,
  "voteDuration": 30,
  "voteInterval": 300,
  "subscriberMultiplier": 2,
  "blockedEvents": []
}

Configuration Options

licenseKey(string)

Your license key from the dashboard. Required for all features.

twitchChannel(string)

Your Twitch channel name (lowercase). Used to connect to chat.

enableAIEvents(boolean)PRO

Enable AI-generated contextual events. Requires Pro subscription.

enableDramaMeter(boolean)

Track entertainment levels and auto-trigger events during slow moments.

enableClipDetection(boolean)PRO

Automatically detect highlight moments. Requires Pro subscription.

voteDuration(number)

How long (in seconds) each voting round lasts. Default: 30

voteInterval(number)

Time (in seconds) between voting rounds. Default: 300 (5 minutes)

subscriberMultiplier(number)

Vote weight multiplier for Twitch subscribers. Default: 2

blockedEvents(array)

List of event types to disable. Example: ["tnt_rain", "lava_floor"]

5. Viewer Voting

Voting is the core mechanic of Chaos Protocol. Here's how it works:

1

Vote Starts

3 random events appear on screen with numbers 1-3

2

Viewers Vote

Chat types 1, 2, or 3 to vote for their choice

3

Chaos Happens

The winning event triggers in your game

Vote Weighting

  • Regular viewers: 1 vote
  • Subscribers: 2 votes (configurable)
  • VIPs/Mods: 3 votes

Example chat voting:

Viewer1: 1

SubViewer: 3

Viewer2: 2

ModViewer: 3

6. Drama Meter

The Drama Meter tracks the entertainment level of your stream and can auto-trigger events during slow moments.

How It Works

  • Drama increases when: mobs are killed, player takes damage, chat activity spikes, achievements earned
  • Drama decreases over time during peaceful moments (mining, building, AFK)
  • Auto-trigger: When drama falls below 20% for too long, a random event triggers automatically

Drama Meter Display

Low
Medium
High

7. AI EventsPRO

Pro subscribers get access to AI-generated events that analyze your game state and create contextual chaos.

What AI Events Consider

Your current biome and location
Items in your inventory
Nearby mobs and structures
Recent player actions
Current health and hunger
Time of day in-game
Recent chat messages
Stream drama level

Example AI-generated event:

"The Nether Breach"

Context: Player mining diamonds at Y=-59, low health, no food

Effect: A small nether portal opens, spawning 3 Piglins who are interested in your diamonds...

Upgrade to Pro

8. In-Game Commands

/chaos start

Start receiving votes and triggering events

/chaos stop

Stop all chaos activity

/chaos vote

Manually trigger a voting round

/chaos status

Show current drama level and connection status

/chaos event <type>

Manually trigger a specific event (for testing)

/chaos leaderboard

Show top chaos voters in chat

(Pro only)
/chaos config reload

Reload configuration without restarting

9. Clip DetectionPRO

Clip Detection automatically identifies highlight-worthy moments during your stream and timestamps them for easy clipping.

Detected Moments

Player deathHigh
Boss defeatedCritical
Achievement earnedMedium
Near-death escapeHigh
Massive damage takenHigh
Drama spike (80%+)Medium

Clip timestamps are saved to your dashboard and can be exported for video editing software.

10. Troubleshooting

Mod not loading

Make sure you have Fabric Loader and Fabric API installed. Check that all mods are for the same Minecraft version.

Not connecting to Twitch chat

Verify your twitchChannel is set to your exact Twitch username (lowercase). Make sure you're live before starting chaos.

License key not working

Copy the key directly from your dashboard. Make sure there are no extra spaces. Check your subscription status.

AI events not generating

AI events require a Pro subscription. Check that enableAIEvents is set to true in your config.

Votes not being counted

Viewers must type just the number (1, 2, or 3). Make sure voting is active by running /chaos vote.

Events not triggering

Check the game log for errors. Some events may be blocked if you're in a protected area or creative mode.

Still having issues?

Join our Discord community for live support, or email us at support@minecraftaimods.com

Ready to Unleash Chaos?

Download Chaos Protocol and transform your Minecraft streams today.

Download from ModrinthGo to Dashboard