Twitch Chaos Mod

Chaos Mod is an interactive mod that allows Twitch chat to vote on various in-game effects, send emails and shop for items! Experience Chaos with 100 different commands to vote for!

The mod features full Channel Points integration that lets viewers redeem custom rewards for Chaos Commands, emails, shop items, and hints. These rewards can be configured individually and run alongside regular Twitch voting.

It also features a Direct Mode with an Online Control Panel that runs alongside Twitch Integration. When enabled, it allows sending specific commands directly to players through a web interface.

Version 3.2.0 has reworked ChaosBot to switch to a new Python Twitch API. This transition was due to Twitch's PubSub deprication, and as such, you now must follow the new Web OAuth instructions below to utilize ChaosBot. Ultimately, it should be easier for users since it will automatically request needed auth scopes.

Please see changelog for specific changes.

ChaosMod has automatic installation for the Twitch ChaosBot. A main menu button automatically downloads and runs a pre-built exe making installation a breeze. If you still want to run from source, it can automatically launch the python file for you.

If you encounter any issues, please report them in the Discord channel or Github issues. ChaosBot now has improved logging, so please include the log file (VotV\Binaries\Win64\pyChaosMod\logs or VotV\Binaries\Win64\logs) when submitting Twitch issues for easier troubleshooting.

Features

• Twitch chat voting system

• Channel Point integration

• Offline Mode that randomly runs commands without Twitch Integration

• Direct Mode to send commands over a web interface

• Built in automatic installation of Twitch bot

• Randomized chaos effects, including custom assets

• Highly Customizable

• Email, Hint, and Shop system for viewer interaction - users can send emails to the in-game computer, order items from the shop and send hints of specific types

• Stylish In-game UI to display votes and ChaosMod status

Community

GitHub Discussions

Discord

Automatic r2modman Setup

1. Install ChaosMod and unreal-shimloader

2. Follow Twitch's instructions to register an Application in the Twitch Dev Console

   • When registering your Application, be sure to set your OAuth Redirect URL to http://localhost:17563. This is neccessary for automatic Web OAuth.
   • Name and Category can be whatever you'd prefer. Example: VotVChaosBotModdy. Category: Game Integration.
   • Your Application should be Confidential.

3. Once your Application is registered, click the Manage button from Dev Console.

   • Make note of your Client ID.
   • Under "Client Secret" click New Secret
   • Make note of your Client Secret. Do not share these values - you must keep them confidential.

4. Launch the game with ChaosMod installed and click Chaos Settings on the Main Menu.

   • Under "Twitch Settings" enter the following:
     • Your desired Twitch Channel
     • Your Client ID
     • Your Client Secret
   • Adjust any other settings as needed.

5. Click Save.

6. Launch the ChaosBot from main menu, which will automatically download and extract a pre-built exe, then run it.

If you want to download the exe manually, or run from source, see below.

Manual r2modman Setup

1. Install ChaosMod and unreal-shimloader

2. Download ChaosBot.zip from GitHub releases

   • Optionally, download python source from GitHub repo

3. Navigate to modded game directory, pa08_00**\WindowsNoEditor\VotV\Binaries\Win64\

4. Place ChaosBot.exe in a folder called "pyChaosMod" inside Win64 folder

   • Optionally, extract python source into Win64 folder
   • pip install to install from requirements.txt

5. Follow Twitch's instructions to register an Application in the Twitch Dev Console

   • When registering your Application, be sure to set your OAuth Redirect URL to http://localhost:17563. This is neccessary for automatic Web OAuth.
   • Name and Category can be whatever you'd prefer. Example: VotVChaosBotModdy. Category: Game Integration.
   • Your Application should be Confidential.

6. Once your Application is registered, click the Manage button from Dev Console.

   • Make note of your Client ID.
   • Under "Client Secret" click New Secret
   • Make note of your Client Secret. Do not share these values - you must keep them confidential.

