Common Issues
| Problem | Solution |
|---|---|
| Effect not visible | Check Post Process Volume is Unbound or player is inside it; verify Blendables array contains the material; check Intensity > 0 and Blend Weight = 1.0. |
| Performance drops | Reduce active effect count; lower sample counts in parameters; use Unreal's GPU profiler to find bottlenecks; disable effects based on scalability settings. |
| Looks different in packaged build | Check post-process scalability settings; verify shader model compatibility for target platform; ensure all shaders compiled during packaging. |
| Localization not working | Verify Render CustomDepth Pass is enabled; confirm stencil values match between actor and material; use the Custom Depth visualization mode to debug. |
| Runtime parameter changes have no effect | Must use a Dynamic Material Instance — not the material asset directly. Parameter names are case-sensitive. |
| Effects flickering | Check for two Post Process Volumes with the same priority; TAA can interact badly with some effects — try adjusting TAA settings. |
Known Limitations
- Some effects require shader model 5.0 or higher
- Mobile platforms may need effect-specific optimisations
- Maximum 128 blendable materials per Post Process Volume
- Custom depth stencil limited to 256 unique values
Getting Help
If your issue isn't covered above, open a support ticket or reach us on Discord. Include your Unreal Engine version, AOS pack version, platform, steps to reproduce, and any relevant screenshots.