Skip to main content

Plugin — Wheel of Fortune

Wheel of Fortune is a randomized prize wheel for streams — when a viewer donates above your threshold, the wheel spins with weighted segments (each segment has its own probability) and lands on a result.

Use it for anything: in-game rewards, streamer challenges, food orders, topic prompts, you name it.

What you'll need​

  • A list of segments (slices) you want on the wheel — at least 2
  • A weight for each segment — higher number = higher chance
  • (Optional) a spin sound + flash color

Step 1 — Enable the plugin​

  1. Go to Plugins → the Wheel of Fortune tab
  2. Flip the Enable toggle

Step 2 — Pick a Mode + Amount​

In the Trigger section:

  • ≥ minimum amount — donation ≥ X → spin
  • = exact amount — donation = X exactly → spin

Then enter the amount.

Step 3 — Add Segments​

In the Segments section (you need ≥ 2):

  1. Click + Add Segment
  2. Fill in each segment:
    • Label — text on the slice (e.g. "Big Prize", "Sing one song")
    • Color — slice background color
    • Text Color — text color (legible on the slice)
    • Weight — chance (1–100; all weights are normalized to 100% across the wheel)
  3. Repeat until you have all your segments

:::tip How does weight work? 3 segments with weights 1, 1, 8 → 10%, 10%, 80%
Equal weights everywhere → equal probability for every slice :::

Step 4 — Set size, duration, font​

  • Wheel Size — 280–700px
  • Spin Duration — 2–10s (how long it spins)
  • Display Duration — 1–10s (how long the result stays after stopping)
  • Font Family — font on the wheel
  • Show Donor (toggle) — show the donor name
  • Show Result (toggle) — show a result popup

Step 5 — Spin Sound + Flash​

Spin Sound​

  1. Upload a sound file (loops while the wheel spins)
  2. Set the volume

Flash​

  • Flash Color — flash color when the wheel stops
  • Flash Intensity — how bright

Step 6 — Copy Widget URL → OBS​

  1. Find Wheel Widget URL → click Copy
  2. URL: http://localhost:3001/wheel
  3. OBS → + Sources → Browser → paste URL
  4. Set Width / Height to fit Wheel Size + labels
  5. Drag into position

Step 7 — Test with Preview​

The plugin tab has a Preview / Spin Now button — click it to spin without a real donation. Watch for:

  • Segments are arranged with nice colors
  • Spin animation runs smoothly
  • Results match your expected weights (spin 10–20 times to eyeball the distribution)

Tips & Troubleshooting​

  • Can't save segments: you need ≥ 2 — you can't delete the last 2.
  • Same result every time: check weights — if one segment has way more weight than the others, that's expected.
  • Text unreadable: adjust Text Color to contrast with the slice Color.
  • Spin sound never stops: check the audio file — the app loops it automatically and stops on spin end.
  • Want to clear history: the plugin tab has a History section — Clear All button.

:::warning Real audiences Very low weights (e.g. 1 out of 100) might never come up in a single stream — balance for fun and surprise but stay realistic. :::

See also​