Compositor Safe Repair

Compositor Safe Repair

Frame By Plane builds managed compositor groups while preserving artist-created nodes and links. Safe Repair is designed to stop before changing the graph unless it can capture a complete snapshot.

Blender 5.2 support

Version 7.1.18 adds snapshot support for Blender RNA arrays and mathutils color, vector, rotation and matrix values. Nested groups, custom properties, links, rollback and orphan cleanup are covered by native Blender 5.2 tests.

Fail-closed behavior

Unknown RNA values remain unsupported intentionally. If Safe Repair cannot serialize a value, it cancels without editing the artist graph. This protects custom compositor setups from partial repair.

Render opt-in in 7.2

Building or inspecting Frame By Plane compositor nodes no longer changes F12 output automatically. Enable the managed compositor explicitly when it should participate in a render. Disabling it restores the previous render state while leaving artist-created nodes and links untouched.

If repair cancels:

1. Save a copy of the .blend file.
2. Open Project Health and run compositor checks.
3. Copy the diagnostic report.
4. Open a GitHub issue with Blender version, operating system and reproduction steps.