Interaction System - NEW V4.3
Creating an Interactable
This guide explains how to create an interactable object in ACF from start to finish: chests, NPCs, levers, pickups, doors, examinable objects, and so on.
There are two flavours of interaction, and you choose per object:
Immediate — the effect happens instantly when the player presses Interact (no animation). Great for pickups, buttons, instant levers.
Animated / warped — the player plays an animation that motion-warps toward the object before the effect fires. Great for chests, levers you pull, NPC handshakes.
Both are configured the same way — entirely from the interactable's UACFInteractableComponent. The only difference is whether you fill in the animation fields.
Concepts
An interactable in ACF is any Actor that:
implements
IACFInteractableInterface— mandatory. This is what makes the object detectable by the player's interaction sphere. Without it, the object is invisible to the system even if it has the component.carries a
UACFInteractableComponent— recommended. It holds the prompt name, interaction state (Free/Busy), examination texts, delegates, and (for animated interactions) the action tag, montage, and the warp target transform.
The easiest way to get both is to derive from AACFBaseInteractableActor, which implements the interface and adds the component for you.
On the other side, the player's UACFInteractionComponent continuously scans for nearby interactables, picks the best one (closest, or most aligned with the camera), and on Interact asks the server to run the interaction. If the component defines an Interaction Action Tag, ACF plays the animated ability; otherwise the interaction is immediate.
Player's interaction sphere → detects actors implementing IACFInteractableInterface
→ picks the best one → your UI shows GetInteractableName()
Player presses Interact → Interact() → ServerInteract (server)
├─ Interaction Action Tag set? → YES → play existing warped ability
│ → NO → immediate
▼
OnInteractedByPawn (server) + OnLocalInteractedByPawn (client) ← your logic runs hereStep 1 — Create the Interactable Actor
In the Content Browser: right-click → Blueprint Class.
Pick
ACFBaseInteractableActoras the parent.Name it, e.g.
BP_Chest(orBP_HealthPotionPickup,BP_Lever…).
This gives you an Actor that already implements IACFInteractableInterface and already has a UACFInteractableComponent (named InteractableComponent) attached to a scene root.
Alternative — existing Actor you can't reparent: open its Blueprint → Class Settings → Interfaces → Add →
ACFInteractableInterface, then Add Component →ACF Interactable Component. Everything else in this guide is identical.
Step 2 — Add the Visual and Collision
Add a Static Mesh (or Skeletal Mesh) for the object's look.
Give the Actor a collision that generates overlap events on the channel the player's interaction sphere scans (ACF default: the
Interactableobject channel /Pawn).Easiest: a Box/Sphere Collision around the object,
Generate Overlap Events = true, using theInteractablecollision profile.
Size the collision so the player overlaps it comfortably before pressing Interact (this defines the "in range" area for this object, in addition to the player's own detection radius).
If the object is never detected, it's almost always a collision/channel issue — see Troubleshooting.
Step 3 — Configure the Interactable Component
Select InteractableComponent in the Components panel and open its Details. This is the single place where you configure the object's interaction behaviour.
ACF|Interactable — Identity
Property | Description |
|---|---|
| The prompt text shown by your UI, e.g. |
ACF|Interactable|Action Ability — animated interaction (optional)
Leave these empty for an immediate interaction. Fill them in for an animated/warped one (see the Optional section).
Property | Description |
|---|---|
| Gameplay Tag of the existing interact ability in the player's ability set (e.g. |
| The montage this object plays during the animated interaction. Different objects can use different montages while sharing the same ability. |
| (optional) A CCM camera event fired while interacting. |
| (optional) Lock the camera on the object during the interaction; tune with |
ACF|Interactable|Behaviour
Property | Description |
|---|---|
| Master switch. |
| If |
| If |
| Read-only at runtime (Free / Busy), replicated. |
ACF|Interactable|Examination (optional)
Property | Description |
|---|---|
| Pages of text for "Examine"-style widgets. Leave empty if not needed. |
Step 4 — Implement the Interaction Logic
Open the Blueprint's Event Graph and override the interface events (they appear as overridable events, and under My Blueprint → Interfaces). Put your actual gameplay effect here:
Event On Interacted By Pawn (Pawn, InteractionType)— server-authoritative logic. This is the main one: grant an item, open a UI, toggle a lever, start a dialogue, etc.For immediate interactions, this fires the moment the player presses Interact.
For animated interactions, this fires at the montage's Notable Point.
Event On Local Interacted By Pawn— client-side feedback (sounds, particles, local-only UI).Event On Interactable Registered By Pawn— the player is now looking at / in range of this object. Show the prompt, enable an outline/glow.Event On Interactable Unregistered By Pawn— the player moved away / switched target. Hide the prompt, disable the outline.
The component manages state automatically. You usually don't touch Free/Busy here unless you have special needs.
You can also override:
Can Be Interacted (Pawn)— returnfalseto block interaction under conditions (e.g. "requires a key", "already looted").Get Interactable Name— return a dynamic name (defaults to the component'sDefault Interactable Name).
Step 5 — Hook Up the Prompt (UI)
Interaction UI is driven from the player's UACFInteractionComponent (already on your pawn). Typical pattern:
Bind to
On Interactable Registered (Actor)→ show a prompt widget; read the label from the actor'sGet Interactable Name.Bind to
On Interactable Unregistered (Actor)→ hide the prompt.Bind your Interact input to call
Interacton the component.
(If your project already has an interaction prompt widget — as the ACF sample does — your new interactable works with it automatically; you only need Default Interactable Name set.)
Optional — Adding a Warped Animation
To make the player walk up and play an animation aligned to the object:
On the component (Step 3): set
Interaction Action Tagto the tag of the existing interact ability (e.g.Action.Interact), and assign the animation toInteraction Montage Override.Place the warp target: the world transform of the
UACFInteractableComponentis the motion-warp destination. In the viewport, move/rotate the component to where the character should stand and face during the animation (position and rotation matter).Prepare the montage: open the montage you assigned and add:
a Motion Warping notify state covering the travel portion, with Warp Target Name =
Interactable(this matches the ability's sync point — the ACF default);an ACF Notable Point notify at the frame where the effect should happen — this is when
On Interacted By Pawnfires.(optional) a
UACFNotifyInteractWarpnotify to refresh the warp target at a specific keyframe.
Verify the ability is in the set: open the player's Ability Set and confirm the interact ability (
UACFInteractActionAbility) is granted under the same tag you used. In the ACF sample it already is — you don't create it.
Requirements: the player character needs a UMotionWarpingComponent (ACF characters have one).
Per-object differences (which animation, where the character lands, prompt, camera) all live on the component. One ability serves every interactable.
State and Availability (Free / Busy / Enabled)
The component tracks an interaction state (EACFInteractionState):
Free — available.
Busy — interaction in progress (unless
b Allow Interaction While Busy = true).
Useful Blueprint functions on the component:
Set Interaction Enabled (bool)— turn the object on/off (independent of state). E.g. disable a chest after it's looted.Can Be Interacted (Pawn)—falseif disabled or Busy.Set Interaction State (NewState)/End Interaction()— manual control (mostly for immediate interactions; the animated ability handles this for you).
Events Reference
On the UACFInteractableComponent (object side)
Event | When |
|---|---|
| Server: a pawn interacted successfully. |
| Client: local callback (immediate feedback). |
| A pawn registered the object as a potential interactable. |
| A pawn unregistered the object. |
| State switched Free ↔ Busy. |
On the player's UACFInteractionComponent (pawn side)
Event | When |
|---|---|
| The best interactable changed to an Actor (show prompt). |
| The best interactable was cleared/changed (hide prompt). |
| The interaction completed successfully. |
Worked Examples
A) Immediate pickup (no animation)
BP_HealthPotionfromACFBaseInteractableActor; add mesh + overlap collision.Component:
Default Interactable Name = "Pick Up Potion". LeaveInteraction Action Tagempty.Override
On Interacted By Pawn→ add the potion to the pawn's inventory →Destroy Actor.
B) Chest with a warped open animation
BP_ChestfromACFBaseInteractableActor; add mesh + overlap collision.Component:
Default Interactable Name = "Open Chest",Interaction Action Tag = Action.Interact,Interaction Montage Override = AM_OpenChest.Place the
InteractableComponentin front of the chest, facing it (the warp target).In
AM_OpenChest: add a Motion Warping notify (targetInteractable) + a Notable Point at the "lid touch" frame.Override
On Interacted By Pawn→ grant loot + play the chest-open animation; optionallySet Interaction Enabled (false)so it can't be reused.
C) Locked door (conditional)
BP_DoorfromACFBaseInteractableActor.Override
Can Be Interacted→ returntrueonly if the pawn has the key; otherwisefalse(the door won't be selectable).Override
On Interacted By Pawn→ open the door.
Troubleshooting
Symptom | Likely cause / Fix |
|---|---|
The object is never detected | Missing |
Detected, but | No valid best interactable, or |
No prompt appears |
|
You wanted an animation but it fires instantly |
|
The ability never activates | The tag in |
Animation plays but the character doesn't move to the object | Missing/incorrect Motion Warping notify, target name isn't |
Character warps to the wrong spot/rotation | Reposition the |
Wrong animation plays | Set the correct |
The effect happens at the wrong moment (animated) | Move the Notable Point notify to the correct keyframe. |
The object stays Busy and can't be reused | Enable |