Interaction Engine Documentation

Interaction modes

Runtime behavior by interaction type.

Each slot selects an InteractionType that defines how the interaction progresses, what input the player must provide, and which nested settings matter.

Mode summary

ModeRuntime behaviorPrimary settings
SimpleOne interaction input produces one action immediately.Core slot fields and Display.
HoldThe input must remain active until the configured duration completes.HoldDuration and bResetProgressOnCancel.
ToggleThe same slot switches between active and inactive states.Core slot fields plus any Blueprint logic tied to toggle state.
MultiHitProgress is accumulated through repeated hit events or repeated interaction actions.MaxHealth, DamagePerHit, HitResetTimeout, and DamageMultipliers.
ButtonMashCompletion requires repeated button presses within the configured timing window.ButtonMashCount and ButtonMashTimeout.

Simple

Use Simple when one confirmed input should immediately execute the slot logic. It fits direct actions such as opening, picking up, talking, or pressing a button.

Hold

Use Hold when the player must maintain input for a duration before the slot completes. The hold settings define duration and whether progress resets on cancel.

Toggle

Use Toggle when the same slot switches between two persistent states. Common examples include lights, powered devices, and switch-driven states.

MultiHit

Use MultiHit when the slot should accumulate progress from repeated hit events. It is commonly used for harvesting, mining, chopping, breaking, or tool-driven interactions.

ButtonMash

Use ButtonMash when the slot requires rapid repeated presses within a limited time window. It fits force-open sequences, struggle interactions, or other time-pressured actions.

Selection guide

If the action should behave like... Use this mode
One confirmed input and immediate executionSimple
Continuous input over a durationHold
A persistent on/off stateToggle
Repeated impact, damage, or effortMultiHit
Rapid repeated presses under a timerButtonMash