Pulse AI
Pulse AI gives enemies and NPCs a brain on StateTree. Agents notice targets with a reaction time, forget them again, call allies, patrol, wander, use smart objects and think less when no player is near. Everything that differs between kinds of agents lives in a profile asset; behavior is a StateTree built from the Pulse AI nodes and your own.
Pulse AI depends on PulseFoundation 1.0 and the engine plugins StateTree, GameplayStateTree, SmartObjects, GameplayBehaviorSmartObjects and GameplayAbilities.
Documentation map
- Getting started: an agent that patrols and chases you in five steps.
- Core concepts: agent, controller, brain, awareness and how they talk.
- Awareness: reaction time, forgetting, targets, noises, alarms, perception modifiers.
- Profiles and difficulty: everything a kind of agent needs, scaled per difficulty.
- StateTree nodes: tasks, conditions, evaluator, considerations, writing own nodes.
- Groups and LOD: alarms, roles, many agents at little cost.
- Multiplayer: what runs where and what replicates.
- Settings: Project Settings > Pulse > AI.
- Debugging: cheats, snapshot, timeline, visual logger.
- Console: cheats and log categories.
- Combat integration: attacks, tokens, bosses and encounters with PulseGameplay combat.
- HUD integration: “?” and “!” above agents.
- Dialog integration: agents in dialogs stand still, break off on alarm; dialog tasks for agents.
- Quest integration: quests spawn and steer agents; objectives to defeat a group or escort an agent.
- Build integration: agents raid buildings of Pulse Build; doors with navigation links.
- Time integration: daily routines on the clock of Pulse Time; StateTree nodes for the time of day.
- Faction integration: friend and foe by the factions of Pulse Faction; factions from the profile.
At a glance
| Step | In this plugin |
|---|---|
| Set Up | 0 required, 10 optional |
| Create | AI Profile, AI StateTree, AI Controller; starter content |
| Test | Example map LV_PulseAI_Example, cheat PulseAIGrant |
| Check | Pulse window, Check All, -run=PulseCheck |
In more detail:
- Put Pulse AI Agent on a pawn and pick a profile.
- Set the pawn’s AI Controller Class to APulseAIController.
- Make a StateTree with the schema Pulse AI and put it into the profile.
- Place a navmesh and press Play.
Modules and bridges
| Plugin | Module | What it adds |
|---|---|---|
| PulseAI | PulseAI | Agent, controller, brain, awareness, profiles, groups, LOD, StateTree nodes, cheats |
| PulseAI | PulseAIEditor | The Pulse workflow: Pulse window, Add > Pulse > AI, Check (editor only) |
| PulseAICombatBridge | PulseAICombatBridge | Combat teams as attitude, attack sets, attack tokens, telegraphs, bosses, encounters (needs PulseGameplay; damage makes agents aware without it, see Awareness) |
| PulseAIHUDBridge | PulseAIHUDBridge | Awareness markers above agents and attack warnings on the Pulse HUD (needs PulseGameplay) |
| PulseAIDialogBridge | PulseAIDialogBridge | Agents in dialogs: dialog events, In Dialog task, break off on alarm, dialog tasks Set AI Profile and Send AI Event (needs PulseDialog) |
| PulseAIQuestBridge | PulseAIQuestBridge | Quest tasks Spawn AI, Set AI Profile, Send AI Event and Raise AI Alarm, objectives Defeat AI Group and Escort AI (needs PulseQuest) |
| PulseAIBuildBridge | PulseAIBuildBridge | Raids on buildings: evaluator Hostile Build Piece, tasks Move To Build Piece and Damage Build Piece, door navigation links (needs PulseBuild) |
| PulseAITimeBridge | PulseAITimeBridge | Daily routines: routine asset, profile extension Daily Routine, routine component with profile switches, StateTree nodes Time Between, Current Time Window and Go To Activity (needs PulseTime) |
| PulseAIFactionBridge | PulseAIFactionBridge | Friend and foe by faction: attitude solver Factions, profile extension Factions, attitudes refreshed when ranks, memberships or relations change, StateTree conditions Faction Attitude and Faction Rank (needs PulseFaction) |
The examples in /PulseAI/Examples (guard StateTree, guard profile, a map with a patrol route) and /PulseAICombatBridge/Examples (fighter, boss, encounter map) show complete setups.