Skip to content

Toggle Constraint Axis

by Tokage IT Lab.·Workflow

Illustrative cover generated by AnyPlugins — no product screenshot available.

Why we like it

Toggle Constraint Axis earns its spot for a narrow but real annoyance: repeatedly tapping X, Y or Z to lock an axis when moving many objects. It moves that setting into header checkboxes and Ctrl + Alt hotkeys instead. Worth noting the move tool's gizmo and modal keys still take priority over the checkboxes.

What is Toggle Constraint Axis?

Toggle Constraint Axis is a Blender add-on that places checkboxes in the View 3D header to constrain the axis when moving objects, vertices or other elements with tools such as Tweak or Move. Constraining an axis would normally mean pressing the X, Y or Z key each time you move something.

The checkboxes correspond to the transform.translate attribute. Setting X, Y and Z all to false or all to true leaves movement unconstrained, [True, False, False] allows only X-axis movement, and [True, True, False] limits movement to the XY-plane. Default hotkeys for axis constraints are Ctrl + Alt + X, Y or Z, and the add-on works by overriding some of the settings that call transform.translate in the keymap.

A few behaviours to keep in mind: if you press a modal key, modal takes priority, and if you use the move tool's gizmo, the gizmo takes priority regardless of the constraints. Blender 3.0 or later uses the .py file, while 2.91 or earlier uses the zip. Released by Tokage IT Lab. under the GPL license.

Who is Toggle Constraint Axis best for?

Toggle Constraint Axis is best for blender users who move many objects, vertices or other elements along a fixed axis or plane and want to avoid pressing X, Y or Z on every transform.

How much does Toggle Constraint Axis cost?

Toggle Constraint Axis is completely free to download and use.

Key features

  • Checkboxes in the View 3D header that constrain the movement axis for tools such as Tweak and Move
  • Checkboxes map to the transform.translate X, Y and Z attributes: [True, False, False] allows only X-axis movement, [True, True, False] limits movement to the XY-plane
  • Default axis-constraint hotkeys of Ctrl + Alt + X, Y or Z
  • Works by overriding settings that call transform.translate in the keymap
  • Configurable JSON list of keymap categories to override in preferences
  • Separate downloads for Blender 3.0 and later (.py) and 2.91 or earlier (.zip)
  • Documentation included

Tags

#axis constraint#transform#viewport#tweak#keymap#3D View#lock

Frequently asked questions

Which Blender versions does Toggle Constraint Axis support?

Toggle Constraint Axis lists support for Blender 2.83, 2.9, 2.91, 2.92, 2.93, 3.0 and 3.1. The download you use depends on your version: for Blender 3.0 or later, grab the toggle_constraint_axis.py file, and for 2.91 or earlier, use the toggle_constraint_axis_2_91.zip archive. If you are on the older 2.7x hotkey scheme, note that the default Ctrl + Alt + Z constraint can clash with Undo history, so you may need to rewrite or disable that binding after installing.

How do I install Toggle Constraint Axis for Blender 3.0 or later?

Toggle Constraint Axis ships as two separate files split by Blender version. For Blender 3.0 or later, download and use toggle_constraint_axis.py, and for 2.91 or earlier, download and use the toggle_constraint_axis_2_91.zip archive. The developer notes to be careful when installing, uninstalling and rewriting preferences, since the add-on overrides some keymap settings that call transform.translate. A JSON list of keymap categories is available in the preferences, so you can adjust which categories the add-on searches for transform.translate.

What are the default hotkeys for Toggle Constraint Axis?

Toggle Constraint Axis uses Ctrl + Alt + X, Y or Z as its default hotkeys for axis constraints. If you are still on the 2.7x hotkeys, be aware that Ctrl + Alt + Z can conflict with Undo history, so the developer recommends rewriting or disabling it. Two behaviours override the checkboxes: pressing a modal key gives modal priority, and grabbing the move tool's gizmo follows the gizmo instead, so pulling the X-axis handle moves along X regardless of the current constraint settings.

What do the X, Y, Z checkboxes control in Toggle Constraint Axis?

Toggle Constraint Axis maps its three checkboxes directly to the transform.translate attribute for X, Y and Z. Setting all three to false, or all three to true, leaves movement unconstrained in every direction. Enabling only X, as in [True, False, False], restricts movement to the X-axis, while [True, True, False] confines it to the XY-plane. This lets the constraint stay set as you move object after object, instead of pressing an axis key on each individual transform.

Is Toggle Constraint Axis free, and what license does it use?

Toggle Constraint Axis is listed as free here in the catalog, and it is released under the GPL license by Tokage IT Lab. For current licensing terms and any changes, check the developer's page directly. Its update log shows a single v1.0 release dated February 21, 2021. Because it is distributed under the GPL, you are free to use and modify it in line with that license, so review the terms if you plan to adapt or redistribute the add-on.

Alternatives to Toggle Constraint Axis

Also in Workflow for Blender.

Similar plugins