This wiki is archived and useful information is being migrated to the main bzflag.org website

Editing BZRobots/API

Jump to: navigation, search

Warning: The database has been locked for maintenance, so you will not be able to save your edits right now. You may wish to copy and paste your text into a text file and save it for later.

The administrator who locked it offered this explanation: Archived wiki

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision Your text
Line 13: Line 13:
  
  
If you are new to BZRobots, but have Robocode experience, you may want to take a look at [[BZRobots/API_BZRobots_vs_Robocode]]
+
'''Note:''' ''As BZRobots currently supports bot scripts written in three different languages, the following is a C-style, but language independent description of the methods available for bot development.''
 
+
 
+
Unless otherwise specified, all units are in map units (distance), degrees (angles), and seconds (time)
+
 
+
=API Methods=
+
'''Note:''' ''As BZRobots currently supports bot scripts written in three different languages, the following is language independent description of the methods available for bot development. Actual usage will vary depending on the language used''
+
  
 
{| cellpadding=4 {{Prettytable}}
 
{| cellpadding=4 {{Prettytable}}
 
|-
 
|-
! colspan=7 {{Hl3}} | ==Robot/AdvancedRobot Methods==  
+
! colspan=7 {{Hl3}} |==Robot/AdvancedRobot Methods==  
 
|-
 
|-
 
| {{Hl3}} |'''Method'''  
 
| {{Hl3}} |'''Method'''  
Line 57: Line 51:
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
| void doNothing()  
+
| void execute()  
| Clears the event queue; any events will be disgarded
+
| Causes any action queued by setAhead, setTurnRight, etc. to take place, ending the "turn"  
! bgcolor="#BB0000" | Y
+
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 +
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
| void execute()  
+
| void doNothing()
| Causes any action queued by setAhead, setTurnRight, etc. to take place, ending the "turn"  
+
| Does nothing (equivalent of a short sleep)
 +
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BB0000" | N
 
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
| void fire(double power)
+
| void fire()
 
| Fires a single shot  
 
| Fires a single shot  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y  
+
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
| Bullet *fireBullet(double power)
+
| Bullet *fireBullet()
 
| Fires a single shot, returning a reference to the fired shot
 
| Fires a single shot, returning a reference to the fired shot
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y  
+
! bgcolor="#00BB00" | Y  
 
! bgcolor="#BBBB00" | 50%  
 
! bgcolor="#BBBB00" | 50%  
|-
 
| list<Event> getAllEvents()
 
| Returns a list of all events currently in the queue
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BB0000" | 5%
 
 
|-
 
|-
 
| double getBattleFieldLength()
 
| double getBattleFieldLength()
Line 102: Line 88:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#555555" | N/A  
+
! bgcolor="#555555" | N/A (*)
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
Line 113: Line 99:
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
| list<Event> getBulletHitBulletEvents()
+
| double getDistanceRemaining()
| Returns a list of BulletHitBulletEvent currently in the queue
+
| Returns the distance remaining from a setAhead/setBack
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y  
+
! bgcolor="#BB0000" | Y
! bgcolor="#BB0000" | 5%  
+
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
| list<Event> getBulletHitEvents()
+
| double getTurnRemaining()
| Returns a list of BulletHitEvent currently in the queue
+
| Returns the distance remaining from a setTurnLeft/setTurnRight
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | Y
! bgcolor="#BB0000" | 5%
+
|-
+
| list<Event> getBulletMissedEvents()
+
| Returns a list of all BulletMissedEvent currently in the queue
+
! bgcolor="#BB0000" | N
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | 5%
+
|-
+
| double getDistanceRemaining()
+
| Returns the distance remaining from a setAhead/setBack
+
! bgcolor="#BB0000" | N
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | Y
+
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
 
| double getEnergy()
 
| double getEnergy()
| For robocode compatibly - robot's current "energy" (Always 16)  
+
| For robocode compatibly - robot's current "energy" (Always 100)  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | Y
! bgcolor="#555555" | N/A
+
! bgcolor="#00BB00" | 100%
 
|-
 
|-
 
| double getGunCoolingRate()
 
| double getGunCoolingRate()
Line 158: Line 128:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
Line 165: Line 135:
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | 100%
 
|-
 
| double getGunHeadingRadians()
 
| For robocode compatibly - robot's gun heading (Always matches robot heading)
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
Line 182: Line 144:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
|-
 
| double getGunTurnRemaining()
 
| For robocode compatibly - (Always returns 0)
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| double getGunTurnRemainingRadians()
 
| For robocode compatibly - (Always returns 0)
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#555555" | N/A
 
 
|-
 
|-
 
| double getHeading()
 
| double getHeading()
Line 207: Line 153:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | 100%
 
|-
 
| double getHeadingRadians()
 
| Returns the current heading of the robot in radians
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
Line 222: Line 160:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BB0000" | N
+
! bgcolor="#BB0000" | N (*)
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
Line 230: Line 168:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#555555" | N/A  
+
! bgcolor="#555555" | N/A (*)
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
Line 255: Line 193:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | 100%  
+
! bgcolor="#BB0000" | 0%  
 
|-
 
|-
 
| double getRadarHeading()
 
| double getRadarHeading()
Line 264: Line 202:
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
|-
 
| double getRadarHeadingRadians()
 
| For robocode compatibly - robot's radar heading (Always matches robot heading)
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | 100%
 
|-
 
| double getRadarTurnRemaining()
 
| For robocode compatibly - (Always returns 0)
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| double getRadarTurnRemainingRadians()
 
| For robocode compatibly - (Always returns 0)
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| list<Event> getRobotDeathEvents()
 
| Returns a list of all RobotDeathEvent currently in the queue
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BB0000" | 5%
 
 
|-
 
|-
 
| int getRoundNum()
 
| int getRoundNum()
Line 304: Line 210:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
|-
 
| list<Event> getScannedRobotEvents()
 
| Returns a list of all ScannedRobotEvent currently in the queue
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BB0000" | 5%
 
|-
 
| list<Event> getStatusEvents()
 
| Returns a list of all StatusEvent currently in the queue
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BB0000" | 5%
 
 
|-
 
|-
 
| double getTime()
 
| double getTime()
Line 326: Line 216:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#00BB00" | 100%
+
|-
+
| double getTurnRemaining()
+
| Returns the distance remaining from a setTurnLeft/setTurnRight
+
! bgcolor="#BB0000" | N
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | 100%
+
|-
+
| double getTurnRemainingRadians()
+
| Returns the distance remaining from a setTurnLeft/setTurnRight in radians
+
! bgcolor="#BB0000" | N
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | Y
+
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
Line 358: Line 232:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y  
+
! bgcolor="#00BB00" | Y (*)
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
Line 384: Line 258:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
|-
 
| bool isAdjustGunForRobotTurn
 
| For robocode compatibility - always true
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| bool isAdjustRadarForGunTurn
 
| For robocode compatibility - always true
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| bool isAdjustRadarForRobotTurn
 
| For robocode compatibility - always true
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#555555" | N/A
 
 
|-
 
|-
 
| void resume()
 
| void resume()
Line 430: Line 280:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#555555" | N/A
+
! bgcolor="#00BB00" | 100%
 
|-
 
|-
 
| void setAdjustRadarForGunTurn(bool independent)
 
| void setAdjustRadarForGunTurn(bool independent)
Line 438: Line 288:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#555555" | N/A
+
! bgcolor="#00BB00" | 100%
 
|-
 
|-
 
| void setAdjustRadarForRobotTurn(bool independent)
 
| void setAdjustRadarForRobotTurn(bool independent)
Line 446: Line 296:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#555555" | N/A
+
! bgcolor="#00BB00" | 100%
 
|-
 
|-
 
| void setAhead(double distance)
 
| void setAhead(double distance)
Line 470: Line 320:
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y  
+
! bgcolor="#BBBB00" | Y (*)
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
Line 478: Line 328:
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
 
! bgcolor="#BBBB00" | 50%  
 
! bgcolor="#BBBB00" | 50%  
 
|-
 
|-
Line 512: Line 362:
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
|-
 
| void void setTurnGunLeft(double degrees)
 
| For robocode compatablity - has no effect
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BBBB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| void void setTurnGunLeftRadians(double radians)
 
| For robocode compatablity - has no effect
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BBBB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| void void setTurnGunRight(double degrees)
 
| For robocode compatablity - has no effect
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BBBB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| void void setTurnGunRightRadians(double radians)
 
| For robocode compatablity - has no effect
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BBBB00" | Y
 
! bgcolor="#555555" | N/A
 
 
|-
 
|-
 
| void void setTurnLeft(double degrees)
 
| void void setTurnLeft(double degrees)
| Sets the robot to turn left by ''degrees'' at the next execute()
+
| Sets the robot to turn left by ''degress'' at the next execute()
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
Line 553: Line 371:
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
| void void setTurnLeftRadians(double radians)
+
| void void setTurnRate(double turnRate)
| Sets the robot to turn left by ''radians'' at the next execute()
+
| Sets the maximum turn rate for the robot at the next execute()
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | Y (*)
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
|-
 
| void void setTurnRadarLeft(double degrees)
 
| For robocode compatibility - has no effect
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BBBB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| void void setTurnRadarLeftRadians(double radians)
 
| For robocode compatibility - has no effect
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BBBB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| void void setTurnRadarRight(double degrees)
 
| For robocode compatibility - has no effect
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BBBB00" | Y
 
! bgcolor="#555555" | N/A
 
|-
 
| void void setTurnRadarRightRadians(double radians)
 
| For robocode compatibility - has no effect
 
! bgcolor="#BB0000" | N
 
! bgcolor="#BB0000" | N
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BBBB00" | Y
 
! bgcolor="#555555" | N/A
 
 
|-
 
|-
 
| void void setTurnRight(double degrees)
 
| void void setTurnRight(double degrees)
| Sets the robot to turn right by ''degrees'' at the next execute()
+
| Sets the robot to turn right by ''degress'' at the next execute()
! bgcolor="#BB0000" | N
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | 100%
+
|-
+
| void void setTurnRightRadians(double radians)
+
| Sets the robot to turn right by ''radians'' at the next execute()
+
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
 
! bgcolor="#BB0000" | N  
Line 622: Line 400:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#555555" | N/A
+
! bgcolor="#00BB00" | 100%
 
|-
 
|-
 
| void turnGunLeft(double degrees)
 
| void turnGunLeft(double degrees)
Line 630: Line 408:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#555555" | N/A
+
! bgcolor="#00BB00" | 100%
 
|-
 
|-
 
| void turnLeft(double degrees)
 
| void turnLeft(double degrees)
Line 637: Line 415:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#00BB00" | 100%
 
|-
 
| void turnLeftRadians(double radians)
 
| Turns the robot left ''radians'' radians
 
! bgcolor="#00BB00" | Y
 
! bgcolor="#BB0000" | N
 
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
Line 654: Line 424:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y  
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#555555" | N/A
+
! bgcolor="#00BB00" | 100%
 
|-
 
|-
 
| void turnRadarLeft(double degrees)
 
| void turnRadarLeft(double degrees)
Line 662: Line 432:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y  
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#555555" | N/A
+
! bgcolor="#00BB00" | 100%
|-
+
| void turnRadarLeftRadians(double radians)
+
| For robocode compatibly - but has no effect
+
! bgcolor="#BB0000" | N
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#BBBB00" | Y
+
! bgcolor="#555555" | N/A
+
|-
+
| void turnRadarRight(double degrees)
+
| For robocode compatibly - but has no effect
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#BBBB00" | Y
+
! bgcolor="#555555" | N/A
+
|-
+
| void turnRadarRightRadians(double radians)
+
| For robocode compatibly - but has no effect
+
! bgcolor="#BB0000" | N
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#BBBB00" | Y
+
! bgcolor="#555555" | N/A
+
 
|-
 
|-
 
| void turnRight(double degrees)
 
| void turnRight(double degrees)
Line 697: Line 443:
 
! bgcolor="#00BB00" | 100%  
 
! bgcolor="#00BB00" | 100%  
 
|-
 
|-
| void turnRightRadians(double radians)
+
! colspan=7 {{Hl3}} |==Robot/AdvancedRobot Event Handlers==  
| Turns the robot right ''radians'' radians
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | N
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | Y
+
! bgcolor="#00BB00" | 100%
+
|-
+
! colspan=7 {{Hl3}} | ==Robot/AdvancedRobot Event Handlers==  
+
 
|-
 
|-
 
| {{Hl3}} |'''Method'''  
 
| {{Hl3}} |'''Method'''  
Line 720: Line 458:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | N
! bgcolor="#BB0000" | 10%  
+
! bgcolor="#BB0000" | 0%  
 
|-
 
|-
 
| void onBulletFired(BulletFiredEvent e)
 
| void onBulletFired(BulletFiredEvent e)
Line 728: Line 466:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#555555" | N/A
+
! bgcolor="#BB0000" | N  
! bgcolor="#BB0000" | 10%  
+
! bgcolor="#BB0000" | 0%  
 
|-
 
|-
 
| void onBulletHit(BulletHitEvent e)
 
| void onBulletHit(BulletHitEvent e)
Line 736: Line 474:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | N
! bgcolor="#BBBB00" | 80%  
+
! bgcolor="#BB0000" | 0%  
 
|-
 
|-
 
| void onBulletHitBullet(BulletHitBulletEvente)
 
| void onBulletHitBullet(BulletHitBulletEvente)
Line 745: Line 483:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#555555" | N/A
+
! bgcolor="#BB0000" | 0%
 
|-
 
|-
 
| void onBulletMissed(BulletMissedEvent e)
 
| void onBulletMissed(BulletMissedEvent e)
Line 752: Line 490:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | N
! bgcolor="#BB0000" | 10%  
+
! bgcolor="#BB0000" | 0%  
 
|-
 
|-
 
| void onDeath(DeathEvent e)
 
| void onDeath(DeathEvent e)
Line 768: Line 506:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y  
+
! bgcolor="#BBBB00" | Y  
! bgcolor="#BB0000" | 25%  
+
! bgcolor="#BB0000" | 0%  
 
|-
 
|-
 
| void onHitRobot(HitRobotEvente)
 
| void onHitRobot(HitRobotEvente)
Line 777: Line 515:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#555555" | N/A
+
! bgcolor="#BB0000" | 0%
 
|-
 
|-
 
| void onHitWall(HitWallEvent e)
 
| void onHitWall(HitWallEvent e)
Line 792: Line 530:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | N
! bgcolor="#00BB00" | 100%  
+
! bgcolor="#BB0000" | 0%  
 
|-
 
|-
 
| void onScannedRobot(ScannedRobotEvent e)
 
| void onScannedRobot(ScannedRobotEvent e)
Line 800: Line 538:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#BBBB00" | Y (*)
! bgcolor="#00BB00" | 100%  
+
! bgcolor="#22BB00" | 90%  
 
|-
 
|-
 
| void onSpawn(SpawnEvent e)
 
| void onSpawn(SpawnEvent e)
Line 808: Line 546:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#555555" | N/A
+
! bgcolor="#BB0000" | N
! bgcolor="#00BB00" | 100%
+
! bgcolor="#00BB00" | Y
 
|-
 
|-
 
| void onStatus(StatusEvent e)
 
| void onStatus(StatusEvent e)
Line 816: Line 554:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#00BB00" | Y
+
! bgcolor="#BB0000" | N
! bgcolor="#00BB00" | 95%  
+
! bgcolor="#BB3300" | 20%  
 
|-
 
|-
 
| void onWin(WinEvent e)
 
| void onWin(WinEvent e)
Line 824: Line 562:
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
 
! bgcolor="#00BB00" | Y  
! bgcolor="#BBBB00" | Y
+
! bgcolor="#BB0000" | N
! bgcolor="#BB0000" | 10%  
+
! bgcolor="#BB0000" | 0%  
 
|-
 
|-
 
|}
 
|}
Line 831: Line 569:
 
=See Also=
 
=See Also=
  
* [[BZRobots/API_BZRobots_vs_Robocode]] - Differences between Robocode and BZRobots
+
[[BZRobots/Ideas]] - Ideas for a possible future release
* [[BZRobots/Ideas]] - Ideas for a possible future release
+

Please note that all contributions to BZFlagWiki may be edited, altered, or removed by other contributors. If you do not want your writing to be edited mercilessly, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource (see BZFlagWiki:Copyrights for details). Do not submit copyrighted work without permission!

To edit this page, please answer the question that appears below (more info):

Cancel | Editing help (opens in new window)

Templates used on this page: