0.35.3

📦 0.35.3 - Memory Leak Fixes – 08-Feb-2026

🐞 Bug Fixes

• Server:
  • #180: Fixed critical memory leak where NanoTimer created a new thread for every turn (37M threads over 21 hours
    at 500 TPS), causing OutOfMemoryError. Replaced with ResettableTimer that reuses a single thread via
    ScheduledExecutorService.
  • #180: Fixed the memory leak from unbounded game history accumulation. Now limits turn history to last 2 turns and
    clears old rounds, reducing memory footprint from gigabytes to megabytes during long games.
  • #180: Fixed memory leak from collections not being cleared after the game end (participantIds, botIntents,
    participantMap, etc.), preventing garbage collection of game objects.

🚀 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/

📖 The Book of Robocode: book.robocode.dev – Comprehensive guide with
advanced strategies for Tank Royale like wave surfing, guess-factor targeting, and movement techniques.

Recommended reading order:

• [Getting Started] – Learn the basics
• [Installation guide] – Detailed setup instructions
• [My First Bot tutorial] – Build your first bot
• [GUI documentation] – Master the user interface

---

🛠 Installing Robocode

Requirements

• Java 11 or newer is required to run Robocode Tank Royale
• We recommend using the latest Java version for the 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.3.msi]
🍎 macOS	[robocode-tank-royale-gui-0.35.3.pkg]
🐧 Linux	[robocode-tank-royale-gui-0.35.3.rpm] (RPM) / [robocode-tank-royale-gui-0.35.3.deb] (DEB)

System Requirements:

• Java 11 or newer must be installed
• The JAVA_HOME environment variable must be set to your Java installation directory
  • Need help? Read this article from Baeldung:
    How to Set JAVA_HOME on Windows, macOS, and Linux

⚠️ 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.3.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.3.x86_64.rpm
# or
sudo rpm -ivh robocode-tank-royale-gui-0.35.3.x86_64.rpm

DEB (Debian/Ubuntu):

sudo apt install ./robocode-tank-royale-gui_0.35.3_amd64.deb
# or
sudo dpkg -i robocode-tank-royale-gui_0.35.3_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.3.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.3.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.3.jar

Linux/macOS (run-robocode.sh):

