Configuration and Tuning

Export

Tune formation math and movement on open navigation data before testing corners, doors, slopes, or combat interruptions.

Group membership

  • Is 2D changes the formation calculation for a 2D space.
  • Formation Group ID separates independent groups. Agents cooperate only with members using the same ID.
  • Force Leader makes this agent the leader. Avoid enabling it on more than one member of the group.

Leader and orientation

  • Target Position is the destination assigned to the group.
  • Formation Direction uses the leader Transform, movement direction, or a specified vector.
  • Specified Direction is used only when Formation Direction is Specified.
  • Move To Initial Formation makes members assemble before the leader begins traveling.
  • Fail On Agent Removal fails the task when a member leaves.
  • Update Unit Locations On Agent Removal recalculates assignments after a member leaves.

Movement stability

  • Rotation Speed and Rotation Threshold control how quickly and precisely agents align.
  • Out Of Range Distance Delta and In Range Distance Delta define separate boundaries for leaving and re-entering the acceptable formation range.
  • Out Of Range Speed Multiplier helps a lagging member catch up.
  • Stuck Duration determines how long zero velocity is tolerated.
  • Stop On Task End stops the pathfinder when the formation task finishes.

Use the two range deltas as hysteresis. Keep a gap between them so small position changes do not repeatedly toggle catch-up behavior at one boundary.

Set Out Of Range Speed Multiplier high enough to close a gap without exceeding the pathfinder or animation’s stable speed. Stuck Duration should tolerate an ordinary local-avoidance pause but detect a member that truly cannot reach its slot.

Tune spacing and assignment

  1. Set adjacent spacing above the combined radii of neighboring agents.
  2. Verify the leader and formation direction.
  3. Confirm each member chooses a stable slot without crossing several neighbors.
  4. Move the target slowly, then at gameplay speed.
  5. Add corners, doors, slopes, and local avoidance.
  6. Remove one member and verify the configured reassignment policy.

If the pattern exposes optimized assignment, use it when minimizing travel and crossing matters. A pattern that intentionally preserves authored or random membership may opt out so index meaning remains stable.

When members continually trail, compare the leader’s speed with follower acceleration and the catch-up multiplier. Formation settings cannot preserve a rigid shape when the leader permanently moves faster than followers can recover.