Documentation

Unity Engine


User Manual

Script Reference

Unity Engine


pathfindingIterationsPerFrame

The maximum number of nodes processed for each frame during the asynchronous pathfinding process.
Read time 1 minuteLast updated 10 days ago

Definition

  • Type: Property
  • Namespace: UnityEngine.AI
  • Assembly: UnityEngine.AIModule
public static int pathfindingIterationsPerFrame { get; set; }

Remarks

During the pathfinding process, the pathfinder expands only a certain number of nodes (NavMesh polygons) for each frame. This allows for smoother gameplay when processing long paths or when processing a large number of requests concurrently. However, the path request might take many frames to process.
The iteration count only affects asynchronous pathfinding. This method of pathfinding is used when the NavMesh Agent destination is set with NavMeshAgent.SetDestination or _destination.
Increasing this value causes faster path processing but it might also cause frame rate issues. The default value is 100. An ideal value is between 50 and 500.