Configuration Reference

// Recovery
float ActionRecoveryTime;               // Seconds suspended after an action completes or times out (0 = off)
float InterruptRecoveryTime;            // Seconds suspended after an interrupt or cancel; keep below ActionRecoveryTime
float ActionRecoveryTimeRandomization;  // ± jitter on completion recovery, so a pack does not act in lockstep
TObjectPtr<USECActionHook> GlobalHook;  // Optional instanced lifecycle hook run for every action this enemy commits

struct FActionSpec
{
    // Identity
    FName ActionId;                    // Unique identifier within the set
 
    // Execution: instanced method that owns how the action runs
    TObjectPtr<USECExecutionMethod> ExecutionMethod; // Gameplay Ability, Behavior Tree Sequence, or your own subclass
 
    // Scoring
    float SelectionWeight;             // Base priority multiplier
    float RiskPenalty;                 // Divides the final score (1.0 = no penalty)
    TMap<FGameplayTag, float> TagScoreMultipliers; // Situational tag multipliers
    FSECCustomScoring CustomScoring;   // Scoring list: Scorers (multiply) + Gates (veto)
 
    // Cooldowns
    FActionCooldown Cooldown;
        float Duration;                // Time before reuse
        float InitialCooldown;         // Cooldown applied on spawn
        float Randomization;           // Cooldown randomness, 0.2 means ±20% (default 0.2)
        float InterruptRefund;         // Share of the remaining cooldown handed back on interrupt (default 0)
        float SpawnCooldownChance;     // Chance to start on cooldown at spawn, desyncing a group (default 0)
        int32 MaxConsecutiveUses;      // Consecutive uses before another action must run; -1 is unlimited
 
    // Chaining
    TArray<FActionChainLink> ChainLinks; // Follow-ups this action prefers
        FName TargetActionId;            // Action ID of the follow-up
        float BonusMultiplier;           // Score multiplier it receives (default 1.5)
 
    // Preconditions (Hard Gates)
    FGameplayTagContainer RequiresTags;// Must have these to use
    FGameplayTagContainer BlockTags;   // Cannot use if these exist
    bool bRequireLineOfSight;          // Only fire with a clear LOS to target
    FGameplayTagContainer AddTags;     // Added while action active
};

Range.MinValue = 0;
Range.OptimalMin = 100;
Range.OptimalMax = 250;
Range.MaxValue = 400;

// Distance
float DesiredDistance;            // Ideal distance to hold (cm), default 400
float DistanceTolerance;          // Far half of the comfort band as a fraction of desired (0.05-0.5), default 0.2
float CrowdTolerance;             // Near half, how far a target may press in before the AI gives ground (0.05-0.9), default 0.45
 
// Strafe Rest (fatigue)
bool  bEnableStrafeRest;          // Rest after continuous strafing, default true
float StrafeRestTimeLimit;        // Seconds of strafing before a rest (3-60), default 10
float StrafeRestDuration;         // Rest length in seconds (0.5-10), default 1.5
 
// Threat Response
bool  bSwapStrafeOnHighThreat;    // Swap strafe side under high threat, default false
bool  bAdjustDistanceByThreat;    // Back off as threat rises, default false
float ThreatDistanceScale;        // How strongly threat pushes distance out (0-5), default 1.0
 
// Custom Rules
TArray<UPositioningRule*> PositioningRules;  // Instanced direction modifiers, empty by default

Name: DA_AggressiveMelee
 
DesiredDistance: 300
DistanceTolerance: 0.15
CrowdTolerance: 0.6
 
bEnableStrafeRest: true
StrafeRestTimeLimit: 15.0
StrafeRestDuration: 0.5
 
bSwapStrafeOnHighThreat: false
bAdjustDistanceByThreat: false
ThreatDistanceScale: 1.0
 
PositioningRules: []

FMovementBehaviorConfig::MakeDefault();     // Balanced (400 cm)
FMovementBehaviorConfig::MakeAttacker();    // Close, aggressive, minimal rest (300 cm)
FMovementBehaviorConfig::MakeWaiter();      // Far, patient, frequent rest (600 cm)
FMovementBehaviorConfig::MakeFlanker();     // Medium, quick repositioning (400 cm)
FMovementBehaviorConfig::MakeSupporter();   // Medium-far, moderate rest (500 cm)
FMovementBehaviorConfig::MakeElite();       // Relentless pressure, very short rest (350 cm)

float Damage;                              // Base amount, before anything the target does to it (default 10)
FGameplayTag DamageType;                   // Kind of damage, for a target that resists or reacts by type
TSubclassOf<UDamageType> DamageTypeClass;  // Carried on the point damage fallback; unset sends the engine default
FGameplayTagContainer DamageTags;          // Extra tags describing hits from this attack, for example a backstab
 
bool bUseAuthoredHitDirection;             // Send a fixed blow direction instead of the attacker-to-target one
FVector AuthoredHitDirectionLocal;         // That direction in attacker space; (0,0,1) launches upward
 
TArray<TObjectPtr<USECHitEffect>> HitEffects;  // What the hit does beyond the number