nav
Create navigation regions, agents, and links; bake navmeshes; and query 3D paths in Godot.
Instructions
导航操作。create_region: 创建 NavigationRegion3D（可选烘焙）。bake_mesh: 烘焙导航网格（耗时较长）。create_agent: 创建 NavigationAgent3D。set_params: 设置导航参数。create_link: 创建 NavigationLink3D。query_path: 查询 3D 导航路径。运行时操作，仅影响当前执行上下文。如需持久化，请编辑 .tscn 文件。
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bake | No | create_region: 是否立即烘焙导航网格（默认 false） | |
| name | No | create_region/create_agent/create_link: 节点名称 | |
| action | Yes | 操作类型 | |
| params | No | set_params: 导航参数（仅传入需要修改的字段） | |
| parent | No | create_region/create_agent/create_link: 父节点路径（默认 root） | |
| end_pos | No | query_path: 终点 {x,y,z} | |
| timeout | No | bake_mesh 烘焙超时秒数（默认 120，大场景可调至 600） | |
| position | No | create_region: 位置 {x,y,z} | |
| node_path | No | bake_mesh/set_params: 目标节点路径 | |
| start_pos | No | query_path: 起点 {x,y,z} | |
| end_position | No | create_link: 终点位置 {x,y,z} | |
| project_path | No | Godot 项目目录路径（可选，默认使用 GODOT_PROJECT_PATH 环境变量或当前目录） | |
| bidirectional | No | create_link: 是否双向通行（默认 true） | |
| load_autoloads | No | 是否加载 Autoload 上下文（默认 true） | |
| start_position | No | create_link: 起始位置 {x,y,z} | |
| target_position | No | create_agent: 目标位置 {x,y,z} | |
| avoidance_enabled | No | create_agent: 是否启用避障（默认 false） | |
| navigation_region | No | query_path: NavigationRegion3D 节点路径（可选） | |
| path_desired_distance | No | create_agent: 路径期望距离（默认 0.5） | |
| target_desired_distance | No | create_agent: 目标期望距离（默认 1.0） |