Troubleshooting

Common checks for installation, strict structure validation, placement discovery and the Unreal remote bridge.

Add-on does not load

• Verify Blender is version 5.0 or newer.
• Install the complete packaged add-on folder, not isolated Python files.
• Confirm the sidebar category is Blending to Unreal.

Structure validation fails

Use Setup → Refresh Structure before manually renaming or rebuilding collections. Validation is intentionally strict about typed children, Parent Empty setup, LOD continuity, material metadata and the hidden Asset wrapper.

No Unreal instances

1. Activate the bridge license.
2. Make sure the Unreal Editor is running.
3. Enable Unreal's Python Editor Script Plugin and Python Remote Execution.
4. Click Refresh Instances again and select the target editor.

No placement instances

Write Placement only includes visible collection instances that resolve to Blending to Unreal asset references. For Geometry Nodes, the evaluated source must still trace back to an asset-stamped source object/collection. Hidden/excluded sources are ignored.

If the Bridge reports zero placements, check that the placement file uses linked/instanced Blending to Unreal collections rather than unrelated duplicate geometry.

Update Unreal fails

• Save the Blender file first.
• Select a discovered Unreal instance.
• Confirm Remote Execution is enabled and not blocked by local networking/security configuration.
• Generate fresh export/placement files before Update Unreal when testing a changed structure.