Robocode/My First Robot - Revision history

MultiplyByZer0: Add images

2017-09-16T22:17:31Z

Add images

MultiplyByZer0: Add line highlight

2017-08-29T04:15:04Z

Add line highlight

MultiplyByZer0: Improve tutorial

2017-08-19T00:44:38Z

Improve tutorial

MultiplyByZer0: Better image placement

2017-08-16T00:13:22Z

Better image placement

MultiplyByZer0: Move documentation footer to a template, and some other changes

2017-08-09T22:16:42Z

Move documentation footer to a template, and some other changes

Sprucenshield: /* Compile your robot */

2016-12-01T19:36:19Z

Compile your robot

Sprucenshield: /* My First Robot */

2016-12-01T19:23:59Z

My First Robot

Tonnetz: /* Fire at Will! */ Fixed dash

2014-11-20T06:39:02Z

Fire at Will!: Fixed dash

Tonnetz: /* Fire at Will! */ Tweaked wording to hopefully give the impression that events are delivered within, not parallel to, the run method's execution

2014-11-20T06:38:27Z

Fire at Will!: Tweaked wording to hopefully give the impression that events are delivered within, not parallel to, the run method's execution

Chase-san: /* Let's move somewhere */ Let's remove the smiley face altogeather.

2013-11-04T20:16:17Z

Let's move somewhere: Let's remove the smiley face altogeather.

@@ Line 12: / Line 12: @@
 == The Robot Editor ==
 The first step is to open up the Robot Editor. From the main Robocode screen, click on the '''Robot''' menu, then select '''Source Editor'''.
@@ Line 21: / Line 22: @@
 == A new robot ==
 This is what you should be looking at:
 <syntaxhighlight lang="java" line highlight="8-11,16">
-package man;
+package pkg;
 import robocode.*;
