unity-navmesh

NavMesh Skills

Requirements

• com.unity.ai.navigation (≥ 2.0). navmesh_bake and navmesh_clear operate on NavMeshSurface components in the active scene — the scene must contain at least one NavMeshSurface for a bake to do anything.

Overview

Baking and pathfinding.

Common Mistakes

DO NOT (common hallucinations):

• navmesh_create does not exist → use navmesh_bake to generate NavMesh
• navmesh_add_agent_component / navmesh_set_agent_speed do not exist → use navmesh_add_agent + navmesh_set_agent (convenience wrappers), or component_add/component_set_property for full control
• NavMesh must be re-baked after scene geometry changes

Routing:

• For NavMeshAgent/NavMeshObstacle components → use component module
• For path calculation → navmesh_calculate_path (this module)

Skills

navmesh_bake

Bake the NavMesh (Synchronous). Warning: Can be slow. Parameters: None.

navmesh_clear

Clear the NavMesh data. Parameters: None.

navmesh_calculate_path

Calculate a path between two points. Parameters:

• startX, startY, startZ (float): Start position.
• endX, endY, endZ (float): End position.
• areaMask (int, optional): NavMesh area mask.

Returns: { status: "PathComplete", distance: 12.5, corners: [...] }

navmesh_add_agent

Add NavMeshAgent component to an object.

Parameter	Type	Required	Default	Description
name	string	No	null	GameObject name
instanceId	int	No	0	GameObject instance ID
path	string	No	null	GameObject hierarchy path

Returns: { success, gameObject }

navmesh_set_agent

Set NavMeshAgent properties (speed, acceleration, radius, height, stoppingDistance).

Parameter	Type	Required	Default	Description
name	string	No	null	GameObject name
instanceId	int	No	0	GameObject instance ID
path	string	No	null	GameObject hierarchy path
speed	float	No	null	Agent movement speed
acceleration	float	No	null	Agent acceleration
angularSpeed	float	No	null	Agent angular speed
radius	float	No	null	Agent radius
height	float	No	null	Agent height
stoppingDistance	float	No	null	Distance to stop before target