A game for TikTok LIVE, version 2.0

Gifts become heroes.
Heroes fight live.

Every gift a viewer sends drops heroes with their name into a cave arena. They fight monster invasions and bandit waves while the leaderboard keeps score, all on your stream.

  • 8 heroes
  • 400+ gifts mapped
  • 70 on screen
  • 1920x1080 OBS source
  1. Black Ninja1-coin gifts
  2. Medieval Troops9 to 15 coins
  3. Arabian20 to 30 coins
  4. Samurai99 coins
  5. Spartan100 to 199 coins
  6. Persian200 to 499 coins
  7. Knight Templar500 to 999 coins
  8. Mongolian1,000+ coins

How a stream plays out

Your viewers drive the whole game. Here is a typical few minutes, the way the game log would tell it.

You start the server, connect your TikTok username and go live. The rest runs on its own.

  1. Gift

    nadia.live sends a Rose. Five Black Ninjas drop in with her name above them.

  2. Gift

    raka_99 sends a bigger gift. Stronger heroes join, and the most expensive gifts send up to 190.

  3. Queue

    The arena reaches 70 heroes. New ones wait their turn, with at most 10 per viewer on the field.

  4. Invasion

    Goblins and cave orcs storm in. Every hero turns to the nearest enemy.

  5. Ultimate

    A Samurai hits 30% energy and slashes across 320 px at 3x damage.

  6. Tamed

    A cave orc goes down and switches sides to fight with the heroes.

  7. Bandits

    A bandit wave arrives on its timer, a little tougher than the last one.

  8. Top 1

    dimas takes first place on the leaderboard with the most damage.

Eight heroes, priced like the gifts that summon them

Stats were rebalanced in version 2.0 so a pricier gift always brings a stronger fighter. Pick a hero to see it in action.

Black Ninja

Gift tier: 1-coin gifts

A swarm unit. Weak alone, dangerous in numbers, and the hero a Rose gift sends in.

HP
300
DMG
30
DEF
5

Ultimate at 30% energyHoming shurikens or a piercing shuriken burst. Passive: counter-attacks behind a straw-doll decoy.

Medieval Troops

Gift tier: 9 to 15 coins

Basic infantry that holds the line when it arrives in groups.

HP
750
DMG
52
DEF
23

Ultimate at 30% energySummons 1 to 3 shadow clones for 5 seconds.

Arabian

Gift tier: 20 to 30 coins

Mid-tier cavalry with real punch in small groups.

HP
950
DMG
75
DEF
24

Ultimate at 30% energySandstorm aura: nearby enemies lose 30% defence and speed for 7 seconds.

Samurai

Gift tier: 99 coins

A skilled duelist, strongest in a small elite squad.

HP
1,100
DMG
90
DEF
30

Ultimate at 30% energySword slash across a 320 px radius at 3x damage, drawn in three tiers by damage dealt.

Spartan

Gift tier: 100 to 199 coins

Heavy infantry. Tanky, steady and reliable in medium groups.

HP
1,500
DMG
95
DEF
55

Ultimate at 30% energyBattle Rage: +50% damage and +20% defence for 15 seconds.

Persian

Gift tier: 200 to 499 coins

Elite balanced unit. Few of them spawn, and each one hits hard.

HP
1,800
DMG
115
DEF
44

Ultimate at 30% energyPoison aura: three damage ticks over 10 seconds in a 250 px radius.

Knight Templar

Gift tier: 500 to 999 coins

The tank. Holds the arena while everyone else does the damage.

HP
3,000
DMG
120
DEF
80

Ultimate at 30% energyDivine Shield: +100% defence and +35% damage for 15 seconds.

Mongolian

Gift tier: 1,000+ coins

The heaviest hitter in the game, able to wipe out a whole wave.

HP
2,400
DMG
190
DEF
35

Ultimate at 30% energyArrow burst: 6 arrows in 800 ms, around 1,000 total damage.

Something always needs fighting

Quiet moments never last. The arena throws enemies at your viewers' heroes on a schedule you control.

The game and its control room

Real screens from version 2.0. The admin panel is password protected, needs no code editing, and every change reaches the live canvas without a refresh.

Battle Arena in play: heroes named after viewers fight goblins and cave orcs under the gift guide and leaderboard
Every hero carries the viewer's name over a health bar. The strip on top lists gifts and what they spawn, the leaderboard ranks damage and kills, and two timers count down to the next invasion and bandit wave.
A bandit wave hits the heroes while the spawn queue lists each viewer's heroes
Bandit waves and monster invasions run on the timers you set. The spawn queue on the right shows how many heroes each viewer has in the arena and how many are waiting for a slot.
Battle Arena control panel with TikTok connection, manual spawn, game controls and audio settings
Connect to TikTok with a live status, spawn heroes by hand, set the music volume, reset the leaderboard or the heroes, trigger a bandit wave or monster invasion, and swap every sound effect.
Arena background upload, hero stats, monster stats and game rules panels
Edit HP, damage, defence and energy for each hero and monster, set the arena capacity, the limit per viewer and the wave timers, and upload a 1280 x 720 arena background.
Gift simulator with a username field, follow and viewer join buttons and a grid of gifts with hero counts
Spawn any gift's heroes on the canvas under any username, search the whole gift list, and fire the follow and viewer-join rewards before your stream starts.
Gift mapping editor rows pairing gifts with hero types and counts
Search a gift and choose which heroes it spawns and how many. One gift can spawn several hero types, and saving pushes the change to the running game.

