模块速查
每个模块一张卡片:它是什么、加在哪里、最常改的设置和最常用的节点。数值是 C++ 默认值,以 Details 面板为准。
守卫#
AAIEnemy · /Game/Benjamin-AI/Enemy/Guard
感知玩家,计算警觉值和警戒状态,负责抓捕、被打晕和死亡。
把 Guard 蓝图拖进关卡
| 设置 | 默认 | 作用 |
|---|---|---|
Sight Range | 1500 cm | 亮处的视野距离 |
Sight Angle | 45° | 视锥半角 |
Awareness Gain Rate | 1.0 /s | 看见玩家时警觉值的上涨速度 |
Capture Range | 150 cm | Alerted 时的抓捕距离 |
Patrol Points | — | 巡逻点列表 |
Draw Debug | 关 | 画视锥、线索点和状态文字 |
Event On Player CapturedEvent On Alert State ChangedShare AlertReport KilledTake PunchSteal EmotionPacifyReset Perception行为控制器#
AAIEnemyController
按警戒状态巡逻、调查、搜索、追击和返回。
自动接管守卫,不用手动添加。要改默认值,做一个继承 AIEnemyController 的蓝图,设成守卫的 AI Controller Class。
| 设置 | 默认 | 作用 |
|---|---|---|
Search Radius | 400 cm | 搜索时挑点的范围 |
Search Duration | 8 s | 搜索至少持续多久 |
Retarget Distance | 150 cm | 新线索离多远就改道 |
Behavior Paused | 关 | 暂停行为,过场动画用 |
Request InvestigateReturn To PatrolReset BehaviorForce StateClear Forced State敌人子系统#
UAIEnemySubsystem
分发声音、管理证据、判断明暗、找目击者、转发打分事件、按范围找守卫。
每个关卡自动有一个;任何蓝图都能用 Get AIEnemySubsystem 拿到
| 设置 | 默认 | 作用 |
|---|---|---|
Belief Per Kill | 0.5 | 被目击杀人时加的 Belief |
Belief Per Emotion Stolen | 0.2 | 被目击偷情绪时加的 Belief |
Extra Witness Factor | 0.5 | 每多一个目击者的加成 |
Report Sound AtReport Evidence AtReport Witnessable Event AtForce State In RadiusSet Lights In RadiusGet Enemies In RadiusIs Location DarkOn Ghost Score EventAI Light(灯光)#
UAILightComponent
标记哪些地方会变暗;灯灭时留下让守卫来查看的证据。
灯的 Actor,推荐加在 BP_LightParent 上
| 设置 | 默认 | 作用 |
|---|---|---|
Radius | 0 | 暗区半径,0 表示用灯的衰减半径 |
Investigate When Turned Off | 开 | 灯灭时守卫过来查看 |
Evidence Lifetime | 15 s | 灭灯证据存在多久 |
Start On | 开 | 没有灯光组件时的初始状态 |
Draw Debug | 关 | 在地上画判定圈 |
Turn OnTurn OffToggleSet Light OnIs Light OnOn Light ChangedAI Evidence(证据)#
UAIEvidenceComponent
物品被销毁时自动报“物品丢失”,也可以手动报告和撤回。
可以被拿走的物品
| 设置 | 默认 | 作用 |
|---|---|---|
Evidence Type | Item Missing | 证据类型 |
Notice Radius | 1200 cm | 多远能发现 |
Require Line Of Sight | 开 | 要看见才算发现 |
Report When Owner Destroyed | 开 | 销毁时自动报告 |
Lifetime | 0 | 存在秒数,0 表示永久 |
Report ChangeReport Change AtReport Change Of TypeRetract Last ChangeStealth Noise(玩家噪音)#
UStealthNoiseComponent
玩家发出的所有声音:脚步、动作、交互。它不会自己发声,要由蓝图调用。
玩家(正式项目已经挂在 BP_ThirdPersonCharacter 上)
| 设置 | 默认 | 作用 |
|---|---|---|
Walk Noise Radius | 500 cm | 走路 |
Sprint Noise Radius | 1400 cm | 跑步 |
Crouch Noise Radius | 0 | 蹲下,0 表示静音 |
Noise Wall Attenuation | 0.5 | 每过一面墙减掉的比例 |
Draw Debug | 关 | 画声音扩散圈 |
Make Walk NoiseMake Sprint NoiseMake Crouch NoiseMake Movement NoiseMake NoiseGet Noise Radius情绪#
UEmotionComponent
守卫当前的情绪、切换时的闪烁,以及被偷后的冷却。
守卫自带,组件名叫 Emotion
| 设置 | 默认 | 作用 |
|---|---|---|
Emotion Change Time | 1 s | 切换前闪烁多久 |
Emotion Reset Time | 3 s | 没有条件满足后多久回到 Calm |
Emotion Suppress Time | 10 s | 被偷后多久不能再产生 |
Initial Emotion | Calm | 开局情绪 |
Rules | 2 条 | 规则表,默认两条都产生 Angry |
Get Display ColorTurn On AngryTurn On FearTurn On JoySet Custom FlagForce EmotionOn Emotion Changed决策#
UEnemyMLDecisionComponent
看不见玩家时去哪:搜索的下一个点和搜捕的目标。目前只有规则版在用。
守卫自带,组件名叫 Decision
| 设置 | 默认 | 作用 |
|---|---|---|
Decision Mode | Rule | Rule 或 ML;ML 不可用时自动退回 Rule |
Draw Debug | 关 | 画最近一次的决策点 |
Choose Search PointChoose Hunt PointIs ML AvailableGet Active ModeOn Decision MadeStealth Move Package(潜行包)#
UStealthMovePackage
蹲和跑、镜头缩放、击杀、偷情绪、隐身,以及 T、L 两个测试键。
玩家(可选;正式项目的玩家没有挂)
| 设置 | 默认 | 作用 |
|---|---|---|
Kill Range | 180 cm | E 键击杀距离 |
Steal Range | 180 cm | F 键偷取距离 |
Invisibility Duration | 0 | V 键隐身时长,0 表示再按一次才关 |
Light Toggle Range | 1500 cm | L 键开关灯的范围 |
Try KillTry Steal EmotionSet InvisibleTest Force FightTest Toggle Nearest LightGet Move StateGhost Score#
UGhostScoreComponent
把守卫上报的事件换算成分数并打印出来;分值还是占位数。
玩家或关卡里任意 Actor(可选)
| 设置 | 默认 | 作用 |
|---|---|---|
Starting Score | 1000 | 开局分数 |
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 决策用的场地、假玩家和统计。正常关卡不需要。
只在训练地图里用