Setup & Requirements
Do I need programming or coding knowledge to set up Battle Arena?
No coding required for basic setup. The package includes a step-by-step installation guide. You'll need to run a few terminal commands to install Python dependencies (pip install -r requirements.txt) and start the server — but no code editing is needed to get the game running out of the box.
What are the system requirements?
You need a computer or VPS running Python 3.9+ and a modern browser (Chrome recommended). Minimum specs: 2GB RAM, dual-core CPU. For streaming, a 4-core CPU and 4GB RAM is recommended so the game and OBS don't compete for resources.
Does it work on Windows, Mac, and Linux?
Yes. Battle Arena is a Python Flask application that runs on any OS that supports Python 3.9+. It has been tested on Windows 10/11, Ubuntu 22.04, and macOS 13+. You can also deploy it to a Linux VPS so you don't need to keep a local machine running during streams.
Does it work with OBS as a Browser Source?
Yes — this is the intended workflow. Add the game URL as a Browser Source in OBS at 1280×720. The game uses a Web Worker and AudioContext keepalive to stay fully active even when the browser window is not focused, so animations never freeze during your stream.
Can I host it on a VPS or cloud server?
Yes. Deploying to a VPS (e.g., DigitalOcean, Linode, Hetzner) is recommended for serious streamers. The Flask server runs behind Nginx or Apache, and you can use gunicorn with eventlet for production-grade WebSocket support. Basic deployment instructions are included.
TikTok Integration
Do I need a large following to use Battle Arena?
No minimum follower count is required to run the game itself. However, TikTok may require your account to meet certain criteria (typically 1,000+ followers) to access the Gift feature during Lives. Check TikTok's current live gifting policy for your region.
Which TikTok gifts trigger hero spawns?
Over 400 TikTok gifts are pre-mapped out of the box. Each gift's coin value determines which hero spawns — cheaper gifts spawn weaker heroes (Black Ninja at 1 coin), expensive gifts spawn elite heroes (Mongolian Archer at 1,000+ coins). You can customize these mappings in the admin panel.
What happens if TikTok's API changes?
Battle Arena connects to TikTok Live using the open-source TikTokLive Python library. If TikTok makes breaking changes, the community typically releases an updated version of the library within days. You can update it with pip install --upgrade TikTokLive. We also monitor this and push updates when needed.
Game & Customization
Can I customize gift-to-hero mappings?
Yes. The admin control panel lets you reassign which gift spawns which hero, adjust spawn counts, and fine-tune thresholds. Advanced users can also edit the gift_map.json config file directly. Changes take effect without restarting the server.
How many heroes can be on screen at the same time?
The default cap is 70 heroes on screen simultaneously. This is configurable in the admin panel under "Performance Settings". Lowering it helps on slower machines; the game automatically prioritizes higher-tier heroes when the cap is reached.
Can I add custom heroes or characters?
Yes. Battle Arena uses a plugin-based hero system. Each hero is a folder containing a sprite sheet, a hero.json config, and an optional logic.js file for special abilities. You can add entirely new heroes by following the same structure — no changes to the core engine needed.
Can I upload a custom arena background?
Yes. Version 2.0 added background image upload from the admin panel. Upload any PNG at exactly 1280×720 px and it replaces the arena background instantly — no page reload needed for viewers already watching. The admin panel validates the dimensions before accepting the upload.
Do all heroes have unique abilities?
Yes. All 8 heroes have fully coded ultimate abilities that activate at 30% energy: Black Ninja (homing shurikens), Medieval Troops (shadow clones), Arabian (sandstorm debuff aura), Samurai (AoE sword slash), Spartan (Battle Rage — +50% DMG/DEF), Persian (poison aura), Knight Templar (Divine Shield — +100% DEF), Mongolian (6-arrow burst).
Purchase & License
Is this a one-time payment or a subscription?
One-time payment of $37. No monthly fees, no subscription. You own the code outright. Future updates are delivered free through your Envato/CodeCanyon account.
Does the purchase include future updates?
Yes. All future updates are free and available to download directly from your CodeCanyon account under "Downloads". When a new version is released, you'll get an email notification from Envato.
Can I use Battle Arena commercially on my stream?
Yes. The Regular License permits commercial use — you can use Battle Arena on your own TikTok streams, including monetized streams where viewers send gifts. You may not resell the software itself or bundle it into a product sold to others; that would require an Extended License.
What support is included?
Your purchase includes 6 months of item support via CodeCanyon's support system. Support covers installation help, bug reports, and clarification questions. For faster response, you can also reach us via WhatsApp or email — contact details are in the documentation.
