Modules
One card per module: what it is, where it goes, the settings you change most and the nodes you use most. Numbers are C++ defaults; trust the Details panel.
Guard#
AAIEnemy · /Game/Benjamin-AI/Enemy/Guard
Perceives the player, tracks Awareness and alert state, and handles capture, knockout and death.
Drag the Guard Blueprint into a level
| Setting | Default | What it does |
|---|---|---|
Sight Range | 1500 cm | Sight range in the light |
Sight Angle | 45° | Cone half-angle |
Awareness Gain Rate | 1.0 /s | How fast Awareness rises in sight |
Capture Range | 150 cm | Capture distance while Alerted |
Patrol Points | — | Patrol point list |
Draw Debug | Off | Draws the cone, clues and status text |
Event On Player CapturedEvent On Alert State ChangedShare AlertReport KilledTake PunchSteal EmotionPacifyReset PerceptionBehavior controller#
AAIEnemyController
Patrols, investigates, searches, chases and returns based on the alert state.
Possesses guards automatically. To change its defaults, make a Blueprint based on AIEnemyController and set it as the guard's AI Controller Class.
| Setting | Default | What it does |
|---|---|---|
Search Radius | 400 cm | Radius for picking search points |
Search Duration | 8 s | Minimum search time |
Retarget Distance | 150 cm | How far a new clue must be to change course |
Behavior Paused | Off | Pauses behavior, for cutscenes |
Request InvestigateReturn To PatrolReset BehaviorForce StateClear Forced StateEnemy subsystem#
UAIEnemySubsystem
Sends sounds, holds evidence, answers light queries, finds witnesses, relays score events and finds guards by radius.
One per level, automatically; any Blueprint gets it with Get AIEnemySubsystem
| Setting | Default | What it does |
|---|---|---|
Belief Per Kill | 0.5 | Belief per witnessed kill |
Belief Per Emotion Stolen | 0.2 | Belief per witnessed steal |
Extra Witness Factor | 0.5 | Bonus per extra witness |
Report Sound AtReport Evidence AtReport Witnessable Event AtForce State In RadiusSet Lights In RadiusGet Enemies In RadiusIs Location DarkOn Ghost Score EventAI Light#
UAILightComponent
Marks where it can get dark, and leaves evidence for guards to check when the light goes out.
The lamp actor, ideally on BP_LightParent
| Setting | Default | What it does |
|---|---|---|
Radius | 0 | Dark-area radius; 0 uses the attenuation radius |
Investigate When Turned Off | On | Guards check when it goes out |
Evidence Lifetime | 15 s | How long the evidence lasts |
Start On | On | Initial state with no light component |
Draw Debug | Off | Draws the circle on the floor |
Turn OnTurn OffToggleSet Light OnIs Light OnOn Light ChangedAI Evidence#
UAIEvidenceComponent
Reports “item missing” when the item is destroyed; can also report and retract by hand.
Items that can be taken
| Setting | Default | What it does |
|---|---|---|
Evidence Type | Item Missing | Evidence type |
Notice Radius | 1200 cm | How far away it can be noticed |
Require Line Of Sight | On | Must be seen to count |
Report When Owner Destroyed | On | Report automatically when destroyed |
Lifetime | 0 | Seconds it lasts; 0 means permanent |
Report ChangeReport Change AtReport Change Of TypeRetract Last ChangeStealth Noise#
UStealthNoiseComponent
Every noise the player makes: footsteps, actions, interactions. It never makes noise by itself; Blueprints call it.
The player (already on BP_ThirdPersonCharacter in the formal project)
| Setting | Default | What it does |
|---|---|---|
Walk Noise Radius | 500 cm | Walking |
Sprint Noise Radius | 1400 cm | Sprinting |
Crouch Noise Radius | 0 | Crouching; 0 means silent |
Noise Wall Attenuation | 0.5 | Fraction lost at each wall |
Draw Debug | Off | Draws noise rings |
Make Walk NoiseMake Sprint NoiseMake Crouch NoiseMake Movement NoiseMake NoiseGet Noise RadiusEmotion#
UEmotionComponent
The guard's current emotion, the flicker on change, and the cooldown after a steal.
Built into every guard, as the component named Emotion
| Setting | Default | What it does |
|---|---|---|
Emotion Change Time | 1 s | Flicker before switching |
Emotion Reset Time | 3 s | Time back to Calm with no condition met |
Emotion Suppress Time | 10 s | Cooldown after a steal |
Initial Emotion | Calm | Starting emotion |
Rules | 2 rules | Rule table; both defaults produce Angry |
Get Display ColorTurn On AngryTurn On FearTurn On JoySet Custom FlagForce EmotionOn Emotion ChangedDecision#
UEnemyMLDecisionComponent
Where to go without sight of the player: the next search point and the hunt target. Only the rule version runs today.
Built into every guard, as the component named Decision
| Setting | Default | What it does |
|---|---|---|
Decision Mode | Rule | Rule or ML; falls back to Rule when ML is unavailable |
Draw Debug | Off | Draws the latest decision point |
Choose Search PointChoose Hunt PointIs ML AvailableGet Active ModeOn Decision MadeStealth Move Package#
UStealthMovePackage
Crouch and sprint, camera zoom, kill, steal emotion, invisibility, and the T and L test keys.
The player (optional; not on the formal project's player)
| Setting | Default | What it does |
|---|---|---|
Kill Range | 180 cm | E-key kill distance |
Steal Range | 180 cm | F-key steal distance |
Invisibility Duration | 0 | V-key duration; 0 means until pressed again |
Light Toggle Range | 1500 cm | L-key light toggle range |
Try KillTry Steal EmotionSet InvisibleTest Force FightTest Toggle Nearest LightGet Move StateGhost Score#
UGhostScoreComponent
Turns guard events into points and prints them; the values are placeholders.
The player or any actor in the level (optional)
| Setting | Default | What it does |
|---|---|---|
Starting Score | 1000 | Starting score |
Points Spotted Player | -10 | Spotted |
Points Detected Player | -50 | Detected and chased |
Points Guard Dead | -100 | Guard killed |
Print Score Changes | On | Print each change on screen |
Add ScoreReset ScoreGet ScoreGet Points For EventOn Score ChangedML training tools#
EnemyML Arena · Player Bot · Evaluator · Training Game Mode
The arena, bot player and statistics for training and evaluating ML decisions. Normal levels don't need them.
Training maps only