User:AW/guideToRobocode

The rules of the game

In robocode 1v1, there are two robots fighting on a 600 by 800 pixel battlefield. Pixels are measured from the bottom left, as in a Cartesian coordinate system. Each robot starts with a certain amount of energy (usually 100 energy). When the energy runs out, the robot dies. The objective is to destroy the enemy by as large a margin as possible.

To do this, robots have certain:

Abilities

1. Move forwards or backwards at up to 8 pixels per turn (a turn in robocode is also called a tick)
2. Accelerate at up to 1 pixel per turn squared
3. Deccelerate at up to 2 pixels per turn squared
4. Turn their body at up to (10 - 0.75 * abs(velocity)) degrees peer turn and get their orientation (relative to "north" on the battle field, going clockwise like a compass.)
5. Turn their gun at up to 15 degrees per turn and get their gun's orientation relative to the body of the tank
6. Turn their radar at up to 45 degrees per turn and get the radar's orientation
7. Fire bullets ranging with powers ranging from 0.1 to 3.0
8. Firing bullets creates gun heat of 1 + firePower / 5.0; if gunHeat > 0, the robot cannot fire.
9. A robot's hit box is a non-rotating square. Each side is 36 pixels in length.

Bullets

1. Firing a bullet costs energy equal to the power of the bullet;
2. A bullet has a velocity of 20 - 3 * bulletPower;
3. When a bullet hits, it does 4 * firePower damage to an enemy robot if firePower < 1;
4. if firePower >= 1 the bullet does 4 * firepower + 2 * (firePower - 1). You cannot be hit by your own bullets.
5. When a bullet hits an enemy, the firing robot receives a bonus in energy of 3 * bulletPower.
6. When two bullets collide, both of them are destroyed.
7. When a bullet hits the wall, it is destroyed.

Radar

A robot can receive the following information about his enemy via radar:

1. Enemy's heading (the heading is the direction the robot is facing, this is measured from );
2. Enemy's distance;
3. Enemy's bearing (the angle from our heading to the enemy);
4. Enemy's speed;
5. Enemy's energy;

Robot collisions

1. If a robot hits a wall, the robot stops instantly and takes damage equal to abs(velocity) * 0.5 - 1 if abs(velocity) > 2.0
2. If a robot hits another robot, it takes 0.6 damage and instantly stops if it is moving towards the other robot.

And one final bit of details:

Robocode Processing Loop

The order that Robocode runs is as follows:

1. Battle view is (re)painted.
2. All robots execute their code until they take action (and then paused).
3. Time is updated (time = time + 1).
4. All bullets move and check for collisions. This includes firing bullets.
5. All robots move (gun, radar, heading, acceleration, velocity, distance, in that order).
6. All robots perform scans (and collect team messages).
7. All robots are resumed to take new action.
8. Each robot processes its event queue.

That's it. You now know how robocode works. If you ever need to refresh your memory, you can go to the Physics page.

Strategy

Given the above abilities, how do you destroy the other robot? Over the years, several techniques have developed.

Here are the key concepts:

Waves

You may have noticed above that the list of things your radar can detect does not include bullets. This is part of what makes robocode so interesting. Because firing costs energy and you can detect the enemy's energy, you can tell when they fired and what power bullet they shot. With the power, you can find the velocity of the bullet, and because you can find the location of the enemy robot, you know where the bullet was fired from. Therefore you have three pieces of information: 1) Where the bullet was fired from. 2) How fast it is going. 3) How long it has been moving.

From these, you can find a circle that contains the set of possible positions of a bullet. The radius of this circle increases each turn (tick). This "object" (the circle of increasing radius that contains all possible points where a bullet can be) is called a wave. Whenever you fire, you too create a wave of possible points your bullet could be. Of course you know what angle you used so you know where the bullet is, but the wave shows all points where the bullet could have been.

For a detailed article, see Waves.

Guess Factors

When people think of tanks shooting at each other, they generally assume these tanks are realistic. In real life, tanks shoot projectiles at about 1500 m/s, while the tanks move at a speed of at most 0.03 m/s. In real life, you can't dodge. In robocode, however, bullets travel at less than three times the maximum speed of a tank. Dodging works in robocode. Eventually, a mechanic called guess factors emerged. When targeting, you have to choose an angle to fire at, with the hope of hitting the enemy. The enemy can reach a certain range of angles, which can be proved to be at most asin(8/bulletSpeed) in either direction from the ray drawn from the firing robot through the target robot (see MEA for the proof). Since this range of angles contains all the angles that the enemy could reach, the angles in this range are also the only angles that are reasonable to fire at. Let's normalize these angles from -1 to 1, with 0 being straight at the target. We could define 1 to be the maximum possible angle in the clockwise direction (assuming our robot is the center of the universe), but instead, let's make it the maximum angle in the direction the enemy robot is "orbiting" us.

We now have a unambiguous way of referring to each reasonable firing angle. This notation gives angle in an offset from "head on" (the ray from our robot through their robot) and normalized by bullet power, so that 1.0 is the "maximum" angle they could reach "orbiting" us in the direction they are going now, and -1.0 is the "maximum" angle could reach if they changed directions.

For more information, see GF

Waves and guess factors are the core of the current top robots.