What is in the box

New in version 2.0

Released 21 June 2026. Updating means replacing the Source folder, with no database changes.

New 5 items

  • Upload a custom arena background from the admin panel, with a size check and live preview.
  • All eight heroes have working ultimates with real gameplay effects.
  • Samurai sword slash with three damage tiers.
  • Arrows and shurikens now use dedicated sprites.
  • Black Ninja straw-doll counter-attack.

Improved 4 items

  • The game keeps running when Chrome sits behind other apps.
  • Hero names, health and energy bars follow movement smoothly.
  • Wave and invasion timers keep counting in the background.
  • Hero stats rebalanced to match gift coin tiers.

Fixed 4 items

  • Spartan and Knight Templar ultimates now apply real buffs.
  • Knight Templar ultimate triggers at the right energy level.
  • Samurai uses its own sword slash instead of shadow clones.
  • No more double game-logic updates when you return to the tab.

From download to live in five steps

  1. Step 1

    Install Python 3.8+

    On Windows, tick Add Python to PATH in the installer. On macOS and Linux, use your package manager.

  2. Step 2

    Extract the files

    Unzip the package into a folder such as C:\BattleArena or ~/BattleArena.

  3. Step 3

    Install the dependencies

    Open a terminal in the Source folder and run pip install -r requirements.txt.

  4. Step 4

    Start the server

    Run python app.py and leave the terminal open. The game is served at localhost:5000.

  5. Step 5

    Connect and add to OBS

    Open localhost:5000/admin, connect your TikTok username, then add the canvas as an OBS browser source.

pip install -r requirements.txt
python app.py

Requirements

Operating system
Windows 10, macOS 10.14 or Linux. Windows 11 or macOS 12+ recommended.
Python
3.8 minimum, 3.10 or newer recommended
Memory
4 GB minimum, 8 GB recommended
Storage
500 MB free, 1 GB recommended
Browser
Chrome 90+ or Firefox 88+
Streaming
OBS Studio, version 29+ recommended
TikTok
An account that can go LIVE and receive gifts

Pay once, stream with it for good

Battle Arena is sold on CodeCanyon under its Tools License, which covers one user and unlimited end products. It runs on your own PC or server, so there is no subscription and no overlay service in between.

  • Full Python and JavaScript source code
  • 8 heroes, 2 monster types and bandit waves
  • Admin panel with gift simulator and mapping editor
  • 400+ gift mappings and all sprites and sounds
  • Step-by-step documentation for install, OBS and TikTok

Good to know

The live connection uses TikTok's public LIVE data through the open-source TikTokLive library, not an official TikTok API, so changes on TikTok's side can affect it. Battle Arena is an independent product and is not affiliated with or endorsed by TikTok or ByteDance.

Tools License, CodeCanyon

$37

One-time payment

  • Full source code
  • Free updates through your Envato account
  • Item support through CodeCanyon
  • Documentation included
Buy on CodeCanyon (opens in a new tab)

Questions before you buy

Do I need coding experience?

No. If you can install software and run one command, you can run Battle Arena. Everything else, from gift mappings to hero stats, is set in the browser-based admin panel.

Which TikTok gifts spawn heroes?

Over 400 gifts come mapped out of the box, keyed by gift name. Cheap gifts send a handful of Black Ninjas, and the most expensive gifts send up to 190 heroes across all eight types. You can change any mapping in the Gift Mapping Editor.

Why is the TikTok connection not working?

The connection only works while you are live. Start your TikTok LIVE first, then click Connect in the admin panel, and type your username without the @ symbol.

What resolution should the OBS browser source use?

Point the browser source at http://localhost:5000 with a width of 1920 and a height of 1080. The canvas background is transparent, so it layers over your camera.

Does it keep running when OBS hides the browser?

Yes. Version 2.0 runs the game logic in a Web Worker with an AudioContext keepalive, so timers, waves and spawns keep going when Chrome is behind other windows.

Can I run it on a VPS?

Yes. You need Python 3.8 or newer, and the server has to be reachable from your OBS browser source. Point the OBS URL to the server address instead of localhost.

Does it work on Mac and Linux?

Yes. Battle Arena runs on Windows 10 and 11, macOS 10.14 and newer, and the major Linux distributions.

Can I use my own sprites and arena?

Yes. Hero sprites live in the static folder and can be replaced with your own files at the same names and sizes. Since version 2.0 you can also upload a 1280 x 720 PNG arena background from the admin panel.

The game lags with many heroes. What can I do?

Lower the global hero limit in the admin panel. 50 heroes is a good starting point on modest hardware, and extra heroes wait in a queue until a slot frees up.

Can I get a refund?

Refunds follow the Envato Market refund rules on CodeCanyon. They cover items that are not as described, do not work and cannot be fixed, have an unpatched security issue, or come without the promised support, within 180 days for supported CodeCanyon items. A change of mind is not covered. Contact us first so we can try to fix the problem.

What does the purchase include?

The full Python and JavaScript source code, the admin panel, all sprites and sounds, the 400+ gift mapping catalogue and the documentation, under the CodeCanyon Tools License with item support through CodeCanyon.

Give your viewers something to fight for

One purchase, running on your own machine tonight. Read the documentation first if you want to check every step.