Troubleshooting
Symptom first. If you have a problem that is not listed, check the example map for that feature and compare component settings.
Nothing highlights when I hover
The interaction component has no Highlight Class set, or the actor's meshes do not match Highlight Tag. Leave Highlight Tag empty to highlight every mesh.
Post-process highlights do not appear
Custom Depth-Stencil is not enabled. Two ways that happens.
If AFS_Core_Snapping is not enabled, nothing turns custom depth on — the Engine.ini that sets
r.CustomDepth=3 ships in the snapping plugin rather than in AFS_Core_Highlight. Set Custom
Depth-Stencil Pass to Enabled with Stencil under Project Settings, Rendering.
If snapping is enabled, your project's own DefaultEngine.ini is overriding the plugin — project
config wins over plugin config. Check the value in Project Settings, Rendering, and remember the
setting only applies after an editor restart.
My server RPC does nothing and no error appears
AFPNetDriver is not the active net driver, or the calling object does not implement
IOutsidePawnRPCInterface. See Multiplayer guide.
The wrong pawn spawns
Pawn Select on the PDA_Level is set to one of the Force options, or the level has no
BP_MapInfo actor pointing at the data asset.
An ability stopped working and nothing changed
A blocker was added and never removed, usually with a mismatched reason name. Check the ability's Blockers array at runtime — it lists the reasons currently holding it down.
Assets fail to load after enabling one plugin
Its dependencies are not enabled. See the Requires panel on that plugin's page.
The player spawns at floor height in VR
The teleport or spawn is not applying location correction, or the pawn is the plain Pawn variant
where the Character variant is expected. BPC_PawnAbility_Teleport_Character handles capsule
offset; the Pawn variant does not.
Two hands cannot hold the same object
The object needs a BPC_PickupCoordinator component alongside its grip interaction.
Widgets do not restyle when I change theme
Styling code is not in WidgetElement_UpdateTheme. Anything in Construct runs once and will not
re-run on a theme change.
Sounds play at the wrong volume
The project's sound classes are set by AFA_Sounds/Config/Engine.ini. If your project overrides
the default sound class, the framework's mix will not apply.
Still stuck
Ask in the Discord. Post your engine version, which plugins are enabled and what you expected to happen, and say which example map you compared against — that is usually enough to identify the cause in one reply.