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

  1. Getting started: an agent that patrols and chases you in five steps.
  2. Core concepts: agent, controller, brain, awareness and how they talk.
  3. Awareness: reaction time, forgetting, targets, noises, alarms, perception modifiers.
  4. Profiles and difficulty: everything a kind of agent needs, scaled per difficulty.
  5. StateTree nodes: tasks, conditions, evaluator, considerations, writing own nodes.
  6. Groups and LOD: alarms, roles, many agents at little cost.
  7. Multiplayer: what runs where and what replicates.
  8. Settings: Project Settings > Pulse > AI.
  9. Debugging: cheats, snapshot, timeline, visual logger.
  10. Console: cheats and log categories.
  11. Combat integration: attacks, tokens, bosses and encounters with PulseGameplay combat.
  12. HUD integration: “?” and “!” above agents.
  13. Dialog integration: agents in dialogs stand still, break off on alarm; dialog tasks for agents.
  14. Quest integration: quests spawn and steer agents; objectives to defeat a group or escort an agent.
  15. Build integration: agents raid buildings of Pulse Build; doors with navigation links.
  16. Time integration: daily routines on the clock of Pulse Time; StateTree nodes for the time of day.
  17. 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:

  1. Put Pulse AI Agent on a pawn and pick a profile.
  2. Set the pawn’s AI Controller Class to APulseAIController.
  3. Make a StateTree with the schema Pulse AI and put it into the profile.
  4. 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.


This site uses Just the Docs, a documentation theme for Jekyll.