Modifiers Reference

Modifiers are what turn authored data into rig behavior. A behavior modifier goes in a mode's Modifiers array and produces GameplayCameras rig nodes. A parameter modifier goes in a state's Parameters array and overrides values for that state.

Both use the same shape: a tag plus a Params map of string values. The generated /AgenticGameplayCamera/Shared/AgenticCameraSchema.json is authoritative for key names — regenerate it with Validate All Camera Tables whenever you are unsure.

Behavior Modifiers

Focus

Tag: Agentic.Camera.Modifier.Focus

Lock-on target tracking. Rotates the view to keep the target framed by driving control rotation, which makes the camera arm orbit the character. Needs IAgenticTargetProvider on your character — from the optional sibling Agentic Targeting plugin. Without a target source this modifier is inert; the rest of the camera is unaffected.

HardLock calls SetIgnoreLookInput(true), which is what prevents the input fighting that reads as camera stutter. Input is restored automatically when the target is lost, the mode changes to Soft, or the camera mode deactivates.

{
    "ModifierTag": { "TagName": "Agentic.Camera.Modifier.Focus" },
    "Params": {
        "Mode": "0",
        "InterpSpeed": "12.0",
        "bYawOnly": "true",
        "TargetOffset": "(X=0,Y=0,Z=50)"
    }
}

Awareness

Tag: Agentic.Camera.Modifier.Awareness

Multi-threat framing. Adjusts arm length, FOV and lateral framing offset so several threats stay readable — and never touches rotation. The player always controls where they look; Awareness only controls how far back and how wide the view is, like taking a step back from a scene. Requires IAgenticTargetProvider.

It queries awareness targets, filters by ScoreThreshold, checks MinThreatsToActivate, measures the angular spread of what is left, and pulls back when that spread exceeds the current FOV.

{
    "ModifierTag": { "TagName": "Agentic.Camera.Modifier.Awareness" },
    "Params": {
        "MinThreatsToActivate": "2",
        "MinArmLength": "300.0",
        "MaxArmLength": "600.0",
        "ArmWeight": "0.7",
        "MaxFOV": "110.0",
        "FOVWeight": "0.3",
        "bEnableFramingOffset": "true",
        "FramingOffsetWeight": "0.5",
        "InterpSpeed": "5.0"
    }
}

Focus and Awareness compose deliberately: Focus points the camera at the locked target, Awareness pulls back to reveal flankers, and neither fights the player's input.

LookAhead

Tag: Agentic.Camera.Modifier.LookAhead

Offsets the camera toward the movement direction so motion reads with anticipation.

PitchScale

Tag: Agentic.Camera.Modifier.PitchScale

Scales arm length and FOV by camera pitch: one extreme gets intimate and close, the other gets a wider overview.

PitchFollow

Tag: Agentic.Camera.Modifier.PitchFollow

Tilts the camera to follow terrain slope while walking up or down an incline, returning to a resting pitch on flat ground. For falling pitch, use the Pitch parameter on the Falling state instead — the separation lets you tune slope and falling independently.

YawFollow

Tag: Agentic.Camera.Modifier.YawFollow

Rotates yaw to follow the character's movement direction after a delay without camera input — the exploration camera that quietly centres itself behind the character. Not recommended on combat modes, where precise manual control matters more.

Constraints

Tag: Agentic.Camera.Modifier.Constraints

Limits pitch and yaw, decelerating smoothly into the boundary rather than clamping hard. Requires the Params. prefix.

{
    "ModifierTag": { "TagName": "Agentic.Camera.Modifier.Constraints" },
    "Params": {
        "Params.bConstrainPitch": "true",
        "Params.PitchMin": "-89.0",
        "Params.PitchMax": "89.0",
        "Params.PitchTolerance": "10.0",
        "Params.bConstrainYaw": "false"
    }
}

IdleReset

Tag: Agentic.Camera.Modifier.IdleReset

Returns the camera to the rotation captured when the mode activated, once the player has been idle long enough.

Shake

Tag: Agentic.Camera.Modifier.Shake

Procedural Perlin shake, location and rotation, with per-axis control. Every value is a camera parameter evaluated by the plugin's deterministic shake math — the same evaluator the cinematic Shake correction uses — so a state that shakes differently is a variable write into the running rig, not a rig rebuild. Requires the Params. prefix.

{
    "ModifierTag": { "TagName": "Agentic.Camera.Modifier.Shake" },
    "Params": {
        "Params.Octaves": "2",
        "Params.bEnableRotationShake": "true",
        "Params.Pitch_Amplitude": "0.15",
        "Params.Pitch_Frequency": "6.0",
        "Params.Yaw_Amplitude": "0.08",
        "Params.Yaw_Frequency": "4.5",
        "Params.Roll_Amplitude": "0.12",
        "Params.Roll_Frequency": "5.0"
    }
}

Rig Overlay

Tag: Agentic.Camera.Modifier.Rig

Overlays a designer-authored camera rig on top of the programmatic one — the bridge between data-driven modifiers and Epic's visual node graph. Good for one-off effects that are simply easier to draw than to describe.

Create one with Content Browser → right-click → Miscellaneous → Camera Rig, build the node tree in the Camera Rig Editor, then reference its path.

Parameter Modifiers

State-specific value overrides, used in the Parameters array of a state configuration.

Arm — Agentic.Camera.Param.Arm

FOV — Agentic.Camera.Param.FOV

Offset — Agentic.Camera.Param.Offset

Pitch — Agentic.Camera.Param.Pitch

Lag — Agentic.Camera.Param.Lag

bUseSameLagForBlendOut is what makes a transition symmetric. Entering crouch at lag speed 5 and leaving it at the mode's default 12 reads as a slow settle and a fast snap back; setting the flag uses 5 in both directions.

The mode's Lag config also carries Lag.bDebugDraw, which draws the lag offset line, the target position sphere and the lag speed as text.

Blend Curves

Used by Arm, FOV, Pitch and the mode transition config.

Recommended starting points per state: EaseInOut for a crouch's arm, EaseOut for sprint arm and FOV, Snap for falling and for aim arm, SmoothStep for walking, Overshoot for a jump's arm, EaseOut for aim FOV.

Adding Your Own

A new behavior modifier is a UAgenticCameraModifier subclass; a new parameter modifier is a UAgenticCameraParam subclass overriding GetParamTypeId(). Either way the data side is three files in this order:

1. DT_GameCameraTags.csv — the tag, added first, then reimported.
2. DT_GameCameraModifiers.json — the tag → class mapping.
3. DT_GameCameraModes.json — the modes or states that use it.

Then run Validate All Camera Tables: it cross-checks that contract and regenerates the schema your new parameter keys need to appear in.