ObjectVault Documentation

ObjectVault is an object-level versioning tool for Blender. It lets you save versions of individual objects, compare ideas, and restore the complete object or only the part you need.

Installation

1. Download the ObjectVault extension ZIP file.
2. Open Blender.
3. Go to Edit → Preferences → Get Extensions.
4. Open the menu in the top-right corner and select Install from Disk.
5. Select the ObjectVault ZIP file.
6. Enable ObjectVault: Object-Level Versioning.
7. In the 3D Viewport, press N and open the ObjectVault tab.

Quick Start

1. Select an object in the 3D Viewport.
2. Enter a name in Version Name, for example: Base Design.
3. Click Save Object Version.
4. Edit the object as usual.
5. Select a saved version from the history when you want to compare or restore it.

Panel Overview

Version Branch

Use this field to organize alternative design directions. A branch is a separate version history for the same object.

Examples:

• Main
• Sport Variant
• Client Feedback
• Experimental

Enter a new branch name before saving a version. ObjectVault will save that version into the selected branch.

Version Name

Add a clear note before saving a version. Good names make your history easier to understand later.

Examples:

• Base Design
• Rounded Edges
• Dark Metal Material
• Client Revision 02

Save Object Version

Creates an independent snapshot of every selected object. The snapshot includes supported geometry, materials, transforms, modifiers, and constraints.

Restoring a Version

Make the original object active, then use one of the buttons inside a saved version.

Ghost Comparison

Click Ghost Comparison to show the saved version as an orange wireframe overlay in the viewport.

Use it to compare the current object with an earlier idea before restoring anything. Click the button again to hide the ghost.

Compare

Click Compare to view a compact summary of the current object and the saved version. The comparison includes basic geometry, material, and modifier information.

Delete

Click Delete next to a saved version to remove that version and its internal snapshot safely.

Backup Collection

ObjectVault stores snapshots inside a hidden, non-rendering collection named:

__OBJECTVAULT_BACKUPS__

Do not manually edit, rename, move, or delete objects inside this collection. Use ObjectVault’s Delete button to remove versions safely.

Remove Missing Version Records

Use this button only if a snapshot was manually removed from the backup collection or became unavailable. It removes history entries that no longer have a valid internal snapshot.

Important Notes

• Snapshots are stored inside the current .blend file.
• File size increases according to the number and complexity of saved versions.
• ObjectVault tracks objects with an internal ID, so renaming an object does not disconnect its history.
• ObjectVault is designed for intentional object versions. It is not a replacement for full project backup or source control.
• Save your Blender file regularly.

Compatibility

• Blender 4.2 and newer.
• Tested with Blender 5.2 LTS.
• No internet connection or external account required.