Catmint Wheel
Giveaway tool
Catmint Wheel is a complete Streamer.bot-powered giveaway system, not only a spinning graphic. The controller dock configures the round, collects and weights viewer entries, filters blocked bots, loads and spins the OBS wheel, validates or rerolls the result, tracks a verified winner and saves local winner data.
0REAL CUSTOMER INTERFACE
Actual Wheel and Controller Dock
These screenshots show the real customer interfaces. The functional HTML remains inside the downloadable customer package.
Complete giveaway workflow
From chat entry to verified winner
- Set the active entry command, giveaway type, prize and maximum ticket bonus in the controller dock.
- Open the round and collect viewer entries from chat; capped supporter-luck bonuses can add weighted wheel slices.
- Apply the included bot blocklist/allowlist and keep rejected users out of the active round.
- Load only the eligible entries into the OBS wheel, then spin directly from the controller dock.
- Validate the pulled result, create a pending winner claim and reroll when a result is not accepted.
- After a verified win, track that exact winner’s later Steam trade-offer link and write local winner exports.
- Clear the active round when finished; optional Troll Roll and supporter-luck tools are included.
Requirements
- Windows 10 or 11
- OBS Studio Browser Source
- Streamer.bot 1.0
- WebSocket Server at 127.0.0.1:8080
Portable and private by default
The package installs in any writable Windows folder. Entries, winners, pending claims, recent chat, trade links, logs and exports start empty and are written only inside the customer’s local project folders. No creator account, token, webhook, password or private path is included.
Giveaway rules: tell your chat
- Chat entry: base ticket plus follow, mod, VIP, sub and supporter bonus, capped at the max tickets (default 8).
- Extra tickets go on top, with no cap: your list or a manual add in the dock, and channel-point redeems (+1 per redeem).
- Every ticket is its own slice. All slices are the same size and mixed around the wheel.
- Everyone is checked: must follow, account at least 7 days old, no bots. A refused redeem is cancelled and the points are refunded at once.
- Long giveaways (for example a month): open it again with the same name and it continues, every ticket is kept. A new name starts empty, with a backup saved first.
- Drawn and not here, not following or a bot = ALL their tickets are removed, redeemed ones too, and no points are refunded.
A copy-ready chat message is in the download: CHAT_RULES_MESSAGE.txt.
Tested customer build
Tested customer build
Version 1.2.0 adds extra tickets from your list and channel-point redeems on top of the chat cap, equal mixed slices and checks for everyone. Every action was compiled and run in a full test giveaway: entries, list, redeems, spin, removal and reroll.
Included
Complete customer package
Project files
C4TM30W_CATMINT_WHEEL_v1.2.0_CUSTOMER.zip
What it is and does: Catmint Wheel is a complete Streamer.bot-powered giveaway system, not only a spinning graphic. The controller dock configures the round, collects and weights viewer entries, filters blocked bots, loads and spins the OBS wheel, validates or rerolls the result, tracks a verified winner and saves local winner data.
Why it is useful: The real wheel and controller dock keep giveaway control separate from the OBS display and support validation and rerolls.
Fallback: Yes — local test entries and manual controller actions allow setup testing without exposing private streamer data.
Latest fix: Extra tickets (list, manual add, channel-point redeem) on top of the cap, equal mixed slices, a smooth spin up to 10,000 slices, and everyone is checked.