AI 敌人系统手册 English

完整答疑

团队文档的完整版,按模块分成 16 节。

更新于 2026-11-18

1. 概览#

这套敌人 AI 是纯 C++ 写的规则 AI,不需要行为树或 StateTree 资源。守卫(AAIEnemy)负责感知和判断,控制器(AAIEnemyController)负责行动,关卡里的敌人子系统(UAIEnemySubsystem)负责把声音、证据、灯光和目击事件分发给所有守卫。

守卫负责感知,控制器负责行动,事件都经过子系统 箭头表示谁把信息交给谁 视觉:守卫每帧直接检测玩家 分发 上报 状态和线索 打分事件 玩家 脚步、动作发出声音 灯(AI Light) 明暗、灯灭的证据 物品(AI Evidence) 被拿走时报证据 卡牌、技能、蓝图 互殴、开关灯、制造声音 敌人子系统 UAIEnemySubsystem,每关一个 声音:按半径分给守卫 证据池:守卫定时来扫 明暗:哪里算暗处 目击:找目击者、加 Belief 警报共享:通知附近守卫 打分事件:转给监听者 按范围找守卫:给卡牌用 守卫 AAIEnemy 视觉、听觉、证据 警觉值和警戒状态 抓捕、击晕、死亡 自带情绪、决策组件 控制器 AAIEnemyController 巡逻、调查、搜索、追击 计分系统、UI 等 绑定子系统的委托
敌人 AI 的结构 · 谁把信息交给谁

声音、证据、目击这些事件都先交给子系统,再由子系统分给每个守卫;视觉是守卫自己每帧去检测。

这套 AI 由哪些部分组成?#

模块类挂在哪负责什么
守卫AAIEnemyGuard 蓝图的父类视觉、听觉、证据、警觉值和警戒状态、抓捕、击晕、死亡,以及各种蓝图事件
行为控制器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。

每一帧大概发生了什么?#

  1. 守卫的 Tick:判断能不能看到玩家,更新警觉值和警戒状态,检查能不能抓到玩家,每 0.25 秒扫一次证据。
  2. 控制器的 Tick:按警戒状态选行为,发出寻路请求,转向该看的方向。
  3. 声音和目击是“事件”,不靠 Tick:谁发出就调用子系统,子系统当场分发给每个守卫。

文中的数字以什么为准?#

都是 C++ 里的默认值。Guard 蓝图或关卡里的实例可能改过,以 Details 面板上显示的为准。守卫的参数在 Details 面板里按 AI 分类排好了,比如 AI | Perception、AI | Behavior。

2. 快速上手:在关卡里放一个守卫#

把 Guard 蓝图拖进关卡、保证脚下有导航网格,它就会自己站岗;再给它几个巡逻点,它就会巡逻。其他东西都是自动的。

最少需要什么?#

  1. 把 /Game/Benjamin-AI/Enemy/Guard(或任何继承 AAIEnemy 的蓝图)拖进关卡。控制器会自动接管,不用手动设 AI Controller Class。
  2. 关卡里要有 NavMeshBoundsVolume 盖住守卫活动的区域,并且导航网格已经生成(视口里按 P 能看到绿色区域)。没有导航网格守卫不会动,屏幕左上角会打印红色的 MoveTo failed 诊断。
  3. 关卡里要有玩家。守卫默认盯的是 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 节。

判定具体怎么算?#

  1. 距离:从守卫眼睛(胶囊体中心往上 Base Eye Height)到玩家胶囊体中心的直线距离,不超过射程。
  2. 角度:只看水平方向。玩家和守卫正前方的水平夹角不超过半角。玩家在正上方或正下方也算在视锥里。
  3. 遮挡:从眼睛到玩家中心打一条 Visibility 通道的射线。打到玩家本身(或挂在玩家身上的东西)才算看见。

参数在哪?#

