Troubleshooting

Start with the visible message or behavior. An unavailable library entry or disabled action usually shows the missing requirement beside it.

The plugin does not build

Confirm that the project uses Unreal Engine 5.8.1 and has the matching C++ compiler toolchain. This Ferrite build contains source runtime and editor modules rather than precompiled binaries.

The Ferrite button is missing

1. Open Edit > Plugins and confirm Ferrite is enabled.
2. Restart the editor if enablement changed.
3. Confirm the project opened without a Ferrite editor-module load failure.

Expected result: Ferrite appears on the Level Editor toolbar.

Post Effects says to open a level

Open an editor level before using Post Effects. Ferrite needs a loaded world and a Post Process Volume to own the stack.

There is no stack host

Add an effect from the Effects Library. In Choose Post Effects Host, use Use Existing for a loaded Post Process Volume or Create Global for a new global volume.

When several Ferrite-enabled volumes exist, use Host to choose the volume whose stack you want to inspect and edit.

An effect cannot be added

• In stack and One Instance Only mean the selected stack already has the allowed singleton.
• Unavailable provides the current registration or setup reason.
• A Custom Material Instance must use the Post Process domain, run After Tonemapping, and have Is Blendable disabled.

Resolve the reason shown in the Library. Copying the source asset does not remove its domain, blendable, or registration requirements.

An effect is present but the image does not change

Check these in order:

1. Enable the row if its state is Bypassed.
2. Confirm Blend Weight is above 0 when the effect should contribute.
3. Confirm the Host chooser points to the intended Post Process Volume.
4. For a bounded volume, confirm the camera is inside its influence; otherwise use the global volume you created.
5. Confirm the viewport is rendering in real time and the Material Instance has compiled successfully.
6. Compare the result with neighboring effects bypassed; stack order can change the final image.

A row cannot be moved or edited

A Follow Screen Percentage row moved above a Final Output row changes to Final Output when that effect supports it. If the effect does not support Final Output, Ferrite rejects the move. A Final Output row cannot move below Follow Screen Percentage until you change its Evaluation explicitly.

Ferrite shows an external Material Instance or opaque blendable as read-only. Open its backing asset or Post Process Volume to change it.

Manual scope

This Manual covers installation and Post Effects. Use the Effects Library to see the effects included in your installed build.