Battle Arena Mini Game

TikTok Live Interactive Battle Game - Complete Tutorial & Documentation

A real-time battle arena game that integrates with TikTok Live. Viewers can spawn heroes by sending gifts, and watch them battle against monsters and bandits!

Get Started Visit Arizu Studio

System Requirements

Before installing Battle Arena, make sure your system meets the following requirements.

Hardware Requirements

  • CPU: Dual-core processor or better
  • RAM: 4GB minimum (8GB recommended)
  • Storage: 500MB free space
  • Internet: Stable connection required

Software Requirements

  • Python 3.8 or higher
  • pip (Python package manager)
  • Modern web browser (Chrome, Firefox, Edge)
  • Git (optional, for cloning)

Python Dependencies

Package Version Description
Flask 2.0+ Web framework for the game server
Flask-SocketIO 5.0+ Real-time WebSocket communication
Flask-CORS 3.0+ Cross-origin resource sharing
TikTokLive Latest TikTok Live connection library
python-socketio 5.0+ Socket.IO client/server

Installation Guide

Follow the instructions below based on your operating system.

1

Install Python

Download and install Python from python.org. Make sure to check "Add Python to PATH" during installation.

# Verify Python installation
python --version
pip --version
2

Extract Game Files

Extract the Battle Arena files to your desired location (e.g., C:\Games\BattleArena).

3

Install Dependencies

Open Command Prompt or PowerShell in the game directory and run:

# Navigate to game directory
cd C:\Games\BattleArena

# Install required packages
pip install -r requirements.txt

# Or install TikTok connector separately
INSTALL_TIKTOK.bat
4

Run the Game

Start the game server:

# Start the server
python app.py

# Or use the batch file
START_WEB.bat
The game will be available at http://localhost:5000
1

Update System & Install Python

# Update package list
sudo apt update && sudo apt upgrade -y

# Install Python and pip
sudo apt install python3 python3-pip python3-venv -y

# Verify installation
python3 --version
pip3 --version
2

Extract and Navigate

# Extract files
unzip battle-arena.zip -d ~/BattleArena

# Navigate to directory
cd ~/BattleArena
3

Create Virtual Environment (Recommended)

# Create virtual environment
python3 -m venv venv

# Activate virtual environment
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt
4

Run the Game

# Make sure venv is activated
source venv/bin/activate

# Start the server
python3 app.py
1

Install Python 3

# For CentOS 8/Stream/RHEL 8+
sudo dnf install python3 python3-pip -y

# For CentOS 7
sudo yum install epel-release -y
sudo yum install python3 python3-pip -y

# Verify installation
python3 --version
2

Extract and Setup

# Extract files
unzip battle-arena.zip -d ~/BattleArena
cd ~/BattleArena

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt
3

Configure Firewall (if needed)

# Allow port 5000
sudo firewall-cmd --add-port=5000/tcp --permanent
sudo firewall-cmd --reload
4

Run the Game

source venv/bin/activate
python3 app.py
1

Install Python

# Update system
sudo pacman -Syu

# Install Python
sudo pacman -S python python-pip

# Verify
python --version
2

Setup and Install

# Extract and navigate
unzip battle-arena.zip -d ~/BattleArena
cd ~/BattleArena

# Create venv and install
python -m venv venv
source venv/bin/activate
pip install -r requirements.txt
3

Run the Game

source venv/bin/activate
python app.py
1

Install Dependencies

Kali Linux usually comes with Python pre-installed.

# Update system
sudo apt update && sudo apt upgrade -y

# Install pip if not present
sudo apt install python3-pip python3-venv -y

# Verify
python3 --version
2

Setup Game

# Extract files
unzip battle-arena.zip -d ~/BattleArena
cd ~/BattleArena

# Setup virtual environment
python3 -m venv venv
source venv/bin/activate

# Install requirements
pip install -r requirements.txt
3

Run the Game

source venv/bin/activate
python3 app.py

How to Use

Learn how to configure and use Battle Arena effectively.

1. Configure TikTok

Open the Control Panel at http://localhost:5000/admin and enter your TikTok username to connect.

  • Enter your TikTok username (without @)
  • Click "Connect" to establish connection
  • Make sure you are LIVE on TikTok

2. Open Game Display

Access the game at http://localhost:5000 and use it as a browser source in OBS.

  • Resolution: 1280x720 recommended
  • Use Browser Source in OBS
  • Enable "Control audio via OBS"

3. Gift Mapping

Configure which heroes spawn for each gift in the Gift Mapping Editor.

  • Each gift can spawn multiple hero types
  • Adjust hero count per gift
  • More expensive gifts = stronger heroes

4. Adjust Settings

Customize hero stats, monster stats, audio, and more from the Control Panel.

  • Hero Stats: HP, Damage, Defense
  • Monster Stats: Adjust difficulty
  • Audio: Custom sound effects

Control Panel Features

Game Controls

Reset heroes, trigger events, control music

Manual Spawn

Spawn heroes manually for testing

Gift Simulator

Test gift spawns without TikTok

Important: You must be LIVE on TikTok for the connection to work. The game connects to your live stream to receive gift events.

Game Features

Explore all the features available in Battle Arena.

8 Hero Types

Ninja, Medieval, Arabian, Samurai, Spartan, Persian, Templar, and Mongolian warriors.

Monster Invasion

Periodic monster waves that heroes must defeat. Kill monsters to tame them!

Bandit Waves

Bandit attacks that challenge your heroes. Defeat them for bonus points!

Leaderboard

Real-time leaderboard showing top viewers by damage and kills.

Custom Audio

Upload your own background music and sound effects.

Real-time Sync

Instant synchronization between TikTok gifts and game spawns.

License & Credits

Copyright & License

Battle Arena Mini Game

Copyright © 2024-2026 Arizu Studio. All rights reserved.

Terms of Use

By using this software, you agree to the following terms:

  • This software is provided "AS IS" without warranty of any kind.
  • The developer is not responsible for any damages arising from the use of this software.
  • You are solely responsible for compliance with TikTok's Terms of Service.
  • Redistribution or resale of this software without permission is prohibited.
  • You may modify the software for personal use only.
Disclaimer

Battle Arena is an independent project and is not affiliated with, endorsed by, or sponsored by TikTok or ByteDance. TikTok is a trademark of ByteDance Ltd. Use of TikTok Live features is subject to TikTok's own terms and policies.

Developer Information
Open Source Libraries

This project uses the following open source libraries:

Support

If you need help or have questions:

Contact Support