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โ€‹