游戏 AI / 系统课时

定位移动失败原因

定位移动失败原因

敌人进入追击分支却原地不动,或 Move To 刚启动就失败,并不一定是任务节点坏了。本课把问题拆成导航覆盖、角色尺寸与碰撞、目标键值、寻路配置和运行状态五层,按可复现、可观察、可排除的顺序定位根因。

学习目标

  • 用导航显示与 AI 调试器确认敌人是否拿到了有效移动任务。
  • 逐层检查 NavMesh 连通性、Agent 参数、碰撞与目标位置。
  • 区分真正的移动失败、未结束的移动和被行为树主动中断。

固定一个最小复现场景

准备带 CharacterMovement 的敌人 Character、负责控制它的 AIController、已启动的 Behavior Tree,以及类型为 Actor 的 Blackboard 键 TargetActor。先只测试一个 Move To:让目标站在开阔地面,不要同时运行随机巡逻、攻击或频繁改写目标的 Service。

进入 PIE 后,在 Behavior Tree 资产的调试对象选择器中选中这只敌人。若根本没有进入 Move To,优先检查 AIController 是否占有 Pawn、行为树是否运行、Decorator 是否挡住分支。只有任务实际被执行,才继续查导航。

检查导航覆盖、碰撞与 Agent

在关卡视口按 P 显示 NavMesh。敌人脚下和目标附近都应有可走区域,而且两处必须属于实际可连接的导航区域;同为绿色但被墙、深沟或断层隔开的区域,不保证存在路径。检查 Nav Mesh Bounds Volume 的范围,必要时重建导航。

在运行中的游戏控制台执行:

text
show Navigation true

预期结果:运行画面显示可通行导航面,可以直观看到敌人起点、目标落点及中途的缺口。这是视图效果,不是会打印固定文本的控制台命令。

如果只有窄门、斜坡或台阶前失败,检查角色胶囊体的半径和高度,以及导航数据的 Agent Radius、Agent Height、Agent Max Slope、Agent Max Step Height。NavMesh 允许规划的通道不一定容得下实际碰撞体;反过来,碰撞物的导航影响设置也可能把本应可走的区域挖空。先修正几何和 Agent 匹配,再考虑放宽路径限制。

核对目标数据和 Move To 选项

运行时观察 Blackboard 中的 TargetActor:它必须是有效的目标 Actor,不能已销毁、未设置或意外被 Service 清空。如果改用 Vector 键,确认值不是尚未初始化的零向量,且位置可投射到合适的导航面;楼上楼下仅有相近的平面坐标并不意味着可达。

再核对 Move To 的 Blackboard Key 是否选对。Track Moving Goal 用于跟踪会移动的目标 Actor;Observe Blackboard Value 处理黑板目标值的改变;Project Goal Location 尝试把位置投射到 NavMesh,但无法修复起点不在导航面或导航区域不连通的问题。Allow Partial Path 只允许沿不完整路径前进,不等于保证到达原目标。

用运行状态判断故障层

在 PIE 按英文单引号键 ' 打开 AI Debugger,使用数字小键盘 1 看控制器与移动状态、2 看行为树和 Blackboard、0 看导航数据;具体快捷键可参见 Unreal 官方 AI Debugging 文档。

观察到的现象 优先判断 下一步
Move To 立即 Failed 目标无效、找不到路径或移动请求被拒绝 检查黑板键、起点和终点的可达性
持续 In Progress 却卡住 碰撞阻挡、动态障碍或一直达不到终点判定 对比导航路径、胶囊体和到达半径
频繁被 Aborted 高优先级分支抢占或 Decorator 观察到键变化 查看是哪次状态更新触发了中断
很快 Succeeded 但看起来没靠近 已满足 Acceptable Radius 和可选的胶囊半径判定 核对预期停止距离,而不是当作寻路错误

Move To 移动失败的逐层诊断流程

修复后做三组回归

  1. 把目标放在同一块连续导航面内:敌人应能绕过静态障碍并进入预期停止距离。
  2. 把目标移到不可达平台:应能识别无完整路径或合理的部分路径,而不是把 Allow Partial Path 误判为成功抵达。
  3. 在运行时移动或清空目标:确认追击更新合理,失去目标时分支有明确回退,且不会反复触发无效移动请求。

一次只改一个设置,并记录起点、目标、NavMesh 形状、Acceptable Radius 和最终任务状态。这样下一次出现相同故障,才能快速定位到真正的失败层。

按自己的节奏,确认真正理解。

目录与阅读设置

阅读设置

17

记录一个想法

定位移动失败原因

0 / 10000 · 笔记保存到账号。未提交的修改会在关闭、离开或刷新后丢失。

登录哪都通