Presets Guide

Complete reference for targeting presets, tasks, and the JSON configuration workflow.

What Are Presets?

Presets define WHO to target:

• Range - How far to search
• Selection - How to find targets (AOE, trace)
• Filters - What to exclude (dead, blocked, too far)
• Sorting - How to rank targets (distance, threat, screen position)

Styles define HOW lock-on behaves. Presets define WHO gets targeted.

Built-in Presets

Targeting Presets

Awareness Presets

Hysteresis: Acquire vs Break Distance

Each preset has two distance thresholds:

Why different? Prevents frustrating lock breaks during combat movement.

Example: Melee Preset
  - Acquire: 15m (target must be within 15m to lock)
  - Break: 20m (target can go up to 20m before lock breaks)

Player locks at 14m → target backs up to 18m → STAYS LOCKED
Target at 21m → lock breaks

How It Works

The FilterValidationDistance task enables hysteresis:

• During selection: Skipped (acquire distance from AOE/Trace radius)
• During validation: Active (break distance check)

// In preset tasks:
{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.AOE" },
    "Params": { "Radius": "1500" }  // 15m acquire
},
{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.Filter.ValidationDistance" },
    "Params": { "MaxDistance": "2000" }  // 20m break
}

Preset Details

Melee

Tag: Agentic.Targeting.Preset.Melee

Souls-style melee lock-on for swords, axes, and close combat.

Task Pipeline:

1. AOE (15m sphere)
2. Filter.Targetable
3. Filter.ValidationDistance (20m)
4. Filter.LOS
5. Sort.Distance (weight 0.7)
6. Sort.ScreenCenter (weight 0.3)

Ranged

Tag: Agentic.Targeting.Preset.Ranged

Souls-style ranged lock-on for bows and crossbows.

Task Pipeline:

1. Trace (30m sphere sweep)
2. Filter.Targetable
3. Filter.ValidationDistance (40m)
4. Filter.LOS
5. Sort.ScreenCenter (weight 0.6)
6. Sort.Distance (weight 0.4)

Ranged.Short

Tag: Agentic.Targeting.Preset.Ranged.Short

For throwing weapons - knives, firebombs, chakrams.

Astra (Divine Weapons)

Tag: Agentic.Targeting.Preset.Astra

Extreme-range for divine weapons (Brahmastra, Agneyastra).

Freeflow

Tag: Agentic.Targeting.Preset.Freeflow

Arkham-style auto-targeting for crowd combat.

Key Difference: No LOS check for instant, snappy combat feel.

Freeflow.Ranged

Tag: Agentic.Targeting.Preset.Freeflow.Ranged

Freeflow for thrown weapons (Batarangs, gadgets).

Awareness Presets

All awareness presets use pure distance sorting (closest first).

Task Reference

Presets are built from modular Tasks. Each task performs one operation in the targeting pipeline.

Selection Tasks

Find initial pool of potential targets.

AOE Parameters

{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.AOE" },
    "Params": {
        "Radius": "1500",              // Detection radius (cm)
        "ShapeType": "Sphere",         // Sphere or Box
        "CollisionChannel": "ECC_Pawn",
        "bIgnoreSourceActor": "true"
    }
}

Trace Parameters

{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.Trace" },
    "Params": {
        "TraceType": "Sphere",            // Line, Sphere, Capsule, Box
        "DefaultTraceLength": "3000",     // Trace distance (cm)
        "DefaultSweptTraceRadius": "100", // Sweep radius
        "bIgnoreSourceActor": "true",
        "bMultiTrace": "true"             // Find all hits, not just first
    }
}

Filter Tasks

Remove invalid targets from pool.

FilterTargetable Parameters

{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.Filter.Targetable" },
    "Params": {
        "bFilterNonImplementors": "true"  // Require IAgenticTargetable interface
    }
}

FilterLOS Parameters

{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.Filter.LOS" },
    "Params": {
        "TraceChannel": "ECC_Visibility",      // Collision channel
        "bUseTargetableLocation": "false"      // Use GetTargetLocation() from interface
    }
}

FilterDistance vs FilterValidationDistance

Use FilterValidationDistance for hysteresis:

// Acquire at 15m, break at 20m
{ "TaskTag": { "TagName": "Agentic.Targeting.Task.AOE" }, "Params": { "Radius": "1500" } },
{ "TaskTag": { "TagName": "Agentic.Targeting.Task.Filter.ValidationDistance" }, "Params": { "MaxDistance": "2000" } }

Sort Tasks

Rank remaining targets by priority.

Sort Parameters

All sort tasks support:

{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.Sort.Distance" },
    "Params": {
        "Weight": "0.7",           // Contribution to final score (0-1)
        "MaxDistance": "2000"      // Normalize distance against this
    }
}

SortScreenCenter Parameters

{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.Sort.ScreenCenter" },
    "Params": {
        "Weight": "0.6",
        "FalloffExponent": "2.0",         // How fast score drops off-center
        "bUseTargetableLocation": "false"  // Use interface location
    }
}

SortStickDirection Parameters

{
    "TaskTag": { "TagName": "Agentic.Targeting.Task.Sort.StickDirection" },
    "Params": {
        "Weight": "0.6",
        "FalloffExponent": "1.5"
    }
}

Creating Custom Presets

1. Content Browser -> Right-click -> Miscellaneous -> Data Asset
2. Pick Agentic Targeting Preset

3. Fill in the properties:
   • Preset Tag - Unique tag for this preset
   • Display Name - Human-readable name
   • Tasks - Add selection, filter, and sort tasks

That's it. Your preset is ready to use.

TargetingComponent->SetPresetByTag(
    FGameplayTag::RequestGameplayTag("Agentic.Targeting.Preset.MyCustom")
);

Best Practices

1. Use FilterValidationDistance for hysteresis - Acquire at one range, break at a larger range
2. Weight your sorts - Multiple sorts combine (e.g., Distance 70% + ScreenCenter 30%)
3. Skip LOS for snappy combat - Freeflow presets don't use LOS filter
4. Use Trace for ranged weapons - AOE is circular, Trace follows aim direction

Troubleshooting

No Targets Found

1. Check preset range matches your level scale
2. Ensure enemies have IAgenticTargetable interface
3. Enable debug: TargetingComponent->bDebugDraw = true
4. Check collision channels match enemies

Lock Breaks Too Easily

1. Increase break distance in FilterValidationDistance
2. Increase style's GracePeriod
3. Use GoW style (longer grace period)

Wrong Target Selected

1. Adjust sort weights
2. Check sort order (first sort has priority)
3. Try different sort combination

Related Documentation

• Styles Reference - How lock-on behaves
• Targeting Recipes - Style + Preset combinations
• Awareness Guide - Multi-target tracking
• Extending Tasks - Create custom Blueprint tasks