Action Reference
Navigation Actions appear in Movement Pack in the Action selector. Their controlled Target GameObject identifies the actor; fields such as Destination GameObject, Follow Target, or Threat identify a separate object it reacts to.
Common navigation settings
Bind Result to a MovementResult variable for transitions. Only Running means the Action is still working; a terminal result finishes it, including failure results.
| Setting | Effect |
|---|---|
| Auto Add Movement Agent | Adds the coordinator component when missing. The provider still needs a valid movement component. |
| Stop On End | Stops and clears owned movement on exit; traversal handoff is retained. Disable only when deliberately managing the retained route. |
| Allow Partial Path | Lets an accepted partial path remain active. It does not turn partial-path arrival into complete arrival. |
| Use Timeout, Timeout | Finish with Timed Out after the configured active duration. Explicit state-machine pause time is excluded. |
| Fail When Stuck | Ends movement with Stuck when the agent’s progress test fails. |
| Path Validation Grace | Delays path-status checks after a new destination request so a pending route has time to resolve. |
Seek and Follow expose Completion Mode: Arrival completes on reaching the goal, Stable Arrival requires uninterrupted arrival or in-band time, Duration completes after active time, and Continuous keeps running. Duration completion means the requested time passed; it is not proof of arrival.
Seek
Choose Destination Source: GameObject for a scene target or Position for a world-space point. Arrival Distance supplies an arrival tolerance. With the built-in provider, the larger of this tolerance and the NavMesh Agent stopping distance is used, and the path must be complete rather than pending or partial.
Moving destinations replan only after both Replan Interval and Replan Distance permit another request. Increase the interval to reduce path requests; decrease the displacement threshold when small target motion matters. A position variable is read again during updates, so another Action or script can change it while Seek runs.
Follow
Assign Follow Target, Minimum Distance, and Maximum Distance to define a band. Hysteresis expands the correction boundary so small distance changes do not rapidly alternate approach and retreat. The Action matches the target’s sampled speed while in the band, corrects at the original provider speed outside it, and stops when an in-band target stops.
Face Target rotates horizontally at Rotation Speed while following. The default Continuous mode maintains the relationship. Use Stable Arrival and Stable Duration when the state should finish only after a sustained in-band interval.
Pursue
Assign Pursuit Target. The Action estimates an intercept using target velocity and bounds prediction by Maximum Prediction in seconds. It reads Rigidbody velocity when available and otherwise estimates motion from the target Transform. Default Agent Speed supplies a minimum speed for prediction when current agent velocity is low.
Replan Interval and Replan Distance limit replacement route requests. Completion requires remaining within Arrival Distance of the actual target for Stable Arrival Duration, rather than merely reaching an obsolete predicted point. Reduce prediction for teleporting or sharply turning targets.
Flee and Evade
Flee samples a destination away from the current Threat. Flee Distance controls each escape step; Safe Distance and Safe Duration determine completion. Sample Distance allows a nearby provider-supported point when the ideal escape position is unavailable.
Evade also considers predicted threat velocity. Maximum Prediction is its time horizon. Candidate Count and Candidate Angle bound the alternative escape directions tested on each replan. Safety requires the threat to remain far enough away across the prediction horizon for Safe Duration, so a threat approaching quickly can prevent early completion even when its current distance looks safe.
Neither Action guarantees an escape route in an enclosed area. Handle Destination Rejected, Path Invalid, and Stuck with a recovery state.
Patrol
Assign Waypoints as a GameObject array. Route Mode selects Sequential, Ping Pong, or Random. Arrival Distance controls waypoint arrival and Dwell Duration pauses at each reached point.
Required Cycles: 0 patrols continuously. A positive value finishes after that many cycles. Skip Invalid Waypoints and Maximum Recovery Attempts control bounded recovery from invalid or unreachable waypoints; an empty usable route reports No Waypoints. Keep authored points on navigation data for this agent type.
Wander
Distance sets the forward offset of a desired destination and Maximum Angle bounds a random heading change. Sample Distance and Sample Attempts bound provider sampling around that point. The Action waits for Arrival Distance, optionally dwells for Dwell Duration, then chooses again.
Required Destinations: 0 wanders continuously. A positive count produces a finite Action. Sampling can still fail; use Destination Rejected as a graph decision rather than treating wandering as guaranteed movement.
Move To Cover
Move To Cover combines selection, movement, and arrival validation. It requires a valid provider to check complete routes and exposes the selected cover position, stance, and failure diagnostics. Choose Arrival to finish after stable concealed arrival or Maintain to keep validating and recovering protection. See Cover for setup, search budgets, maintenance, reservations, and output lifetime.