游戏 AI / 系统课时

排查查询结果为空

排查查询结果为空

EQS 在编辑器里看似配置完整,运行时却可能没有候选点、所有候选被过滤,或明明选出了赢家而敌人仍不移动。本课用“查询是否执行→是否生成→是否过滤→是否可导航→是否正确消费”的顺序定位问题,避免盲目放宽全部条件。

学习目标

  • 区分 EQS 未执行、候选为零、测试全失败和移动失败四类现象。
  • 使用 EQS Testing Pawn 与运行时 AI Debugger 找到候选消失的环节。
  • 逐一验证 Generator、Context、Test、NavMesh 和过滤阈值并恢复合理条件。

先确认故障发生在哪一层

先在 Behavior Tree 调试器中选中目标敌人,看 Run EQS Query Task 是否真正进入执行状态。如果它根本没有运行,优先检查 AIController 是否占有 Pawn、行为树是否启动、上层 Decorator 是否挡住分支。若查询成功但 Move To 失败,问题更可能在 Blackboard 键类型、导航连通性或移动代理,而不是“EQS 没有结果”。

可观察现象 优先检查
查询节点从不执行 行为树分支、Decorator、AIController
没有生成任何点 Generator 的范围、密度和生成中心 Context
有点但全部判失败 Trace、Distance、Pathfinding Test 的过滤条件
有 Winner 但无法移动 Blackboard 写入类型、NavMesh、Move To 终点

用调试工具复现

在关卡中放置 EQSTestingPawn 类型的测试 Pawn,给它的 Query Template 指定出问题的 EQS。选择测试 Pawn 后观察候选球体,启用 Draw Failed Items、Draw Labels,并切换 Step to Debug Draw,对比每个 Test 前后的剩余点数及失败原因。注意测试 Pawn 的查询者与实际敌人不同:若 Generator 或 Context 依赖 Querier、AIController 或玩家目标,需要在运行时再验证一次,不能以静态预览结果替代真实执行。

在 PIE 中打开控制台,输入下面的内置调试命令:

text
EnableGDT

预期结果:游戏视口出现 Gameplay Debugger 覆盖层(需启用相关调试功能)。选中敌人后,通过小键盘 3 切换 EQS 数据,小键盘 0 查看导航信息,小键盘 2 对照行为树;实际展示内容取决于是否运行过查询。

从候选生成到 Blackboard 消费的 EQS 空结果诊断流程

逐层恢复有效候选

按下面的顺序操作,每次只改一处,记录“生成数、通过数、Winner 是否存在”,否则很难判断究竟是哪项修复生效。

  1. Generator:暂时关闭所有 Test,只保留一个简单的 Grid 生成器。检查网格半径、间距、生成中心是否位于预期区域。连点都没有,说明问题尚未进入评分阶段。
  2. Context:检查生成中心和各 Test 使用的 Context。默认 Querier 对应实际查询发起者;自定义 Context 要返回有效 Actor 或位置。TargetActor 未设置时,以玩家为基准的测试可能拿不到参考目标。
  3. Tests:逐个恢复 Test。先改为仅评分或临时取消过滤,确认候选是否可通过;再恢复 Trace 的检测方向、碰撞通道与遮挡要求,并核对 Distance Test 是按谁到谁的距离计算。
  4. 导航:在编辑器按 P 检查 NavMesh 可视化,确认敌人周围与预期目标区域都具有可通行网格,并检查断开的导航岛。若启用 Pathfinding Test 或投射到导航面的步骤,核对寻路起点、代理尺寸和投射范围。
  5. 过滤阈值:最后检查距离上下限和布尔过滤条件。Unreal 默认以厘米为距离单位;例如要求距玩家 600~900 cm,但生成器只在玩家周围 300 cm 取点,必然不可能通过距离过滤。

区分空结果和错误的赢家

“没有 Winner”通常属于生成或过滤失败;“有 Winner,但总在错误的位置”属于评分方向、权重或参考 Context 的问题。检查 Test 的 Scoring Equation、归一化与权重,确保“离目标远”或“有掩体”等偏好没有被设置成相反方向。

若 Winner 正确但 TacticalLocation 没值,检查 Run EQS Query 的 Blackboard Key 是否为 Vector,以及该查询返回的是位置而不是 Actor。如果键有效但 Move To 失败,应单独验证终点的导航可达性。查询失败时也要确认 Update BB on Fail 的清理行为,防止旧值被误当成新结果。

验证修复没有破坏战术目的

最终在无遮挡、贴墙、窄通道和目标移动四种场景复测:生成器能覆盖候选区域,关键 Test 不会把所有点意外淘汰,Winner 满足战术要求且移动可达。让敌人走完一次“发现目标→查询→写入→移动”的闭环,再恢复查询频率和严格过滤条件。

只有候选生成、过滤评分、黑板写入、导航执行都被分别确认,才能认定“空结果”问题真正解决。

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

目录与阅读设置

阅读设置

17

记录一个想法

排查查询结果为空

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

登录哪都通