Robocode Python Clone

Basic clone of Robocode.

This repo just went through a large rewrite and is currently missing some of the features described below. It is planned to add them back in.

Recently implemented a engine_c in cython and cpp.

TODO:

• Consider where the Robot struct/class should be cython or cpp.

• Implement movement as a proper stack of commands that have decreasing amounts.

• Fully document all methods that are intended to be part of the public API.

• Decide on whether to use degrees or radians for rotation.

• Convert to a Data Oriented Programming model (should allow for multi-battle speedup):

  • Create robot data containers similar to Bullets
  • Refer Robot classes back to these data containers
  • Gracefully handle alive/dead, adding removing

• Scale the Overlay independently from the battle scaling

• Implement auto slow down on stacked commands e.g. calculate quickest path to angle without breaking max acceleration by turning remainder of angle in 1 tick. max_accel = 4 but remainder = 2 in 1 tick, velocity should reach 0 at same time as stopping.

• Represent the user Robot space as dict of configs passed to the engine.

Python -> Cython -> C++ flow

• PyRobot Class (Cython) -> constructs c++ Robot structs underneath
  • Subclassed PyRobot contains AI script (python)
• Engine Class (Cython) -> takes PyRobots as argument.
• Engine step method calls:
  • PyRobot run to execute python AI scripts.
  • Robot step to do fast update of logic

To summarise the repo now relies on an Engine class that is not easily accessible by user code. The objects that the engine interacts with are different from those that the 'User' will use to write their AI. New concepts:

• Engine -> RobotData
• User -> Robot

The engine reads the users intent from attributes on Robot then calculates the environments updates. Once finished an update happens from RobotData -> Robot. This should make it more difficult for a User to set the position of a Robot, effectively teleporting around the environment.

---

How to use:

To build your own robot:

from robots import AdvancedRobot


class MyFirstRobot(AdvancedRobot):
    def __init__(self, *args, **kwargs):
        super(MyFirstRobot, self).__init__(*args, **kwargs)
        self.radar.locked = True
        self.gun.locked = True

    def do(self):
        self.move_forward(1000)
        self.turn_left(360)

    def on_scanned(self, scanned):
        self.fire(1)

Simple spin and shoot when a robot is scanned.

To run the application:

from robots.app import App, Battle
# Import the bot from wherever it was located
from robots.bots import MyFirstRobot, RandomRobot


app = App((600, 400))
app.battle = Battle(app, (600,400), [
    MyFirstRobot.MyFirstRobot,
    RandomRobot.RandomRobot
])

app.set_sim_rate(10) # Set the simulation rate
app.on_execute() # Start execution

Multi Battles

It is also possible to run multiple battles simultaneously. Useful when training reinforcement learning algorithms.

from robots.app import App
from robots.battle import MultiBattle
from robots.bots import MyFirstRobot, RandomRobot


app = App((1200, 800))
app.battle = MultiBattle(app, (600,400), [
    MyFirstRobot.MyFirstRobot,
    RandomRobot.RandomRobot
], 16)
app.on_execute()