Blender add-on · by GreenJin

ZSculpt

ZBrush controls for Blender's Sculpt Mode.

Drag empty space to orbit, Alt to carve, hold Shift to smooth, Ctrl to mask. The moves your hands already know, plus a ZBrush-style Undo History bar and Face Set Layers. Every group of shortcuts has its own switch, and one click gives you Blender's defaults back.

Drag empty space to orbit Alt ZSub · Shift Smooth · Ctrl Mask Undo History bar Face Set Layers Blender 5.2+
Mac users: the Undo History bar does not work on macOS.

Blender has no Python API for the undo list, so ZSculpt reads it with a safe, read-only method that exists only on Windows and Linux. On a Mac the bar stays hidden; every other feature works.

Blender 5.2 with ZSculpt 1.1, recorded as it happened. The keys at the bottom light up while they're held.

In motion

Your ZBrush hands, in Blender

Pick a move to see it. The dots mark what's new in version 1.1.

Shortcuts

Every shortcut ZSculpt adds

They work in Sculpt Mode only, on top of Blender's keymap; your own keymap isn't changed. Red keys are the ones ZSculpt uses. Tap one to see what it does.

TYIO
GHJKL
ZCVNM
ShortcutWhat it doesBlender's defaultSetting
Navigation
Drag on empty spaceRotate the viewNavigate on Empty Space
Shift while rotatingSnap to the nearest axis view (in every mode)Shift Snaps While Rotating
Alt + drag on empty spacePan; let go of Alt while dragging to zoomNavigate on Empty Space
RMB dragRotate the viewSculpt menu on pressRight-Drag Navigation
Alt + RMB dragPan; let go of Alt to zoomRight-Drag Navigation
Ctrl + RMB dragZoomLasso maskRight-Drag Navigation
RMB clickSculpt menu, as beforeRight-Drag Navigation
FFrame the whole meshBrush sizeZBrush-Style Hotkeys
PPerspective / orthographicPinch brushZBrush-Style Hotkeys
Alt + click another mesh 1.1Sculpt that mesh instead, like picking a SubToolAlt+Click Switches Object
Brush
Alt + strokeInvert the brush (ZSub)Ctrl + stroke invertsAlways on
Hold Shift / CtrlSwitch to the Shift brush (Smooth) / Ctrl brush (Mask); the header shows itShift: Smooth only during the strokeZBrush-Style Shift / Ctrl Brushes
Hold Shift / Ctrl + BPick a brush: it becomes the new Shift / Ctrl brushZoom border / render borderZBrush-Style Shift / Ctrl Brushes
SBrush sizeSmooth brushZBrush-Style Hotkeys
UBrush strength (ZBrush's Z Intensity)ZBrush-Style Hotkeys
Shift+U / Ctrl+UStrength of the Shift / Ctrl brushZBrush-Style Hotkeys
SpaceSculpt menu: brush, size, strengthPlay animationZBrush-Style Hotkeys
BBrush shelfBox maskZBrush-Style Hotkeys
XX symmetry on / offFlip brush colorsZBrush-Style Hotkeys
Shift+FWireframe on / off (ZBrush's PolyF)Brush strengthZBrush-Style Hotkeys
Mask
Ctrl + strokePaint mask; with Alt: unmaskCtrl + stroke invertsCtrl Masking & Ctrl+Shift Visibility
Ctrl + click the modelBlur the mask; with Alt: sharpenCtrl Masking & Ctrl+Shift Visibility
Ctrl + drag from empty spaceLasso (or box) mask; with Alt: unmask; hold Space to move the shapeCtrl Masking & Ctrl+Shift Visibility
Ctrl + click empty spaceInvert the mask; with Alt: clear itCtrl Masking & Ctrl+Shift Visibility
Ctrl + drag around nothingClear the maskCtrl Masking & Ctrl+Shift Visibility
Ctrl+AMask everythingZBrush-Style Hotkeys
Visibility & face sets
Ctrl+Shift + dragKeep what's inside, hide the rest; with Alt: hide the insideCtrl Masking & Ctrl+Shift Visibility
Ctrl+Shift + click a face setIsolate it (click again: show all); with Alt: hide itCtrl Masking & Ctrl+Shift Visibility
Ctrl+Shift + click empty spaceShow everythingCtrl Masking & Ctrl+Shift Visibility
Ctrl+Shift + drag around nothingInvert what's visibleCtrl Masking & Ctrl+Shift Visibility
Ctrl+WNew face set from the mask, or from what's visibleGrow face setZBrush-Style Hotkeys
Subdivision & tools
D / Shift+DMultires level up / down (sculpt and viewport together)Subdivision Keys
Ctrl+DDivide: add a Multires level (adds the modifier if needed)Subdivision Keys
QBrush toolQuick FavoritesQ W E R Tools
W / E / RMove / Scale / Rotate toolR: voxel / detail sizeQ W E R Tools
Alt+RVoxel size, or Dyntopo detail size (Blender's R, moved)Q W E R Tools
Undo History bar Not on macOS
Windows and Linux only. On macOS the bar stays hidden and these do nothing.
Click or drag the barJump through your undo stepsUndo History Slider
Esc while draggingBack to where you startedUndo History Slider
Wheel over the barOne step back / forwardUndo History Slider

Blender's default is what the key does in Sculpt Mode without ZSculpt (Blender 5.2). Keys ZSculpt doesn't use keep working as usual, for example Ctrl+I invert mask, Ctrl+R remesh, Alt+Q transfer mode and the brush keys. With the Face Set brush, Shift keeps Blender's relax-borders stroke, and stencil brushes keep their right-mouse controls.

Settings

Every group has its own switch

In Edit › Preferences › Add-ons › ZSculpt. Turn a group off and its keys go back to Blender's at once. This is the real panel:

Blender Preferences, Add-ons, ZSculpt 1.1.0 expanded: the ZSculpt master checkbox, then Navigate on Empty Space, Right-Drag Navigation, Alt+Click Switches Object, Ctrl Masking and Ctrl+Shift Visibility with Mask and Select marquee and the two Camera Based options, ZBrush-Style Hotkeys, Subdivision Keys, Q W E R Tools, Shift Snaps While Rotating, Invert Drag Zoom, Suspend Emulate 3 Button Mouse in Sculpt Mode, ZBrush-Style Shift / Ctrl Brushes, Undo History Slider with History Range, Bar Width and Undo Steps
Blender 5.2, Preferences › Add-ons, ZSculpt 1.1.0 with its defaults. Tap to open it full size.
  • OnZSculptThe master switch: off means Blender's default sculpt controls, everywhere at once. The Enabled button in the sidebar tab is the same switch.
  • OnNavigate on Empty SpaceDrag empty space to rotate; Alt+drag to pan, let go of Alt to zoom.
  • OnRight-Drag NavigationRight-drag rotates, Alt pans, Ctrl zooms. A right click still opens the sculpt menu.
  • OnAlt+Click Switches ObjectAlt+click another visible mesh to sculpt it. Alt+drag still carves or pans.
  • OnCtrl Masking & Ctrl+Shift VisibilityEvery Ctrl mask move and Ctrl+Shift hide / isolate move.Mask Marquee Lasso (default) or Box · Select Marquee Box (default) or Lasso · Camera Based Masking / Selection off by default: drags go through the whole mesh like ZBrush; on: only faces facing you.
  • OnZBrush-Style HotkeysS, U, Shift+U, Ctrl+U, Space, B, X, F, Shift+F, P, Ctrl+W, Ctrl+A.
  • OnSubdivision KeysD, Shift+D and Ctrl+D for Multires.
  • OnQ W E R ToolsBrush, Move, Scale, Rotate. Blender's R moves to Alt+R.
  • OnShift Snaps While RotatingHold Shift during any view rotation to snap to the nearest axis view. Works in every mode.
  • OffInvert Drag ZoomFlips the direction of the Alt-release and Ctrl+right-drag zoom.
  • OnSuspend 'Emulate 3 Button Mouse' in Sculpt ModeThat Blender option turns Alt+click into a middle click. It's switched off only while you sculpt and comes back when you leave.
  • OnZBrush-Style Shift / Ctrl BrushesHolding Shift or Ctrl switches to the Smooth / Mask brush, so the header shows it; pick another while holding to replace it. Off: Blender's built-in temporary Smooth and Mask.
  • OnUndo History Slider Not on macOSThe bar at the top of the viewport (Windows and Linux).History Range Sculpt Session (default: steps since you entered Sculpt Mode) or Everything · Bar Width · Undo Steps, Blender's own setting.

One switch for everything: switch the Enabled button in the ZSculpt tab to Disabled, and all shortcuts and features go back to Blender's defaults. Click it again to get ZSculpt back.

Sidebar

The ZSculpt tab

In Sculpt Mode, press N and open the ZSculpt tab of the 3D Viewport sidebar.

The ZSculpt tab in Blender's sidebar: the Enabled button, Mask Lasso and Select Box, Camera Based Masking and Selection, Shift / Ctrl Brushes with Shift: Smooth and Ctrl: Mask, the SDiv line, Undo History Slider with Range and Undo Steps, then Face Set Layers with Show All, Invert and the list Base, Ears, Eyes, Brow, Muzzle, each with its color, face count, eye, solo, merge and delete buttons, and the folded Shortcuts panel
  1. EnabledThe master switch. Disabled gives you Blender's own controls at once.
  2. Mask / SelectLasso or box for Ctrl and Ctrl+Shift drags. The Camera Based options limit them to faces facing you.
  3. Shift / Ctrl BrushesWhich brushes Shift and Ctrl give you, with their Intensity. A reset arrow appears once you change one.
  4. SDivThe Multires level as one slider, like ZBrush's. No Multires yet? Ctrl+D adds it.
  5. Undo History Slider Not on macOSOn or off, its range, and Blender's Undo Steps (how far back the bar can go). On a Mac this box shows why the bar is unavailable.
  6. Face Set LayersShow All and Invert, then every face set in its viewport color with its face count: the eye hides it, the star solos it, merge folds it into the selected one, X deletes it (back to Base). Double-click a name to rename it. Everything undoes with Ctrl+Z.
  7. ShortcutsThe cheat sheet, folded until you need it. The same list is in the Preferences.
Details

Specs & questions

Specs

Blender
5.2 or newer (an extension: install from disk)
Works in
Sculpt Mode in the 3D Viewport, with a mouse or a pen
Systems
Windows, macOS, Linux (pure Python). The Undo History bar needs Windows or Linux; on macOS it stays hidden and everything else works
Your keymap
Untouched. ZSculpt's keys are added on top, in Sculpt Mode only, while it's enabled
Needs
Nothing else to install, no internet. At start it writes one temporary .blend to read Blender's undo layout
Version
1.1.0
License
GPL-3.0-or-later

Questions

Will it change my keymap or settings?

No. ZSculpt adds its keys on Blender's add-on layer, in Sculpt Mode only. Switch Enabled off, or disable the add-on, and Blender's defaults are back at once.

I want Blender's S (or any key) back

Turn off that key's group in Preferences › Add-ons › ZSculpt. The table above names the setting for every shortcut.

Does it work with a pen tablet?

Yes. Clicks and drags are told apart with Blender's own tablet drag threshold, so taps work as clicks.

I use "Emulate 3 Button Mouse"

It turns Alt+click into a middle click, which would break the Alt moves. ZSculpt switches it off while you're in Sculpt Mode and back on when you leave.

Why is the Undo History bar missing on my Mac?

Blender has no Python API for the undo list, so ZSculpt reads it with a safe, read-only method that exists on Windows and Linux. Everything else works on macOS.

Multires, Dyntopo, Voxel Remesh?

All fine. D, Shift+D and Ctrl+D drive Multires, Alt+R sets the voxel or detail size, Ctrl+R remeshes as usual. The Face Set Layers list is off while Dyntopo is on.

Is ZSculpt made by Maxon?

No. ZBrush is a trademark of Maxon. ZSculpt is an independent add-on, not affiliated with or endorsed by Maxon.

How to use

Sculpting in a minute

  1. InstallDrag the zip into Blender, or Edit › Preferences › Get Extensions › drop-down at the top right › Install from Disk…
  2. SculptEnter Sculpt Mode. ZSculpt is on: drag empty space to orbit, Alt to carve, Shift to smooth, Ctrl to mask.
  3. Open the ZSculpt tabPress N in the 3D Viewport: the Enabled switch, Shift / Ctrl brushes, SDiv, the Undo History bar and Face Set Layers.
  4. Make it yoursEdit › Preferences › Add-ons › ZSculpt: turn groups on or off, pick lasso or box, set the bar's range and width.