Stream auction: bidding, wheel and tournament

How the bidding works

A lot is something you might do: a horror run with the lights off, chat picking your build, an hour of karaoke. Viewers put money and points behind the one they want, and the totals decide the outcome.

• Donations from any connected service raise the lot named in the message.
• Twitch channel points count too — you choose which rewards take part, and an unmarked reward is ignored instead of dragging random redemptions into the auction.
• You can add a bid yourself from the control panel, for the times someone paid outside the app.
• A bid the engine could not place — the lot was misspelled, or not named at all — goes into a disputed queue rather than being lost.

Four ways to pick a winner

The mode changes what the money buys, and that changes how chat behaves. Pick the one that fits the evening.

• Leader — the largest total wins. Simple, and ruthless: a big donation ends the argument.
• Weighted wheel — money buys a bigger sector, and the spin decides. A small bid still has a chance, which keeps quiet viewers in the game.
• Elimination — the wheel spins the losers out one at a time, so the tension lasts several rounds instead of one.
• Tournament — lots are played off in pairs up a bracket, with the match size you choose.

What the viewers see

The engine itself draws nothing. Three overlays go into OBS as browser sources, and you use the ones you need.

• The board: the countdown and the leaderboard of lots, updated the moment a bid lands.
• The wheel: the spin itself, with the sector colours and the odds visible before it starts.
• The bracket: the tournament tree, focused by itself on the match being played.

What you see while playing

Five tiles for the control panel, so the auction is run in one window instead of a page you have to alt-tab to.

• The auction desk: status, timer, summary and the buttons that start, pause and finish the bidding and spin the draw.
• The lots list: wheel colours and chances, drag to reorder, names and amounts edited in place.
• The disputed bids queue: assign a stray bid to a lot in one click, with the viewer’s message shown as it came.
• The wheel and the bracket tiles: the same wheel and the same tree the stream sees, without switching to the OBS preview.

Corrections that do not lose money

Mid-stream mistakes are the normal case, so undoing them is built in rather than bolted on.

• Deleting a lot says how many bids and how much money go with it before it happens.
• Dragging one lot onto another merges them — the bids move instead of disappearing.
• A rejected channel point bid can return the points to the viewer, when Twitch allows it for that reward.
• A correction made by hand survives the next incoming bid.

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 auction and at least one overlay — without one, the bidding happens invisibly to chat.
2. Add the lots and choose how the winner is decided.
3. Pick which channel point rewards take part, if you use them.
4. Put the board and the wheel into OBS as browser sources.
5. Add the auction desk tile to the control panel and run the evening from there.

The wheel on the auction page, the tile on the panel and the overlay in OBS are one and the same wheel. Style it once and it looks the same in all three places.

Works together with