Rules (Robocode 1.9.5.0 API)

java.lang.Object
- robocode.Rules

```
public final class Rules
extends Object
```
Constants and methods that defines the rules of Robocode. Constants are used for rules that will not change. Methods are provided for rules that can be changed between battles or which depends on some other factor.

Since:

1.1.4

Author:

Luis Crespo (original), Flemming N. Larsen (original)

Field Summary

Fields
Modifier and Type	Field and Description
`static double`	`ACCELERATION` The acceleration of a robot, i.e. the increase of velocity when the robot moves forward, which is 1 pixel/turn.
`static double`	`DECELERATION` The deceleration of a robot, i.e. the decrease of velocity when the robot moves backwards (or brakes), which is 2 pixels/turn.
`static double`	`GUN_TURN_RATE` The turning rate of the gun measured in degrees, which is 20 degrees/turn.
`static double`	`GUN_TURN_RATE_RADIANS` The turning rate of the gun measured in radians instead of degrees.
`static double`	`MAX_BULLET_POWER` The maximum bullet power, i.e. the maximum amount of energy that can be transferred to a bullet when it is fired, which is 3 energy points.
`static double`	`MAX_TURN_RATE` The maximum turning rate of the robot, in degrees, which is 10 degress/turn.
`static double`	`MAX_TURN_RATE_RADIANS` The maximum turning rate of the robot measured in radians instead of degrees.
`static double`	`MAX_VELOCITY` The maximum velocity of a robot, which is 8 pixels/turn.
`static double`	`MIN_BULLET_POWER` The minimum bullet power, i.e the amount of energy required for firing a bullet, which is 0.1 energy points.
`static double`	`RADAR_SCAN_RADIUS` The radar scan radius, which is 1200 pixels.
`static double`	`RADAR_TURN_RATE` The turning rate of the radar measured in degrees, which is 45 degrees/turn.
`static double`	`RADAR_TURN_RATE_RADIANS` The turning rate of the radar measured in radians instead of degrees.
`static double`	`ROBOT_HIT_BONUS` The amount of bonus damage dealt by a robot ramming an opponent by moving forward into it, which is 2 x `ROBOT_HIT_DAMAGE` = 1.2 energy points.
`static double`	`ROBOT_HIT_DAMAGE` The amount of damage taken when a robot hits or is hit by another robot, which is 0.6 energy points.

Method Summary

All Methods Static Methods Concrete Methods
Modifier and Type	Method and Description
`static double`	`getBulletDamage(double bulletPower)` Returns the amount of damage of a bullet given a specific bullet power.
`static double`	`getBulletHitBonus(double bulletPower)` Returns the amount of bonus given when a robot's bullet hits an opponent robot given a specific bullet power.
`static double`	`getBulletSpeed(double bulletPower)` Returns the speed of a bullet given a specific bullet power measured in pixels/turn.
`static double`	`getGunHeat(double bulletPower)` Returns the heat produced by firing the gun given a specific bullet power.
`static double`	`getTurnRate(double velocity)` Returns the turn rate of a robot given a specific velocity measured in degrees/turn.
`static double`	`getTurnRateRadians(double velocity)` Returns the turn rate of a robot given a specific velocity measured in radians/turn.
`static double`	`getWallHitDamage(double velocity)` Returns the amount of damage taken when robot hits a wall with a specific velocity.

Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

- Field Detail
  - ACCELERATION
```
public static final double ACCELERATION
```
    The acceleration of a robot, i.e. the increase of velocity when the robot moves forward, which is 1 pixel/turn.
    
    See Also:
    
    Constant Field Values
  - DECELERATION
```
public static final double DECELERATION
```
    The deceleration of a robot, i.e. the decrease of velocity when the robot moves backwards (or brakes), which is 2 pixels/turn.
    
    See Also:
    
    Constant Field Values
  - MAX_VELOCITY
```
public static final double MAX_VELOCITY
```
    The maximum velocity of a robot, which is 8 pixels/turn.
    
    See Also:
    
    Constant Field Values
  - RADAR_SCAN_RADIUS
```
public static final double RADAR_SCAN_RADIUS
```
    The radar scan radius, which is 1200 pixels. Robots which is more than 1200 pixels away cannot be seen on the radar.
    
    See Also:
    
    Constant Field Values
  - MIN_BULLET_POWER
```
public static final double MIN_BULLET_POWER
```
    The minimum bullet power, i.e the amount of energy required for firing a bullet, which is 0.1 energy points.
    
    See Also:
    
    Constant Field Values
  - MAX_BULLET_POWER
```
public static final double MAX_BULLET_POWER
```
    The maximum bullet power, i.e. the maximum amount of energy that can be transferred to a bullet when it is fired, which is 3 energy points.
    
    See Also:
    
    Constant Field Values
  - MAX_TURN_RATE
```
public static final double MAX_TURN_RATE
```
    The maximum turning rate of the robot, in degrees, which is 10 degress/turn. Note, that the turn rate of the robot depends on it's velocity.
    
    See Also:
    
    MAX_TURN_RATE_RADIANS, getTurnRate(double), getTurnRateRadians(double), Constant Field Values
  - MAX_TURN_RATE_RADIANS
```
public static final double MAX_TURN_RATE_RADIANS
```
    The maximum turning rate of the robot measured in radians instead of degrees.
    
    See Also:
    
    MAX_TURN_RATE, getTurnRate(double), getTurnRateRadians(double)
  - GUN_TURN_RATE
