Country Bounce | TikTok Live Chat Battle Royale Game (Python Script)

Country Bounce Live — Interactive TikTok Live Battle Royale

Country Bounce Live turns your TikTok LIVE chat into a real-time physics battle royale. Viewers type a country name (or its 2-letter code) in the comments to drop their country’s ball into the arena, send TikTok Gifts to launch bombs that blow holes in the arena wall, and watch the last country bouncing take the win — all rendered live as a browser source in OBS Studio / Streamlabs.

No coding knowledge required to run it: install the Python server once, connect your TikTok username from a password-protected Admin Panel, and go live. Every sound effect, gift-to-bomb mapping, and game rule is configurable from the browser — no code editing needed.

Key Features

• Type-to-Spawn Gameplay — Viewers type a country name or ISO code (case-insensitive) in TikTok chat to spawn their country’s ball.
• TikTok Gifts = Bombs — Any TikTok gift can be mapped to a bomb value; gifts instantly queue bombs that blast open the arena wall.
• Never a Dead Stream — If nobody comments for 20 seconds, the game automatically seeds a bot to kick things off. If real viewers don’t reach the configurable minimum player count, bots fill the remaining slots gradually so every match still starts on time.
• Full Match Flow — Waiting → 15s Pre-Spawn lobby → 10s “Get Ready” countdown → Battle → Chaos (shrinking arena) → Winner celebration modal.
• Live On-Screen Indicators — Alive counter, phase timer, a “Next Spawn” queue counter (so viewers know their comment was received even mid-match), and a bomb counter.
• 190+ Country Flags bundled out of the box, with alias matching (full name or code, e.g. “Indonesia” or “id”).
• 400+ TikTok Gifts Pre-Mapped to bomb values in the Gift Manager — add, edit, or delete mappings live from the Admin Panel.
• 4 Configurable Sound Effects (Collision, Bomb, Win, Countdown) — upload your own audio and adjust volume per sound, with instant in-panel preview.
• Secure Admin Panel — password-protected control room with CSRF-protected actions, confirmation prompts on destructive actions (reset arena, reset leaderboard, delete gift), and toast notifications for every action.
• OBS-Ready — a clean 1080×1920 portrait canvas designed to drop straight into a Browser Source.
• Self-Hosted — runs on your own PC or VPS via Python/Flask + Socket.IO. No monthly subscription, no third-party overlay service.

Requirements

• Windows, macOS, or Linux
• Python 3.9 or newer
• OBS Studio (or any software supporting Browser Sources)
• An active TikTok LIVE stream to connect to

What’s Included

• Full Python/Flask + Socket.IO source code
• Admin control panel (TikTok connection, gift mapping, game settings, audio config, security)
• 190+ country flag assets, sample sound effects, and a preloaded 400+ gift mapping catalog
• Step-by-step documentation (installation, OBS setup, TikTok connection, troubleshooting)

Support is provided through the item’s comment/support section. Please include your OS, Python version, and a description of the issue when requesting help.