How It Works

Use the planner to test route ideas, compare starts, and talk through strategy before a practice run.

Workflow

Start in the Mission Tool and define the mission name, start position, heading, and action list. Use the Robot Builder if you want to model the actual footprint of the chassis and any mission attachments.

When the mission looks right, run it directly on the field map or use replay mode to scrub through the route frame by frame. If you are working with a team, save missions and robot profiles through the hosted team cloud.

What The Model Assumes

The simulator is meant for planning, not for precise drivetrain prediction. It helps students reason about geometry and sequencing, but it does not model wheel slip, acceleration, backlash, collision physics, or sensor drift.

Topic Current behavior
Units Centimeters for distance, degrees for heading
Origin Lower-left corner of the field
Heading 0 degrees points along positive X, positive angles turn counter-clockwise
Robot shape One rectangle plus optional rectangular attachments
Turning In-place turns around a configurable front/back offset
Timing Replay timing is illustrative rather than measured from a real robot
Practical Tips

Keep the mission model simple enough that students can understand why the path changes. If a path only works in the simulator when the start pose is extremely exact, that is usually a sign the real robot will need a more reliable alignment method or a better recovery plan.

Using the hub yaw sensor for turns will generally make the simulated route more meaningful, because the visual plan assumes the robot can hit the commanded heading consistently.

Mission JSON

The planner also accepts mission JSON directly. This is useful when you want to share a route, keep versions in source control, or generate paths outside the editor.

{
  "name": "Coral Sweep",
  "startX": 11.5,
  "startY": 0,
  "startAngle": 90,
  "robotWidthCm": 17,
  "robotLengthCm": 15,
  "traceColor": "#108368",
  "offsetY": 1.8,
  "attachments": [
    { "side": "front", "widthCm": 6, "lengthCm": 4, "positionCm": 0 }
  ],
  "actions": [
    { "type": "move", "value": 17 },
    { "type": "rotate", "value": -24 },
    { "type": "move", "value": 50 },
    { "type": "move", "value": -50 },
    { "type": "rotate", "value": 24 },
    { "type": "move", "value": -17 }
  ]
}
Reference Images

These diagrams explain how the turn-center offset and field orientation are interpreted by the planner.

Offset diagram
Field orientation diagram