Hard Lock (SoftLockUpdatePolicy: None)
Single Target
ValidationPolicy: PoolOnly @ 1.0s
ValidationFailAction: TrySwitch
GracePeriod: 0.5s
RelockAction: TryDifferent
RelockFallback: Release

Discovery: 15m AOE Sphere
Filters: Targetable + LOS
Scoring: Distance 50% + ScreenCenter 30% + Threat 20%

Soft Lock (SoftLockUpdatePolicy: Event)
Single Target
SoftLockEventTag: Agentic.Targeting.Event.Attack
ValidationPolicy: None (soft lock handles updates)
RelockAction: TryDifferent
RelockFallback: Release

Discovery: 8m AOE Sphere (close range for crowd combat)
Filters: Targetable (no LOS - snappy instant targeting)
Scoring: StickDirection 60% + Distance 40%

// Call this when player presses attack input
void AMyCharacter::OnAttackInput()
{
    // 1. First: Soft lock to acquire target
    TargetingComponent->ClearAllTargets();
    TargetingComponent->TriggerSoftLockUpdate();

    // 2. Then: Execute attack toward target
    AActor* Target = TargetingComponent->GetCurrentTarget();
    ExecuteAttack(Target);  // Target may be null if no enemies nearby
}

Soft Lock (SoftLockUpdatePolicy: Event)
Single Target
ValidationPolicy: None

Discovery: 15m AOE Sphere
Filters: Targetable + LOS
Scoring: StickDirection 50% + ScreenCenter 50%

// Player equips Batarang
void AMyCharacter::OnGadgetEquipped()
{
    // Keep Freeflow style, change to ranged preset
    TargetingComponent->SetPresetByTag(
        FGameplayTag::RequestGameplayTag("Agentic.Targeting.Preset.Freeflow.Ranged")
    );
}

// Player switches back to fists
void AMyCharacter::OnMeleeEquipped()
{
    TargetingComponent->SetPresetByTag(
        FGameplayTag::RequestGameplayTag("Agentic.Targeting.Preset.Freeflow")
    );
}

Hard Lock (SoftLockUpdatePolicy: None)
Single Target
ValidationPolicy: PoolOnly @ 0.2s
ValidationFailAction: TrySwitch
RelockAction: Cycle (tap to cycle through targets)
RelockFallback: Keep (stay on current if only one)

Discovery: 30m Sphere Trace (1m radius)
Filters: Targetable + LOS
Scoring: ScreenCenter 60% + Distance 40%

// Player switches from sword to bow
void AMyCharacter::OnWeaponSwitched(EWeaponType NewWeapon)
{
    // Keep same SoulsStyle, just change preset
    if (NewWeapon == EWeaponType::Bow)
    {
        TargetingComponent->SetPresetByTag("Agentic.Targeting.Preset.Ranged");
    }
    else if (NewWeapon == EWeaponType::Sword)
    {
        TargetingComponent->SetPresetByTag("Agentic.Targeting.Preset.Melee");
    }
    // Style stays Souls - same lock behavior, different query
}

Hard Lock (SoftLockUpdatePolicy: None)
Single Target
ValidationPolicy: PoolOnly @ 1.0s
ValidationFailAction: TrySwitch
GracePeriod: 0.7s (longer than Souls)
RelockAction: TryDifferent
RelockFallback: Release

Discovery: 8m AOE Sphere
Filters: Targetable + LOS
Scoring: Distance 50% + ScreenCenter 30% + Threat 20%

Soft Lock (SoftLockUpdatePolicy: PoolOnly)
Single Target
SoftLockUpdateInterval: 0.1s (100ms re-evaluation)
ValidationPolicy: None

Discovery: 30m Sphere Trace
Filters: Targetable + LOS
Scoring: ScreenCenter 60% + Distance 40%

// Called when aim input is pressed/released
void AMyCharacter::OnAimInput(bool bIsAiming)
{
    if (bIsAiming)
    {
        // Start auto-targeting while aiming
        TargetingComponent->Lock();
    }
    else
    {
        // Stop targeting when aim released
        TargetingComponent->Unlock(false);  // false = no grace period
    }
}

// On combat enter
TargetingComponent->StartAwareness(FGameplayTag::RequestGameplayTag("Agentic.Targeting.Preset.Awareness.Melee"));

// Get peripheral threats
TArray<FAgenticTargetData> Threats = TargetingComponent->GetAwarenessTargets();

// Show threat indicators on HUD
for (const FAgenticTargetData& Threat : Threats)
{
    ShowThreatIndicator(Threat.Target, Threat.Angle, Threat.ThreatLevel);
}

Discovery: 15m AOE Sphere
Filters: Targetable only (no LOS - see threats through walls)
Scoring: ThreatLevel 60% + Distance 40%

// Souls lock + awareness = best of both worlds
TargetingComponent->SetStyleByTag("Agentic.Targeting.Style.Souls");
TargetingComponent->SetPresetByTag("Agentic.Targeting.Preset.Melee");
TargetingComponent->StartAwareness("Agentic.Targeting.Preset.Awareness.Melee");

// Now you have:
// - Hard lock to primary target (GetCurrentTarget)
// - Awareness of peripheral threats (GetAwarenessTargets)

{
    "Name": "MultiLockMissiles",
    "StyleTag": { "TagName": "Agentic.Targeting.Style.MultiLock" },
    "DisplayName": "Multi-Lock Missiles",
    "Description": "Lock onto multiple targets (up to 5). Each Lock() adds next best target.",
    "LockCapacity": "Multi",
    "MaxLockedTargets": 5,
    "SoftLockUpdatePolicy": "None",
    "ValidationPolicy": "PoolOnly",
    "ValidationTickInterval": 0.5,
    "ValidationFailAction": "Release",
    "GracePeriod": 0.3,
    "RelockAction": "TryDifferent",
    "RelockFallback": "Release"
}

// Get all locked targets (for multi-lock missiles, etc.)
TArray<AActor*> Targets = TargetingComponent->GetLockedTargets();

// Check if specific target is locked
bool bLocked = TargetingComponent->HasLockedTarget(EnemyActor);

// Manually add/remove from multi-lock
TargetingComponent->AddLockedTarget(BossActor);
TargetingComponent->RemoveLockedTarget(DeadEnemy);

// Check capacity
bool bCanAdd = TargetingComponent->CanAddMoreLockedTargets();
int32 Count = TargetingComponent->GetLockedTargetCount();

void AMyCharacter::FireMultiLockMissiles()
{
    TArray<AActor*> LockedTargets = TargetingComponent->GetLockedTargets();

    for (AActor* Target : LockedTargets)
    {
        // Spawn homing missile for each locked target
        SpawnHomingMissile(Target);
    }

    // Clear locks after firing
    TargetingComponent->ReleaseLock();
}

void AMyCharacter::PerformCleaveAttack()
{
    TArray<AActor*> LockedTargets = TargetingComponent->GetLockedTargets();

    // Damage all locked targets
    for (AActor* Target : LockedTargets)
    {
        ApplyDamage(Target, CleaveBaseDamage);
    }
}