REFERENCE REMAPPER — DOCUMENTATION

Reference Remapper selectively retargets supported Object references from one Source object to another object.

It does not copy the Source object's settings or data to the replacement object.

It changes only the selected references that point to the Source.

--------------------------------

QUICK START

--------------------------------

1. Select the object whose references you want to replace.

   This becomes the Source.

2. In Object Properties, open the Reference Remapper panel.

3. Choose an object in Replace With.

4. Click Preview Changes.

5. Review the detected references.

6. Enable or disable categories or individual reference slots.

7. Click Replace Selected.

Only the checked references are retargeted.

The Source object itself is not deleted.

--------------------------------

SUPPORTED REFERENCE TYPES

--------------------------------

Reference Remapper 1.0 supports Object-to-Object replacement for:

- Parenting

- Modifiers

- Object Constraints

- Pose Bone Constraints

- Driver Targets

- Geometry Nodes Modifier public Object inputs

--------------------------------

PREVIEW

--------------------------------

Preview Changes scans supported references to the active Source object.

The panel displays:

- Found: total supported references detected

- Selected: references currently selected for replacement

You can toggle:

- an entire category

- an individual reference

No reference is changed during Preview.

--------------------------------

PARENTING

--------------------------------

Parent references are deselected by default because replacing a parent changes object hierarchy.

When a Parent reference is replaced, Reference Remapper preserves the child's world transform by default.

Parenting changes are marked for Review before replacement.

--------------------------------

DRIVERS

--------------------------------

Driver target IDs can be retargeted from the Source object to the replacement object.

Reference Remapper does not rewrite the driver's data path or bone target.

Because the same data path may not exist on the replacement object, Driver references can be marked for Review.

--------------------------------

GEOMETRY NODES

--------------------------------

Reference Remapper supports public Object inputs exposed on a Geometry Nodes Modifier.

References stored inside the node tree itself, such as an internal Object Info node, are not included in version 1.0.

--------------------------------

SAFETY

--------------------------------

Before applying a replacement, Reference Remapper scans the scene again and verifies that the Preview is still current.

References that cannot be safely edited are blocked rather than forced.

The replacement operation is applied as one transaction. If the selected changes cannot complete safely, the operation is rolled back.

A completed replacement is one Blender Undo step.

Use Ctrl+Z to restore the previous state.

--------------------------------

LINKED DATA

--------------------------------

Read-only linked owners are not directly modified.

Local editable owners can still reference linked Source objects and may be retargeted when Blender allows the owner to be edited.

Reference Remapper does not automatically create Library Overrides or Make Local copies.

--------------------------------

VERSION 1.0 LIMITATIONS

--------------------------------

Version 1.0 does not include:

- Geometry Nodes references inside the node tree

- Collection reference remapping

- Material remapping

- Action remapping

- Automatic Make Local

- Automatic Library Override creation

- Automatic Source deletion

--------------------------------

COMPATIBILITY

--------------------------------

Tested with:

- Blender 4.5.13 LTS

- Blender 5.0.1

- Blender 5.1.2

- Blender 5.2.1 LTS