用途:为 Godot 游戏提供 AI 寻路方案,覆盖塔防、RTS、潜行等需要单位移动与避障的场景,核心基于 NavigationAgent2D/3D 与 NavigationServer。
主要能力:2D 与 3D 基础移动(get_next_path_position 取下一路径点,配合 move_and_slide);追击玩家与巡逻点两种常见模式;通过 avoidance_enabled 与 radius 实现群体避障;使用 NavigationObstacle2D 处理移动障碍;附带 dynamic_nav_manager.gd 脚本用于移动平台等运行时导航网格更新;支持 velocity_computed、navigation_finished 等信号处理。
使用方式:场景中加入 NavigationRegion2D(绘制可行走区域并烘焙导航网格),单位挂 NavigationAgent2D/3D。基本流程为在 _ready 用 call_deferred 延迟初始化,等待 get_tree().physics_frame 后再设置 target_position,物理帧内检查 is_navigation_finished(),再取下一路径点计算方向并 move_and_slide。追击时可用 chase_range 判断距离后设定目标;巡逻用 patrol_points 数组循环切换目标。
限制与注意事项:_ready() 中直接设置 target_position 会因 NavigationServer 未就绪而静默失败;运行时不要用 NavigationRegion2D.bake_navigation_polygon() 同步烘焙,以免卡顿,应改用 NavigationServer2D 动态更新或预烘焙;到达目标后需检查 is_navigation_finished(),否则会沿旧路径移动;启用避障时必须设置 radius,否则默认 0 会穿过其他单位;追击 AI 不要每帧轮询 target_position,建议用 0.2 秒定时器或距离阈值;目标不可达时 get_next_path_position() 可能失效,应先用 is_target_reachable() 校验。其他性能参数如 path_desired_distance、path_max_distance、max_neighbors 可按需配置。官方更详细说明可参考 Godot 导航文档。