RBN-CODE

Arena

When accessing an arena, the page will look like this:

Arenas only pause when:

• Waiting for robot connection, usually with browser robots.
  Displayed as a red "(precheck) ..." error in the sidebar.
  Just connect a brain via the Robot Control Panel.
• Other robot errors
  Displayed in sidebar as red text under a robot.
• The simulation has stopped
  Notification shown at the top of the screen.

Additional details are shown below the current Arena:

Get a Robot ID and Key from Arenas, which can be used to upload robots via the Robot Manager. Direct uploads from the Robot Control Panel is also possible.

The Robot ID can be used to add uploaded robots into other arenas via the Arena Builder.

Robots

• Each robot has a "brain", consisting of functional code
• There are two types of robots:
  • browserbots run client-side in the browser
  • serverbots run server-side and are uploaded browserbots
• Browserbots are used for development and testing
  • Browserbots are always called Debug <number>
  • Convert browserbots into serverbots via the Robot Manager
  • Serverbots run faster and have custom names and teams
  • Serverbots are harder to debug
• Robots receive context - "brain" input and output:
  { "state": { "name": "Debug 1", "team": "Team Debug 1", "health": 85, "position": { "x": 450, "y": 650 }, "angle": 2.1400183660255045, "angleToCenter": 4.71238898038469, "maxForce": 0.001, "maxRotate": 0.272, "scanner": { "wall": [], "robot": [ { "entityType": "robot", "id": 51322, "x": 192.43402603984921, "y": 349.9999999999999, "speed": 7.381, "angle": 3.141592653589793, "angleFromRobot": 6.283185307179585, "range": 142.43402603984921, "active": true, "name": "Debug 2", "team": "Team 2" } ], "projectile": [ { "entityType": "projectile", "id": 52277, "x": 171.4173413305188, "y": 349.9999999999999, "speed": 10.503, "angle": 0, "angleFromRobot": 6.2831853071795845, "range": 121.41734133051881 } ], "ALL": [ { "entityType": "projectile", "id": 52277, "x": 171.4173413305188, "y": 349.9999999999999, "speed": 10.503, "angle": 0, "angleFromRobot": 6.2831853071795845, "range": 121.41734133051881 }, { "entityType": "robot", "id": 51322, "x": 192.43402603984921, "y": 349.9999999999999, "speed": 7.381, "angle": 3.141592653589793, "angleFromRobot": 6.283185307179585, "range": 142.43402603984921, "active": true, "name": "Debug 2", "team": "Team 2" } ] }, "proximity": [ { "entityType": "wall", "id": 51314, "x": -5, "y": 350, "speed": 0, "angle": 0, "angleFromRobot": 3.141592653589793, "range": 26.35326595073043, "entitySubtype": "west" }, { "entityType": "robot", "id": 51322, "x": 68.81672460300315, "y": 345.59091911817507, "speed": 2.744, "angle": 2.9182367723982225, "angleFromRobot": 6.0599183837452015, "range": 43.54425745702567, "active": true, "name": "Debug 2", "team": "Team 2" } ], "lastDamage": [ { "atFrame": 132, "type": "collision", "origin": { "entityType": "wall", "entitySubtype": "west" } }, { "atFrame": 134, "type": "hit", "origin": { "entityType": "robot", "name": "Debug 2", "team": "Team 2" } } ] }, "round": { "remaining": 50.5, "active": 3 }, "memory": {}, "action": { "desiredAngle": 0.05, "desiredForce": 0.0005, "desiredLaunch": false, "desiredScan": 150 } }
  • context.state contains current information about the robot
  • robots have two main sensor inputs:
    • context.state.scanner list things in front of it
    • context.state.proximity list things within close range
• The "brain" sets context.action to control:
  • robot rotation / .desiredAngle
    a number in radians, maximum possible per frame is stored in context.state.maxRotate
  • robot forward movement / .desiredForce
    a number representing force, maximum possible per frame is stored in context.state.maxForce
  • projectile launch / .desiredLaunch
    a boolean value, actual launch rate is limited by the server
  • scan distance / .desiredScan
    a number, far scans are narrower; near scans are wider
• context.round contains information about the current round
• Robots are stateless and do not "remember" anything
  Frame-to-frame storage is available with context.memory
• Code is run every frame, 60 frames = 1 server second
• Robots are damaged by: projectiles, robot bodies, walls
• Serverbots are also damaged from syntax errors; and brain timeouts, caused by hanging code
  Server-side damage show as blue sparks
• Browserbots depend on the internet and run slower.
• A faster way to code and test robots is to run a local server. This platform is open-source, can run offline locally. The link is available in the page footer.