参数默认作用
Sight Range1500 cm亮处看亮处时的射程
Sight Angle45°视锥半角,实际张角是它的两倍
Turn Rate360°/秒转身速度,视锥跟着身体转
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 Rate1.0 /秒看见玩家时每秒涨多少
Awareness Decay Rate0.5 /秒什么都没感知到时每秒降多少
Suspicion Threshold0.3到这个值进入 Suspicious
Alert Threshold1.0到这个值进入 Alerted
Alert Duration5 秒Alerted 后什么都感知不到,先保持这么久再开始下降
Suspicion Duration8 秒被声音、证据、同伴警告弄成 Suspicious 后,保持这么久再开始下降
Chase Delay1 秒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 Noise500 cm
跑步Make Sprint Noise1400 cm
蹲着Make Crouch Noise0(静音)
其他Make Noise调用时自己填

这些在 Stealth Noise 组件上改。玩家带 InvisibleToAI 标签时,所有节点都不发声。

墙能挡住声音吗?#

看穿墙衰减。从声源朝每个守卫的方向打射线,每穿过一面墙,剩下的距离乘以 (1 − 衰减)。角色不算墙。

  • 0:完全穿墙。Report Sound At 默认就是 0。
  • 0.5:穿一面墙剩一半。Stealth Noise 的 Noise Wall Attenuation 默认是 0.5。
  • 1:一面墙就完全挡住。

守卫听到之后做什么?#

  1. 记住声源位置(Last Heard Sound Location)。
  2. 按 Noise Reaction 反应:默认 Suspicious,抬到 0.3 并保持 8 秒;也可以改成 Alerted。
  3. 触发 On Sound Heard 事件。
  4. 控制器走到声源位置,到了以后在附近搜索。

被安抚、晕倒、死亡的守卫听不到任何声音。

脚步声每帧都报,会不会出问题?#

打分不会重复扣:每个守卫在一个警戒周期里只报一次 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)检查一次证据池,要同时满足:

  1. 距离在证据的 Notice Radius(默认 1200 cm)以内。
  2. 证据要求视线时(默认要求),证据位置要在守卫的视锥里且没被挡住。射线打到证据物体本身也算看见。证据在暗处时同样只能在很近的地方看到。

证据设了 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 Stolen0.20.30.4
NPC Killed0.50.751.0
Restricted Area Sighting0.10.150.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 cm45°Sight Range / Sight Angle 本身
亮暗225 cm18°Light To Dark Sight(0.15 / 0.4)
暗亮1950 cm67.5°Dark To Light Sight(1.3 / 1.5)
暗暗300 cm22.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(旧行为, 新行为),可以用来换动画或表情。

起疑先查看,确认才追击,线索断了就一路退回巡逻 任何时候只要 Alerted 且看得见玩家,都会进入确认 到了,接着巡逻 看见玩家、警觉值到 1 巡逻 / 站岗 Unaware 时的日常 按巡逻点走或站岗 调查 Suspicious 起疑 走向最新的可疑点 搜索 到了以后 在附近挑点张望 返回 平静下来后 回巡逻点或岗位 确认 Alerted 且看得见 停下盯 Chase Delay 追击 确认之后 冲向玩家 搜捕 Alerted 但看不见 去最后知道的位置 Unaware:巡逻、站岗、返回 Suspicious:调查、搜索 Alerted:确认、追击、搜捕,也会搜索
警戒状态与行为 · 7 种行为

绿、黄、红三种颜色对应三种警戒状态,和头顶警觉条的颜色一致。搜索在 Suspicious 和 Alerted 下都会出现。

有哪些行为?#

行为什么时候在做什么速度(cm/秒)
Patrol 巡逻Unaware,有巡逻点或随机巡逻半径按顺序走巡逻点,每个点停 Patrol Wait TimePatrol 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 Radius80 cm巡逻和返回的到达半径
Investigate Acceptance Radius100 cm调查和搜索的到达半径
Retarget Distance150 cm新线索离当前目标多远就改道
Nav Projection Extent250, 250, 300 cm目标点吸附到导航网格的搜索范围
Search Radius400 cm搜索时随机挑点的半径
Search Duration8 秒搜索至少持续多久
Search Look Time1.5 秒每个搜索点停多久
Chase Acceptance Scale0.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 就是这么做的。之后会依次:

  1. 关闭感知、停止移动,胶囊体不再挡人。
  2. 播放死亡表现:有 Death Anim 就播放,然后定格在最后一帧或转成布娃娃;没有就直接布娃娃。
  3. 触发 On Died,上报 Guard Dead 打分事件。
  4. 在原地留下一个永久的 Body 证据。
  5. 上报 NPC Killed 目击事件,看到的守卫会警报。

