Robocode Tank Royale

Build the best - destroy the rest!

✨ Welcome

Welcome to the Robocode docs. These docs are meant for people who are new to Robocode, as well as a reference guide to various aspects of the Robocode Tank Royale programming game.

🚀 Get Started

On this page you can pick articles on the menu on the left side to read about various topics.

If you are new to Robocode, you should start with:

• the Introduction to Robocode, and
• read the Getting Started, and then
• continue to My First Bot to create your first bot.

Advanced strategies

📘 The Book of Robocode

Want to go beyond the fundamentals? The Book of Robocode is the advanced companion to these docs, covering movement, targeting, radar control, energy management, and competition-level tactics for both Robocode and Tank Royale.

Open the BookStart with the tutorial

Radar & ScanningTargetingMovement & EvasionEnergy & Scoring

🗺️ Learning Roadmap

Robocode mastery is a journey from fundamentals to advanced competitive strategies. We've organized documentation into a clear learning path:

🎯 Foundation (Start Here)

Essential concepts everyone needs:

1. Introduction - What is Robocode?
2. Installation - Set up your environment
3. Getting Started - Core concepts (rounds, turns, energy)
4. My First Bot - Create your first bot
5. Anatomy of a Bot - Understanding body, gun, and radar
6. Coordinates and Angles - Arena coordinate system
7. Physics - Movement, rotation, and bullet mechanics

🔧 Intermediate Skills

Build competent bots with solid fundamentals:

• Beyond the Basics - Event handling and logic flow
• Collision Mechanics - Wall/bot collision handling
• Testing & Debugging Guide - Test strategies and debugging
• Performance Optimization - Write efficient code
• Custom Game Setup - Configure battles and test scenarios
• Team Strategies - Team communication and coordination basics

📚 Advanced Topics (The Book of Robocode)

Ready for advanced competitive strategies? These docs cover the fundamentals, while The Book of Robocode takes you further into competition-level tactics:

• Radar & Scanning - Perfect locks, spinning radar, melee strategies
• Advanced Targeting - GuessFactor targeting, pattern matching, virtual guns
• Movement & Evasion - Wave surfing, anti-gravity, bullet dodging
• Statistical Targeting - Segmentation, statistics-based targeting
• Energy & Scoring - Strategic resource management

🖥️ Tank Royale Viewer

Want to visualize battles in style? Check out the Tank Royale Viewer—an amazing and beautiful web-based viewer for watching Robocode Tank Royale matches in real-time! Created by Jan Durovec (who also built the Recorder for Tank Royale's replay feature), this tool brings your battles to life with an interactive, modern interface.

Perfect for:

• 🏆 Displaying live battles on big monitors during competitions and tournaments
• 📊 Understanding bot strategies and showcasing championship matches

Ideal for spectators, broadcasters, and tournament organizers! ⚡

Give the Tank Royale Viewer a try!

🙏 Thanks to the contributors

Huge thanks to every contributor — you make this project shine! 🙌

☕ Support Robocode

If you are a fan of Robocode, you can support the project and me by buying some coffee 😊

💖 Thank you, JetBrains, for supporting Open Source

Thank you, JetBrains, for supporting non-commercial Open Source projects by providing licenses for Open Source development, including Robocode Tank Royale. ❤️

This project makes use of these great products from JetBrains for Java, Kotlin, C#, Python, and web development:

tools and technologies by JetBrains

used for Java API, Kotlin (game), and web development

used for C# API development

used for Python API development

used as primary language and for tooling