Task Reference

Movement tasks answer different navigation questions. Choose the task whose completion semantics match the graph instead of compensating with extreme distances or timeouts.

Cover

Cover searches candidate points relative to a threat, rejects unsuitable locations, and navigates to the selected result. Configure layers and search distance so the query examines protective geometry rather than every nearby collider.

Test narrow pillars, long walls, corners, and a moving threat. A point can be geometrically behind cover but unreachable by the selected pathfinder, so validate both the cover query and sampled navigation destination.

Seek, Pursue, and Follow

• Seek follows the target’s current position without prediction.
• Pursue predicts ahead using target velocity and Target Distance Prediction.
• Follow maintains the configured distance instead of trying to reach the target pivot.

Prediction amplifies velocity noise. Cap look-ahead for animated, network-interpolated, or teleporting targets. Seek is often more stable when direction changes abruptly.

Flee and Evade

Flee chooses a destination directly away from the target’s current position. Evade estimates the target’s future position from its velocity before choosing the escape direction. In both tasks, Look Ahead Distance sets the escape-step distance; it does not itself predict target motion.

Both tasks need navigable space away from the threat. A world-space direction directly away can still be unreachable around a wall, so provide a fallback for confined spaces.

Patrol

Patrol iterates authored waypoints and can wait at each one. Keep every waypoint on reachable navigation data and far enough from walls for the agent to enter its arrival radius.

Decide in the surrounding graph whether an interruption resumes the current waypoint or resets the route. That behavior is separate from the waypoint positions.

Wander

Wander repeatedly chooses destinations within its allowed area. A large radius produces travel; a small radius with frequent updates can produce indecisive turning. Restrict samples to the same navigation area and agent type used by the pathfinder.

Move Towards and Rotate Towards

Move Towards changes position directly and does not route around obstacles. Rotate Towards changes rotation directly and does not request a path. Use them for controlled unobstructed actions, not as replacements for a pathfinder.

Verify task status

Test the Success, Failure, Running, interruption, and unreachable-target paths used by the surrounding graph. A large arrival distance can hide an invalid route by succeeding from the wrong side of an obstacle.