Unity Navmesh

Before calling any skill in this module: if you are about to call a skill with parameters guessed from its name or description, STOP — read this file (or fetch its schema via GET /skills/recommend?includeSchema=true) first. If you already have the parameter definitions from recommend/schema, you may proceed straight to dryRun.

Triggers

• Setting up navigation
• Baking a NavMesh
• Testing agent paths
• Tuning bake parameters
• 搭建导航、烘焙 NavMesh、测试 Agent 路径、调整烘焙参数

NavMesh Skills

Bake / clear NavMesh data, calculate paths, sample positions, and configure NavMeshAgent / NavMeshObstacle components.

Operating Mode

• Approval：查询类 skill（navmesh_calculate_path / navmesh_sample_position / navmesh_get_settings，源码标 SkillMode.SemiAuto）直接执行；变更类（navmesh_bake / navmesh_add_agent / navmesh_set_agent / navmesh_add_obstacle / navmesh_set_obstacle / navmesh_set_area_cost，标 SkillMode.FullAuto）需用户 grant，grant 后服务端一步执行返结果。
• Auto / Bypass：所有未被禁列表拦截的 skill 直接执行。
• 本模块含 Delete 类 skill：navmesh_clear 标记为 SkillOperation.Delete，会被 IsForbiddenInSemi 静态拦截 —— 仅 Bypass 模式或将其加入 Allowlist 才能调用。
• navmesh_bake 同步阻塞主线程；大场景可能很慢，调用前提醒用户。

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: blocks the Editor, can be slow on large scenes. 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, valid, distance, cornerCount, corners }

• status: NavMeshPathStatus string (PathComplete / PathPartial / PathInvalid)
• valid: true only when status == "PathComplete"
• distance: total path length (0 for invalid paths)
• cornerCount: number of corner points in corners
• corners: array of {x, y, z} waypoints (empty when no path)

navmesh_add_agent

Add NavMeshAgent component to an object.

Returns: { success, gameObject }

navmesh_set_agent

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

Returns: { success, gameObject, speed, radius }