游戏 AI / 系统课时

用调试器确认行为已执行

用调试器确认行为已执行

敌人没有移动,不代表行为树完全没有运行。本课使用 Unreal Engine 的 AI Debugging 和行为树编辑器,在 PIE 运行期间检查当前 AI 实例、活动分支、任务状态及 Blackboard 实时值,区分任务未触发与任务执行失败两类问题。

学习目标

  • 打开 AI Debugging,选择正确的敌人实例并查看运行状态。
  • 在行为树编辑器中识别活动节点和 Blackboard 实时数据。
  • 根据调试现象判断执行异常的原因,并完成重复验证。

准备一个可调试的敌人

开始之前,关卡中应有一个由 AIController 控制的敌人 Pawn。确认敌人设置了正确的 AI Controller Class,控制器已经调用 Run Behavior Tree,行为树也关联了对应的 Blackboard 资产。

例如,项目中使用 BT_Enemy 和 BB_Enemy,行为树包含 Wait 和 Move To 任务。为了观察移动,还需要使用 Nav Mesh Bounds Volume 覆盖敌人所在的可行走区域。

启动 PIE 后,先确认敌人确实被 AIController 附身。只打开行为树资产并看到节点连线,并不能证明这些节点已在运行时执行。

打开 AI Debugging 查看当前任务

  1. 保持 PIE 运行,将视线指向需要检查的敌人。
  2. 按默认的单引号键 ' 开启 Gameplay Debugger,并选中目标敌人。
  3. 按小键盘 1 查看 AIController、Pawn 和活动任务信息。
  4. 按小键盘 2 显示 Behavior Tree 与 Blackboard 调试信息。
  5. 检查显示的控制器、行为树资产及当前活动任务是否与预期一致。

如果默认调试快捷键无法使用,可以在 PIE 的游戏控制台尝试执行以下命令:

text
EnableGDT

预期结果:游戏视口出现 Gameplay Debugger 覆盖层。选中敌人并开启 Behavior Tree 类别后,可以查看当前行为树分支及 Blackboard 键值。该命令不会生成固定格式的控制台输出。

快捷键可能被项目重新绑定,必要时可以到 Project Settings 的 Gameplay Debugger 设置中检查。调试时还应确认游戏视口具有键盘焦点。

PIE 中 AI Debugging 与行为树运行时调试位置

在行为树编辑器检查执行路径

双击打开 BT_Enemy,保持 PIE 运行。在编辑器工具栏的 Debug Object 下拉列表中,选择与视口中敌人对应的运行时实例。

选择正确对象后,可以观察执行路径的高亮变化和当前节点状态。Blackboard 面板显示该实例的运行时键值,而不只是资产定义中的键名称。

建议使用持续数秒的 Wait 任务作为第一个观察点。运行时确认等待节点进入活动状态,再观察等待结束后的下一次任务执行。这比只检查最终角色位置更容易确认行为树确实在推进。

对于依赖 Blackboard 条件的分支,需要同时核对以下信息:

  • TargetActor 是否保存了预期目标。
  • 位置键是否已经写入有效目的地。
  • Decorator 条件是否满足,是否阻止了分支进入。
  • 当前高亮任务是否与 Blackboard 键值变化一致。

根据调试结果定位异常

调试现象 优先检查
没有可选的调试实例 AIController 是否附身、行为树是否启动
行为树存在但分支不进入 Blackboard 键值、Decorator 条件
进入 Move To 后立即失败 目标键、导航网格、目的地可达性
调试数据与敌人动作不一致 是否选择了正确实例、PIE 会话是否匹配

尤其需要区分 任务正在执行 和 任务已经成功完成。例如,Move To 进入活动状态只能说明行为树尝试执行移动,不能说明导航请求一定成功。

可以在 PIE 中使用控制台命令查看导航网格:

text
show Navigation true

预期结果:满足调试显示条件时,视口会显示导航网格的可视化信息。具体覆盖区域由当前关卡的导航数据决定。若目标落在不可达区域,应先解决导航问题,而不是反复修改行为树节点。

完成一次验证后,重新启动 PIE,重复相同操作并记录敌人实例、触发条件、活动任务及关键 Blackboard 值。只有能够稳定观察到键值改变、分支切换和任务执行,才能确认行为已真正跑通。

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

目录与阅读设置

阅读设置

17

记录一个想法

用调试器确认行为已执行

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

登录哪都通