7. Launch the game with ChaosMod installed and click Chaos Settings on the Main Menu.

   • Under "Twitch Settings" enter the following:
     • Your desired Twitch Channel
     • Your Client ID
     • Your Client Secret
   • Adjust any other settings as needed.

8. Click Save.

9. Launch the ChaosBot from main menu, which will automatically run in order priority: ChaosBot.exe, python Chaosbot.py

   • Optionally, run the program from pyChaosMod folder

Folder structure WindowsNoEditor\VotV\Binaries\Win64\pyChaosMod is essential for proper functionality

Configuration

Use in-game configuration menu to change settings and set Twitch connection info.

Usage

1. Start your game with mods enabled, through r2modman or manual setup.

2. Launch ChaosBot from main menu

   • Optionally, launch exe or .py file manually from pyChaosMod folder

3. Either pause the game or open inventory to see buttons to toggle the mod and other functions (bottom right)

   Optional In-game keybinds:

   • F8: Toggle Chaos Mod on/off

   • F7: Manually trigger voting

   • F6: Clear active events, to allow saving and pausing if disabled

   • F3: Toggle email system (if enabled)

4. Twitch viewers can vote using numbers in chat during voting periods.

5. If enabled, viewers can use the !email command to send in-game emails.

   • Format: !email subject:[subject] body:[body]

6. If the shop system is enabled, viewers can use the !shop command to place orders when the shop is open. This will deduct Points if enabled.

   • Shop items list

Showcase

https://github.com/user-attachments/assets/4adc4bad-de7b-4fab-8a11-432bc1a9cb42

https://github.com/user-attachments/assets/9d8f602b-c36d-4a8f-b708-261537f7ef94

Twitch Chatter Email Showcase

https://github.com/user-attachments/assets/e9362855-1803-4733-a60d-bf4571f273f7

Twitch Shopping Showcase

Commands

3.5.1

• Updated to a09n

3.5.0

• Initial release for latest stable game version: a09j_0001

3.4.0

• Fixed Nextbot AI

• Nextbots can now be killed (not glorp)

• 5G Horse can now be destroyed

• Added commands:

  • Force Save
  • Monochrome Pigs
  • Too Many Visitors

3.3.0

• Added OBS Browser Overlay

  • The webserver runs locally and updates with voting information in real-time
  • Access from http://localhost:3202/ or add an OBS Browser Source and point it to http://localhost:3202/
  • Default stylized to match VotV, but can edit cfg/styles.css to user preference

• Added The Big Red Button

  • ChaosMod prop that runs Random Events or Chaos Effects when pressed
  • Presser beware...

• Modified several commands

  • pyramidTime (again), Smoke500Cigs, Nextbots, waspAttack

• Full Nextbot Rework with new AI

  • They are pretty ruthless now shrugs

• Added 2 new Nextbots

• ChaosBot improvements

• Added additional voting related hint/visibility settings

• Removed OhFiddlesticks command

3.2.0

• Reworked ChaosBot to use TwitchAPI Python Library due to PubSub deprication
• Updated Config, Readme, etc for new OAuth.

3.1.5

• Fixed Lua command errors
• Changed WS hints to only send if debug enabled

3.1.3

• Updated to game version pa0082b_0004
• Enhanced websocketHandler AddHint debug output

3.1.2

• Updated to latest game version 0.8.2 pre-alpha
• Fixed Config menu Focus issue
• Fixed ChaosBot psutil dep bug

3.1.1

• Updated to latest game version pa0082_0011 (Test version, no longer available on twitch.io)
• Fixed Pyramic Time command (I swear)
• Removed Madness Combat command
• Converted more Lua commands to Blueprints for stability
• Updated list_store

3.1.0 (UP TO pa0081_0008)

Changed

• Migrated away from "listen" text/json files for game communication to WebSocket server. Mod no longer supports 0.7.

  • Hopefully resolves mysterious connection issues where game does not register votes, commands, etc.
  • More info: https://discord.com/channels/1285223290520207411/1285223379598839899/1323558223755870208

