๐Ÿค– UNEARTHED Run Planner

Plan multiple robot runs sharing the 2:30 match. Click missions, tune your robot, and drive them in sequence.

Click mission = add/remove from active run Bends = route around obstacles ๐Ÿ  Click a base = add a base visit (base-to-base is a route too)

Robot

cm/s
s/90°
sec

Runs

    ๐Ÿ“– Full reference guide

    ๐Ÿ“– How to Use the Run Planner

    A complete guide to planning your 2:30 LEGOยฎ FLL Unearthed match. Everything you need to know โ€” from adding your first mission to saving and reloading plans.


    1. The Field

    The central SVG is a top-down map of the FLL Unearthed playing mat. It uses a grid coordinate system: columns Aโ€“J (left to right) and rows 1โ€“6 (bottom to top). Each grid cell equals 20 cm in real life.

    ABC DEF GHI J 123 456 RED HOME BLUE HOME 1 2 3 4 5 6 7 8 9 10 11 12 13 14 gy gx โ†’
    The field grid: gx 0โ€“10 (leftโ†’right), gy 0โ€“6 (bottomโ†’top). Each cell = 20 cm.

    There are 14 mission models on the field, each placed at a specific grid cell. The two home zones (Red on the left, Blue on the right) are where your robot starts and finishes each run.

    ๐Ÿ”ด
    Red Home
    Left side, bottom-left corner. Click to add as a start/end point.
    ๐Ÿ”ต
    Blue Home
    Right side, bottom-right corner. Routes can end here for base-to-base runs.
    ๐ŸŽฏ
    14 Missions
    Numbered circles. Click to add/remove from the active run.

    2. Building Your First Route

    A route is an ordered list of stops: missions, base visits, or bend waypoints. Click to build one step by step.

    1

    Select your home base. In the Robot settings panel (top-right), choose Red โ—ค or Blue โ—ฅ. Your robot always launches from this base.

    2

    Click a mission on the field. Each click adds that mission to your current route. The mission circle turns golden yellow and gets an order number badge.

    3

    Click again to remove. A second click on the same mission removes it from your route.

    4

    Watch the route draw automatically. A dashed line connects Home โ†’ each stop in order โ†’ back to Home. The route color matches the active run's tab color.

    HOME 1 2 3 4 robot
    Example route: Home โ†’ M01 โ†’ M02 โ†’ M03 โ†’ M04 โ†’ Home. The robot visits each in order and returns.

    3. Adding Bend Waypoints (Bends Mode)

    Sometimes you need to route around obstacles. Use bends mode to add custom waypoints between missions.

    1

    Click "โœ๏ธ Bends: OFF" in the Runs panel. It turns purple and says "Bends: ON".

    2

    Click anywhere on the field. A purple dot appears โ€” that's a bend waypoint. The route bends to pass through it.

    3

    Reorder or remove bends. Use the โ†‘/โ†“ and โœ• buttons in the route list, just like with missions.

    How it works: Click "โœ๏ธ Bends: OFF" to enable bends mode. Then click anywhere on the field to place a bend waypoint (shown as a purple dot). The route will pass through each bend waypoint in order, creating a path that goes around obstacles between missions.

    Tip: Bend waypoints don't have a stop time โ€” the robot just passes through them. They only affect the route geometry and total distance calculation.

    4. Editing Mission Stop Times

    Each mission has its own dwell time โ€” how long the robot pauses to complete the task. The default is 2.5 seconds.

    1

    In the route list (right panel), each mission stop shows an editable time field next to its name.

    2

    Type a new value and press Enter. The total time recalculates instantly.

    3

    Base visits (home base stops) also have an editable time โ€” useful for attachment swaps. Default is 0 s.

    Route list (Run 1) 1 M01 Surface Brushing 3.0 s 2 M02 Map Reveal 2.0 s 3 M04 Careful Recovery 4.5 s โ€ข bend waypoint (no stop time)

    Stop time impact on total

    The total match time is: driving + turning + stop times. Increasing a mission's stop time by 1 second adds exactly 1 second to the total.

    Total = Driving time + Turning time + Stop times Driving (108s) Turn (18s) Stop (54s) Budget: 150s

    5. Robot Settings & Stats

    The Robot settings panel controls physics calculations. These values must match your real robot for accurate time estimates.

    SettingDefaultWhat it does
    Drive speed20 cm/sHow fast the robot moves forward. Higher = faster, less driving time.
    Turn speed1.5 s/90ยฐTime to rotate 90ยฐ. Angle changes at each corner: (degrees รท 90) ร— turn_speed.
    Match time150 sTotal match duration (2:30). Used for the budget bar and over-time warnings.
    Start homeRed โ—คWhich base Run 1 launches from. Red = left, Blue = right.
    BackgroundPlainToggle between Grid (with red gridlines) and Plain (clean view).

    The Stats Panel

    Beneath the route list, the Stats panel shows a live breakdown for the active run:

    Distance
    Total route length in cm (grid distance ร— 20)
    Driving
    Distance รท speed = driving time in seconds
    Turning
    Angle changes รท 90 ร— turn speed = turning time
    At missions
    Sum of all stop times for missions + base visits
    Tip: The "Starts / ends at" line shows which home base the run uses. This updates automatically when you add or remove base visit stops.

    6. Planning Multiple Runs

    A real match has one robot driving multiple runs. Each run is a launch from base โ†’ missions โ†’ home (or another base). All runs share the 2:30 budget.

    1

    Add runs with the "+" button next to the tab bar. Each new run gets a unique color and its own route.

    2

    Click tabs to switch between runs. Missions you click get added to whichever tab is active (highlighted in orange).

    3

    Runs chain automatically. Run 1 starts at your chosen home base. Run 2 starts where Run 1 ended. If Run 1 ends at a mission (not a base), it returns to its start โ€” so Run 2 also launches from the same base.

    4

    Base-to-base runs are special: if the last stop in a run is a base visit (๐Ÿ ), that run ends at that base. The next run starts there instead.

    How runs chain together H 1 2 Run 1: Home โ†’ M01 โ†’ M02 โ†’ Home (returns to start) H 3 4 5 H Run 2: Home โ†’ M03 โ†’ M04 โ†’ M05 โ†’ Blue base (ends at Blue!) Run 3: Starts at Blue base (where Run 2 ended) โ†’ missions โ†’ returns to Blue

    All Runs Summary

    At the bottom of the panel, a stacked bar chart shows each run's time as a colored segment vs. the 150s budget. If the total exceeds the budget, it turns red with โš ๏ธ.

    All Runs Total Run 1: 52s Run 2: 68s Run 3: 30s 150s budget Total: 150s / 150s โ€” Right on budget!

    7. Base-to-Base Runs

    This is one of the most powerful features: you can plan runs that end at a different base than they start from, chaining your strategy across the match.

    1

    Add a base visit as the last stop in a run. Click either the Red or Blue home square on the field to add a ๐Ÿ  base visit to your route.

    2

    The run now ends there. Instead of returning to its start base, the robot stays at the base you clicked.

    3

    The next run starts from that base. Run 2 auto-launches from where Run 1 ended โ€” saving drive time and positioning your robot strategically.

    Strategy tip: Plan a long sweep run (e.g., bottom-left to bottom-right) that ends at the Blue base. Then Run 2 can start from Blue and tackle missions on the far side without backtracking all the way across the field.

    8. Driving All Runs (Animation)

    When your plan is ready, click "โ–ถ Drive all runs" to watch a replay of your strategy.

    1

    The robot (orange triangle) appears on the field and follows each run's route in sequence.

    2

    It turns visually at each corner โ€” you can see the triangle rotate to face the next segment. Turn time is calculated from your turn speed setting.

    3

    At missions, it pauses and turns red while "working." The pause duration equals the mission's stop time.

    4

    A live timer in the top-right corner shows elapsed match time (โฑ 45.2s / 150.0s). It counts real seconds, not the sped-up animation.

    5

    After all runs complete, it displays "โœ“ Match complete" with the final total time.

    The animation runs in your browser โ€” open the app and click "โ–ถ Drive all runs" to see it live.

    Note: The animation plays runs sequentially (one after another) with a brief pause between them. This matches how a real competition works โ€” one robot, multiple launches.

    9. Save & Load Plans

    Your entire plan can be saved as a JSON file and reloaded later. Perfect for sharing strategies with teammates or keeping multiple plans.

    1

    Save: Click "๐Ÿ’พ Save plan". A file downloads as run-plan-YYYY-MM-DD.json.

    2

    Load: Click "๐Ÿ“‚ Load plan" and select a previously saved JSON file. Everything restores โ€” all runs, routes, stop times, robot settings.

    What gets saved:

    The save file includes everything: your robot settings (speed, turn speed, budget, home base), all runs with their routes (missions, bends, base visits in order), and every stop time. You can share these files between team members or keep different strategy versions.

    Route stop types: t: "m" = mission, t: "h" = base visit, t: "b" = bend waypoint


    10. Tips & Best Practices

    Pro tip: Start with a simple plan (2โ€“3 missions per run), drive it, check the times, then add more. Iterating gradually is faster than building a complex plan and finding it's over budget.

    ๐Ÿค– Happy Planning!

    You now know everything about the Unearthed Run Planner. Go build a winning strategy for your team!