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
- Black Ninja1-coin gifts
- Medieval Troops9 to 15 coins
- Arabian20 to 30 coins
- Samurai99 coins
- Spartan100 to 199 coins
- Persian200 to 499 coins
- Knight Templar500 to 999 coins
- 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.
- Gift
nadia.live sends a Rose. Five Black Ninjas drop in with her name above them.
- Gift
raka_99 sends a bigger gift. Stronger heroes join, and the most expensive gifts send up to 190.
- Queue
The arena reaches 70 heroes. New ones wait their turn, with at most 10 per viewer on the field.
- Invasion
Goblins and cave orcs storm in. Every hero turns to the nearest enemy.
- Ultimate
A Samurai hits 30% energy and slashes across 320 px at 3x damage.
- Tamed
A cave orc goes down and switches sides to fight with the heroes.
- Bandits
A bandit wave arrives on its timer, a little tougher than the last one.
- 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.
Goblins
Small and cunning. They come in packs and wear down weak squads.
- 40 HP
- 25 DMG
- 15 DEF
Cave orcs
Huge health and armour. Beat one down and your heroes can tame it into an ally.
- 3,000 HP
- 10 DMG
- 100 DEF

Bandit waves
Bandits arrive on a timer and get tougher as the stream goes on. You can also start a wave or a monster invasion by hand from the admin panel.
- Timer in Game Rules
- Manual trigger
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.






What is in the box
Gift-driven gameplay
Gifts spawn heroes in real time, and viewer joins and follows can reward free Ninjas too.
Fair spawn queue
Up to 10 heroes per viewer and 70 on screen. Everything above that waits its turn instead of being lost.
Monster taming
Defeated monsters can join the heroes' side, so long fights change the balance of the arena.
Live leaderboard
Top viewers ranked by total damage and kills, updating on stream as the fight goes on.
Your own look and sound
Upload background music, sound effects and a custom 1280 x 720 arena background.
Built for long streams
A Web Worker game loop keeps the match alive when the browser is hidden behind OBS.
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
- Step 1
Install Python 3.8+
On Windows, tick Add Python to PATH in the installer. On macOS and Linux, use your package manager.
- Step 2
Extract the files
Unzip the package into a folder such as C:\BattleArena or ~/BattleArena.
- Step 3
Install the dependencies
Open a terminal in the Source folder and run pip install -r requirements.txt.
- Step 4
Start the server
Run python app.py and leave the terminal open. The game is served at localhost:5000.
- 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
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.