#!/bin/sh
java -jar robocode-tankroyale-gui-0.35.3.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.3.zip]	[Python] 3.10 or newer
🔷 C#	[sample-bots-csharp-0.35.3.zip]	Microsoft [.NET SDK] 8 or newer
☕ Java	[sample-bots-java-0.35.3.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.3

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.3</version>
</dependency>

Option 2: Gradle
Add to your build.gradle:

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

Option 3: Direct JAR download

• Download: [robocode-tankroyale-bot-api-0.35.3.jar]
• Or
  browse: Maven Central Repository

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

Install via NuGet Package Manager:

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

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 `so...

0.35.2

📦 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:

• [Getting Started] – Learn the basics
• [Installation guide] – Detailed setup instructions
• [My First Bot tutorial] – Build your first bot
• [GUI documentation] – Master the user interface

---

🛠 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:

• Java 11 or newer must be installed
• The JAVA_HOME environment variable must be set to your Java installation directory
  • Need help? Read this article from Baeldung:
    How to Set JAVA_HOME on Windows, macOS, and Linux

⚠️ 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

• Download: [robocode-tankroyale-bot-api-0.35.2.jar]
• Or
  browse: Maven Central Repository

🔷 .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

• GitHub Repository: robocode-dev/tank-royale
• Issue Tracker: Report bugs or request features
• Documentation: [Complete documentation site](https://robocode-dev...

0.35.1

📦 0.35.1 - Automatic User Data Migration – 27-Jan-2026

🚀 Improvements

• GUI:
  • Added automatic migration of user data files (gui.properties, server.properties, game-setups.properties,
    and recordings/ directory) from the old location (current working directory or JAR location) to the new
    platform-specific user data directory. This removes the need for manual file migration when upgrading from
    pre-0.35.0 versions.

🚀 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:

• [Getting Started] – Learn the basics
• [Installation guide] – Detailed setup instructions
• [My First Bot tutorial] – Build your first bot
• [GUI documentation] – Master the user interface

---

🛠 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.1.msi]
🍎 macOS	[robocode-tank-royale-gui-0.35.1.pkg]
🐧 Linux	[robocode-tank-royale-gui-0.35.1.rpm] (RPM) / [robocode-tank-royale-gui-0.35.1.deb] (DEB)

System Requirements:

• Java 11 or newer must be installed
• The JAVA_HOME environment variable must be set to your Java installation directory
  • Need help? Read this article from Baeldung:
    How to Set JAVA_HOME on Windows, macOS, and Linux

⚠️ 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.1.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.1.x86_64.rpm
# or
sudo rpm -ivh robocode-tank-royale-gui-0.35.1.x86_64.rpm

DEB (Debian/Ubuntu):

sudo apt install ./robocode-tank-royale-gui_0.35.1_amd64.deb
# or
sudo dpkg -i robocode-tank-royale-gui_0.35.1_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.1.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.1.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.1.jar

Linux/macOS (run-robocode.sh):

#!/bin/sh
java -jar robocode-tankroyale-gui-0.35.1.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.1.zip]	[Python] 3.10 or newer
🔷 C#	[sample-bots-csharp-0.35.1.zip]	Microsoft [.NET SDK] 8 or newer
☕ Java	[sample-bots-java-0.35.1.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.1

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.1</version>
</dependency>

Option 2: Gradle
Add to your build.gradle:

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

Option 3: Direct JAR download

• Download: [robocode-tankroyale-bot-api-0.35.1.jar]
• Or
  browse: Maven Central Repository

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

Install via NuGet Package Manager:

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

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

• GitHub Repository: robocode-dev/tank-royale
• Issue Tracker: Report bugs or request features
• Documentation: [Complete documentation site](https://robocode-dev.github.io/...

0.35.0

📦 0.35.0 - BREAKING: Python Bot API Converted to Synchronous API & Refactored to Use Properties - 26-Jan-2026

💥 Breaking Changes (Python Bot API)

The Python Bot API has been refactored to match Java and .NET:

1. Async → Sync: Converted from async/await to synchronous blocking API
2. Properties: Replaced getter/setter methods with Pythonic property accessors
3. Typed Team Messages: Use @team_message_type decorator for automatic serialization

Quick Migration

Before (0.34.x)	After (0.35.0)
async def run(self):	def run(self):
await self.forward(100)	self.forward(100)
asyncio.run(bot.start())	bot.start()
self.get_energy()	self.energy
self.is_running()	self.running
self.set_adjust_gun_for_body_turn(True)	self.adjust_gun_for_body_turn = True

Full migration guide: See the MyFirstBot sample bots
and Team Messages article.

🚀 Improvements

• Python Bot API: Synchronous API with property accessors, typed team messages with Color serialization
• Bot Events Panel: Optimized logging, improved formatting with ANSI colors, grouped bulletStates
• Recordings: Now saved to recordings subdirectory in user data directory
• Build: Replaced Proguard with R8 for code shrinking

🐞 Bug Fixes

• Bot API (Java, C#/.NET, Python):

  • Fixed a bug where the user's OnDeath callback would not be called when the bot dies. The internal death handler
    was stopping the bot thread before the event queue could dispatch the DeathEvent to user callbacks.
    Now the OnDeath handler is subscribed to public event handlers with priority 0 (lower than user's default of 1),
    ensuring user's OnDeath callback runs before the thread is stopped.

• GUI:

  • Improved performance of the bot console and server log windows under heavy logging.
  • Added batched updates to reduce UI freezes when bots or the server produce a high volume of output.
  • Introduced bounded retention to prevent the console from consuming too much memory and becoming slow over
    time.
  • Added a new configuration setting console-max-characters (default: 10,000) to control the maximum amount of
    text retained in each console window.
    • How to configure:
      • Open the Config -> GUI Options menu in the GUI.
      • Adjust the Console max characters value and click OK to save.

🚀 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:

• [Getting Started] – Learn the basics
• [Installation guide] – Detailed setup instructions
• [My First Bot tutorial] – Build your first bot
• [GUI documentation] – Master the user interface

---

🛠 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.0.msi]
🍎 macOS	[robocode-tank-royale-gui-0.35.0.pkg]
🐧 Linux	[robocode-tank-royale-gui-0.35.0.rpm] (RPM) / [robocode-tank-royale-gui-0.35.0.deb] (DEB)

System Requirements:

• Java 11 or newer must be installed
• The JAVA_HOME environment variable must be set to your Java installation directory
  • Need help? Read this article from Baeldung:
    How to Set JAVA_HOME on Windows, macOS, and Linux

⚠️ 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.0.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.0.x86_64.rpm
# or
sudo rpm -ivh robocode-tank-royale-gui-0.35.0.x86_64.rpm

DEB (Debian/Ubuntu):

sudo apt install ./robocode-tank-royale-gui_0.35.0_amd64.deb
# or
sudo dpkg -i robocode-tank-royale-gui_0.35.0_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.0.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.0.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.0.jar

Linux/macOS (run-robocode.sh):

#!/bin/sh
java -jar robocode-tankroyale-gui-0.35.0.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 |
|---------------|------------------------------------|-----------------------------...

0.34.2

📦 0.34.2 - Added native installer packages for GUI – 25-Dec-2025

Native installer packages for the GUI have been added for Windows, Linux, and macOS. These packages might still be early
days. If you find any issues, please report them on the
issue tracker.
These packages still require Java 11 or higher to be installed on your system, but they make it easier to install,
uninstall, and run Robocode Tank Royale.
You can still download the JAR version as usual, which works on all platforms with Java 11 or higher installed.

🔧 Changes

• Replaced Picocli for Clikt for the server, booter, and recorder.

🐞 Bug Fixes

• #178: Fix .sh scripts to use java instead of javaw
• Fixed a major bug with the Server, Booter, and Recorder where the application ran when --info or --help was passed
  as a command line argument.

🚀 Improvements

• Bot API for C#/.NET:

  • Updated to the newest dependencies.

• GUI:

  • Added native installer packages for the GUI (Windows MSI, macOS PKG, Linux RPM, and DEB).
    • Note: Java 11+ is required and the runtime must be discoverable via the JAVA_HOME environment variable. See
      the installation documentation for platform-specific instructions.
  • Settings are now stored in platform-specific user directories to avoid permission issues:
    • Windows: %LOCALAPPDATA%\Robocode Tank Royale or %APPDATA%\Robocode Tank Royale
    • macOS: ~/Library/Application Support/Robocode Tank Royale
    • Linux: $XDG_CONFIG_HOME/robocode-tank-royale or ~/.config/robocode-tank-royale
  • You need to move your gui.properties, server.properties, game-setups.properties and the recordings
    directory into the new user data directory for the GUI.
  • Added jlink runtime image creation for Windows installers to avoid "Failed to launch VM" issues on some machines.

🚀 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:

• [Getting Started] – Learn the basics
• [Installation guide] – Detailed setup instructions
• [My First Bot tutorial] – Build your first bot
• [GUI documentation] – Master the user interface

---

🛠 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.34.2.msi]
🍎 macOS	[robocode-tank-royale-gui-0.34.2.pkg]
🐧 Linux	[robocode-tank-royale-gui-0.34.2.rpm] (RPM) / [robocode-tank-royale-gui-0.34.2.deb] (DEB)

System Requirements:

• Java 11 or newer must be installed
• The JAVA_HOME environment variable must be set to your Java installation directory
  • Need help? Read this article from Baeldung:
    How to Set JAVA_HOME on Windows, macOS, and Linux

⚠️ 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.34.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.34.2.x86_64.rpm
# or
sudo rpm -ivh robocode-tank-royale-gui-0.34.2.x86_64.rpm

DEB (Debian/Ubuntu):

sudo apt install ./robocode-tank-royale-gui_0.34.2_amd64.deb
# or
sudo dpkg -i robocode-tank-royale-gui_0.34.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.34.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.34.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.34.2.jar

Linux/macOS (run-robocode.sh):

#!/bin/sh
java -jar robocode-tankroyale-gui-0.34.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.34.2.zip]	[Python] 3.10 or newer
🔷 C#	[sample-bots-csharp-0.34.2.zip]	Microsoft [.NET SDK] 8 or newer
☕ Java	[sample-bots-java-0.34.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.34.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.34.2</version>
</dependency>

...

0.34.1

📦 0.34.1 - Fixes on_death in Python Bot API and GUI improvements – 14-Nov-2025

🚀 Improvements

• GUI

  • #174: Prevent overwriting UI scale property (sun.java2d.uiScale) for high DPI displays if already set (via
    command line). Thanks goes to David Martinez Peña 👍
    • Fixed for the sun.java2d.d3d and sun.java2d.opengl as well.

• Updated the devcontainer so it uses the current and full tech stack necessary to build all of Robocode Tank Royale.

🐞 Bug Fixes

• Bot API for Python:
  • The on_death() event handler is now called when the bot dies.

📄 Documentation

You find the Robocode Tank Royale documentation here. You
should start out by reading Getting Started first.

🔨 Try it out

Please head over to My First Bot tutorial to learn how to set up your first bot for Robocode Tank Royale.

🛠 Installing Robocode

You need Java 11 as a minimum or newer, e.g. the newest version of Java available.

You can read the installation guide to get more details about installing both Java and Robocode.

▶ Running Robocode

The main application is the GUI which is a Java application. You can read about how to use the
GUI here.

The Robocode GUI is run from the command line (shell or command prompt) in order to start and view
battles:

java -jar robocode-tankroyale-gui-0.34.1.jar

🤖 Sample bots

If you are new to Robocode, you need to download some bots and extract those to directories on your system.
These bot directories can be added from the menu of the GUI: Config → Bot Root Directories

These sample bots are currently available:

Platform	Archive	Requirements
Python	sample-bots-python-0.34.1.zip	Python 3.10 or newer
C#	sample-bots-csharp-0.34.1.zip	Microsoft .NET SDK 8 or newer
Java	sample-bots-java-0.34.1.zip	Any Java SDK 11 or newer

All bots are put in zip archives, which should be installed in independent directories.
Each zip archive contains a ReadMe.md file with more information for the specific platform.

📦 Bot API

In order to start developing bots for Robocode, the following APIs are available.

📦 Python:

Available as:

• Python package at the Python Package Index (PyPI)

📦 Java:

Available as:

• Jar file: robocode-tankroyale-bot-api-0.34.1.jar
• Maven package at
  the Maven Central Repository

📦 .NET:

Available as:

• NuGet package at the NuGet repository

0.34.0

📦 0.34.0 – Python Support + GUI Improvements – 19-Oct-2025

The Python Bot API, sample bots, and documentation are now complete. 🎉
We also added Spanish, Catalan/Valencian, and Danish translations. New translations are always welcome!
Additionally, we introduced UI improvements such as UI scaling and a volume slider in the options.

🚀 Improvements

• Bot API

  • #128: Python Bot API + sample bots.
    • A huge thank-you, Yang Li for the tremendous effort in making this a reality! ❤️
  • .NET version has been updated to .NET 8 and C# 12.

• GUI

  • #168: Added GUI Options dialog with a UI scale setting (100%, 125%, 150%, 175%, 200%, 250%, 300%).
  • #168: Applied full-UI HiDPI scaling using the JVM property sun.java2d.uiScale, based on the saved setting.
    • Thanks to David Martinez Peña for proposing the solution that made this possible. 💪
  • Added volume slider in the Sound Options dialog.
  • #169: Added Spanish and Catalan/Valencian translations.
    • Thank you, David Martinez Peña, for contributing the first translations ever—and for helping test the Python API! ❤️
  • Added Danish translations as well.
  • Added an option to switch between Spanish, English, and Danish in the GUI Options dialog.

📄 Documentation

You find the Robocode Tank Royale documentation here. You
should start out by reading Getting Started first.

🔨 Try it out

Please head over to My First Bot tutorial to learn how to set up your first bot for Robocode Tank Royale.

🛠 Installing Robocode

You need Java 11 as a minimum or newer, e.g. the newest version of Java available.

You can read the installation guide to get more details about installing both Java and Robocode.

▶ Running Robocode

The main application is the GUI which is a Java application. You can read about how to use the
GUI here.

The Robocode GUI is run from the command line (shell or command prompt) in order to start and view
battles:

java -jar robocode-tankroyale-gui-0.34.0.jar

🤖 Sample bots

If you are new to Robocode, you need to download some bots and extract those to directories on your system.
These bot directories can be added from the menu of the GUI: Config → Bot Root Directories

These sample bots are currently available:

Platform	Archive	Requirements
Python	sample-bots-python-0.34.0.zip	Python 3.10 or newer
C#	sample-bots-csharp-0.34.0.zip	Microsoft .Net SDK 8 or newer
Java	sample-bots-java-0.34.0.zip	Any Java SDK 11 or newer

All bots are put in zip archives, which should be installed in independent directories.
Each zip archive contains a ReadMe.md file with more information for the specific platform.

📦 Bot API

In order to start developing bots for Robocode, the following APIs are available.

📦 Python:

Available as:

• Python package at the Python Package Index (PyPI)

📦 Java:

Available as:

• Jar file: robocode-tankroyale-bot-api-0.34.0.jar
• Maven package at the Maven Central Repository

📦 .Net:

Available as:

• NuGet package at the NuGet repository

0.33.1

📦 0.33.1 - Fixes for Recording and Replays - 08-Sep-2025

🐞 Bug Fixes

• Maven Central:
  • Fixed the names of the artifacts in the Maven Central repository, which were lacking the robocode-tankroyale
    prefix.
• GUI:
  • #162: Corrected the order of death indicators (skulls) to accurately reflect in-game events.
  • Auto-Record Bug Fix: Resolved an issue where battles were still being recorded after disabling the auto-record
    feature.

🚀 Improvements

• GUI:
  • #165: Enhanced "🔴REC" Indicator: Improved the visual design of the recording indicator for better clarity and user
    experience.

📄 Documentation

You find the Robocode Tank Royale documentation here. You should start out by reading Getting Started first.

🔨 Try it out

Please head over to My First Bot tutorial to learn how to set up your first bot for Robocode Tank Royale.

🛠 Installing Robocode

You need Java 11 as a minimum or newer, e.g. the newest version of Java available.

You can read the installation guide to get more details about installing both Java and Robocode.

▶ Running Robocode

The main application is the GUI which is a Java application. You can read about how to use the GUI here.

The Robocode GUI is run from the command line (shell or command prompt) in order to start and view
battles:

java -jar robocode-tankroyale-gui-0.33.1.jar

🤖 Sample bots

If you are new to Robocode, you need to download some bots and extract those to directories on your system.
These bot directories can be added from the menu of the GUI: Config → Bot Root Directories

These sample bots are currently available:

Platform	Archive	Requirements
C#	sample-bots-csharp-0.33.1.zip	Microsoft .Net SDK 6.0 or newer
Java	sample-bots-java-0.33.1.zip	Any Java SDK 11 or newer

All bots are put in zip archives, which should be installed in independent directories.
Each zip archive contains a ReadMe.md file with more information for the specific platform.

📦 Bot API

In order to start developing bots for Robocode, the following APIs are available.

📦 Java:

Available as:

• Jar file: robocode-tankroyale-bot-api-0.33.1.jar
• Artifact at Maven Central Repository

📦 .Net:

Available as:

• Artifact at Nuget repository

0.33.0

📦 0.33.0 - Added Recording and Replays - 06-Sep-2025

This version adds support for recording and replaying battles (#55: Game replays). All credits go
to Jan Durovec for implementing this cool feature! 🤩

The new recording and replay functionality allows you to:

• Record battles and save them for later replay
• View the replay timeline and seek to specific points in time
• See skull markers on the timeline indicating when bots were killed
• Study the standard output from bots in their console windows
• Inspect bot properties and events at any point during the battle

This feature is particularly useful for:

• Debugging bot behavior
• Analyzing past battles in detail
• Learning from recorded matches

🚀 Improvements

• Server and GUI:

  • Add support for enabling/disabling server secrets in GUI and server. Server secrets will be disabled by default.
    In earlier versions, the server secrets were enabled by default, which could be annoying when you want to test
    your bots without having to worry about the server secrets.

• Recorder:

  • #55: A new recorder application was added, which is a command-line tool for recording battles.

• GUI:

  • #159: Replay feature added.
  • #160: Added replay timeline and allow seeking.
  • #161: Updated round/turn indicator in the arena panel.

⚠️ Breaking Changes

• GUI:
  • The GUI configuration file has been renamed from config.properties to gui.properties. If you have a local
    config.properties, rename it to gui.properties to retain your settings.
  • The game type setup file has been renamed from games.properties to game-setups.properties. Rename your
    existing file to game-setups.properties to preserve custom setups.

🐞 Bug Fixes

• Server, Booter, Recorder:

  • Got rid of WARNING: A restricted method in java.lang.System has been called when running with Java 22 or later.

• Booter:

  • Bots could not be booted on Linux. Thanks goes to Yang Li for fixing this. ❤️

📄 Documentation

You find the Robocode Tank Royale documentation here. You should start out by reading Getting Started first.

🔨 Try it out

Please head over to My First Bot tutorial to learn how to set up your first bot for Robocode Tank Royale.

🛠 Installing Robocode

You need Java 11 as a minimum or newer, e.g. the newest version of Java available.

You can read the installation guide to get more details about installing both Java and Robocode.

▶ Running Robocode

The main application is the GUI which is a Java application. You can read about how to use the GUI here.

The Robocode GUI is run from the command line (shell or command prompt) in order to start and view
battles:

java -jar robocode-tankroyale-gui-0.33.0.jar

🤖 Sample bots

If you are new to Robocode, you need to download some bots and extract those to directories on your system.
These bot directories can be added from the menu of the GUI: Config → Bot Root Directories

These sample bots are currently available:

Platform	Archive	Requirements
C#	sample-bots-csharp-0.33.0.zip	Microsoft .Net SDK 6.0 or newer
Java	sample-bots-java-0.33.0.zip	Any Java SDK 11 or newer

All bots are put in zip archives, which should be installed in independent directories.
Each zip archive contains a ReadMe.md file with more information for the specific platform.

📦 Bot API

In order to start developing bots for Robocode, the following APIs are available.

📦 Java:

Available as:

• Jar file: robocode-tankroyale-bot-api-0.33.0.jar
• Artifact at Maven Central Repository

📦 .Net:

Available as:

• Artifact at Nuget repository

0.32.1

📦 0.32.1 - No need of default constructor - 01-Jul-2025

🚀 Improvements

• Bot API:
  • The BaseBot() constructor (instead of Bot() constructor) now automatically searches for the bot config file ( .json) and falls back on using environment variables if the config file could not be found.
  • The sample bots could not start up due to this issue.

🐞 Bug Fixes

• Booter
  • Fixed the escaping issue with double backslash characters.
• Sample Bot:
  • Fixed a bug in TrackFire.cs where the turret misaligned while attempting to lock onto a target, causing it to oscillate erratically during target acquisition.

📄 Documentation

You find the Robocode Tank Royale documentation here. You should start out by reading Getting Started first.

🔨 Try it out

Please head over to My First Bot tutorial to learn how to set up your first bot for Robocode Tank Royale.

🛠 Installing Robocode

You need Java 11 as a minimum or newer, e.g. the newest version of Java available.

You can read the installation guide to get more details about installing both Java and Robocode.

▶ Running Robocode

The main application is the GUI Application which is a Java application. You can read about how to use the GUI Application here.

The Robocode GUI application is run from the command line (shell or command prompt) in order to start and view
battles:

java -jar robocode-tankroyale-gui-0.32.1.jar

🤖 Sample bots

If you are new to Robocode, you need to download some bots and extract those to directories on your system.
These bot directories can be added from the menu of the GUI: Config → Bot Root Directories

These sample bots are currently available:

Platform	Archive	Requirements
C#	sample-bots-csharp-0.32.1.zip	Microsoft .Net SDK 6.0 or newer
Java	sample-bots-java-0.32.1.zip	Any Java SDK 11 or newer

All bots are put in zip archives, which should be installed in independent directories.
Each zip archive contains a ReadMe.md file with more information for the specific platform.

📦 Bot API

In order to start developing bots for Robocode, the following APIs are available.

📦 Java:

Available as:

• Jar file: robocode-tankroyale-bot-api-0.32.1.jar
• Artifact at Maven Central Repository

📦 .Net:

Available as:

• Artifact at Nuget repository