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.


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