```
public static final double GUN_TURN_RATE
```
    The turning rate of the gun measured in degrees, which is 20 degrees/turn. Note, that if setAdjustGunForRobotTurn(true) has been called, the gun turn is independent of the robot turn. In this case the gun moves relatively to the screen. If setAdjustGunForRobotTurn(false) has been called or setAdjustGunForRobotTurn() has not been called at all (this is the default), then the gun turn is dependent on the robot turn, and in this case the gun moves relatively to the robot body.
    
    See Also:
    
    GUN_TURN_RATE_RADIANS, Robot.setAdjustGunForRobotTurn(boolean), Constant Field Values
  - GUN_TURN_RATE_RADIANS
```
public static final double GUN_TURN_RATE_RADIANS
```
    The turning rate of the gun measured in radians instead of degrees.
    
    See Also:
    
    GUN_TURN_RATE
  - RADAR_TURN_RATE
```
public static final double RADAR_TURN_RATE
```
    The turning rate of the radar measured in degrees, which is 45 degrees/turn. Note, that if setAdjustRadarForRobotTurn(true) and/or setAdjustRadarForGunTurn(true) has been called, the radar turn is independent of the robot and/or gun turn. If both methods has been set to true, the radar moves relatively to the screen. If setAdjustRadarForRobotTurn(false) and/or setAdjustRadarForGunTurn(false) has been called or not called at all (this is the default), then the radar turn is dependent on the robot and/or gun turn, and in this case the radar moves relatively to the gun and/or robot body.
    
    See Also:
    
    RADAR_TURN_RATE_RADIANS, Robot.setAdjustGunForRobotTurn(boolean), Robot.setAdjustRadarForGunTurn(boolean), Constant Field Values
  - RADAR_TURN_RATE_RADIANS
```
public static final double RADAR_TURN_RATE_RADIANS
```
    The turning rate of the radar measured in radians instead of degrees.
    
    See Also:
    
    RADAR_TURN_RATE
  - ROBOT_HIT_DAMAGE
```
public static final double ROBOT_HIT_DAMAGE
```
    The amount of damage taken when a robot hits or is hit by another robot, which is 0.6 energy points.
    
    See Also:
    
    Constant Field Values
  - ROBOT_HIT_BONUS
```
public static final double ROBOT_HIT_BONUS
```
    The amount of bonus damage dealt by a robot ramming an opponent by moving forward into it, which is 2 x ROBOT_HIT_DAMAGE = 1.2 energy points.
    
    See Also:
    
    Constant Field Values
- Method Detail
  - getTurnRate
```
public static double getTurnRate(double velocity)
```
    Returns the turn rate of a robot given a specific velocity measured in degrees/turn.
    
    Parameters:
    
    velocity - the velocity of the robot.
    
    Returns:
    
    turn rate in degrees/turn.
    
    See Also:
    
    getTurnRateRadians(double)
  - getTurnRateRadians
```
public static double getTurnRateRadians(double velocity)
```
    Returns the turn rate of a robot given a specific velocity measured in radians/turn.
    
    Parameters:
    
    velocity - the velocity of the robot.
    
    Returns:
    
    turn rate in radians/turn.
    
    See Also:
    
    getTurnRate(double)
  - getWallHitDamage
```
public static double getWallHitDamage(double velocity)
```
    Returns the amount of damage taken when robot hits a wall with a specific velocity.
    
    Parameters:
    
    velocity - the velocity of the robot.
    
    Returns:
    
    wall hit damage in energy points.
  - getBulletDamage
```
public static double getBulletDamage(double bulletPower)
```
    Returns the amount of damage of a bullet given a specific bullet power.
    
    Parameters:
    
    bulletPower - the energy power of the bullet.
    
    Returns:
    
    bullet damage in energy points.
  - getBulletHitBonus
```
public static double getBulletHitBonus(double bulletPower)
```
    Returns the amount of bonus given when a robot's bullet hits an opponent robot given a specific bullet power.
    
    Parameters:
    
    bulletPower - the energy power of the bullet.
    
    Returns:
    
    bullet hit bonus in energy points.
  - getBulletSpeed
```
public static double getBulletSpeed(double bulletPower)
```
    Returns the speed of a bullet given a specific bullet power measured in pixels/turn.
    
    Parameters:
    
    bulletPower - the energy power of the bullet.
    
    Returns:
    
    bullet speed in pixels/turn
  - getGunHeat
```
public static double getGunHeat(double bulletPower)
```
    Returns the heat produced by firing the gun given a specific bullet power.
    
    Parameters:
    
    bulletPower - the energy power of the bullet.
    
    Returns:
    
    gun heat

Class Rules

Field Summary

Method Summary

Methods inherited from class java.lang.Object

Field Detail

ACCELERATION

DECELERATION

MAX_VELOCITY

RADAR_SCAN_RADIUS

MIN_BULLET_POWER

MAX_BULLET_POWER

MAX_TURN_RATE

MAX_TURN_RATE_RADIANS

GUN_TURN_RATE

GUN_TURN_RATE_RADIANS

RADAR_TURN_RATE

RADAR_TURN_RATE_RADIANS

ROBOT_HIT_DAMAGE

ROBOT_HIT_BONUS

Method Detail

getTurnRate

getTurnRateRadians

getWallHitDamage

getBulletDamage

getBulletHitBonus

getBulletSpeed

getGunHeat