Robocode.TankRoyale.BotApi 0.34.1

Robocode Tank Royale - .NET Bot API

<img src="https://raw.githubusercontent.com/robocode-dev/tank-royale/refs/heads/main/gfx/Tank/Tank-logo.svg" width="150" alt="Robocode logo">

Build the best - destroy the rest!

The .NET Bot API for Robocode Tank Royale — the next evolution of the classic Robocode programming game where you code virtual tanks (bots) to battle in a virtual arena.

About Robocode Tank Royale

Robocode is a programming game where your task is to code a bot (a virtual tank) that competes against other bots in a real-time battle arena. You are the programmer — the bot acts entirely on your code.

Tank Royale brings Robocode to the next level with:

• Network-based battles via WebSocket connections
• Multiple programming languages and platforms
• Real-time battles with multiple bots

Installation

Add the .NET Bot API to your project using the .NET CLI:

dotnet add package Robocode.TankRoyale.BotApi

To install a specific version, add the --version option:

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

Requirements

• .NET 8 or higher
• Windows, macOS, or Linux

Quick Start

Get started quickly with the official tutorial and sample bot:

• 📖 Tutorial: My First Bot for .NET — https://robocode-dev.github.io/tank-royale/tutorial/dotnet/my-first-bot-for-dotnet.html
• 📁 Sample code (C#): MyFirstBot — https://github.com/robocode-dev/tank-royale/tree/main/sample-bots/dotnet/MyFirstBot

How to run:

• Install and start the Robocode Tank Royale GUI from the releases page (it also starts the game server)
• Build and run your bot project
• In the GUI, add your bot process and start a battle

Features

The .NET Bot API provides:

• Full Bot Control: Move your tank, rotate gun and radar, fire bullets
• Event Handling: Respond to hits, bot scanned, bullet impacts, and more
• Battle Information: Access to battle state, opponent positions, and game rules
• Debugging Support: Built-in debugging and logging capabilities

Getting Started

1. Install the package: dotnet add package Robocode.TankRoyale.BotApi
2. Download Robocode Tank Royale (GUI + server) from the releases page: https://github.com/robocode-dev/tank-royale/releases
3. Create your bot: follow the .NET tutorial or copy the MyFirstBot sample
4. Run battles: start the GUI, add your bot process, and watch the fight

Documentation & Resources

• 📖 Official Documentation: robocode-dev.github.io/tank-royale
• .NET API Reference: https://robocode-dev.github.io/tank-royale/api/dotnet/
• Getting Started: https://robocode-dev.github.io/tank-royale/tutorial/getting-started.html
• 🤖 My First Bot: Create Your First Bot
• Sample Bots: https://github.com/robocode-dev/tank-royale/tree/main/sample-bots/dotnet
• Source Code: https://github.com/robocode-dev/tank-royale/tree/main/bot-api/dotnet

Supported Platforms

Robocode Tank Royale runs on:

• Windows
• macOS
• Linux

The .NET Bot API works with .NET 8 or higher on all supported platforms.

Community & Support

• GitHub Issues: Report bugs and request features
• Discussions: Community discussions and help
• Contributing: Check out our Contributing Guide

Development Status

🚧 Work in Progress: The .NET Bot API is currently under active development. Features and APIs may change before the stable release.

License

Licensed under the Apache License 2.0

Copyright

Copyright © 2022 Flemming N. Larsen

Ready to build the best tank and destroy the rest? Start coding your bot today! 🚀🎯