Use topology-bound selections for masks and deterministic displacement. sculpt.brush_stroke requires a foreground VIEW_3D and an active compatible sculpt brush; use it for reproducible strokes, then inspect the actual vertex change.
Record that voxel remesh invalidates old element selections. Keep Multires levels bounded and editable. Decimate/Shrinkwrap cleanup may prepare a proxy but is not production character retopology.
For artistic refinement beyond structured strokes, pause for user takeover, then re-inspect and start a new transaction before continuing. Report topology changes, modifier state and known loss of detail.
When to Use
Use when topology-bound masks, deterministic displacement, structured sculpt strokes, Voxel Remesh, Multires, or surface cleanup are needed.
Prerequisites
- Specify the target object, topology version, selection/mask, brush, strength, symmetry, detail scale, and allowed topology changes.
- Foreground sculpt strokes require VIEW_3D and a compatible active brush.
Workflow
Step 1. Check the object scale, topology, and active mode, and bind the selection to the current topology version. Step 2. First perform repeatable displacement or structured strokes, and measure the actual vertex changes. Step 3. Only after approval, perform voxel remesh or Multires, then discard old element selections. Step 4. Check the silhouette, detail loss, modifier state, and subsequent retopo needs. Step 5. Pause for the user to take over during free artistic sculpting, and after resuming, re-check and create a new transaction.
Validation
Report before-and-after vertex statistics, topology version, stroke parameters, actual displacement, remesh/Multires state, previews, and known detail loss.
Rules and Capability Boundaries (Inapplicable Scenarios)
Cleaning up modifiers can only prepare a proxy and is not equivalent to production-grade character retopo; after the user takes over, do not roll back and overwrite manual edits.
Gotchas (Common Issues and Recovery)
- Selection invalid: re-query after topology changes, and do not reuse old indices.
- Detail loss: restore from the transaction snapshot and adjust the voxel size or level.
- Stroke has no effect: check the mode, active brush, mask, and visible geometry.