死亡表现的参数在 AI → Death 分类里:

参数默认作用
Death Anim空死亡动画(序列或蒙太奇),空就直接布娃娃
Ragdoll After Death Anim关动画播完后转布娃娃;关着就定格在最后一帧
Ragdoll Impulse300布娃娃开始时沿“凶手 → 守卫”的方向推一下
Destroy After Death0死后多少秒删掉尸体,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 节):

  1. 在 Fight Search Radius(3000 cm)内找最近的、活着且清醒的其他守卫,每 0.5 秒重新检查一次。
  2. 走过去,停在 Fight Stand Off Distance(150 cm)处;太近(小于 120 cm)会边面对对手边后退。
  3. 在 Fight Attack Range(190 cm)内,每 Fight Attack Interval(1 秒,不会短于出拳动画)出一拳,经过 Attack Hit Delay(0.35 秒)后命中,对方 Take Punch。
  4. 被打的一方播受击动画,攻够 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(偷的人),返回偷到的情绪和卡牌权重(就是情绪强度)。正式项目里目前没有东西调用它,偷情绪的技能要自己接上。偷完之后:

  1. 守卫回到 Calm,Emotion Suppress Time(10 秒)内不会再产生被偷的那种情绪。
  2. 上报 Emotion Stolen 目击事件:看到的其他守卫会警报,并增加 Belief。被偷的守卫自己不算目击者。
  3. 偷到的不是 Calm 时,守卫被安抚。

情绪正在闪烁时被偷,默认拿到的是旧情绪;勾上 Take Pending During Flicker 就拿新的。

安抚(Pacify)是什么?#

被安抚的守卫会“忘掉一切”:警觉值清零、记忆清空、回到 Unaware、解除卡牌强制状态、立刻回巡逻路线。安抚期间它看不见、听不到、不当目击者、不接受同伴警告;这期间看到的证据会被永久忽略。

参数(AI → Emotion → Pacify)默认作用
Pacify On Emotion Stolen开被偷情绪时是否安抚
Pacify When Calm Stolen关偷走 Calm 是否也安抚。关着是为了不让“偷 Calm”变成免费的“别追我”
Pacify Duration0安抚时长,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 PlayerAlerted 且盯满 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 DebugAI Light 组件地上的明暗判定圈,黄色是亮、深蓝是灭
Draw DebugStealth Noise 组件声音扩散圈,和听到的守卫连到玩家的线
Draw Debug情绪组件脚下的情绪颜色圈,切换时会闪
Draw Debug决策组件最近一次决策选的点
Draw DebugStealth 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 BeliefBelief
Report Ghost Score Event手动发一个打分事件
On Belief Changed、On Event Witnessed委托:Belief 变化、有目击事件
On Ghost Score Event 和五个分类型的委托打分事件,见第 12 节

其他组件#

组件常用节点
AI LightTurn On、Turn Off、Toggle、Set Light On、Is Light On、Get Light Radius、On Light Changed
AI EvidenceReport Change、Report Change At、Report Change Of Type、Retract Last Change
EmotionTake Emotion、Force Emotion、Turn On / Off Emotion 及 Angry、Fear、Joy、Calm 快捷版、Set Custom Flag、Get Display Color、Evaluate Desired Emotion(可覆盖)
Stealth NoiseMake Walk Noise、Make Sprint Noise、Make Crouch Noise、Make Movement Noise、Make Noise、Get Noise Radius
Ghost ScoreAdd Score、Reset Score、Get Score、Get Points For Event、On Score Changed
DecisionChoose Search Point、Choose Hunt Point、Is ML Available、Get Active Mode、On Decision Made