SuperAPI AI 工具集

godot-ai-navigation

智能体与模型

查看项目

更新于 10-15 23:40

技能介绍

用途:在 Godot 中为 AI 移动做决策路由,基于 NavigationAgent/NavigationServer,帮助判断该用节点代理还是 NavigationServer RID、该烘焙还是用障碍物,并给出追击与巡逻的重定向策略。

主要能力:提供三组决策树。其一,节点代理 vs RID:2D 俯视/横版且少于约 50 个代理、需编辑器微调用 NavigationAgent2D 配 CharacterBody2D;3D 地面/斜坡同理用 NavigationAgent3D;成百上千简单移动体用 NavigationServer 的 RID 代理;卡住或抖动时先做卡住恢复。其二,烘焙 vs 障碍:可行走几何变化用异步解析与烘焙;移动平台用动态区域管理;投射物/滚动危险用 RVO 障碍避免整体重烘焙;偏好道路可用区域进入/通行成本。其三,层、链接与群体:用导航层位掩码做行走/飞行/游泳或阵营过滤;用 NavigationLink 处理跳跃/传送/电梯;用领队相对偏移做编队与防聚集;复用查询参数/结果对象减少热路径分配。

使用方式:按决策树分类需求,只打开所选行对应的寻路脚本,不要加载其余脚本。追击按约 0.2 秒定时器或距离阈值重定向,绝不每物理帧设置 target_position;巡逻仅在 is_navigation_finished() 且 is_target_reachable() 时推进路点,不可达则跳过或重寻路。状态归属由 godot-state-machine-advanced 负责,本技能只决定状态请求目的地后如何重定向。

限制与禁忌:首次 target_position 前必须 call_deferred() 并 await get_tree().physics_frame;不得同步运行时烘焙,应使用 bake_from_source_geometry_data_async;不得每帧轮询追击目标或调用 get_path();不得忽略 is_target_reachable() 与卡住恢复;启用避让时半径不得为 0。若未安装 godot-navigation-pathfinding,仅可使用最小卡住恢复清单,不要凭记忆粘贴完整烘焙或 RID 教程。

适用场景:RTS 单位移动与 RVO 群体、塔防路径敌人与动态阻挡、潜行守卫巡逻、战斗中的交战/风筝/侧翼移动等。依赖 godot-navigation-pathfinding、godot-characterbody-2d、godot-2d-physics、godot-physics-3d 等前置技能。