游戏 AI / 系统课时
让 AIController 接管敌人
让 AIController 接管敌人
敌人 Character 已经放进关卡,却不会自动执行智能行为。要让 Unreal 的 AI 系统真正控制它,需要创建 AIController,配置自动接管条件,并验证 Possess 是否成功。本课完成这一条控制链,不依赖行为树,也不把敌人暂时静止误判为接管失败。
学习目标
- 区分 AIController、Pawn 与 Possess 的职责。
- 为敌人配置独立的 AIController 和自动接管条件。
- 使用 On Possess 事件与调试信息确认控制器已经绑定敌人。
分清控制器与角色身体
在 Unreal Gameplay Framework 中,Pawn 是游戏世界中的可控制实体,Controller 则负责决定由谁控制它。
Character 是 Pawn 的子类,提供胶囊碰撞、角色移动组件等能力。AIController 不负责显示模型,而是承担 AI 决策与控制入口。两者通过 Possess 建立控制关系。
一个简单的敌人控制链包含三个关键动作:
- 创建或放置敌人 Pawn。
- 引擎根据敌人的 AI Controller Class 和 Auto Possess AI 配置创建并分配控制器。
- AIController 对敌人执行 Possess,成功后触发 On Possess 事件。
玩家侧则通常由 PlayerController 控制玩家 Pawn。测试时必须确保玩家控制器和 AI 控制器没有接管错误的对象。

创建并绑定 AIController
下面采用蓝图工作流。使用第三人称模板工程即可独立跟做:关卡中需要有一个玩家角色,以及一个基于 Character 创建并放置在场景中的 BP_Enemy。本节验证控制器接管本身,暂时不要求导航网格或行为树。
先创建 AI 控制器资产:
- 在 Content Browser 中新建 Blueprint Class。
- 在父类选择界面搜索 AIController,并将其作为父类。
- 将新蓝图命名为
BP_EnemyController。 - 打开蓝图,确认它属于 AIController 类型,编译并保存。
然后打开 BP_Enemy,在 Class Defaults 的 Details 面板中搜索并设置以下属性:
| 属性 | 设置值 | 作用 |
|---|---|---|
| AI Controller Class | BP_EnemyController | 指定敌人使用的 AI 控制器类型 |
| Auto Possess AI | Placed in World or Spawned | 同时支持关卡预放置和运行时生成 |
| Auto Possess Player | Disabled | 防止敌人被玩家控制器自动接管 |
修改后点击 Compile 和 Save。检查关卡里确实放置了 BP_Enemy 实例,而不是只有内容浏览器中的蓝图资产。
Auto Possess AI 的几个选项有不同的使用边界:
- Disabled:不通过此机制自动创建和分配 AIController。
- Placed in World:适合预先放置在关卡中的敌人。
- Spawned:适合世界加载后动态生成的敌人。
- Placed in World or Spawned:两种情况都允许自动接管。
本例选择最后一种,以免将来把敌人改为运行时生成后出现控制器缺失的问题。如果后续改用 Spawn AI From Class 等专用生成流程,还应检查该流程自身的控制器创建逻辑,避免重复初始化。
用 On Possess 验证接管
只设置属性还不够。最好让控制器在接管成功时产生一个可观察的信号,而不是仅凭敌人是否移动判断结果。
打开 BP_EnemyController 的 Event Graph,完成以下蓝图连线:
- 添加 Event On Possess 事件节点。
- 从事件的执行输出连接一个 Print String 节点。
- 将 Print String 的 In String 设置为
Enemy AI possessed。 - 编译并保存蓝图,然后运行测试关卡。
预期结果:当 BP_EnemyController 成功接管关卡中的敌人时,游戏视口出现 Enemy AI possessed 提示。如果关卡只有一个敌人,且没有再次接管,通常只会触发一次。敌人此时保持静止是正常的。
还可以在 PIE 中打开控制台,执行以下调试命令:
ShowDebug AI预期结果:引擎切换 AI 调试信息的显示状态。具体显示内容取决于引擎版本与当前调试目标;当调试目标是敌人时,可以辅助检查 AI 控制相关状态。控制台命令不负责创建或接管 AIController,On Possess 的打印信息仍是本例最直接的成功证据。
需要从 Pawn 侧交叉验证时,可以在 BP_Enemy 蓝图中使用 Get Controller 节点获取当前控制器,再通过 Get Class 或 Get Display Name 检查它的类型或名称。应当能够识别出由 BP_EnemyController 创建的实例,而不是 PlayerController。
接管失败时检查什么
如果 On Possess 没有打印信息,按照从资产配置到运行状态的顺序排查,不要立即开始修改行为树。
先打开关卡中的敌人实例,检查 Details 中是否存在与蓝图类默认值不同的覆盖设置。关卡实例覆盖了 AI Controller Class 或 Auto Possess AI 时,修改蓝图默认值不一定会改变该实例的最终配置。
再检查三个常见问题:
- 没有控制器:确认 AI Controller Class 指向
BP_EnemyController,Auto Possess AI 包含当前敌人的创建方式。 - 控制器类型错误:确认关卡中的对象确实是
BP_Enemy,而不是另一个没有配置 AIController 的 Character。 - 玩家误控制敌人:确认 Auto Possess Player 为 Disabled,并检查 GameMode 的默认玩家 Pawn 与关卡内已放置的玩家实例。
如果 On Possess 已经触发,但敌人仍然不移动,不应将其归类为 Possess 失败。需要另行检查是否发送了移动命令、是否存在可用导航网格,以及 Character Movement 是否允许移动。
在多人游戏中还需注意,Possess 是具有网络权威要求的操作,不能依赖普通客户端直接接管敌人。单机 PIE 验证成功后,涉及网络运行时应在服务器权威侧检查控制器创建与接管。
本课的完成标准是:玩家仍由 PlayerController 控制,敌人由 BP_EnemyController 控制,On Possess 能明确触发,Pawn 的 Get Controller 能返回正确的 AI 控制器。满足这些条件,就建立了后续运行 Behavior Tree 所需的控制入口。