Robocode 1

COMP 1010 Home > Back to Extra Labs

Introduction In this lab you will learn to play the exciting coding game called Robocode. Robocode is an event driven program that allows us to create, modify, and test virtual warrior robots in a virtual battlefield. If you are not familiar with event driven programming you should consider completing the GUI Lab part 1 or at least read Step 3 from that lab. Completing this lab and Robocode part 2 will also give you a head start in understanding and using Application Programming Interfaces (APIs).

Installation

• Download and run the latest version of robocode-x.x.x.x-setup.jar file from: http://sourceforge.net/projects/robocode/files/

After Robocode is installed you can run it by either executing the supplied shortcut by navigating to your installation folder and running the robocode.bat file.

Upon first boot of the game you will see a short battle demo.

When the demo ends you will be presented with a scoreboard of the demo battle as well as the Main Menu. Close the scoreboard as we have no use for it. Let us focus on the main menu for now.

The Main Menu

At the top of the main menu you will find the toolbar which you will use to start virtual battles. The main menu is also used to design robots.

Selecting Battle from the toolbar allows you to setup a virtual battle. You can start from scratch by selecting New, this creates a new virtual battle. Selecting Open lets you open a pre-existing battle. The Open option also allows you to make modifications to the settings if so desired, or you can simply run the battle as is.

The Robot menu provides robot development options. Selecting Editor within the Robot menu will open the Robot Editor. You will soon use the Robot Editor to design your first robot.

For now this is all you need to know to get started and move around using robocode. Do not worry about the other options just yet.

Sample battle

To better familiarize yourself with robocode and understand what the game is all about let us first look at setting up a sample battle using some of the predefined robots that came with the installation of robocode. Let us create a virtual battle with 3 robots that goes for 5 rounds. To do so:

1. Click on the Battle menu and select New. This will open the New Battle Screen.
2. Double click on any 3 robots from the Available Robots pane. Upon adding robots you should be able to see them pop up on the Selected Robots pane on the right.
3. Change the number of rounds value to 5.
   • Each battle consists of consecutive rounds. Since the robots are randomly dropped on the the battlefield we can have multiple rounds to make the game fair.
4. Click on Start Battle and enjoy.

In robocode you do not have control over any robot during the battle. Your programming skills in designing your robot will determine how well your robot does in combat. So without further ado, go ahead and read the next section which tells you how to create your first robot.

Create your first Robot

Now that you have the basics down, lets create your first Robot.

1. From the Robot menu, select Editor (Or Press Ctrl+E). This opens up the Robot Editor where you will make, edit, and compile your Robot.
2. From the File menu, select New, then select Robot. (Or press Ctrl+N).
3. Enter a name for your Robot (This name cannot contain any spaces, similar to java variables. Remember, Robocode was made in java). Click Ok.
4. Enter a short package name for your Robot. This should be somewhat different than your Robots name.

Voila! Your Robot has been created. As you can see the Robot code pops up and is ready to edit. Your Robot is what is known as an object in more advanced programming. Your Robot has some basic methods in its file. These include run(), onScannedRobot(ScannedRobotEvent e), onHitByBullet(HitByBulletEvent e), onHitWall(HitWallEvent e).

Making the Robot Move

Now that your code for your Robot has been created, lets add in some functionality. By default the robot has some movement functionality already in it. Lets take a look at the run method to examine this default movement.

 public void run() {
   // Initialization of the robot should be put here

   // After trying out your robot, try uncommenting the import at the top,
   // and the next line:

   // setColors(Color.red,Color.blue,Color.green); // body,gun,radar

   // Robot main loop
   while(true) {
      // Replace the next 4 lines with any behavior you would like
      ahead(100);
      turnGunRight(360);
      back(100);
      turnGunRight(360);
   }
} 

As you can see there appears to be some movements called ahead(100) and back(100) in the main while loop. Lets test out these movements and see if our Robot actually does this.

1. Lets first increase the ahead() value to 150 instead of 100.
2. Compile your Robot by going to Compiler, select Compile (Or press Ctrl+B).
3. Once it successfully compiles click Ok. Yay! Your Robot is now compiled and ready to move around the map!
4. Go back to the main GUI and lets import your Robot.
5. Click Battle.
6. Click New (Or press Ctrl+N).
7. Locate your package under the Packages section.
8. Click your package to see your Robot under the Robots section.
9. Click Add -> to add your Robot to the list of selected Robots. Now lets see if your Robot actually moves!
10. Click on Start Battle.

Unless you added any other Robots your Robot should just run around aimlessly for 10 rounds. But now we have verified that movement works! If you like, you can add in different values to ahead(150), turnGunRight(360), back(100), and turnGunRight(360) to experiment with it.

Firing on Other Robots

Now that we know our Robot can move around, lets make it fire on other Robots! By default, when your Robot was created it had a method called onScannedRobot that would return fire(by calling the method fire(1)) when a Robot scanned yours.

We're going to keep this functionality but also lets add in two more times when your Robot will fire.

1. Add in fire(1) underneath ahead(100).
2. Add in fire(1) underneath back(100).

 public void run() {
   // Initialization of the robot should be put here

   // After trying out your robot, try uncommenting the import at the top,
   // and the next line:

   // setColors(Color.red,Color.blue,Color.green); // body,gun,radar

   // Robot main loop
   while(true) {
      // Replace the next 4 lines with any behavior you would like
      ahead(100);
      fire(1);
      turnGunRight(360);
      back(100);
      fire(1);
      turnGunRight(360);
   }
} 

After compiling your Robot lets test our firing on another robot.

1. Select a new Battle.
2. Add in your Robot from your package as you did earlier.
3. Add in, from the sample Package, SittingDuck.
4. Click Start Battle to begin firing!

Feel free to add in other places where you think you should fire on other Robots.

Additional Methods

Now that we have covered the run() method, lets add in some more functionality to three other methods, onScannedRobot(), onHitByBullet() and onHitWall().

onScannedRobot()

By default all you have in this method is:

 public void onScannedRobot(ScannedRobotEvent e) {
   // Replace the next line with any behavior you would like
   fire(1);
} 

1. Add in a turnGunLeft(360) just above your fire(1) methods call.
2. Increase the fire to 2 instead of 1.

onHitByBullet()

By default all you have in this method is:

 public void onHitByBullet(HitByBulletEvent e) {
   // Replace the next line with any behavior you would like
   back(10);
} 

Lets change this up a bit.

1. Insert a turnRight(90) before the back(10).
2. Change back(10) to ahead(20) .

onHitWall()

By default all you have in this method is:

 public void onHitWall(HitWallEvent e) {
   // Replace the next line with any behavior you would like
   back(20);
} 

1. Add in a turnLeft(180) above the back(20).

Battle your Robot

Now it is time to show the TA the cool new things you have learned in this lab! Test out your Robot you have made on other Robots. Feel free to add in more functionality to your Robot. For a more in depth look at this improved functionality, see the next lab Robocode part 2.