Getting Started

Download

PivotBreeze requires Blender 4.2 or newer. The 1.0.0 release verification covers Windows and Linux x86-64 with Blender 4.2.0 and 5.2 LTS, including source-linked runtime and native-window checks. Blender 5.2 also has offscreen GPU verification. macOS and ARM are not verified.

The Download page provides the current marketplace purchase options.

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.
6. Use Blender Undo if this was only a test.

Apply or cancel

Enter / Numpad Enter applies the pivot. Esc cancels the session and restores the original pivot/cursor, including completed helper moves and rotations. In 3D, object geometry stays unchanged; in UV, the original 2D Cursor returns. During a native Blender transform, the first Enter/Esc confirms or cancels that transform; press it again to apply or cancel the pivot session. Incomplete three-point placement cannot be applied with Enter.

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. Unsupported actions, including Bounding Box, Pivot by 3 Points, and rotation-only reset, are disabled in UV. Use the UV Editor’s native snapping.

Update or remove

To update a package installed from disk, finish the active session, save the Blender file, and install the newer original versioned ZIP through Install from Disk. Confirm the displayed extension version afterward. Do not merge files from different package versions or replace individual Python modules.

Integrations should query bpy.ops.wm.ih_pivot_breeze_capabilities_get() and verify the required operators and fields instead of inferring API compatibility from the filename.

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.