Donation carousel: viewers spin your next challenge

What your viewers see

The whole thing is one loop, and it reads without explanation: money goes in, the bar climbs, the ribbon rolls, a card wins. Nobody has to be told what is happening — they watch it happen.

• The bar shows how much is collected and how much is left until the next spin, so a viewer can see that their donation is what tips it over.
• When it fills, the ribbon rolls across the screen and slows to a stop on a card — the same way a case opening does.
• Under the spin it says who tipped it over and what they got, so the person who paid is named on screen.
• Everything that comes up stacks on the challenge list: counters for the things you do, countdowns for the things you endure.

What goes on the cards

A card is a thing you might have to do: play the next hour with no HUD, take a request from chat, drink something the chat chose. Cards live in groups, and the group decides how often it comes up.

• Each group has a rarity, and rarity sets the odds — a legendary card is rare because you made it rare, not because of a number you have to compute.
• The colour of the card and of the bar follows the rarity, so an expensive drop is recognisable before anyone reads it.
• A series creates a dozen numbered cards from one template, for the times a challenge is 'do it once more'.
• Repeat rules decide whether the same card can come up twice in a row, and how far apart it has to be.

The threshold rises, and it drops when it is quiet

A fixed bar goes stale in one evening: the first spin is exciting, the tenth is arithmetic. Two settings keep it from flattening out.

• The threshold can rise with every spin, so the tenth challenge of the night costs more than the first.
• When donations stop coming for a while, the threshold quietly comes down for a time and the bar says so — an evening that went quiet gets a way back instead of standing still.
• The discount only runs while you are live: an overnight gap does not hand out a free spin to whoever tips first in the morning.
• All amounts are in your own base currency, and the pool follows whatever donation services you have connected.

The challenge list keeps score

A challenge that comes up and is forgotten was not a challenge. The list is the memory: it sits in OBS and it survives a restart.

• A counter line grows every time the same card comes up — five push-ups, then ten, then fifteen.
• A countdown line runs on screen and makes a sound when the time is up, so chat knows before you do.
• Timers keep counting through an app restart, so a crash mid-stream does not wipe what you owe.
• You can mark a line done, edit the number or add your own from the control panel without leaving the stream.

Running it while you play

Everything you need mid-stream is on a control panel tile, on the second monitor — not in a settings window you have to alt-tab into.

• The tile shows the bar, the queue of spins waiting to play and the cards that came up last.
• One button spins right now, for the times you want to hand out a challenge yourself.
• The challenge tile starts and pauses timers and edits the numbers in place.
• Both tiles are the same data as the OBS overlays — change it on the panel and the overlay follows.

What it is made of

Each part is a separate module: you install only the ones you need, and any of them can be removed without breaking the rest.

Getting started

1. Install the carousel and at least one overlay — without one the spin happens invisibly to chat.
2. Connect a donation service, so there is something to fill the bar with.
3. Write the cards, put them into groups and give each group a rarity.
4. Set the threshold, and decide whether it rises with every spin.
5. Put the ribbon, the bar and the challenge list into OBS as browser sources.
6. Add the two tiles to the control panel and run the evening from there.

The carousel and the challenge list are separate modules on purpose: a stream that wants the spin without keeping score installs the first and skips the second.

Works together with