AI Enemy System Guide
Find how-tos by task, usage by module, or search any setting, node or question.
I want to…
Place a patrolling guardDrag it in, add a navmesh and patrol pointsMake footsteps heardStealth Noise plus a footstep eventPlace a light that affects AI sightLit, guards see normally; off, the area goes darkMake existing lights matterAdd AI Light to placed lamps and BP_LightParentGet a taken item noticedAdd AI Evidence to the itemHandle getting caughtWire On Player Captured, handle it onceBuild cards and abilitiesFights, blackouts, lures, calming, invisibility, killsHook up score and UIScore events and an in-the-dark hintDebug and testDraw Debug and the LV_AITest level
Find by module
GuardPerceives the player, tracks Awareness and alert state, and handles capture, knockout and death.Behavior controllerPatrols, investigates, searches, chases and returns based on the alert state.Enemy subsystemSends sounds, holds evidence, answers light queries, finds witnesses, relays score events and finds guards by radius.AI LightMarks where it can get dark, and leaves evidence for guards to check when the light goes out.AI EvidenceReports “item missing” when the item is destroyed; can also report and retract by hand.Stealth NoiseEvery noise the player makes: footsteps, actions, interactions. It never makes noise by itself; Blueprints call it.EmotionThe guard's current emotion, the flicker on change, and the cooldown after a steal.DecisionWhere to go without sight of the player: the next search point and the hunt target. Only the rule version runs today.Stealth Move PackageCrouch and sprint, camera zoom, kill, steal emotion, invisibility, and the T and L test keys.Ghost ScoreTurns guard events into points and prints them; the values are placeholders.ML training toolsThe arena, bot player and statistics for training and evaluating ML decisions. Normal levels don't need them.
Full FAQ
16 sections and 100+ questions, from overview to troubleshooting.
- 1. Overview
- 2. Getting started: putting a guard in a level
- 3. Sight
- 4. Awareness and alert states
- 5. Hearing and noise
- 6. Evidence, witnesses, Belief and alert sharing
- 7. Lights and darkness
- 8. Behaviors: patrol, investigate, search, chase
- 9. Capture, knockout, fights and death
- 10. Emotion, stealing emotions and pacify
- 11. Hooks for cards and abilities
- 12. Ghost Score events
- 13. Decision component and machine learning
- 14. Debug tools and the test level
- 15. Troubleshooting
- 16. Blueprint API quick reference