Spin a wheel on stream

What you can do

A Spin Wheel is a wheel of segments on your overlay — challenges, prizes, the next game — that spins when a flow tells it to. Bloopbot picks where it lands, fairly, and every screen showing the wheel spins the same spin and stops on the same segment at the same moment. When it stops, a flow can say the result in chat or do anything else a flow can do.

You make the wheel in the overlay editor, give it as many segments as you like up to 24, and decide how likely each one is. Your moderators spin it by typing !spin, or you can spin it from a channel points reward or a Stream Deck key.

Before you start

• You need an overlay in OBS. Add an overlay to OBS shows how to add one as a Browser Source.
• Spinning a wheel comes with every channel's overlays: the Spin a wheel step is part of Hosted overlays in Plan & billing. What your plan includes explains the page.

Get help with your setup

Optional Help me reuses your saved wheel. Review the segments and weights, its actual spin trigger and its landed response before use. A real spin selects an outcome and can start another flow; it is not required to finish setup.

1. Make a wheel

1. Open Overlays and open the overlay the wheel should appear on, then choose Add and drag the Wheel tile from Goals & games onto the canvas.
2. In an existing overlay, choose Add on the left and drag Wheel from Goals & games onto the canvas, or open it and press Add.
3. Select the Wheel layer. In its settings on the right, press New wheel. It starts with six example segments.
4. Rename it under Wheel name — flows find a wheel by this name, so something short like Challenges works best.
5. Change the segments: each row is a colour, a label and a weight. A bigger weight is a bigger slice and a better chance, and the percentage beside each row is its chance of landing there. Add segment adds one, and the bin icon (Remove segment) removes one. A wheel has 2 to 24 segments.
6. Press Publish. Studio saves the wheel and its layer in the draft while you edit; Publish puts both on stream together.

The canvas shows the wheel as you edit it. To watch it spin, open Simulate in the top bar and press Test spin under Test events. A test spin picks its own segment on the canvas; it runs no flow and nothing is said in chat.

2. Choose how it looks

The Wheel layer's panel also has:

• Wheel — which of your wheels this layer shows. One overlay can hold several Wheel layers, each showing a different wheel.
• Show the wheel’s name — the name above the wheel.
• Show where it lands under the wheel — the landed segment's label under the wheel after a spin.
• Keep the result up for — how long the landed segment stays lit, 0 to 60 seconds. After that the wheel stays where it stopped.

Size the wheel by dragging its corners on the canvas, like any layer; Arrange your overlay covers placement. The pointer sits at the top and the wheel takes your overlay theme's accent colour for its rim and cap.

Press Publish to put the layer on stream.

3. Spin it from chat

The Mod commands pack has two flows for the wheel. Open Flows, press Marketplace, and add Spin the wheel (!spin) and Say where the wheel lands, each on its own. They arrive paused; switch them on.

• Spin the wheel (!spin): a moderator types !spin and your wheel spins for 6 seconds. With several wheels, they type the wheel's name after it: !spin Challenges. If the wheel is still spinning, chat is told to wait for it to land.
• Say where the wheel lands: when a wheel stops, chat hears 🎡 The Challenges wheel landed on Hydrate!

Only one spin runs on a wheel at a time. A !spin while it is still turning is refused rather than queued, so a burst of commands spins it once.

You can also spin from the dashboard: On stream › Wheels has a Spin button on every wheel. Press it to spin the wheel on your overlay without a flow or a chat command; the same spin shows on every screen, and Say where the wheel lands and any Wheel lands flow of yours react to it as they do to !spin, with whoever pressed the button as the spinner. A wheel that is still turning, or has fewer than two segments, says so instead of spinning. Moderators you have ticked on Team get the Wheels page too, with the Spin button but no way to change a wheel.

4. Build your own spin flows

Two steps in the node library do everything the wheel does:

• Spin a wheel (an action): set Wheel to the wheel's name — leave it blank to spin your only wheel — and Spin for (seconds), from 3 to 20. It follows busy when the wheel is still spinning, and error with the reason in $(from.<step>.message) when there is no such wheel.
• Wheel lands (a trigger): runs once when a wheel stops. Only this wheel narrows it to one wheel by name. Its tokens are $(segment) (the label it landed on), $(index) (its number, 1 for the first segment), $(wheel) (the wheel's name) and $(user) (who spun it, when a viewer did).

To let viewers spin it with channel points, make a flow that starts from On a reward redeemed and adds Spin a wheel — Reward redemptions shows how to pick the reward. To spin it from a Stream Deck key, start the flow from a webhook as Webhooks describes.

A Wheel lands flow can do more than talk: put Set a variable after it to count how often a challenge came up, or Show alert to play an alert for a jackpot segment, with a Check a value step that looks at $(segment) first.

A worked example: challenge wheel

1. In your main overlay, add a Wheel layer and make a wheel called Challenges with four segments: Hydrate (weight 3), Stretch (weight 3), Sing a line (weight 2) and Ten push-ups (weight 1). The panel shows their chances: 33.3%, 33.3%, 22.2% and 11.1%.
2. Press Publish to put the wheel and its layer on stream together.
3. Install Spin the wheel (!spin) and Say where the wheel lands from Mod commands, and switch them on.
4. A moderator types !spin. The wheel spins on your overlay, slows, and stops on Sing a line, which lights up with its label under the wheel.
5. As it stops, chat reads 🎡 The Challenges wheel landed on Sing a line!

What you should see

• The wheel on your overlay, at rest, with the segments you published.
• On !spin, a spin of the length the flow set, landing on one segment, with that segment lit and its label underneath for as long as Keep the result up for says.
• The same spin on every Browser Source and preview showing the wheel, landing at the same moment — including one you open or refresh halfway through the spin.
• One chat line per spin from Say where the wheel lands.

If your system asks for reduced motion, the wheel does not spin: it moves straight to where it lands and lights that segment.

Troubleshooting

• The layer draws nothing: it has no wheel chosen, or the wheel it showed was deleted. Select the layer and pick a wheel under Wheel.
• !spin says there is no wheel: the name after !spin does not match any wheel. Wheel names ignore capitals but must otherwise match.
• !spin asks which wheel: you have more than one, so name the one you mean after !spin.
• Nothing happens on !spin from a viewer: the built-in command is for moderators and you. Permissions and cooldowns shows how to open it to more people — add a cooldown if you do.
• The segments on stream are old: check the Studio preview, then press Publish. If you pressed Discard, Studio restores the last published wheel.
• Studio says a wheel was deleted elsewhere: reload Studio to pick up the current wheel list, then make your edit again.
• A spin was refused as still spinning long after it stopped: a spin stays busy until its result has been reported, which takes at most a few seconds after it lands.
• To see or tidy all your wheels at once, open On stream › Wheels. Each wheel lists the overlays that show it — including one whose change is not published yet, marked (unpublished) — with a link into the editor. A wheel no overlay shows can be deleted there with the bin icon (Delete); one still on an overlay cannot, so remove its Wheel layer or pick another wheel for it first.