• Chat Shop now has an Order Queue

  • Orders are placed every minute if queue available. If queue is above 8 items, the order will be placed within 15 seconds.

3.0.0

Added

• Full channel points system with custom rewards

  • Support for special system rewards (email/shop/hint redemptions)

• Direct Mode with Online Control Panel for sending specific direct commands to players

• Enhanced email support with simple format and improved message parsing

  • Simple format: !email (email) - Subject will be Twitch Username, body is entire message
  • Advanced format still available
  • Added support for specific user email handling (e.g., Dr_Bao)

• Enhanced shop system with item verification

• Implemented new hint system

  • !hint command, Hint channel point redemption
  • Can specify hint type (error, warning, thought)

• "Always On" mode for most systems, enhancing ease-of-use

• Dynamic Config Reloader to reload, enable/disable subsystems on the fly

• New custom console logging setup with color formatting

• Automatic ChaosBot updating system

• New configurable "Small Menu" displaying Chaos status during non-voting periods

• 1 random Glorp Friend Christmas event, 2 random Glorp Friend Random events (secrets)

Changed

• Updated to 0.8.1
• Config files moved to /cfg subfolder
• Listen files moved to /listen subfolder
• Enhanced voting status checks
• Simplified main Lua loop
• General code cleanup and optimization
• Enhanced error message clarity
• Setting inputs disable/enable based on other settings for clarity
• Moved 26 Lua scripts to Blueprints

Fixed

• ChaosBot is now launched as Admin to fix issues described by Mimi on Discord
• Fixed issues with incorrect voting options appearing during voting rounds (Thanks Mimi)
• Reduced websocket logging noise (stops logging of sensitive info)
• Added UTF-8 encoding for log files and created custom stream output for console, eliminating bugs from emojis
• Nextbots now follow player when on ATV

2.5.0

Even more overhaul work.

• Added:

  • Offline Mode

    • Offline mode runs without the external program and randomly executes commands based on configurable options, every set time period it has a chance of running a random command

  • Configurable voting and offline options

    • Each command can now be individually toggled to appear during voting or in offline mode

  • Option to disable voting ticker sound

  • 18 new commands!

  • Debug mode to trigger desired chaos commands manually

  • Automatic updating of ChaosBot

• Changed:

  • Twitch Bot rework, now uses TwitchIO library
  • Improved Bot Logging
  • Moved several Lua based commands to Blueprints, work will continue to migrate Lua to Blueprints for increased stability

• Fixed:

  • Voting issue where the lowest option would be picked regardless of number of votes
  • Timescale issue, timers are now paused when sleeping or timescale is fast
  • External Lua scripts not working, hopefully this issue did not affect the Lua Commands, but ExecuteCommand errors should be resolved

• Removed:

  • FastTimeScale command

2.0.0

Large overhaul.

Added:

• Built in-game UI, no longer based on pyglet, same with UI sounds
• In-game settings menu
• Ability to launch or download latest build from game main menu
• Optional pre-built exe
• In-game buttons for hotkey replacements, hotkeys still exist
• 2 new commands (fullSleep, healPlayer)
• Added the ability to disable hard commands (only 4 are deemed "hard" so far)
• DataTables for commands and options
• Punch sound for Charborg Nextbot

Changed:

• Fixed points commands, fullTummy, nextbots, and teleport commands
• Added a timer for pyramidTime to remove after 3-5 mins
• Renamed main.py to ChaosBot.py
• Added utils.py
• Hard coded twitch server info
• Process checks for multiple ChaosBots running, with warnings
• Wait for input before exiting to display errors

1.0.3

• Temporary fix for ATV disabling Chaos

1.0.2

• Fixed console window spam if UE4SS console not open

1.0.1

• Test command cleanup

1.0.0

• Initial Release