游戏 AI / 系统课时
配置 NavMesh 测试区域
配置 NavMesh 测试区域
行为树的 Move To 一直失败,未必是 Task 或 Blackboard 错误;敌人脚下或目标位置可能没有可用导航网格。本课用小型关卡建立 NavMesh 测试范围、核对绿色可通行区域,再让敌人绕障碍抵达目标点。
学习目标
- 放置和调整
Nav Mesh Bounds Volume,生成覆盖测试地面的导航网格。 - 在编辑器和运行时检查可通行区域,识别网格缺失与断裂。
- 通过一次实际寻路区分导航配置问题和行为树逻辑问题。
准备最小测试关卡
新建或打开一个 UE5 测试关卡,放置一块足够大的水平地面、两块带碰撞的立方体障碍,保留从起点绕过障碍到终点的通道。地面应启用碰撞,否则导航构建可能找不到有效的可行走表面。
放置一个基于 Character 的测试敌人,确认它带有 CharacterMovement;将 AI Controller Class 设置为项目中的测试 AIController(没有自定义逻辑时可使用 AIController),并将 Auto Possess AI 设置为 Placed in World or Spawned。再放置一个 Target Point,使它位于障碍物另一侧的地面上。
放置导航体积并显示网格
- 在
Place Actors面板搜索Nav Mesh Bounds Volume,将它拖入关卡。 - 选中体积,使用移动与缩放工具,使其覆盖起点、目标点及中间可绕行的地面;体积底部应包含地面高度,不能只悬浮在地面上方。
- 在关卡视口按
P打开导航可视化。默认情况下,绿色区域是系统生成的可导航多边形;障碍物和不可通行缝隙不应被误认为可达。 - 如果提示需要重新构建导航,在编辑器的
Build菜单执行Build Paths,再检查视口。不同 UE5 版本可能将菜单项放在构建相关子菜单中。

Nav Mesh Bounds Volume 只是规定导航生成的空间边界,不是整个体积都可通行。实际网格由地面碰撞、坡度、台阶、Agent 半径与高度等条件决定。狭窄走廊若不足以容纳 Agent,即使视觉上能穿过,也可能没有绿色连通区域。
在运行中确认导航可见
编辑器视口用 P 检查最方便;开始 PIE 后,还可以打开 Unreal 控制台执行以下命令,检查运行时导航显示:
show Navigation true预期结果:若该关卡已有可用 NavMesh,游戏视口出现导航网格可视化;不会产生固定格式的文本日志。若需要隐藏,运行 show Navigation false。这只是显示开关,不负责生成缺失的导航数据。
让敌人绕障碍走到目标点
不必先构建复杂行为树,就能隔离验证导航基础。在关卡蓝图中完成一次最小测试:
- 放置好的敌人与
Target Point可以通过关卡蓝图中的 Actor 引用访问。 - 使用
Event BeginPlay触发AI MoveTo,将Pawn连接到测试敌人,将Destination连接到目标点的Get Actor Location,把Acceptance Radius设为 50(单位为厘米)。 - 在
On Success执行引脚连接Print String,显示Arrived;在On Fail执行引脚连接另一个Print String,显示Move Failed。 - 运行 PIE,观察敌人是否沿绿色区域绕过障碍,而不是尝试直线穿墙。
预期结果:敌人拥有有效 AIController、起终点属于可连通的导航区域且没有额外移动限制时,角色抵达目标附近,屏幕显示 Arrived。如果显示 Move Failed,优先检查导航与占有关系,再检查移动逻辑。这个测试通过后,再将目标写入 Blackboard,交给行为树的 Move To 使用。
看不到绿色区域时按顺序排查
- 整片区域都没有网格:检查是否放置了
Nav Mesh Bounds Volume、地面碰撞是否有效,以及Project Settings → Navigation System中Auto Create Navigation Data是否启用。 - 只有局部网格或两块区域不相连:确认体积覆盖完整通道、地面没有缝隙;再检查 Navigation Mesh 的
Agent Radius、Agent Height、坡度与台阶限制是否符合敌人体型。 - 编辑器有网格但运行时障碍变化后寻路失败:查看 Navigation Mesh 的
Runtime Generation。静态场景通常不需要动态重建;需要运行时更新几何影响时,再考虑Dynamic并评估重建成本。 - 绿色区域连通但敌人不走:确认 Pawn 确实由 AIController 占有、起点和目标点位于可导航面,以及
CharacterMovement没有被禁用。
只有导航范围、Agent 尺寸和控制器接管这三项成立,Move To 的成功与失败才值得继续从 Blackboard 键和行为树分支中排查。