完整答疑
团队文档的完整版,按模块分成 16 节。
1. 概览#
这套敌人 AI 是纯 C++ 写的规则 AI,不需要行为树或 StateTree 资源。守卫(AAIEnemy)负责感知和判断,控制器(AAIEnemyController)负责行动,关卡里的敌人子系统(UAIEnemySubsystem)负责把声音、证据、灯光和目击事件分发给所有守卫。
声音、证据、目击这些事件都先交给子系统,再由子系统分给每个守卫;视觉是守卫自己每帧去检测。
这套 AI 由哪些部分组成?#
| 模块 | 类 | 挂在哪 | 负责什么 |
|---|---|---|---|
| 守卫 | AAIEnemy | Guard 蓝图的父类 | 视觉、听觉、证据、警觉值和警戒状态、抓捕、击晕、死亡,以及各种蓝图事件 |
| 行为控制器 | AAIEnemyController | 自动接管守卫 | 按警戒状态巡逻、调查、搜索、追击、返回;卡牌强制的互殴 |
| 敌人子系统 | UAIEnemySubsystem | 每个关卡自动有一个 | 广播声音、证据池、灯光明暗、目击与 Belief、Ghost Score 事件、按范围找守卫 |
| 情绪 | UEmotionComponent | 守卫自带 | 当前情绪、切换时的闪烁、被偷后的冷却 |
| 决策 | UEnemyMLDecisionComponent | 守卫自带 | 搜索和搜捕时去哪个点,规则或 ML |
| 灯光 | UAILightComponent | 灯 | 标记会变暗的区域,灯灭时报证据 |
| 证据 | UAIEvidenceComponent | 可被拿走的物品 | 物品被拿走时自动报“物品丢失” |
| 玩家噪音 | UStealthNoiseComponent | 玩家 | 脚步和动作发出的声音 |
| 潜行包 | UStealthMovePackage | 玩家(可选) | 蹲和跑、击杀、偷情绪、隐身和测试键 |
| 打分 | UGhostScoreComponent | 玩家(可选) | 把守卫上报的事件换算成分数 |
| 机器学习 | EnemyML 开头的几个类 | 训练地图 | 训练和评估用的场地、假玩家和统计 |
代码和资源在哪?#
- C++ 都在 Source/ProjectKangaroo/。文件名就是类名去掉前缀,比如 AIEnemy.h、AILightComponent.h;AI Evidence 组件在 AIEvidence.h 里。
- 守卫蓝图:/Game/Benjamin-AI/Enemy/Guard。
- 测试关卡:/Game/Benjamin-AI/LV/LV_AITest,见第 14 节。
- 隐身材质:/Game/Benjamin-AI/Materials/M_StealthInvisible。
每一帧大概发生了什么?#
- 守卫的 Tick:判断能不能看到玩家,更新警觉值和警戒状态,检查能不能抓到玩家,每 0.25 秒扫一次证据。
- 控制器的 Tick:按警戒状态选行为,发出寻路请求,转向该看的方向。
- 声音和目击是“事件”,不靠 Tick:谁发出就调用子系统,子系统当场分发给每个守卫。
文中的数字以什么为准?#
都是 C++ 里的默认值。Guard 蓝图或关卡里的实例可能改过,以 Details 面板上显示的为准。守卫的参数在 Details 面板里按 AI 分类排好了,比如 AI | Perception、AI | Behavior。
2. 快速上手:在关卡里放一个守卫#
把 Guard 蓝图拖进关卡、保证脚下有导航网格,它就会自己站岗;再给它几个巡逻点,它就会巡逻。其他东西都是自动的。
最少需要什么?#
- 把 /Game/Benjamin-AI/Enemy/Guard(或任何继承 AAIEnemy 的蓝图)拖进关卡。控制器会自动接管,不用手动设 AI Controller Class。
- 关卡里要有 NavMeshBoundsVolume 盖住守卫活动的区域,并且导航网格已经生成(视口里按 P 能看到绿色区域)。没有导航网格守卫不会动,屏幕左上角会打印红色的 MoveTo failed 诊断。
- 关卡里要有玩家。守卫默认盯的是 0 号玩家的 Pawn。
怎么让守卫巡逻?#
在关卡里放几个任意 Actor 当巡逻点(Target Point 就行),然后在守卫的 Details → AI → Behavior 里设置:
- Patrol Points:按顺序加入巡逻点。
- Loop Patrol:勾上是走完最后一个回到第一个,不勾是原路往返。
- Patrol Wait Time:每个点停留的秒数,默认 2。
- Patrol Speed:巡逻速度,默认 200 cm/秒。
不放巡逻点会怎样?#
Random Patrol Radius 为 0(默认)时,守卫在出生点站岗,面朝出生时的方向。大于 0 时,守卫会在出生点周围这个半径内随机找点闲逛。
守卫的“岗位”在哪?#
被控制器接管那一刻的位置和朝向就是岗位。调查或追捕结束后,有巡逻点的守卫回到离自己最近的巡逻点接着巡逻,没有巡逻点的回到岗位站岗。
运行时生成的守卫能用吗?#
能。守卫的 Auto Possess AI 是 Placed In World Or Spawned,Spawn 出来也会自动被控制器接管。
能让守卫暂停不动吗?#
能。控制器上有 Behavior Paused,打开后守卫原地站着,不巡逻也不追击,适合过场动画。注意感知还在运行,警觉值照样会涨。在蓝图里用 Get AI Controller → Cast To AIEnemyController 拿到控制器。
参数都在哪里改?#
守卫 Details 面板里的分类:
- AI | Perception:视觉、警觉值、警报共享、抓捕距离。
- AI | Perception | Light:明暗对视线的倍率。
- AI | Perception | Reactions:对噪音、证据、同伴警告的反应。
- AI | Behavior:巡逻、各种速度、转身、确认时间。
- AI | Emotion、Knockout、Fight Anim、Death:情绪、击晕、互殴动画、死亡表现。
- AI | Debug:调试绘制。
搜索半径、到达半径这些在控制器上,见第 8 节。
3. 视觉#
守卫要看到玩家,必须同时满足三条:在射程内、在水平视锥里、中间没有东西挡着。默认射程 1500 cm、半角 45°(正前方 90° 的扇形),明暗会改变这两个值,见第 7 节。
判定具体怎么算?#
- 距离:从守卫眼睛(胶囊体中心往上 Base Eye Height)到玩家胶囊体中心的直线距离,不超过射程。
- 角度:只看水平方向。玩家和守卫正前方的水平夹角不超过半角。玩家在正上方或正下方也算在视锥里。
- 遮挡:从眼睛到玩家中心打一条 Visibility 通道的射线。打到玩家本身(或挂在玩家身上的东西)才算看见。
参数在哪?#
| 参数 | 默认 | 作用 |
|---|---|---|
| Sight Range | 1500 cm | 亮处看亮处时的射程 |
| Sight Angle | 45° | 视锥半角,实际张角是它的两倍 |
| Turn Rate | 360°/秒 | 转身速度,视锥跟着身体转 |
| Target Override | 空 | 填了就改盯这个 Pawn,空就是 0 号玩家 |
为什么玩家躲在矮墙后面还是被看见?#
遮挡只检测一条线:眼睛到玩家胶囊体中心。矮掩体挡不住这条线,就不算遮挡。玩家蹲下时胶囊体变矮、中心变低,就更容易被矮掩体挡住。
哪些东西会挡住视线?#
所有对 Visibility 通道设为 Block 的碰撞,比如墙、柱子、箱子。想让守卫看穿的东西(玻璃、栅栏、草),把它对 Visibility 的响应改成 Ignore。
视锥是跟着头转还是跟着身体转?#
跟着整个 Actor 的朝向。守卫移动时面朝移动方向,停下时面朝关注点(调查的地方、玩家、站岗的方向),按 Turn Rate 平滑转过去。头部动画不影响判定。
守卫盯的是谁?#
默认是 0 号玩家的 Pawn,可以用 Get Perception Target 查。Target Override 填了就改盯它,ML 训练场就是这么让守卫盯假玩家的。同一时间只盯一个目标。
怎么让玩家完全不被发现?#
给玩家 Actor 加上 Tag InvisibleToAI。带这个 Tag 的 Actor:
- 守卫看不见,也听不到它发出的声音。
- 不会被抓。
- 它做的事(偷情绪、杀人)没有目击者。但留下的尸体仍然是证据。
任何方式加删这个 Tag 都行,比如技能里直接改 Actor 的 Tags。蓝图节点 Is Actor Invisible To AI 可以查询。
看见玩家之后会发生什么?#
- 每帧记下玩家位置(Last Known Player Location),警觉值开始上涨,见第 4 节。
- 从看不见变成看见的那一帧触发 On Player Spotted,变成看不见时触发 On Player Lost。
- 连续看见的时间记在 Seen Time 里,用来判断“确认后才追”。
Draw Debug 画出来的视锥代表什么?#
就是此刻判定玩家用的射程和半角,已经算上了守卫和玩家两边的明暗。颜色:红色是正看见玩家,黄色是 Suspicious,绿色是其他情况。注意 Alerted 但暂时没看见玩家时也是绿色。锥是按 3D 画的,但实际判定只看水平角度。
4. 警觉值与警戒状态#
守卫用一个 0 到 1 的警觉值(Awareness)决定状态:到 0.3 进入 Suspicious(起疑,去调查),到 1 进入 Alerted(警报,去抓人)。看见玩家时每秒涨 1.0,所以默认连续看见 0.3 秒会起疑,1 秒会警报。
参数#
| 参数 | 默认 | 作用 |
|---|---|---|
| Awareness Gain Rate | 1.0 /秒 | 看见玩家时每秒涨多少 |
| Awareness Decay Rate | 0.5 /秒 | 什么都没感知到时每秒降多少 |
| Suspicion Threshold | 0.3 | 到这个值进入 Suspicious |
| Alert Threshold | 1.0 | 到这个值进入 Alerted |
| Alert Duration | 5 秒 | Alerted 后什么都感知不到,先保持这么久再开始下降 |
| Suspicion Duration | 8 秒 | 被声音、证据、同伴警告弄成 Suspicious 后,保持这么久再开始下降 |
| Chase Delay | 1 秒 | Alerted 后要连续盯着玩家这么久才开始追 |
三种状态分别是什么意思?#
- Unaware:正常巡逻或站岗。
- Suspicious:觉得不对劲,去可疑的地方看看,并在附近搜索。
- Alerted:确定有人。看得见就追,看不见就去最后知道的位置搜捕。
状态只由警觉值决定,降的时候也是一级一级退:Alerted → Suspicious → Unaware。状态变化时触发 On Alert State Changed(旧状态, 新状态)。
只被看到一眼就会警报吗?#
不会。默认要连续看见约 0.3 秒才起疑、1 秒才警报。视线一断,警觉值就按每秒 0.5 往下降。想让守卫更敏锐就调高 Awareness Gain Rate。
听到声音、发现证据为什么只是 Suspicious?#
这些算“间接线索”,默认反应都是 Suspicious:警觉值至少抬到 0.3,并在 Suspicion Duration(8 秒)内不下降,让守卫有时间走过去看。每来一个新线索,8 秒重新计时。已经 Alerted 的守卫不会被拉回 Suspicious。
反应可以在 AI | Perception | Reactions 里改成 Alerted:Noise Reaction(声音)、Evidence Reaction(证据)、Shared Alert Reaction(同伴警告)。
Alerted 之后多久会平静下来?#
最后一次感知到任何东西后,先保持 Alerted 5 秒;然后警觉值每秒降 0.5,约 1.4 秒后降到 0.3 以下,回到 Unaware。如果还有没用完的怀疑保持时间,会在 Suspicious 停到它用完。
回到 Unaware 时如果守卫还在搜索,会先把搜索做完(见第 8 节),再回岗位。
确认时间(Chase Delay)是干什么的?#
Alerted 只说明守卫确定有人。真正开始追之前,守卫要停下来盯着玩家,连续看满 Chase Delay(1 秒),这段行为叫 Spotting。视线一断计时清零。设成 0 就是一看见就追。
连续看见的时间(Seen Time)从看见的那一刻就开始算,不管当时是什么状态。所以从零开始一直盯到 Alerted 的话,确认时间通常已经够了,会直接开追。被目击、听到声音等先弄到 Alerted 或半路的守卫,再看到玩家时才会明显地停下来盯。
蓝图怎么改警觉值?#
- Add Awareness / Set Awareness:直接加或设定,状态立刻刷新。
- React To Stimulus(Suspicious / Alerted):按“间接线索”的规则抬高,Suspicious 会带上 8 秒保持。
- Set Known Player Location:只告诉守卫“玩家在这”,不改警觉值。
- Reset Perception:清空所有记忆,回到 Unaware,适合重开一局。
头顶的警觉条怎么看?#
勾上 Draw Awareness Bar(或 Draw Debug)后头顶会显示:
- 粗条:警觉值。绿、黄、红对应三种状态,两个白色刻度是 0.3 和 1.0。
- 橙色细条:看见玩家后的确认进度(Seen Time / Chase Delay),满了变红。
- 白色细条:被打晕后还要晕多久。
- 青色细条:被偷情绪后安抚还剩多久。
5. 听觉与噪音#
听觉只有一个判断:守卫离声源的距离在声音半径以内就听得到,不需要视线。默认反应是 Suspicious,守卫会走到声音发出的位置调查,去的是声源位置,不是玩家现在的位置。
声音从哪来?#
声音不会自动产生,都要有人“报”给子系统:
- 玩家:用 Stealth Noise 组件。正式项目的玩家蓝图 BP_ThirdPersonCharacter 已经挂了。它不会自己发声,要由玩家蓝图在合适的时候调用 Make Walk Noise、Make Sprint Noise、Make Crouch Noise、Make Movement Noise(移动状态) 或 Make Noise(半径, Tag)。
- 其他东西(门、扔出去的瓶子、报警器):Get AIEnemySubsystem → Report Sound At(位置, 半径, 发出者, Tag, 穿墙衰减),或者 Report Sound 传一个声音结构体。
- 想知道谁听到了:Report Sound With Feedback 返回听到的守卫列表;Stealth Noise 的节点返回听到的人数。
玩家的声音默认多大?#
| 动作 | 节点 | 半径 |
|---|---|---|
| 走路 | Make Walk Noise | 500 cm |
| 跑步 | Make Sprint Noise | 1400 cm |
| 蹲着 | Make Crouch Noise | 0(静音) |
| 其他 | Make Noise | 调用时自己填 |
这些在 Stealth Noise 组件上改。玩家带 InvisibleToAI 标签时,所有节点都不发声。
墙能挡住声音吗?#
看穿墙衰减。从声源朝每个守卫的方向打射线,每穿过一面墙,剩下的距离乘以 (1 − 衰减)。角色不算墙。
- 0:完全穿墙。Report Sound At 默认就是 0。
- 0.5:穿一面墙剩一半。Stealth Noise 的 Noise Wall Attenuation 默认是 0.5。
- 1:一面墙就完全挡住。
守卫听到之后做什么?#
- 记住声源位置(Last Heard Sound Location)。
- 按 Noise Reaction 反应:默认 Suspicious,抬到 0.3 并保持 8 秒;也可以改成 Alerted。
- 触发 On Sound Heard 事件。
- 控制器走到声源位置,到了以后在附近搜索。
被安抚、晕倒、死亡的守卫听不到任何声音。
脚步声每帧都报,会不会出问题?#
打分不会重复扣:每个守卫在一个警戒周期里只报一次 Noise Heard,回到 Unaware 后才会再报。但每次听到都会更新声源位置、刷新 8 秒的怀疑保持,所以一直发声会让守卫一直处于调查状态。
脚步声怎么接?#
两种常见做法:在脚步的 Anim Notify 里调用 Make Movement Noise;或者在 Tick 里按速度判断。项目里有一个编辑器函数 Wire Stealth Noise Footsteps(分类 Project Kangaroo | Editor Tools),会自动在角色蓝图的 Event Tick 里接好一段逻辑:在地面上移动时,蹲着发蹲下的声音,水平速度超过 450 发跑步声,否则发走路声。
怎么看到声音的范围?#
Stealth Noise 组件勾上 Draw Debug。每次发声会在原地画一个扩散的圈,最大就是穿墙衰减后的真实范围;听到的守卫会连一条线到玩家。走路是橙色,跑步是红色,蹲下是绿色小圈。
6. 证据、目击、Belief 与警报共享#
“证据”是守卫看到就会起疑、过去调查的线索,比如丢失的物品、尸体、灭掉的灯,它不影响 Belief。“目击”是守卫亲眼看到玩家做坏事,目击者立刻警报、通知附近的守卫,并按目击人数增加 Belief。
有哪些证据?#
| 类型 | 谁来报 | 说明 |
|---|---|---|
| Item Missing | 物品上的 AI Evidence 组件,物品被销毁时自动报 | 东西不见了 |
| Body | 守卫死亡时自动报 | 尸体,永久存在 |
| Light Off | 灯上的 AI Light 组件,灯灭时自动报 | 灯灭了,见第 7 节 |
| Custom | 蓝图自己报 | 任何自定义线索 |
蓝图里报证据:Get AIEnemySubsystem → Report Evidence At(类型, 位置, 存在时间, 来源物体),返回一个 Id;要更细的设置就用 Report Evidence 传结构体。Remove Evidence(Id) 撤回。存在时间填 0 就是永久。
守卫什么时候会发现证据?#
每个守卫每 0.25 秒(Evidence Scan Interval)检查一次证据池,要同时满足:
- 距离在证据的 Notice Radius(默认 1200 cm)以内。
- 证据要求视线时(默认要求),证据位置要在守卫的视锥里且没被挡住。射线打到证据物体本身也算看见。证据在暗处时同样只能在很近的地方看到。
证据设了 Auto Notice Radius 时,离得比它还近就不用看也能发现,灯光证据就是这样。同一个证据每个守卫只会发现一次,但不同守卫可以各自发现。
怎么让一个物品被拿走后守卫会察觉?#
在物品 Actor 上加 AI Evidence 组件,保持 Report When Owner Destroyed 勾选。物品被 Destroy(玩家拿走)时,会自动在原位报一个 Item Missing。
也可以手动调用 Report Change、Report Change At、Report Change Of Type。物品放回去时调用 Retract Last Change 撤回。
守卫发现证据后做什么?#
记住证据的位置和类型,触发 On Evidence Found,然后按 Evidence Reaction 反应。默认是 Suspicious:去证据位置调查。证据不增加 Belief。
什么是目击事件?#
目前有三种:
- Emotion Stolen:偷情绪,守卫的 Steal Emotion 会自动报。
- NPC Killed:杀人,守卫的 Report Killed 会自动报。
- Restricted Area Sighting:出现在不该去的地方。禁区怎么判定还没定,由蓝图自己报。
蓝图报目击事件:Get AIEnemySubsystem → Report Witnessable Event At(类型, 位置, 作案者, 受害者)。返回的记录里有目击者列表和加了多少 Belief。
谁算目击者?#
上报的那一刻,每个活着、清醒、没被安抚的守卫都检查一次能不能看到事件位置,用的是和看玩家一样的视锥、射线和明暗规则。能看到的就是目击者。受害者自己不算;作案者带 InvisibleToAI 标签时没有任何目击者。
目击者会做什么?#
把作案者的位置当作玩家位置记住,警觉值直接拉满进入 Alerted,然后通知附近的守卫(警报共享,见下面),并触发 On Event Witnessed。
Belief 怎么算?#
有人目击才加,没人目击一点不加。加的量 = 基础值 × (1 + (目击人数 − 1) × 0.5),总量最多到 1。
| 事件 | 基础值 | 2 个目击者 | 3 个目击者 |
|---|---|---|---|
| Emotion Stolen | 0.2 | 0.3 | 0.4 |
| NPC Killed | 0.5 | 0.75 | 1.0 |
| Restricted Area Sighting | 0.1 | 0.15 | 0.2 |
Belief 本身不改变守卫的行为,它是给其他系统读的。读写:Get Belief、Set Belief、Add Belief;监听:On Belief Changed、On Event Witnessed;全部记录:Get Witness Records。基础值和倍率在子系统上,运行时可以在蓝图里改。
警报共享是怎么回事?#
守卫调用 Share Alert 时,会把自己知道的最新线索位置发给 Alert Share Radius(默认 2000 cm)内的所有守卫。
- 什么时候自动发:目前只有目击事件。守卫自己看见玩家进入 Alerted 时不会自动通知别人,需要的话在 On Alert State Changed 里自己调用 Share Alert。
- 收到警告的守卫:记住这个位置,按 Shared Alert Reaction 反应(默认 Suspicious,去那里看看),触发 On Alert Received。
- 发出警告的守卫:触发 On Alert Shared(通知了几个人),并上报 Alarm Raised 打分事件。
- Alert Share Radius 设成 0 就不通知别人。
7. 灯光与黑暗#
被 AI Light 覆盖、且覆盖它的 AI Light 全部关着的地方就是“暗处”。守卫看暗处的目标又短又窄,站在暗处看亮处的目标反而更远更宽;灯一灭,附近的守卫还会过来查看。
明暗怎么影响视线?#
| 守卫所在 | 目标所在 | 射程 | 半角 | 对应参数(射程倍率 / 角度倍率) |
|---|---|---|---|---|
| 亮 | 亮 | 1500 cm | 45° | Sight Range / Sight Angle 本身 |
| 亮 | 暗 | 225 cm | 18° | Light To Dark Sight(0.15 / 0.4) |
| 暗 | 亮 | 1950 cm | 67.5° | Dark To Light Sight(1.3 / 1.5) |
| 暗 | 暗 | 300 cm | 22.5° | Both Dark Sight(0.2 / 0.5) |
倍率在守卫的 AI → Perception → Light 里:Range Scale 乘射程,Angle Scale 乘半角。同样的规则也用于看证据和目击事件。想知道此刻对某个位置的视线,可以调用守卫的 Get Effective Sight(目标位置)。
怎么把 AI Light 加到现有关卡?#
- BP_LightParent 的灯(推荐):打开 Content/Blueprints/Lights/BP_LightParent → Components → Add → AI Light → 编译保存。所有关卡里的实例和子类都会带上。这是公共资源,改之前先在 P4 里 Check Out,并跟作者说一声。
- 直接摆在关卡里的灯:选中灯的 Actor → Details → + Add → AI Light。运行时要开关的灯,Mobility 设成 Movable 或 Stationary。
- 开局就暗的区域:放一盏取消勾选 Visible 的灯,再加上 AI Light。或者在一个空 Actor 上加 AI Light,取消勾选 Start On,把 Radius 设成区域大小。
守卫这边什么都不用设置。
怎么关灯守卫才知道?#
AI Light 每 0.1 秒检查一次同一个 Actor 上的灯光组件,只要有一个 Visible 且 Intensity 大于 0 就算亮。
- 能识别:对灯光组件 Set Visibility(false) 或 Set Intensity(0),或者调用 AI Light 自己的 Turn Off、Toggle、Set Light On。
- 识别不了:调暗但没到 0、Set Actor Hidden In Game、把灯光颜色改成黑色、Destroy 灯的 Actor。被 Destroy 的灯算“没有灯覆盖”,那块区域反而算亮。
- 用哪种方式关就用哪种方式开。比如用 Turn Off 关(它改的是 Visible),却用 Set Intensity 开,灯会一直不亮。
- 正式项目的灭灯技能 GA_Snuff 用的是 Set Intensity,要确认它设的是 0。
暗区有多大?#
- 是以灯为中心、半径为 Radius 的一个球。Radius 为 0 时用灯的衰减半径(Attenuation Radius)。
- 判定点是角色胶囊体中心,离地大约 90 cm。灯挂得越高,地面上的覆盖圈越小;灯的高度减 90 cm 超过 Radius 时,地面一点都覆盖不到。
- 这个球会穿墙,衰减半径大的灯会把暗区漏到隔壁。
- 没有任何 AI Light 覆盖的地方永远算亮。几盏灯重叠的地方,只要有一盏亮着就算亮。
- 勾上 AI Light 的 Draw Debug,在 PIE 里地上会画出判定圈:黄色是亮着,深蓝是灭了。Radius 可以在关卡里按实例单独改。
灯灭了守卫会怎样?#
会在灯的位置留下一个 Light Off 证据,默认 15 秒后失效(Evidence Lifetime),重新点亮会立刻撤掉:
- 离灯不超过 Radius 的守卫马上发现,不用看。
- 不超过 2 倍 Radius(或 Notice Range)、而且能看到这盏灯的守卫也会发现。
发现后按 Evidence Reaction 反应,默认 Suspicious,过来查看。不想让守卫过来,就取消勾选 AI Light 的 Investigate When Turned Off。
蓝图能用哪些接口?#
- AI Light 组件:Turn On、Turn Off、Toggle、Set Light On、Is Light On、Get Light Radius,以及 On Light Changed 事件。
- 子系统:Set Lights In Radius(一片区域开关灯,返回改了几盏)、Is Location Dark、Get Light Level At、Has Any Light Off、Get All Lights。
- 守卫:Get Effective Sight、Get Sight For Light。
8. 行为:巡逻、调查、搜索、追击#
行为全部由控制器按警戒状态决定:Unaware 时巡逻或站岗,Suspicious 时去可疑点调查、再在附近搜索,Alerted 时看得见就确认后追击、看不见就去最后的位置搜捕。行为切换时触发守卫的 On Behavior Changed(旧行为, 新行为),可以用来换动画或表情。
绿、黄、红三种颜色对应三种警戒状态,和头顶警觉条的颜色一致。搜索在 Suspicious 和 Alerted 下都会出现。
有哪些行为?#
| 行为 | 什么时候 | 在做什么 | 速度(cm/秒) |
|---|---|---|---|
| Patrol 巡逻 | Unaware,有巡逻点或随机巡逻半径 | 按顺序走巡逻点,每个点停 Patrol Wait Time | Patrol Speed 200 |
| Stand Guard 站岗 | Unaware,没有巡逻点 | 回到岗位,面朝出生方向 | Patrol Speed 200 |
| Investigate 调查 | Suspicious | 走向最新的可疑点,边走边看着那里 | Investigate Speed 320 |
| Search 搜索 | 到达可疑点或搜捕目标之后 | 在附近挑点走过去,每个点停下来看一下 | Search Speed 200 |
| Spotting 确认 | Alerted 且看得见,还没盯满 Chase Delay | 停下来盯着玩家 | 不动 |
| Chase 追击 | Alerted、看得见、已确认 | 冲向玩家 | Chase Speed 520 |
| Hunt 搜捕 | Alerted 但看不见 | 去最新线索的位置,到了转为搜索 | Chase Speed 520 |
| Return 返回 | 降回 Unaware | 忘掉所有线索,回最近的巡逻点或岗位 | Patrol Speed 200 |
| Fight Allies 互殴 | 卡牌强制状态 | 找最近的守卫打,见第 9 节 | Chase Speed 520 |
| Unconscious 昏迷 | 被打晕 | 躺着不动 | 不动 |
| Idle | 刚接管、死亡、暂停 | 什么都不做 | 不动 |
“可疑点”是怎么选的?#
守卫同时记着三种线索:最后知道的玩家位置(包括同伴警告和目击)、最后发现的证据位置、最后听到的声音位置。哪个最新就去哪个,可以用 Get Point Of Interest 和 Get Point Of Interest Source 查。
调查途中出现新线索、离当前目标超过 Retarget Distance(150 cm),会立刻改去新位置。搜索途中,新线索离搜索中心超过搜索半径加 150 cm,也会放弃当前搜索去新位置。
搜索会搜多久?#
- Suspicious 或 Alerted 期间:一直搜,没有时间上限。
- 降回 Unaware 时:搜索总共至少持续 Search Duration(8 秒),没搜满的会搜满再返回。
每到一个点停 Search Look Time(1.5 秒)再去下一个。下一个点由决策组件给出,规则版是搜索中心 Search Radius(400 cm)内的随机可达点。附近没有导航网格时守卫会原地张望,过一会儿再试。
守卫是怎么转身的?#
移动时面朝移动方向;速度低于 20 cm/秒时,面朝关注点(调查点、玩家、搜索点、站岗的方向)。都按 Turn Rate(360°/秒)平滑转过去。互殴时始终面对对手。
到达半径、搜索半径这些在哪改?#
在控制器上。控制器是运行时生成的,要改默认值,可以做一个继承 AIEnemyController 的蓝图,再把守卫的 AI Controller Class 换成它。
| 参数 | 默认 | 作用 |
|---|---|---|
| Patrol Acceptance Radius | 80 cm | 巡逻和返回的到达半径 |
| Investigate Acceptance Radius | 100 cm | 调查和搜索的到达半径 |
| Retarget Distance | 150 cm | 新线索离当前目标多远就改道 |
| Nav Projection Extent | 250, 250, 300 cm | 目标点吸附到导航网格的搜索范围 |
| Search Radius | 400 cm | 搜索时随机挑点的半径 |
| Search Duration | 8 秒 | 搜索至少持续多久 |
| Search Look Time | 1.5 秒 | 每个搜索点停多久 |
| Chase Acceptance Scale | 0.5 | 追击的到达半径是 Capture Range 乘以它 |
蓝图能直接指挥守卫吗?#
能。先 Get AI Controller → Cast To AIEnemyController,然后:
- Request Investigate(位置):让守卫去看某个地方。会把警觉值抬到 Suspicious 并保持 8 秒。已经 Alerted 时无效。
- Return To Patrol:立刻放弃当前行为,回岗位。
- Reset Behavior:停下一切,把当前位置当作新岗位。传送守卫后用。
- Behavior Paused:暂停行为,见第 2 节。
守卫自己也有 Set Move Speed,可以临时改移动速度,但下次切换行为时会被改回对应行为的速度。
9. 抓捕、击晕、互殴与死亡#
守卫只在 Alerted 时抓人:离玩家不超过 Capture Range(150 cm)就触发抓捕事件,抓到以后怎么处理由蓝图决定。守卫也可以被打晕(默认 10 拳)、被卡牌逼着互殴,或者被杀死并留下尸体。
抓捕的条件是什么?#
下面几条同时满足:
- 守卫是 Alerted。
- 守卫和玩家的直线距离不超过 Capture Range。
- 守卫没死、没晕,也不在卡牌强制状态里。
- 玩家没有 InvisibleToAI 标签。
注意抓捕不检查视线,隔着一堵薄墙也能抓到。
抓到之后会发生什么?#
C++ 只发事件,不会结束游戏。满足条件时每一帧都会触发两个东西:守卫蓝图里的 On Player Captured 事件,以及可以从外面绑定的 On Captured Player(参数是守卫和玩家)。所以接收方要自己防止重复处理,比如加一个“已经被抓”的标记。
怎么杀死守卫?#
调用守卫的 Report Killed(凶手)。正式项目教程里的 FAB_KillGuard 就是这么做的。之后会依次:
- 关闭感知、停止移动,胶囊体不再挡人。
- 播放死亡表现:有 Death Anim 就播放,然后定格在最后一帧或转成布娃娃;没有就直接布娃娃。
- 触发 On Died,上报 Guard Dead 打分事件。
- 在原地留下一个永久的 Body 证据。
- 上报 NPC Killed 目击事件,看到的守卫会警报。
死亡表现的参数在 AI → Death 分类里:
| 参数 | 默认 | 作用 |
|---|---|---|
| Death Anim | 空 | 死亡动画(序列或蒙太奇),空就直接布娃娃 |
| Ragdoll After Death Anim | 关 | 动画播完后转布娃娃;关着就定格在最后一帧 |
| Ragdoll Impulse | 300 | 布娃娃开始时沿“凶手 → 守卫”的方向推一下 |
| Destroy After Death | 0 | 死后多少秒删掉尸体,0 是永远留着 |
怎么打晕守卫?#
每次调用 Take Punch(攻击者) 算一拳,攻够 Hits To Knock Out(10)就晕;Hit Reset Time(10 秒)内没挨打,计数清零。也可以直接调用 Knock Out 立刻打晕。
昏迷期间不感知、不移动,警觉值和记忆都冻结。Recover Time(8 秒)后自动醒来,接着做原来的事;Wake Up 可以提前叫醒。有 Knock Out Anim 就播放并定格,没有就布娃娃,醒来时从身体躺着的位置站起来。
事件:On Hit Received(攻击者, 累计拳数)、On Knocked Out、On Woke Up。
守卫互殴是怎么打的?#
这是卡牌强制状态 Fight Allies(触发方法见第 11 节):
- 在 Fight Search Radius(3000 cm)内找最近的、活着且清醒的其他守卫,每 0.5 秒重新检查一次。
- 走过去,停在 Fight Stand Off Distance(150 cm)处;太近(小于 120 cm)会边面对对手边后退。
- 在 Fight Attack Range(190 cm)内,每 Fight Attack Interval(1 秒,不会短于出拳动画)出一拳,经过 Attack Hit Delay(0.35 秒)后命中,对方 Take Punch。
- 被打的一方播受击动画,攻够 10 拳就晕。附近没有对手就原地站着,等强制状态结束。
每次出拳触发 On Attack(对手)。互殴期间守卫不会抓玩家,但仍然在感知。
攻击和受击动画怎么换?#
在 AI | Fight Anim 里:Attack Anims 默认是模板里的 MM_Attack_01、02、03,Hit React Anims 默认是模板里的轻受击动画,每次随机挑一个。Ignore Fight Root Motion 默认开着,防止出拳动画把守卫推到对方身上。蓝图也可以自己调用 Play Attack Anim 和 Play Hit React Anim。
10. 情绪、偷取情绪与安抚#
每个守卫自带一个情绪组件,同一时间只有一种情绪,默认是 Calm。玩家可以把守卫当前的情绪偷走变成卡牌;被偷的守卫会回到 Calm、回去巡逻,并且一段时间内对什么都视而不见,这叫安抚。
有哪些情绪?怎么产生?#
目前有四种:Calm、Angry、Fear、Joy。产生哪种由规则表(Rules)决定,默认只有两条:
- 发现威胁(Alerted 或正看见玩家)→ Angry。
- 发现同伴的尸体 → Angry,并且一直保持到被偷走为止。
Fear 和 Joy 没有默认规则。可以在规则表里加规则;也可以用 Turn On Fear、Turn On Joy 这类开关节点;或者用 Set Custom Flag 配合规则里的 Custom Flag 条件。想完全自己写判断逻辑,可以在蓝图里覆盖 Evaluate Desired Emotion。
规则里能用哪些条件?#
Threat Present(发现威胁)、No Threat、Allies Nearby(Ally Radius 1500 cm 内有活着的同伴)、No Allies Nearby、Evidence Found(记得任何证据)、Body Found(记得的证据是同伴尸体)、Suspicious、Custom Flag。一条规则里的条件要全部满足;几条规则同时满足时,Priority 高的赢。
情绪是怎么切换的?#
- 新情绪的条件满足后,颜色在新旧之间闪烁 Emotion Change Time(1 秒),然后瞬间切换。
- 闪烁期间条件不满足了,就取消,保持原来的情绪。
- 所有条件都不满足时,过 Emotion Reset Time(3 秒)回到 Calm。
- 死亡后没有情绪。
要显示颜色,蓝图每帧读 Get Display Color 设到材质上就行,闪烁已经算好了。每种情绪的颜色在 Emotion Colors 里设。
关卡里能让守卫一开始就是生气的吗?#
能。设置 Initial Emotion 和 Initial Intensity;勾上 Lock Initial Emotion 的话,它会一直保持这个情绪、不受规则影响,直到被玩家偷走。
怎么偷情绪?#
调用守卫的 Steal Emotion(偷的人),返回偷到的情绪和卡牌权重(就是情绪强度)。正式项目里目前没有东西调用它,偷情绪的技能要自己接上。偷完之后:
- 守卫回到 Calm,Emotion Suppress Time(10 秒)内不会再产生被偷的那种情绪。
- 上报 Emotion Stolen 目击事件:看到的其他守卫会警报,并增加 Belief。被偷的守卫自己不算目击者。
- 偷到的不是 Calm 时,守卫被安抚。
情绪正在闪烁时被偷,默认拿到的是旧情绪;勾上 Take Pending During Flicker 就拿新的。
安抚(Pacify)是什么?#
被安抚的守卫会“忘掉一切”:警觉值清零、记忆清空、回到 Unaware、解除卡牌强制状态、立刻回巡逻路线。安抚期间它看不见、听不到、不当目击者、不接受同伴警告;这期间看到的证据会被永久忽略。
| 参数(AI → Emotion → Pacify) | 默认 | 作用 |
|---|---|---|
| Pacify On Emotion Stolen | 开 | 被偷情绪时是否安抚 |
| Pacify When Calm Stolen | 关 | 偷走 Calm 是否也安抚。关着是为了不让“偷 Calm”变成免费的“别追我” |
| Pacify Duration | 0 | 安抚时长,0 表示用情绪组件的 Emotion Suppress Time(10 秒) |
蓝图也可以手动调用 Pacify(时长) 和 End Pacify。事件:On Pacified、On Pacify Ended。头顶青色细条是剩余时间。
卡牌或昏迷会改变情绪吗?#
不会。卡牌强制状态和昏迷期间,情绪会被冻结,既不变也不回 Calm,但仍然可以被偷。
怎么看到守卫当前的情绪?#
情绪组件勾上 Draw Debug,脚下会画一个情绪颜色的圈,切换时会闪。事件有 On Emotion Changed、On Flicker Started、On Flicker Cancelled、On Emotion Taken。
11. 给卡牌和技能用的接口#
卡牌对守卫的影响分两类:强制状态(目前只有 Fight Allies,让守卫互殴),和各种区域效果(开关灯、制造声音、安抚等)。强制状态只改行为,不改情绪。
怎么让一群守卫互殴?#
Get AIEnemySubsystem → Force State In Radius(中心, 半径, Fight Allies, 时长)。半径内所有活着、清醒的守卫会开始互殴,返回影响了几个。
- 只影响一个守卫:用守卫上的 Force State(状态, 时长)。
- 时长小于等于 0 表示一直持续,直到调用 Clear Forced State。
- 强制期间守卫不抓玩家;结束后按当时的警戒状态接着行动。
- 事件:On Forced State Changed(旧, 新)。守卫上的 State Forced 可以查是否在强制状态。
各种效果应该调哪个接口?#
| 想做的效果 | 调用哪个 | 在哪 |
|---|---|---|
| 一片守卫互殴 | Force State In Radius | 子系统 |
| 停电,一片区域变暗 | Set Lights In Radius | 子系统 |
| 制造声音引开守卫 | Report Sound At | 子系统 |
| 让某个守卫去看某处 | Request Investigate | 控制器 |
| 让守卫平静、不理玩家 | Pacify | 守卫 |
| 直接打晕 | Knock Out | 守卫 |
| 隐身 | 给玩家加 InvisibleToAI 标签 | 玩家 Actor |
| 对范围内的守卫做别的事 | Get Enemies In Radius / Get All Enemies | 子系统 |
子系统在任何蓝图里都能用 Get AIEnemySubsystem 拿到,不需要引用。
有现成的测试键吗?#
Stealth Move Package 组件带了一组测试键:T 让附近守卫互殴(再按一次解除)、L 开关最近的 AI Light、V 隐身、E 击杀、F 偷情绪,另外 Ctrl 蹲、Shift 跑、滚轮缩放镜头。
正式项目的玩家蓝图没有挂这个组件,所以这些键在正式项目里不存在。需要测试时,可以临时给一个测试用的角色挂上;它的输入是运行时创建的,不需要额外资源。
12. Ghost Score 打分事件#
守卫会把五种“玩家暴露了”的事件上报给子系统,打分系统只要监听子系统就能收到所有守卫的事件。项目自带的 Ghost Score 组件是一个现成的计分示例,分值还是占位数。
有哪些事件?什么时候报?#
| 事件 | 什么时候报 | 会不会重复报 | Ghost Score 组件默认分 |
|---|---|---|---|
| Spotted Player | 守卫从看不见玩家变成看见 | 每个守卫每个警戒周期一次,回到 Unaware 后才会再报 | −10 |
| Detected Player | Alerted 且盯满 Chase Delay,开始追 | 每次 Alerted 一次 | −50 |
| Noise Heard | 守卫听到声音 | 每个守卫每个警戒周期一次 | −5 |
| Alarm Raised | 守卫通知了其他守卫(Share Alert) | 每次通知都报 | −25 |
| Guard Dead | 守卫被杀 | 每个守卫一次 | −100 |
“警戒周期”指守卫从起疑到重新回到 Unaware 的这一段。所以玩家在守卫视线边上反复进出,不会一直扣分。
怎么接自己的计分系统?#
用 Get AIEnemySubsystem 拿到子系统,然后绑定:
- On Ghost Score Event:所有类型都会触发。
- 或者按类型分开的 On Spotted Player、On Detected Player、On Noise Heard、On Alarm Raised、On Guard Dead。
事件参数里有:类型、哪个守卫、发生位置、起因(玩家、发声者或凶手,可能为空)、游戏时间。蓝图也可以用 Report Ghost Score Event 手动发事件,比如做测试按钮。
自带的 Ghost Score 组件怎么用?#
把它挂在玩家(或关卡里任何 Actor)上,它会自己监听子系统,按 Points 里的分值加减,并把每次变化打印到屏幕和日志。
- 开局分数:Starting Score,默认 1000。
- 自定义加减分:Add Score(变化, 原因),比如完成目标。
- 重置:Reset Score。
- 更新 UI:绑定 On Score Changed(新总分, 变化, 原因)。
- 不想刷屏:关掉 Print Score Changes。
正式项目里目前没有资源挂这个组件。
13. 决策组件与机器学习#
守卫“看不见玩家时去哪”——搜索时的下一个点和搜捕的目标——交给决策组件决定。现在实际生效的是规则版;ML 版的接口已经留好,但还没接上训练好的策略,选 ML 也会自动退回规则。
规则版怎么选点?#
- Search:在搜索中心 Search Radius 内随机挑一个走得到的点。
- Hunt:直接去最新线索的位置。
视觉、警觉值、抓捕、看得见时的追击都不经过决策组件,始终是规则。
怎么切换规则和 ML?#
守卫的 Decision 组件 → Decision Mode:Rule 或 ML。ML 不可用时,Get Active Mode 返回 Rule,并把退回次数记在 ML Fallback Count 里。
- 每次决策都会触发 On Decision Made(请求类型, 点, 是否来自 ML)。
- 勾上 Draw Debug 会画出最近的决策点:蓝色是 ML,灰色是规则。
训练场是什么?#
给 ML 训练和评估用的一套工具,设计文档在 Content/EnemyMachineLearning/Docs/Design.md。正常关卡不需要它们。
| 类 | 作用 |
|---|---|
| Enemy ML Arena | 一块区域 + 1 个守卫 + 1 个假玩家。每局把两人随机摆在互相看不见的地方,给守卫一个初始线索;抓到算 Captured,超时算 Timeout |
| Enemy ML Player Bot | 会躲藏、换位置、逃跑的假玩家,有三档难度:不动、会挪、会逃 |
| Enemy ML Evaluator | 收集每局结果,写 CSV 到 Saved/EnemyML/,打印抓捕率和平均抓捕时间 |
| Enemy ML Training Game Mode | 训练地图用的 GameMode |
平铺多个训练场时,中心间距要大于 Alert Share Radius 加跑步声半径,否则相邻的场地会互相干扰。
现在能用 ML 吗?#
还不能。策略网络还没接入,Is ML Available 目前始终返回 false。把 Decision Mode 设成 ML 不会出错,只会在日志里警告一次,然后按规则走。
14. 调试工具与测试关卡#
最常用的是守卫的 Draw Debug:它会画出当前的视锥、记忆里的线索点、头顶的状态文字和警觉条。再配合 AI Light 和 Stealth Noise 各自的 Draw Debug,基本能看清 AI 在想什么。
各个调试开关会画什么?#
| 开关 | 在哪 | 画什么 |
|---|---|---|
| Draw Debug | 守卫,AI → Debug | 视锥;线索点(红球是玩家位置、紫球是证据、青球是声音);Alerted 时的橙色警报共享圈;头顶状态文字和警觉条。同时打开控制器的调试 |
| Draw Awareness Bar | 守卫,AI → Debug | 只画头顶警觉条,见第 4 节 |
| 控制器调试 | 守卫勾 Draw Debug 时自动打开 | 品红色线连到当前目标点、搜索时的黄色搜索圈、行为名和移动状态;屏幕左上角也打印一份 |
| Draw Debug | AI Light 组件 | 地上的明暗判定圈,黄色是亮、深蓝是灭 |
| Draw Debug | Stealth Noise 组件 | 声音扩散圈,和听到的守卫连到玩家的线 |
| Draw Debug | 情绪组件 | 脚下的情绪颜色圈,切换时会闪 |
| Draw Debug | 决策组件 | 最近一次决策选的点 |
| Draw Debug | Stealth Move Package | 击杀范围(白)和偷情绪范围(青) |
头顶的文字怎么读?#
- 守卫的那一行:状态和警觉值,例如 Suspicious Awareness: 0.45 Hold 6.2s,Hold 是怀疑保持的剩余时间。关卡里有灯关着时,还会显示 [Guard Lit/Dark, Player Lit/Dark]。
- 上面品红色的一行:控制器的行为名、这个行为持续了多久、移动状态(moving、done、failed/idle)。
头顶文字需要 HUD,在 Simulate 模式下看不到,这时看屏幕左上角的那份。
测试关卡 LV_AITest 里有什么?#
/Game/Benjamin-AI/LV/LV_AITest 是专门测 AI 的关卡,所有守卫和灯都默认打开了调试绘制,地板按区域上了不同颜色。
| 区域 | 测什么 | 布置 |
|---|---|---|
| A 视觉与掩体 | 视锥和遮挡 | 室外通道,矮掩体(蹲着躲)和柱子,一个巡逻守卫 |
| C 听觉 | 声音和穿墙 | 小隔间里一个背对过道的守卫,走、跑、蹲着经过试试 |
| B 灯光 | 开关灯 | 三盏 AI Light 照亮的房间,一个巡逻守卫 |
| E 暗厅 | 暗处的视线 | 两盏 AI Light 开局就关着,一个巡逻守卫 |
| D 目击 / 尸体 / 警报 | 目击和警报共享 | 两个面对面的守卫、一个巡逻守卫、一个藏在墙后只能被警报叫到的守卫 |
在正式项目里打开 LV_AITest 要注意什么?#
- 先把 World Settings 里的 GameMode Override 改成 /Game/Blueprints/Player/BP_ThirdPersonGameMode,原来指向的模板 GameMode 在正式项目里不存在。
- 地上写的按键提示是给 Stealth Move Package 用的,正式项目的玩家没有这些键。
- 要在 PIE 里开关灯,可以按 F8 脱离角色,选中灯的 PointLight 组件,取消勾选 Visible。
守卫不动了怎么查?#
看屏幕左上角的红字“[守卫名] MoveTo failed …”。它把寻路失败的每一步都列出来了:导航系统在不在、目标点能不能投影到导航网格、寻路结果、移动模式等。最常见的原因是没有导航网格,或者目标点离导航网格太远。
15. 常见问题排查#
大部分问题都能先勾上守卫的 Draw Debug 看一眼:头顶文字会告诉你它当前的状态、行为和移动情况。下面按症状列出最常见的原因。
守卫一动不动#
- 没有导航网格,或者目标点离导航网格太远。看左上角的 MoveTo failed 红字。
- 控制器的 Behavior Paused 打开了。
- 守卫晕了、死了,或者在互殴状态但附近没有对手。
- 守卫的 AI Controller Class 被改成了不是 AIEnemyController 的东西。
守卫看不见玩家#
- 玩家身上有 InvisibleToAI 标签。
- Target Override 指向了别的 Pawn,或者玩家不是 0 号玩家。
- 中间有对 Visibility 是 Block 的碰撞,包括看不见的触发盒。
- 玩家在暗处、守卫在亮处,射程只有 225 cm。看头顶的 [Guard …, Player …]。
- 守卫被安抚了,或者 Perception Enabled 被关掉了。
守卫隔着墙看见或抓住了玩家#
- 这面墙对 Visibility 通道不是 Block。
- 抓捕不检查视线:Alerted 的守卫离玩家 150 cm 以内就会抓,隔着薄墙也一样。
守卫听不到声音#
- 没有人调用 Make … Noise 或 Report Sound。Stealth Noise 不会自己发声。
- 玩家蹲着,蹲下的半径默认是 0。
- 中间有墙,穿墙衰减把半径缩小了。
- 玩家隐身、或者守卫被安抚了。
守卫一直在调查,不回去#
通常是持续的噪音:每次听到都会把 8 秒的怀疑保持重新计时。检查是不是有什么东西在每帧发声。
关了灯守卫没反应#
- 灯上没有 AI Light 组件。
- 灯只是调暗了(Intensity 不是 0),或者用的是隐藏 Actor、销毁 Actor。
- 那个位置还被另一盏亮着的 AI Light 覆盖。
- 灯太高、Radius 太小,地面上根本没被覆盖。勾上 AI Light 的 Draw Debug 看地上的圈。
守卫有时一看见就追,有时先站着不动#
这是确认时间的正常表现。从零开始一直盯到 Alerted 的,连续看见的时间已经够了,会直接追;先被目击、声音等弄到 Alerted 的,再看到玩家时会先盯 1 秒。见第 4 节。
抓到玩家没反应,或者触发了很多次#
C++ 不会结束游戏,要有蓝图处理 On Player Captured 或绑定 On Captured Player。这个事件在范围内每帧都会触发,接收方要自己去重。
扣分好像比预期的少#
Spotted Player 和 Noise Heard 每个守卫每个警戒周期只报一次,守卫回到 Unaware 后才会再报。这是故意的。
改了参数没生效#
- 关卡里的实例可能覆盖了蓝图默认值,Details 里前面有黄色小箭头的就是被改过的。
- 控制器上的参数在关卡里改不到,要做一个控制器蓝图,见第 8 节。
- 改了 C++ 头文件以后,最好关掉编辑器重新编译,Live Coding 处理不了新增属性。
视锥是绿色,但守卫明明在抓人#
Alerted 但暂时没看见玩家时,视锥也是绿色的,只有正看见玩家才变红。以头顶文字里的状态为准。
守卫被打晕醒来后位置变了#
没有配置 Knock Out Anim 时会用布娃娃,身体可能滚开。醒来时会在身体实际躺着的位置站起来,这是正常的。不想要这样就配一个倒地动画。
16. 蓝图接口速查#
下面按“在哪个对象上”分组列出蓝图里能用的节点。子系统在任何蓝图里用 Get AIEnemySubsystem 拿到;控制器用 Get AI Controller → Cast To AIEnemyController 拿到。
守卫(AIEnemy)的函数#
| 节点 | 用途 |
|---|---|
| Get Perception Target | 当前盯的目标 |
| Can See Actor、Can See Location | 现在能不能看到某个 Actor 或位置 |
| Get Effective Sight、Get Sight For Light | 算上明暗后的射程和半角 |
| Add Awareness、Set Awareness、React To Stimulus | 改警觉值 |
| Set Known Player Location | 告诉守卫玩家在哪,不改警觉值 |
| Reset Perception | 清空记忆,回到 Unaware |
| Is Chase Confirmed | 是否已经确认可以追 |
| Hear Sound | 直接让这个守卫听一个声音 |
| Share Alert、Receive Shared Alert | 发出或接收警报共享 |
| Notify Evidence Found、Witness Event | 手动让守卫发现证据、目击事件 |
| Get Point Of Interest、Get Point Of Interest Source | 当前最值得去的点和它的来源 |
| Forget Player、Forget Evidence、Forget Sound | 忘掉某一类线索 |
| Report Killed、Start Ragdoll | 杀死、转布娃娃 |
| Take Punch、Knock Out、Wake Up | 挨一拳、打晕、叫醒 |
| Play Attack Anim、Play Hit React Anim | 播放互殴动画 |
| Steal Emotion | 偷情绪 |
| Pacify、End Pacify、Is Pacified | 安抚 |
| Force State、Clear Forced State | 强制状态 |
| Set Move Speed | 临时改移动速度 |
| Can Perceive Events | 是否能感知(活着、清醒、没被安抚) |
| Is Actor Invisible To AI | 某个 Actor 是否带 InvisibleToAI 标签 |
守卫(AIEnemy)的事件#
| 事件 | 什么时候触发 |
|---|---|
| On Alert State Changed | 警戒状态变化 |
| On Player Spotted、On Player Lost | 玩家从看不见变看见、从看见变看不见 |
| On Player Captured、On Captured Player | 抓到玩家(在范围内每帧触发),后者是可绑定的委托 |
| On Sound Heard | 听到声音 |
| On Alert Received、On Alert Shared | 收到同伴警告、发出警告 |
| On Evidence Found、On Event Witnessed | 发现证据、目击事件 |
| On Behavior Changed | 控制器切换行为 |
| On Died | 死亡 |
| On Pacified、On Pacify Ended | 安抚开始、结束 |
| On Forced State Changed | 强制状态开始或结束 |
| On Attack、On Hit Received | 互殴时出拳、挨打 |
| On Knocked Out、On Woke Up | 被打晕、醒来 |
控制器(AIEnemyController)#
| 节点 | 用途 |
|---|---|
| Request Investigate | 让守卫去看某个位置 |
| Return To Patrol | 立刻回岗位 |
| Reset Behavior | 停下一切,把当前位置当作新岗位 |
| Force State、Clear Forced State、Is State Forced | 强制状态 |
| Behavior、Current Target、Behavior Paused | 当前行为、当前目标点、暂停开关 |
敌人子系统(AIEnemySubsystem)#
| 节点 | 用途 |
|---|---|
| Report Sound、Report Sound At、Report Sound With Feedback | 发出声音 |
| Compute Sound Reach、Compute Sound Shape | 算声音在某个方向能传多远(画声音形状用) |
| Get Enemies In Radius、Get All Enemies | 找守卫 |
| Force State In Radius | 一片守卫进入强制状态 |
| Get Light Level At、Is Location Dark、Has Any Light Off | 查明暗 |
| Set Lights In Radius、Get All Lights | 开关一片灯、拿到所有 AI Light |
| Report Evidence、Report Evidence At、Remove Evidence、Get Active Evidence | 证据 |
| Report Witnessable Event、Report Witnessable Event At、Get Witness Records | 目击事件 |
| Get Belief、Set Belief、Add Belief | Belief |
| Report Ghost Score Event | 手动发一个打分事件 |
| On Belief Changed、On Event Witnessed | 委托:Belief 变化、有目击事件 |
| On Ghost Score Event 和五个分类型的委托 | 打分事件,见第 12 节 |
其他组件#
| 组件 | 常用节点 |
|---|---|
| AI Light | Turn On、Turn Off、Toggle、Set Light On、Is Light On、Get Light Radius、On Light Changed |
| AI Evidence | Report Change、Report Change At、Report Change Of Type、Retract Last Change |
| Emotion | Take Emotion、Force Emotion、Turn On / Off Emotion 及 Angry、Fear、Joy、Calm 快捷版、Set Custom Flag、Get Display Color、Evaluate Desired Emotion(可覆盖) |
| Stealth Noise | Make Walk Noise、Make Sprint Noise、Make Crouch Noise、Make Movement Noise、Make Noise、Get Noise Radius |
| Ghost Score | Add Score、Reset Score、Get Score、Get Points For Event、On Score Changed |
| Decision | Choose Search Point、Choose Hunt Point、Is ML Available、Get Active Mode、On Decision Made |