Skip to main content
Version: Next (dev)

Navmesh Path Test Component

Navmesh Path Test (plAiNavMeshPathTestComponent) requests a route between two objects and draws the result. It tests pathfinding without moving a character or running behavior logic.

Test a route​

  1. Create a floor with static physics collision and an obstacle to route around.
  2. Configure a navmesh type and path search type in AI project settings.
  3. Place two objects near the floor, one on each side of the obstacle. Add Navmesh Path Test to the start object.
  4. Assign the destination object to PathEnd using an object reference.
  5. Select NavmeshConfig and PathSearchConfig, and enable all three visualization options.
  6. Simulate the scene. Allow time for the requested sectors to build.

The corridor is the set of navmesh polygons used by the route. The path line is the route through that corridor. The state text describes the search status; a partial route is not proof that the destination can be reached.

Move the destination while simulating to inspect route changes. Test a destination on the same open floor first, then across a doorway, around an obstacle, and in an intentionally unreachable area.

Properties​

PropertyPurpose
PathEndDestination object reference.
NavmeshConfigPhysical navmesh configuration.
PathSearchConfigGround permissions and traversal costs.
VisualizePathCorridorDraw the polygons making up the route.
VisualizePathLineDraw the line through the corridor.
VisualizePathStateDraw the search state at the start object.

If nothing appears​

  • Confirm that the scene is simulating and PathEnd resolves to an existing object.
  • Check both configuration names and move both endpoints close to walkable ground.
  • Set AI.Navmesh.Visualize = 0 in Panels > CVars to inspect the generated mesh.
  • Verify the floor's collision layer, surface ground type, slope, and agent clearance.
  • If the search area is large, inspect AI.Navmesh.ShowBuildStats or prebuild a smaller test region.

Once this test succeeds, use the same settings on AI Navigation. If the NPC then fails to move, investigate its destination request, movement mode, or controller separately from pathfinding.

See also​