✏️

Manual Path Editor

Draw custom waypoint paths for precise player and ball movement.

What Is the Manual Path Editor?

The Manual Path Editor lets you draw custom waypoint paths for precise player and ball movement. Instead of a simple straight line or curve, you can create any path with multiple waypoints.

Enabling Manual Mode

  1. Switch to Transition mode on the phase you want to edit.
  2. Select an item (player, ball, cone, or target).
  3. In the arrow settings, change the type to Manual.
  4. Toggle Edit Path to enable the manual path editor.

Adding Waypoints

When the editor is active:

  1. Action: Add is the default mode.
  2. Click anywhere on the pitch to add a waypoint.
  3. The first point is always locked to the item's current position.
  4. The last point is always locked to the item's next-phase destination.
  5. New waypoints are inserted at the best position along the path automatically.
Tip: The path is smoothed using a Catmull-Rom spline through your waypoints. You don't need many points — just place them at key turning positions.

Moving Waypoints

  1. Switch action to Move.
  2. Click and drag any waypoint (except the first) to reposition it.
  3. The last waypoint can be dragged — this updates the item's destination in the next phase.
  4. The path curve updates in real-time.

Removing Waypoints

  1. Switch action to Remove.
  2. Click on any intermediate waypoint to delete it.
  3. The first and last waypoints cannot be removed (they're locked to start/end positions).
  4. A minimum of 2 waypoints is always maintained.

Path Visualization

  • Waypoints appear as colored spheres on the pitch.
  • The path is drawn as a smooth tube through the waypoints.
  • An arrowhead shows the direction at the end.
  • The color matches the item type (blue = home, red = away, yellow = cones, red = targets/ball).
Note: When you're done editing, toggle off Edit Path to return to normal interaction. The manual path is saved automatically with the scenario.

Attaching a Ball to a Player

You can attach a ball to a specific player so the ball follows that player's movement path. When attached, the ball's attached field is set to a "team:index" string — for example "home:3" means the ball is attached to the home team's player at index 3.

  1. Select a ball on the pitch, then open its Path menu.
  2. Choose Attach and pick the player to attach to. The attached field is set automatically (no popup confirmation).
  3. The ball now follows the attached player's path during animation.

To detach a ball, open the Path menu and select Detach. If you change your mind, click Cancel in the path menu to exit without making changes. Detaching clears the attached field and lets the ball move along its own independent path.

Tip: The attached format is "team:playerIndex" — for example "away:7" attaches to the away team's 8th player. Attached balls are great for dribbling sequences where the ball should stick to a player's feet.