Spin Mania - Points-Only Slot Machine Game for Live Streams | Python Script

Three slot machines for your TikTok LIVE, played for points only

Spin Mania puts a bank of three slot machines on your stream. Viewers earn spins from chat, follows, likes and gifts, sit down at a machine with their own name and photo, and pull the lever. Three matching symbols win points, four win big, and four red 7s win a progressive jackpot pool of points. Every point goes onto a leaderboard of avatar circles at the top of the screen.

Points only: nothing is bought in the game and nothing of value can be won. Self-hosted: it runs on your own PC. A Python server reads your LIVE and decides every spin, and the game screen is a web page you add to OBS, TikTok LIVE Studio or another app with a Browser Source at 1080×1920.

Key features

How viewers get spins

• Type spin in chat for a free spin, once every 30 seconds per viewer. The chat word is adjustable, up to 10 words in any language.
• Follow for one free spin, once per viewer.
• Every 100 likes give 1 spin. Likes add up per viewer.
• Every gift gives 1 spin per coin, up to 1,000 spins per gift (adjustable from 1 to 100,000). Combos count in full, with no multipliers.

Three machines and a fair line

• Three machines with four reels each play at the same time.
• Spins wait in one line in the order they came in. A viewer plays up to 10 spins in a row (adjustable), then the next viewer sits down, so one big gift never blocks everyone else.
• Each machine shows the player’s photo, name and points, and the spins they have left on rolling digit drums.
• Reels stop one by one. When a big result is still possible, the last reel keeps spinning under a blinking frame before it lands.

Winning

• Three of a kind anywhere on the line wins points. Four of a kind fills the machines with BIG WIN in bulb letters, the winner and the points rolling up.
• Four red 7s win the jackpot pool with a full-screen moment. The pool starts at 5,000 points and every viewer spin adds 10 (both adjustable).
• Three difficulty presets. Hard, the default, gives three of a kind on 4.5% of spins, four of a kind on 0.4% and the jackpot about once in 25,000 spins. Normal and Easy give more wins for smaller streams.
• The points for every result are editable, with the chance of each result shown next to it.
• Ten slot symbols drawn for this game: cherry, lemon, orange, plum, grapes, watermelon, bell, BAR, diamond and the red 7.

Gifts and thank-yous

• Small gifts get a notification, gifts from 10 coins a marquee banner with chasing bulbs and fireworks, and gifts from 500 coins a spotlight with the sender’s photo, confetti and fireworks. Both limits are adjustable.
• No thank-you covers the reels. A spotlight gifter’s spins start on the machines below while the spotlight is still up.
• Big thank-yous wait their turn, so every gifter gets their own moment.

Made for streaming

• Everything sits in the upper part of the 9:16 screen. The bottom 38% stays clear for the LIVE chat and gift bar.
• The machines run on the server, so OBS, preview windows and page refreshes always show the same reels.
• When chat is quiet, attract mode runs house spins so the machines never stand still. House spins never score, never touch the jackpot and always wait behind viewers.
• A marquee sign with chasing bulbs over a slowly drifting velvet background, and a light effects mode for slower PCs.
• The server window shows the links and a new Admin Panel password at every start, then lists follows, gifts, big wins and jackpots.

Admin Panel

Four tabs: Live, TikTok, Settings and Sounds. It also works on a phone on the same Wi-Fi.

• The three machines, the line, the jackpot pool, the last wins and an activity log of gifts, follows, big wins and jackpots.
• Pause the machines, clear the line, reset the jackpot pool or the leaderboard, and add house spins.
• Test everything without going live: type the spin word, follow, send likes and any gift as a test viewer, and show a test jackpot that gives no points.
• Settings for chat words, cooldown, likes, follows, spins per gift, turn length, attract mode, the jackpot pool, difficulty, points per result, thank-you limits and the title, with worked examples next to the numbers.
• Replace any of the thirteen sound effects with your own MP3, WAV or OGG file and set each volume.

Points only

• Points have no cash value. The game screen never mentions coins or money: gifts give spins and wins give points.
• Never offer money, prizes or anything of value for points, wins or jackpots. TikTok’s rules for LIVE do not allow gambling content, so read them before you stream any slot-style game. The documentation says the same in its own section.

Before you buy: the TikTok connection and its costs

• The connection to your LIVE depends on external services that are not part of this item and that we do not control: TikTok’s unofficial live data, read through the open-source TikTokLive library, and Euler Stream, a third-party service that signs each connection. Future changes to TikTok’s API or to these services can stop the connection until TikTokLive and this item are updated.
• Possible ongoing cost: Euler Stream’s free plan has a daily request limit. The game runs on the free plan without a key, but if you stream often or keep reaching that limit, you may need a paid Euler Stream plan. Paid plans are monthly subscriptions billed by Euler Stream at their own prices, which can change, and they are not included in the price of this item.
• You are responsible for any costs and account requirements needed to go live and stay connected: a TikTok account that is allowed to go LIVE, any Euler Stream plan you choose, your internet connection and your streaming software.
• TikTok is a trademark of ByteDance Ltd. This item is not made, endorsed or supported by TikTok or Euler Stream.

Requirements

• Windows 11 (tested). A start script for macOS and Linux is included.
• Python 3.10 or newer
• OBS Studio, TikTok LIVE Studio, Streamlabs Desktop or another app with a Browser Source
• A TikTok account that can go LIVE. The game never asks for your TikTok password.

What’s included

• Full Python, HTML, CSS and JavaScript source code
• Documentation with screenshots: installation, OBS, the TikTok connection, connection status and debugging, every rule and Admin Panel setting, and how to change colors, fonts and the logo
• The ten slot symbols as SVG files you can replace, and thirteen original sound effects
• Start scripts: START_GAME.bat for Windows, start_game.sh for macOS and Linux
• No TikTok gift artwork. At start the server loads gift pictures from TikTok’s own servers, and during a real LIVE each gift shows the picture TikTok sends with it. A gift without a picture shows a gift box drawn for this game, as in the previews.

Installation

• Install Python 3.10 or newer. On Windows, tick “Add Python to PATH”.
• Open the Source folder and double-click START_GAME.bat (start_game.sh on macOS and Linux). It installs the requirements and starts the server.
• Copy the Admin Panel password from the server window.
• In OBS, add a Browser Source with the address http://localhost:5000 at 1080×1920.
• Open http://localhost:5000/admin, log in and try the machines with “Test without going live”.
• Go live, type your TikTok username in the TikTok tab and click Connect.

Support and updates

Ask through the Support tab on this item’s page. Please include your operating system, your Python version and a screenshot of the server window. Updates are free for buyers: download the newest version from your Downloads page. The changelog lists what changed.

Changelog

Version 1.0.0 (October 2026): first release.