StreamRoll+ Streamer.bot Action Event

This guide explains how the StreamRoll+ Streamer.bot Action Event feature works and when to use it.

What This Feature Does

The StreamRoll+ Action Event lets a config notify Streamer.bot when a roll finishes. That gives you a clean way to chain dice results into alerts, scene changes, sounds, counters, chat messages, or any other automation you already run in Streamer.bot.

When To Use It

Use this feature when you want a StreamRoll+ config to behave like an automation trigger instead of just a visual roll.

Good examples include:

• Playing a sound when a special value is rolled.
• Showing a chat message for a rare result.
• Changing an OBS scene or source after a specific roll.
• Updating a counter, reward, or overlay state in Streamer.bot.

Before You Start

You should already have:

• A working StreamRoll account.
• An active StreamRoll+ subscription.
• Streamer.bot installed and running.
• The Streamer.bot websocket server enabled.
• Your StreamRoll overlay and config setup already working.

Setup Overview

1. Open the config you want to extend.
2. Add the StreamRoll+ Action Event feature for that config.
3. Choose the Streamer.bot action that should fire and set a value to trigger on.
4. Save the config and test a roll.

Recommended Workflow

Start with a simple action first. A single chat message or sound cue is easier to verify than a large multi-step automation chain.

After the first test succeeds, expand the action into a fuller workflow with overlays, OBS changes, or channel point interactions.

Testing Checklist

• Roll the config once and confirm Streamer.bot receives the event.
• Verify the intended action runs only for that config.
• Check that any variables or payload values look correct.
• Refresh the overlay and repeat the test to confirm the setup persists.

Troubleshooting

• Nothing happens when the roll completes.

  • Confirm Streamer.bot is running and websocket support is enabled.
  • Re-check that the action event is attached to the correct config and the value is correctly set.

• The wrong action fires.

  • Verify the selected Streamer.bot action name and any config mapping.

• The event fires, but the payload looks incomplete.

  • Re-test with a simpler action first and confirm the roll data is being passed through.

Next Steps

If you are new to Streamer.bot integration, read the main Streamer.bot setup guide first, then return here once the baseline connection is working.