Skip to content

0.35.2

Choose a tag to compare

View all tags
@github-actions github-actions released this 28 Jan 19:20
· 100 commits to main since this release
v0.35.2
0a78833

📦 0.35.2 - Windows Path Fix – 28-Jan-2026

🐞 Bug Fixes

  • GUI:
    • Fixed InvalidPathException on Windows when bot directories contained backslashes. Windows paths like
      C:\robocode\bots\python were being corrupted because backslash sequences (e.g., \r, \b) were interpreted
      as escape characters when saved to the properties file. Bot directory paths are now normalized to use forward
      slashes, which work correctly on all platforms.

🚀 Quick Start

New to Robocode Tank Royale? Follow these steps to get started:

  1. Install Java 11 or newer – Required to run Robocode
  2. Download and install the GUI – Choose between native installer or JAR file (see below)
  3. Download sample bots – Get pre-built bots to try out immediately
  4. Run your first battle – Launch the GUI and start battling!

For detailed guidance, see the Getting Started guide and My First Bot tutorial.

📄 Documentation

The complete Robocode Tank Royale documentation is available at:
https://robocode-dev.github.io/tank-royale/

Recommended reading order:

🛠 Installing Robocode

Requirements

  • Java 11 or newer is required to run Robocode Tank Royale
  • We recommend using the latest Java version for best performance
  • Download Java from the official Oracle website or use OpenJDK

📖 See the installation guide for detailed instructions on installing Java and setting up Robocode.

Choose Your Installation Method

You have two options to install and run the Robocode GUI:

  1. Native Installers (Recommended) – Installs as a native application with desktop shortcuts
  2. Portable JAR File – Run directly from the command line without installation

Both options require Java 11 or newer.

Option 1: Native Installers (Recommended)

Native installers provide the easiest installation experience. The GUI will be registered with your operating system,
allowing you to launch it from your application menu or desktop shortcut.

Download for your platform:

Platform Installer
🪟 Windows robocode-tank-royale-gui-0.35.2.msi
🍎 macOS robocode-tank-royale-gui-0.35.2.pkg
🐧 Linux robocode-tank-royale-gui-0.35.2.rpm (RPM) / robocode-tank-royale-gui-0.35.2.deb (DEB)

System Requirements:

⚠️ Important: Unsigned Installers

The native installers are not code-signed with platform certificates. This is normal for open-source projects.
Your operating system may display security warnings when installing — see the instructions below for your platform.

You can verify installer authenticity using the SHA256SUMS and SHA256SUMS.asc files provided with this release.

Installation Steps:

🪟 Windows (MSI)
  1. Download the .msi file
  2. Double-click to run the installer
  3. If Windows SmartScreen appears ("Windows protected your PC"):
    • Click "More info"
    • Click "Run anyway"
  4. If prompted by User Account Control (UAC), click "Yes"
  5. Follow the installation wizard
🍎 macOS (PKG)
  1. Download the .pkg file
  2. Double-click to run the installer
  3. If macOS Gatekeeper blocks it ("cannot be opened because it is from an unidentified developer"):
    • Open System Settings → Privacy & Security
    • Scroll down and click "Open Anyway" next to the blocked installer
    • Or: Right-click the .pkg file and select "Open", then click "Open" in the dialog
    • Or: Run in Terminal: xattr -d com.apple.quarantine robocode-tank-royale-gui-0.35.2.pkg
  4. Enter your administrator password when prompted
  5. Follow the installation wizard
🐧 Linux (RPM/DEB)

RPM (Fedora/CentOS/RHEL):

sudo dnf install ./robocode-tank-royale-gui-0.35.2.x86_64.rpm
# or
sudo rpm -ivh robocode-tank-royale-gui-0.35.2.x86_64.rpm

DEB (Debian/Ubuntu):

sudo apt install ./robocode-tank-royale-gui_0.35.2_amd64.deb
# or
sudo dpkg -i robocode-tank-royale-gui_0.35.2_amd64.deb

Note: Linux packages may show warnings about being unsigned. This is normal for community-distributed software.

After installation, find Robocode Tank Royale GUI in your application menu/launcher and start battling!

Option 2: Portable JAR File

For users who prefer a portable installation or want more control, you can download the GUI as a standalone JAR file.

Download:

Platform Download
All robocode-tankroyale-gui-0.35.2.jar

System Requirements:

  • Java 11 or newer must be installed and available on your system PATH

Running the GUI:

Open a terminal (or command prompt on Windows) and run:

java -jar robocode-tankroyale-gui-0.35.2.jar

💡 Pro Tips for Better Organization:

Create a dedicated directory for Robocode (e.g., C:\Robocode or ~/Robocode) and place the JAR file there. Then
create a launcher script for easy access:

Windows (run-robocode.bat):

@echo off
java -jar robocode-tankroyale-gui-0.35.2.jar

Linux/macOS (run-robocode.sh):

#!/bin/sh
java -jar robocode-tankroyale-gui-0.35.2.jar

Make the script executable on Linux/macOS:

chmod +x run-robocode.sh

Why use a dedicated directory?

  • Robocode automatically creates configuration files in the same directory as the JAR
  • Makes it easy to manage settings, logs, and optional resources (like the sounds/ folder)
  • Keeps your system organized with all Robocode files in one place

For more details on using the GUI, see the GUI documentation.

🤖 Sample Bots

To start battling immediately, download pre-built sample bots. These bots demonstrate different strategies and
programming styles.

How to install sample bots:

  1. Download the sample bots archive for your preferred language(s)
  2. Extract the archive to a directory on your system (e.g., C:\Robocode\bots\python or ~/robocode/bots/python)
  3. In the GUI, go to Config → Bot Root Directories and add the extracted directory
  4. The bots will now appear in your bot list!

Available sample bots:

Language Download Requirements
🐍 Python sample-bots-python-0.35.2.zip Python 3.10 or newer
🔷 C# sample-bots-csharp-0.35.2.zip Microsoft .NET SDK 8 or newer
☕ Java sample-bots-java-0.35.2.zip Any Java SDK 11 or newer

📝 Each archive contains a README.md file with platform-specific instructions.

📦 Bot API

Ready to develop your own bots? Choose your preferred programming language and install the corresponding Bot API.

🐍 Python

Install via pip:

pip install robocode-tank-royale==0.35.2

Or download from Python Package Index (PyPI)

☕ Java

Option 1: Maven (recommended)
Add to your pom.xml:

<dependency>
    <groupId>dev.robocode.tankroyale</groupId>
    <artifactId>robocode-tankroyale-bot-api</artifactId>
    <version>0.35.2</version>
</dependency>

Option 2: Gradle
Add to your build.gradle:

implementation 'dev.robocode.tankroyale:robocode-tankroyale-bot-api:0.35.2'

Option 3: Direct JAR download

🔷 .NET (C#, F#, VB.NET)

Install via NuGet Package Manager:

dotnet add package Robocode.TankRoyale.BotApi --version 0.35.2

Or browse: NuGet repository

🔊 Sound Effects

Enhance your Robocode experience with sound effects! Sound files are available separately from the main distribution.

Download: Sounds Repository

Installation:

  1. Visit the sounds repository linked above
  2. Follow the installation instructions to place the sounds/ directory in the correct location relative to your GUI
    installation
  3. Restart the GUI to enable sound effects

Sounds include gunshots, explosions, collisions, and more!

📚 Additional Resources

Assets 13
Loading