Tank Royale Battle Viewer

May 24, 2026 · View on GitHub

A web-based viewer for Robocode Tank Royale battles with GPU-accelerated rendering.

What This Is

A passive observer designed for broadcasting battles on a shared display (projector, TV, conference room screen) - giving your audience a polished "live sports broadcast" experience.

This viewer does not control battles. There are no features for starting battles, selecting bots, or managing the server. Use the official Tank Royale GUI (or another controller) on a separate screen for that.

Features

📺 TV broadcast experience - Full-screen, designed for conference rooms and wall displays
🔌 WebSocket connection to Tank Royale server with auto-reconnect
🎮 Real-time battle visualization that keeps up with any server TPS
🚀 GPU-accelerated graphics using PixiJS/WebGL (frees CPU for bots)
🤖 Tank rendering based on the official Robocode GUI style with enhancements
👥 Team support with colored indicators and grouped displays
🏆 Battle results always captured and displayed
📈 Skill ratings - Local skill tracking (OpenSkill or TrueSkill, selectable) with tier badges (Scrap → Legend)
🖼️ Custom arena logo - Upload your own background image
🌓 Light/dark theme - Toggle the surrounding UI between themes; the arena stays dark for broadcast clarity
⚙️ Minimal UI - Settings hidden behind a subtle gear icon

Quick Start

Since this is a static web app running in your browser, you can use it directly at:

https://jandurovec.github.io/tank-royale-viewer/

No installation required - just open the link and connect to your local Tank Royale server.

Local Development

If you want to modify the viewer or run it locally:

Prerequisites

Node.js 22 LTS or later
Tank Royale (for running battles)

Setup

# Clone the repository (the official one or your fork)
git clone https://github.com/jandurovec/tank-royale-viewer.git
cd tank-royale-viewer

# Install dependencies
npm install

# Start development server
npm run dev

Open http://localhost:5173/ in your browser.

Connecting to Tank Royale

Start Tank Royale GUI:

java -jar robocode-tankroyale-gui-x.y.z.jar

The server starts automatically on ws://localhost:7654
Open the viewer - it connects automatically to the default URL
Start a battle in the Tank Royale GUI
Watch the battle in the viewer!

Usage

The viewer is designed for full-screen presentation with minimal UI.

Settings (Gear Icon)

Click the subtle gear icon in the top-right corner to access:

Server URL: WebSocket URL of the Tank Royale server (default: ws://localhost:7654)
Secret: Optional authentication secret if server has secrets enabled
Arena logo: Upload a custom background image with adjustable opacity and size
Skill ratings: Toggle display, choose rating algorithm (OpenSkill or TrueSkill), configure thresholds, export/import/reset ratings