Home › Reference › Troubleshooting

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.