-public class MyFirstRobot extends Robot {
+public class YourRobotNameHere extends Robot {
      public void run() {
          while (true) {

@@ Line 23: / Line 23: @@
 This is what you should be looking at:
-<syntaxhighlight lang="java" line>
+<syntaxhighlight lang="java" line highlight="8-11,16">
 package man;

@@ Line 1: / Line 1: @@
-[[Image:MatBot.jpg|frameless|thumb]]
+[[Image:MatBot.jpg|thumb|MatBot]]
 This is the classic '''My First Robot Tutorial''' that tells how to create your first robot. Here's the fun stuff: This is what [[Robocode]] is all about!
@@ Line 21: / Line 21: @@
 == A new robot ==
-This is what you should be looking at (names have been changed to protect the innocent):
+This is what you should be looking at:
-  package man;
+<syntaxhighlight lang="java" line>
-  import robocode.*;
+package man;
 import robocode.*;
 public class MyFirstRobot extends Robot {
      public void run() {
+     }
+}
 </syntaxhighlight>
-Explanation:
+We're only concerned with lines 8-11 and 16 here... you won't need to change anything else. Not that much, right?
 * <code>import robocode.*;</code> ‒ Says that you're going to use Robocode objects in your robot.
@@ Line 108: / Line 98: @@
 Now, compile it by selecting '''Compile''' in the '''Compiler''' menu.
-If your robot compiles without any errors, you can start a new battle with your robot. Start a new battle by selecting '''New''' in the '''Battle''' menu. If you cannot see your robot, you might have to refresh the list of robots by '''pressing Ctrl + R'''. Add your robot to the battle together with at least one other robot as e.g. sample.Target, and press the '''Start Battle''' button to let the games begin!
+If your robot compiles without any errors, you can start a new battle with your robot. Start a new battle by selecting '''New''' in the '''Battle''' menu. (If you cannot see your robot, you might have to refresh the list of robots by selecting Options -> Clean robot cache). Add your robot to the battle together with at least one other robot as e.g. sample.Target, and press the '''Start Battle''' button to let the games begin!
 == What's next? ==
 You should have a look at all the sample robots to see how certain things are done.
 You'll eventually want to look at the [http://robocode.sourceforge.net/docs/robocode/ Robocode API] to see all the other things your robot can do.

@@ Line 1: / Line 1: @@
 This is the classic '''My First Robot Tutorial''' that tells how to create your first robot. Here's the fun stuff: This is what [[Robocode]] is all about!
-{|
+Creating a robot can be easy. Making your robot a winner is not. You can spend only a few minutes on it, or you can spend months and months. I'll warn you that writing a robot can be addictive! Once you get going, you'll watch your creation as it goes through growing pains, making mistakes and missing critical shots. But as you learn, you'll be able to teach your robot how to act and what to do, where to go, who to avoid, and where to fire. Should it hide in a corner, or jump into the fray?
 == Getting started ==

@@ Line 1: / Line 1: @@
-This is the classic '''My First Robot Tutorial''' that tells how to create your first robot.
+This is the classic '''My First Robot Tutorial''' that tells how to create your first robot. Here's the fun stuff: This is what [[Robocode]] is all about!
 {|
@@ Line 9: / Line 6: @@
 |}
-= My First Robot =
+== Getting started ==
 Ready to create your first robot? I hope you'll find that it's easy, straightforward, fun, and addictive!
@@ Line 25: / Line 22: @@
 Voila! You now see the code for your own robot.
-== A New Robot ==
+== A new robot ==
 This is what you should be looking at (names have been changed to protect the innocent):
@@ Line 46: / Line 43: @@
+   }
-We're only concerned with the bits in '''<span style="color:green">bold</span>''' here... you won't need to change anything else. Not that much, right?
+We're only concerned with the bits in '''<span style="color:green">green</span>''' here... you won't need to change anything else. Not that much, right?
-By the way, if you're REALLY concerned about the rest of it, right now, I describe it here:
+public class MyFirstRobot extends Robot {
-  package man;
-  import robocode.*;
-  &nbsp;
+</syntaxhighlight>
-{| border="1" style="text-align:left"
+Explanation:
 == Let's move somewhere ==
@@ Line 78: / Line 70: @@
 First, we'll examine the run() method:
-  while (true) {
+<syntaxhighlight lang="java">
-      ahead(100);
+while(true) {
-      turnGunRight(360);
+    ahead(100);
-      back(100);
+    turnGunRight(360);
-      turnGunRight(360);
+    back(100);
+    turnGunRight(360);
-−
+}
-<code>while(true) { }</code> means: "While the condition <code>true</code> is true, do everything between the curly brackets { }".
+</syntaxhighlight>
-Since <code>true</code> is always true, it means: "Do the stuff inside my curly brackets, forever".
+<code>while(true) { ... }</code> means: "Do the stuff inside my curly brackets, forever".
 So this robot will:
-# move ahead 100 pixels
+# Move ahead 100 pixels.
-# turn the gun right by 360 degrees
+# Turn the gun right by 360 degrees.
-# move back 100 pixels
+# Move back 100 pixels.
-# turn the gun left/back by 360 degrees
+# Turn the gun right by 360 degrees again.
 The robot will continue doing this over and over and over, until it dies, due to the <code>while(true)</code> statement.
@@ Line 99: / Line 91: @@
 Not so bad, right?
-== Fire at Will! ==
+== Fire at will! ==
 When our radar scans a robot, we want to fire:
-  public void onScannedRobot(ScannedRobotEvent e) {
+<syntaxhighlight lang="java">
-      fire(1);
+public void onScannedRobot(ScannedRobotEvent e) {
+    fire(1);
-The game calls your '''onScannedRobot''' method whenever—during one of the actions—you see another robot.
+The game calls your <code>onScannedRobot()</code> method whenever ‒ during one of the actions ‒ you see another robot.
-It sends along an event that can tell us lots of information about the robot—its name, how much life it has, where it is, where it's heading, how fast it's going, etc.
+It sends along an event that can tell us lots of information about the robot ‒ its name, how much life it has, where it is, where it's heading, how fast it's going, etc.
 However, since this is a simple robot, we're not going to look at any of that stuff. Let's just fire!
@@ Line 127: / Line 121: @@
 == See also ==
-=== Robot API ===
+{{RobocodeDocsList}}
 [[Category:Robocode Documentation]]
 [[Category:Tutorials]]

@@ Line 17: / Line 17: @@
 == The Robot Editor ==
-The first step is to open up the Robot Editor. From the main Robocode screen, click on the '''Robot''' menu, then select '''Editor'''.
+The first step is to open up the Robot Editor. From the main Robocode screen, click on the '''Robot''' menu, then select '''Source Editor'''.
 When the editor window comes up, click on the '''File''' menu, then select '''New Robot'''.

@@ Line 106: / Line 106: @@
+   }
-The game calls your '''onScannedRobot''' method whenever you can see another robot.
+The game calls your '''onScannedRobot''' method whenever—during one of the actions—you see another robot.
 It sends along an event that can tell us lots of information about the robot -- its name, how much life it has, where it is, where it's heading, how fast it's going, etc.