Getting Started

Download

PivotBreeze requires Blender 4.2 or newer. The add-on release verification records Windows checks on Blender 4.2.0 and 5.2.0.

The Download page provides the current marketplace purchase options.

Install only the original versioned ih_pivot_breeze-1.0.0.zip extension package. GitHub’s automatically generated Source code archives are not Blender Extension packages. Do not extract, rearrange, or repack the installation ZIP.

Install from disk

1. Open Edit > Preferences > Get Extensions.
2. Open the menu in the upper-right corner.
3. Choose Install from Disk.
4. Select ih_pivot_breeze-1.0.0.zip.
5. Locate IH PivotBreeze and enable it.

Blender installs a package selected through Install from Disk into a local extension repository. A locally installed package does not receive automatic repository updates.

Activation errors

If PivotBreeze does not activate, open Blender’s Console and keep the complete traceback. Reinstalling repeatedly can hide the original error without fixing its cause.

First pivot

1. Open a 3D View in Object Mode and select a local object.
2. Confirm Activate Pie Menu is enabled in PivotBreeze Preferences.
3. Place the pointer over the 3D View and press Ctrl + D.
4. Choose Activate Pivot and move the helper with Blender’s native gizmo.
5. Press Enter or Numpad Enter, or invoke Activate Pivot again, to apply and close the session.
6. Use Blender Undo if this was only a test.

Apply or cancel

Esc cancels the pivot session and restores the original 3D or UV cursor, including completed helper moves and rotations. Enter / Numpad Enter applies. During a native transform, the key first confirms or cancels that transform; press it again to finish the pivot session.

Optional UV check

Put a Mesh in Edit Mode, open the UV Editor, and confirm that the Mesh has an active UV map. Select visible UV coordinates, place the pointer over the UV Editor, and press Ctrl + D. Activate Pivot should move Blender’s 2D Cursor through a translation-only gizmo without moving the UV coordinates.

The same Pie Menu shortcut is registered in supported 3D View and UV Editor keymaps. The Pie Menu keeps its slot layout; Bounding Box Pivot, Pivot by 3 Points, and Reset Pivot Rotation are disabled in UV. Regular UV pivot editing is translation-only.

Update or remove

To update a package installed from disk, finish the active session, save the Blender file, and install the current original versioned ZIP through Install from Disk. The September 15, 2026 replacement retains version 1.0.0. Reinstall the new ZIP even if Blender already shows 1.0.0; the unchanged version does not trigger automatic update detection. Restart Blender afterward to unload the previous modules. Do not merge files from different package versions or replace individual Python modules.

The current source uses Python API version 4 while the package version is 1.0.0. Integrations should query bpy.ops.wm.ih_pivot_breeze_capabilities_get() instead of inferring API compatibility from the filename. The old snap activation commands have been replaced by Bounding Box Pivot and Pivot by 3 Points. Review saved shortcuts and Pie Menu slots after an update; obsolete assignments may be empty.

Disable PivotBreeze when it should remain installed but inactive. Before removing it, apply or deliberately discard the active session and save any intentional document changes. Removing the package does not reverse applied origins, object locations, editable geometry, cursors, Sculpt Pivot state, or UV coordinates. Use Blender Undo before removal when a test result should not remain.

Next steps

• Follow the User Guide for 3D, UV, snapping, reset, multi-object, and zero workflows.
• Read the Technical Reference before using zero actions on hierarchies, shared data, shape keys, modifiers, animated objects, or production scenes.
• Use Troubleshooting when a shortcut, editor context, UV island, reset target, or zero action does not behave as expected.
• Check the Python API before automating session apply/cancel, runtime settings, transforms, hotkeys, or Pie Menu configuration.

For a first real task, start with a disposable scene or saved copy. Confirm the result with Undo and Redo before relying on the workflow in a production file.