---
title: Troubleshooting
product: Advanced Framework Pro
version: 1.0
engine: Unreal Engine 5.8
updated: 2026-10-05
canonical: https://docs.human-codeable.com/reference/troubleshooting.html
---

# 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](../guides/multiplayer.html).

## 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](https://discord.gg/ZBsXXVJ). 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.