Events Reference

Events are the effects that play when a tag is triggered.

Camera Shake

Class: UAgenticFeedbackFXEvent_Shake

Plays a camera shake via PlayerCameraManager.

Usage Tips

• Set MinScale > 0 so even small hits feel impactful
• Use PlaySpace = World for directional shakes based on WorldLocation
• Enable bCancelPreviousShakes for exclusive shake effects

Hit Stop

Class: UAgenticFeedbackFXEvent_HitStop

Freezes or slows time for impact emphasis.

Curve Types

Target Modes

Note: LocalVisual mode automatically uses the controlled pawn when no SourceActor or TargetActor is provided in the context.

Multiplayer Behavior

In multiplayer, hit stop is a local visual effect - each player experiences their own hit stops:

• When YOU land a hit → Your screen freezes briefly
• When YOU get hit → Your screen freezes briefly
• Other players → See normal speed gameplay (no desync)

Post Process (Temporary)

Class: UAgenticFeedbackFXEvent_PostProcess

Applies a temporary post-process material effect that auto-fades.

Curve Presets

Parameter Sources

FAgenticFXScalarParam allows flexible mapping of material parameters:

C++ Examples:

// Fixed value
ScalarParameters.Add("Radius", FAgenticFXScalarParam(50.0f));

// From magnitude
ScalarParameters.Add("Intensity", FAgenticFXScalarParam::FromMagnitude(1.0f));

// From named context value
ScalarParameters.Add("Direction", FAgenticFXScalarParam::FromContextValue("HitAngle", 0.01f));

Post Process (Persistent)

Class: UAgenticFeedbackFXEvent_PostProcessPersistent

Applies a persistent post-process effect that stays until removed.

Weight Scaling by Magnitude

When bScaleWeightByMagnitude = true, the effect intensity scales with context magnitude:

At 20% health -> magnitude = 0.2 -> subtle vignette
At 5% health  -> magnitude = 0.8 -> strong vignette

This works with the Attribute trigger's bMagnitudeFromAttribute option.

Usage Tips

• For low health: Use with Attribute trigger, enable bScaleWeightByMagnitude
• For poison: Enable bEnableCurveLoop with SmoothPulse curve
• Remove with RemovePostProcessByTag(EventTag)

Audio

Class: UAgenticFeedbackFXEvent_Audio

Plays a sound effect with optional volume/pitch scaling.

Usage Tips

• Enable bScaleVolumeByMagnitude for damage sounds that scale with hit severity
• Add PitchVariation (0.05-0.1) to avoid repetitive sounds
• Use bPlay2D = false with AttenuationSettings for spatial audio

Haptics

Class: UAgenticFeedbackFXEvent_Haptics

Triggers controller haptics/rumble feedback.

Usage Tips

• Use bUseForceFeedbackEffect for complex multi-channel patterns
• Large motor = deep rumble, Small motor = high-frequency buzz
• Light hits: LargeMotor = 0.3, SmallMotor = 0.2, Duration = 0.1
• Heavy hits: LargeMotor = 0.8, SmallMotor = 0.6, Duration = 0.25

Impact Frame

Class: UAgenticFeedbackFXEvent_ImpactFrame

Creates impact emphasis via screen flash or world VFX.

Screen Flash Mode

Full-screen color overlay (fighting game style).

Niagara Mode

Spawn particle VFX at Context.ImpactTransform.

Vector Parameter Sources

Passing ImpactTransform

FAgenticFeedbackFXContext Context;
Context.Magnitude = 1.0f;

// From HitResult
Context.ImpactTransform = FTransform(
    HitResult.ImpactNormal.Rotation(),
    HitResult.ImpactPoint
);

// From socket
Context.ImpactTransform = Mesh->GetSocketTransform("WeaponTip");

Feedback->TriggerFeedbackEvent(Tag, Context);

Usage Tips

• Screen flash: Use 1-2 frames for snappy hits, 3+ for dramatic impacts
• Niagara: Use FloatParameters with Source: Magnitude for damage-scaled VFX
• Niagara: Use VectorParameters with Source: ImpactDirection for directional VFX
• Combine with HitStop for maximum impact feel

Creating Custom Events

UCLASS(BlueprintType, meta = (DisplayName = "My Custom Effect"))
class UAgenticFeedbackFXEvent_MyEffect : public UAgenticFeedbackFXEvent
{
    GENERATED_BODY()

public:
    UPROPERTY(EditAnywhere, BlueprintReadWrite)
    float MyParameter = 1.0f;

    virtual void ExecuteEvent_Implementation(
        UAgenticFeedbackFXComponent* Component,
        const FAgenticFeedbackFXContext& Context) override
    {
        float ScaledValue = MyParameter * Context.Magnitude;
        // Your effect logic here
    }
};

Register in your config and trigger like any other event.