Groups and LOD
Alarms
When an agent becomes Alert from its own senses (not from an alarm), it raises an alarm (UPulseAISubsystem::RaiseAlarm, also the task Raise Alarm): every friendly agent within the alarm radius and every member of its group becomes at least Alert of the target at its location. Receivers never pass the alarm on, so it does not spread over the whole map. Profiles can turn alarms off (bAlarmWhenAlerted, bRespondsToAlarms).
Groups
UPulseAIAgentComponent::Group is a name (a camp, an encounter). Group members hear each other’s alarms at any distance. Encounters of the combat bridge put their agents into one group.
Roles
Profiles list the roles an agent has and prefers (Pulse.AI.Role.*). A group can hand out roles with quotas:
UPulseAISubsystem::Get(this)->SetGroupRoles(TEXT("Camp"), { { Pulse::AI::Tags::Role_Leader, 1 }, { Pulse::AI::Tags::Role_Flanker, 2 } });
Members that prefer a role get it first, then members without role; roles are reassigned when members join or leave. The condition Has Role branches on them.
LOD
The subsystem checks the distance of every agent to the nearest player pawn twice a second:
| LOD | From (default) | Brain | Awareness | Perception |
|---|---|---|---|---|
| Active | 0 | Every update | Every 0.1 s | On |
| Reduced | 40 m | Every 0.25 s | Every 0.5 s | On |
| Dormant | 120 m | Paused, movement stopped | Off | Off |
Agents that are at least Alert never go Dormant (KeepAwakeAwareness). Profiles can set own distances. The LOD replicates (UPulseAIAgentComponent::GetLOD), so clients can lower effects of far agents too.
Pause reasons
The brain is paused for reasons: UPulseAIBrainComponent::SetPauseReason(Reason, bPaused) (C++) sets or removes one, and the logic stays paused while any reason is set. The Dormant LOD pauses with PulseAI.LOD, the cheat PulseAIFreeze with PulseAI.Freeze; bridges use their own (PulseWorldAIBridge: PulseWorld.SimulationRing and PulseWorld.Ground). So an agent that comes near a player stays paused while a bridge still holds it, and a thaw never wakes a dormant agent. HasPauseReason and HasPauseReasons tell who holds it.