0.31.0

[flemming-n-larsen]

📦 0.31.0 - Improved Graphical Debugging - 19-Jun-2025

⚠️ Breaking Changes

Bot API Updates

If you are using Color and the getGraphics() method or Graphics property, you may need to update your bot(s).

Changes Implemented:

• Platform-specific graphics classes and external graphics libraries, such as those for SVG, have been replaced with the following classes:
  • IGraphics
  • SvgGraphics
  • Color
  • Point

Reasons for Changes:

• Simplify the development and maintenance of the debugging graphics feature.
• Avoid using platform-specific features and frameworks that are not compatible across all platforms and operating systems.
• Enhance the speed of SVG serialization, reduce RAM usage, and decrease distribution archive sizes.
• Standardize the API for debug painting across all Bot APIs (Java, .Net, Python, etc.).

Specific Updates:

• Java: A new package dev.robocode.tankroyale.botapi.graphics has been introduced.
• .Net: A new namespace Robocode.TankRoyale.BotApi.Graphics has been introduced.

Additional Information:

• Sample bots have been updated to use the new classes.

🐞 Bug Fixes

• BotAPI:
  • .NET bot fails to start with no or invalid country code #143: .NET bot fails to start with no or invalid country code.
  • .NET bots run only on Windows since 0.30.0 #144: .NET bots run only on Windows since 0.30.0.
    • SvgNet requires System.Drawing, which is not available on Linux and macOS. Hence, the new Robocode specific IGraphics interface must be used instead.
  • Fixed the generated bot Bash scripts for .Net so dotnet build will be called if the bin folder is missing.
• GUI:
  • Fixed multiple issues with the "No bot directory root has been configured" error 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 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.31.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.31.0.zip	Microsoft .Net SDK 6.0 or newer
Java	sample-bots-java-0.31.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.31.0.jar
• Artifact at Maven Central Repository

📦 .Net:

Available as:

• Artifact at Nuget repository

---

This discussion was created from the release 0.31.0.