AI 敌人系统手册 English

模块速查

每个模块一张卡片:它是什么、加在哪里、最常改的设置和最常用的节点。数值是 C++ 默认值,以 Details 面板为准。

更新于 2026-11-18

守卫#

AAIEnemy · /Game/Benjamin-AI/Enemy/Guard

是什么

感知玩家,计算警觉值和警戒状态,负责抓捕、被打晕和死亡。

加在哪里

把 Guard 蓝图拖进关卡

常用设置
设置默认作用
Sight Range1500 cm亮处的视野距离
Sight Angle45°视锥半角
Awareness Gain Rate1.0 /s看见玩家时警觉值的上涨速度
Capture Range150 cmAlerted 时的抓捕距离
Patrol Points—巡逻点列表
Draw Debug关画视锥、线索点和状态文字
常用节点
Event On Player CapturedEvent On Alert State ChangedShare AlertReport KilledTake PunchSteal EmotionPacifyReset Perception

行为控制器#

AAIEnemyController

是什么

按警戒状态巡逻、调查、搜索、追击和返回。

加在哪里

自动接管守卫,不用手动添加。要改默认值,做一个继承 AIEnemyController 的蓝图,设成守卫的 AI Controller Class。

常用设置
设置默认作用
Search Radius400 cm搜索时挑点的范围
Search Duration8 s搜索至少持续多久
Retarget Distance150 cm新线索离多远就改道
Behavior Paused关暂停行为,过场动画用
常用节点
Request InvestigateReturn To PatrolReset BehaviorForce StateClear Forced State

敌人子系统#

UAIEnemySubsystem

是什么

分发声音、管理证据、判断明暗、找目击者、转发打分事件、按范围找守卫。

加在哪里

每个关卡自动有一个;任何蓝图都能用 Get AIEnemySubsystem 拿到

常用设置
设置默认作用
Belief Per Kill0.5被目击杀人时加的 Belief
Belief Per Emotion Stolen0.2被目击偷情绪时加的 Belief
Extra Witness Factor0.5每多一个目击者的加成
常用节点
Report Sound AtReport Evidence AtReport Witnessable Event AtForce State In RadiusSet Lights In RadiusGet Enemies In RadiusIs Location DarkOn Ghost Score Event

AI Light(灯光)#

UAILightComponent

是什么

标记哪些地方会变暗;灯灭时留下让守卫来查看的证据。

加在哪里

灯的 Actor,推荐加在 BP_LightParent 上

常用设置
设置默认作用
Radius0暗区半径,0 表示用灯的衰减半径
Investigate When Turned Off开灯灭时守卫过来查看
Evidence Lifetime15 s灭灯证据存在多久
Start On开没有灯光组件时的初始状态
Draw Debug关在地上画判定圈
常用节点
Turn OnTurn OffToggleSet Light OnIs Light OnOn Light Changed

AI Evidence(证据)#

UAIEvidenceComponent

是什么

物品被销毁时自动报“物品丢失”,也可以手动报告和撤回。

加在哪里

可以被拿走的物品

常用设置
设置默认作用
Evidence TypeItem Missing证据类型
Notice Radius1200 cm多远能发现
Require Line Of Sight开要看见才算发现
Report When Owner Destroyed开销毁时自动报告
Lifetime0存在秒数,0 表示永久
常用节点
Report ChangeReport Change AtReport Change Of TypeRetract Last Change

Stealth Noise(玩家噪音)#

UStealthNoiseComponent

是什么

玩家发出的所有声音:脚步、动作、交互。它不会自己发声,要由蓝图调用。

加在哪里

玩家(正式项目已经挂在 BP_ThirdPersonCharacter 上)

常用设置
设置默认作用
Walk Noise Radius500 cm走路
Sprint Noise Radius1400 cm跑步
Crouch Noise Radius0蹲下,0 表示静音
Noise Wall Attenuation0.5每过一面墙减掉的比例
Draw Debug关画声音扩散圈
常用节点
Make Walk NoiseMake Sprint NoiseMake Crouch NoiseMake Movement NoiseMake NoiseGet Noise Radius

情绪#

UEmotionComponent

是什么

守卫当前的情绪、切换时的闪烁,以及被偷后的冷却。

加在哪里

守卫自带,组件名叫 Emotion

常用设置
设置默认作用
Emotion Change Time1 s切换前闪烁多久
Emotion Reset Time3 s没有条件满足后多久回到 Calm
Emotion Suppress Time10 s被偷后多久不能再产生
Initial EmotionCalm开局情绪
Rules2 条规则表,默认两条都产生 Angry
常用节点
Get Display ColorTurn On AngryTurn On FearTurn On JoySet Custom FlagForce EmotionOn Emotion Changed

决策#

UEnemyMLDecisionComponent

是什么

看不见玩家时去哪:搜索的下一个点和搜捕的目标。目前只有规则版在用。

加在哪里

守卫自带,组件名叫 Decision

常用设置
设置默认作用
Decision ModeRuleRule 或 ML;ML 不可用时自动退回 Rule
Draw Debug关画最近一次的决策点
常用节点
Choose Search PointChoose Hunt PointIs ML AvailableGet Active ModeOn Decision Made

Stealth Move Package(潜行包)#

UStealthMovePackage

是什么

蹲和跑、镜头缩放、击杀、偷情绪、隐身,以及 T、L 两个测试键。

加在哪里

玩家(可选;正式项目的玩家没有挂)

常用设置
设置默认作用
Kill Range180 cmE 键击杀距离
Steal Range180 cmF 键偷取距离
Invisibility Duration0V 键隐身时长,0 表示再按一次才关
Light Toggle Range1500 cmL 键开关灯的范围
常用节点
Try KillTry Steal EmotionSet InvisibleTest Force FightTest Toggle Nearest LightGet Move State

Ghost Score#

UGhostScoreComponent

是什么

把守卫上报的事件换算成分数并打印出来;分值还是占位数。

加在哪里

玩家或关卡里任意 Actor(可选)

常用设置
设置默认作用
Starting Score1000开局分数
Points Spotted Player-10被看到
Points Detected Player-50被确认并追击
Points Guard Dead-100守卫被杀
Print Score Changes开把每次变化打印到屏幕
常用节点
Add ScoreReset ScoreGet ScoreGet Points For EventOn Score Changed

机器学习训练工具#

EnemyML Arena · Player Bot · Evaluator · Training Game Mode

是什么

训练和评估 ML 决策用的场地、假玩家和统计。正常关卡不需要。

加在哪里

只在训练地图里用