Difference between revisions of "Robocode 1"

Revision as of 11:42, 4 April 2012

COMP 1010 Home > Back to Extra Labs

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 or navigating to your installation folder and running the robocode.bat file.

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

When the battle ends you will be presented with a scoreboard of the demo battle and the Main Menu. Close the scoreboard, we have no use for it. For now lets just focus on the main menu.

The Main Menu

At the top of the main menu you will find the toolbar which you will use to start virtual battles or design a robot.

The Battle menu will allow you to set up a virtual battle. Selecting New will prompt you to create a new virtual battle from scratch by presenting you with the New Battle Screen. Selecting Open will let you open a pre existing virtual battle setting where you can modify the settings or simply just run the battle.

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. Don't 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 pre definied robots that came with the installation of robocode. Lets create a virtual battle with 3 robots and 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 battle. It is up to your programming skills ahead of time to design a robot that will decide what to do 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.