Integrations and Troubleshooting

Use the task variant that matches the pathfinder controlling the agent. Every member of one group should use the same provider.

Pathfinding integrations

Download supported integrations from the Opsive downloads page. Provider-specific tasks appear below that provider in the Formations task menu. For example, an A* Pathfinding Project Grid task appears under Actions > Formations > A* Pathfinding Project > Grid.

After replacing a provider, replace task variants and retune stopping distance, navigation sampling, agent radius, and local avoidance. Importing an integration does not convert existing Unity NavMesh tasks.

The group overlaps at the destination

Increase spacing relative to agent radii and confirm local avoidance is enabled. If every calculated target is the same point, inspect formation-specific fields or custom target math.

The formation flips when the leader turns

The pattern is relative to the leader Transform. Smooth the turn, reduce abrupt destination changes, or change formation only where the group has room to rotate.

One member remains behind

Confirm its provider variant and group data match the others. Verify its slot lies on reachable navigation data and another task has not stopped or redirected the member.

The formation cannot pass through a doorway

Use Column or another narrow pattern for that segment. Increasing speed does not make off-mesh lateral slots reachable.

Two squads merge

Review the group data assigned to their tasks. Scene hierarchy and prefab source do not isolate formation membership.

A removed member leaves stale spacing

Ensure its formation task ends before the object is disabled or pooled, then verify the remaining group’s reassignment behavior.