Utility Classes

WCEQSUtils

Namespace with shared utility functions for EQS classes.

Function Description
GetHealthPercent Retrieves health percentage (0.0–1.0) for an actor by searching its AbilitySystemComponent for Health/MaxHealth attributes via reflection
GetHealthPercentFromASC Same as above but accepts an existing AbilitySystemComponent directly

EQS Contexts

Contexts provide actors or locations that generators and tests can reference.

Class Name Display Name Description
UWCEQSContext_ThreatTarget WC Threat Target Returns the querier's single highest-threat target from their threat table. Ideal for positioning queries relative to the primary combat target.
UWCEQSContext_ThreatTable WC Threat Table Returns all actors in the querier's threat table, sorted by threat value. Supports filtering by minimum threat, result count limits, and taunt exclusion. Ideal for AoE targeting and multi-target queries.
UWCEQSContext_SquadLeader WC Squad Leader Returns the querier's squad leader. Useful for formation positioning, rally points, and coordinated movement. Can optionally return self if the querier is the leader.
UWCEQSContext_SquadMembers WC Squad Members Returns all members of the querier's squad. Supports filtering self-inclusion and restricting to active (non-downed) members. Used for cohesion and friendly-fire avoidance queries.
UWCEQSContext_WoundedAllies WC Wounded Squad Allies Returns squad members that have Wounded status or health below a configurable threshold. Used by protective roles (Tank/Support) for ally-defense behaviors.
UWCEQSContext_RecentDamage WC Recent Damage Sources Returns actors that recently damaged the querier, sorted by recency. Supports time window, result limits, and minimum threat filters. Used for reactive/retaliation targeting.

EQS Generator

Class Name Display Name Description
UWCEQSGen_FormationPoints WC Formation Points Generates tactical formation positions around a context actor. Supports six formation patterns (Line, Wedge, Column, Circle, Diamond, Staggered) with configurable spacing, point count, height offset, and rotation inheritance.

Formation Types (EWCFormationType):

Type Description
Line Horizontal line perpendicular to forward direction
Wedge V-shaped formation with leader at the apex
Column Single-file formation behind leader
Circle Ring around center point
Diamond Four-point rhombus shape
Staggered Two offset columns

EQS Tests

Tests filter or score query items based on various criteria.

Combat & Threat Tests

Class Name Display Name Description
UWCEQSTest_ThreatValue WC Threat Value Filters or scores items by their threat value in the querier's threat table. Supports minimum threat filtering, absolute vs normalized scoring, and inversion for CC target prioritization.
UWCEQSTest_IsInCombat WC Is In Combat Filters or scores items by combat state (Engaging, Retreating, Idle). Useful for targeting engaged enemies or finding idle ambush targets.
UWCEQSTest_AbilityCooldown WC Ability Cooldown Filters or scores based on the querier's ability cooldown status. All items receive the same result since this tests the AI's own readiness, not the targets.

Health & Status Tests

Class Name Display Name Description
UWCEQSTest_HealthPercent WC Health Percent Filters or scores items by health percentage. Uses reflection to find Health/MaxHealth attributes automatically. Supports min/max range filtering and inversion for wounded-target prioritization.
UWCEQSTest_HasStatusEffect WC Has Status Effect Filters or scores items by whether they have a specific gameplay tag status effect active. Works with the WCGASStatusEffectComp. Supports inversion for finding non-CC'd or non-immune targets.