blender-sculpting
Sculpting in Blender 5.2 - base-to-detail workflow, voxel remesh, dyntopo, multires, 5.x brush types, masks/face sets, symmetry, plus headless-safe procedural ops for agents (remesh, symmetrize, multires, inflate, noise detail, smooth) and the sculpt-to-game handoff. Use for organic models, characters, creatures, rocks and bake sources.
- License 许可
- MIT
- 最近更新
- 2026-11-14
- Stars
- ★ 1
- Forks
- 1
01 前言 Front Matter
- name
- blender-sculpting
- license
- MIT
- metadata
- { "author": "blender-agent-skills", "version": "1.2.0" }
- description
- Sculpting in Blender 5.2 - base-to-detail workflow, voxel remesh, dyntopo, multires, 5.x brush types, masks/face sets, symmetry, plus headless-safe procedural ops for agents (remesh, symmetrize, multires, inflate, noise detail, smooth) and the sculpt-to-game handoff. Use for organic models, characters, creatures, rocks and bake sources.
02 资源文件 3
- 参考文档references/forms-and-bake-sources.md4.4 KB
- 脚本scripts/_bpyx.py4.4 KB
- 脚本scripts/sculpt_ops.py4.1 KB
03 SKILL.md 正文
Sculpting
The execution model is in blender-core. The handoff goes to blender-retopology-uv → blender-texture-baking.
Agents: what you can and can't do
- Sculpt Mode operators crash Blender in background mode (
-b), includingmesh_filter. Never enter Sculpt Mode headless. - Headless or MCP: use
scripts/sculpt_ops.pyfor object-level ops:remesh=SIZE,symmetrize=+X,multires=N,inflate=D,detail=STR,SCALE,smooth=N,apply. Combine these with Geometry Nodes (blender-geometry-nodes: SDF grid booleans/fillets, noise displacement) and shape modeling for procedural organic forms. - Live sessions with a UI: brush strokes via
bpy.ops.sculpt.brush_stroke(stroke=[...])need a 3D View region override and are fragile. Prefer procedural ops, then show the user withlook. Hand detailed brushwork to the human.
Professional workflow
- Base mesh / blockout: primitives, metaballs, Skin modifier, or a low-poly base at real scale. Proportions first: compare with references and check against a human 1.75 m.
- Unify: voxel remesh (
remesh=0.02for a 2 m character, smaller for detail) fuses parts and gives even density. Repeat it while the big forms change. - Primary forms at low resolution (Grab, Snake Hook, Clay Strips, Inflate, Smooth). Secondary (muscle groups, folds) at medium resolution. Tertiary (pores, scratches, fabric weave) with Multires levels 4–6, or as normal/displacement maps.
- Dynamic topology (
sculpt.dynamic_topology_toggle): adds detail where you stroke. Good for concept sculpting, bad for final topology and multires (it destroys UVs/multires). Use voxel remesh + multires for production. - Multires: subdivide (
multires_subdivide, Catmull-Clark) on a clean quad base (after retopo) to sculpt high detail that bakes back to the base level (blender-texture-baking, multires bake or high→low). - Handoff: export the high (or keep it in-file), retopo to
_low, UV, bake normal/AO/curvature, then texture.
Brushes (5.x: brushes are assets in the Essentials library)
| Purpose | sculpt_brush_type |
|---|---|
| Build volume | CLAY_STRIPS, CLAY, CLAY_THUMB, LAYER, INFLATE, BLOB |
| Shape / move | GRAB, SNAKE_HOOK, ELASTIC_DEFORM, POSE, BOUNDARY, CLOTH, NUDGE, ROTATE, THUMB |
| Details / edges | DRAW, DRAW_SHARP, CREASE, PINCH |
| Flatten / hard surface | PLANE (flatten/fill/scrape), MULTIPLANE_SCRAPE |
| Clean up | SMOOTH, SIMPLIFY (dyntopo), DISPLACEMENT_ERASER/SMEAR (multires) |
| Masking / grouping | MASK, DRAW_FACE_SETS; Expand (sculpt.expand), mask from cavity |
5.0 renamed brush.sculpt_tool → sculpt_brush_type. 5.1 folded the stroke options into brush.stroke_method (DOTS, DRAG_DOT, SPACE, AIRBRUSH, ANCHORED, LINE, CURVE). 5.2 moved automasking to brush.mesh_automasking_settings / paint.mesh_automasking_settings. |
Rules of thumb
- Sculpt at real scale, with scale applied. Brush radius is in screen space but strength and remesh sizes depend on scale.
- Use symmetry (
mesh.use_mirror_x, radial:mesh.radial_symmetry) on characters until the asymmetry pass at the end. - Face Sets organise parts (head, torso, hands). Hide them and mask by face set to isolate.
- Watch density: a 2 m character at voxel 0.005 is already millions of polys. Keep viewport FPS usable and work up in levels.
- Silhouette first. Check from several angles in flat matcap (
lookshadingsolid) before adding detail. - Floaters/kitbash for hard-surface details on organic models: separate objects, combined at bake time.
- Before baking, run
blender-asset-qaon the high (no inverted parts, no huge self-intersections in the bake range).
References
references/forms-and-bake-sources.md: human proportions in meters and heads, form order (primary → tertiary), hard-surface sculpting (trim gestures, mask extract, face sets, mesh filters), multires rebuild/reshape, and preparing a high-poly bake source (density, cage, naming, exploding). Load it before character, creature or bake-source work.
Gotchas
voxel_remeshdestroys UVs, vertex groups (unless preserve attributes) and multires levels. Do it before UVs/rigging.- Multires + topology changes don't mix: never edit the base topology after subdividing (apply the base or rebuild).
symmetrizeon a non-centered object mirrors across the object's local axis. Center the origin on the symmetry plane first.- Sculpting on shape keys: enable
use_shape_key_edit_modeand sculpt on the active key (facial work,blender-facial-shapekeys).
04 同仓库更多 Skills
blender-workflow-recipes
End-to-end Blender 5.2 playbooks chaining the blender-* skills with QA gates - game props (mid-poly, high-to-low), game characters (sculpt/AI mesh to rigged, animated export), Roblox props/accessories/avatars, AI or downloaded asset cleanup, procedural environments, web/AR assets, product turntables, mood/weather shots (night, rain, snow, fog). Use for complete multi-stage asset requests.
blender-weather-fx
Weather effects in Blender 5.2 - looping Geometry Nodes rain, snow, dust, ash and embers with ground hits and splashes, wet surfaces, puddles with animated ripples, wall streaks, snow cover (shader + real snow geometry), storm lightning with multi-stroke flashes and bolts, engine-ready weather masks. Use for rain, storm, snow, wet street, puddle, dust or ember scenes.
blender-video-editing
Video in Blender 5.2 - Video Sequencer edits from Python (clips, image sequences, crossfades, titles, music fades, proxies, color management, H.264/AAC output) and motion tracking (feature detection, camera solve, scene orientation, tripod and plane tracking, stabilization) for VFX shots. Use to cut renders/footage together or match-move a camera.
blender-time-of-day
Time of day and atmosphere in Blender 5.2 - measured sky + sun for dawn, morning, noon, golden hour, sunset, blue hour, overcast, night/moonlight with stars and city glow, exposure balance, height fog from visibility, god rays, Cycles vs EEVEE volumes, compositor grade, stylized moods (cyberpunk neon, horror, underwater, desert). Use for any day/night, sunset, foggy or mood lighting scene.
blender-texturing
Texture authoring in Blender 5.2 - smart-material layers (edge wear, cavity grime, dust, rust, roughness breakup) from curvature/AO masks, z-fight-safe decal and sticker placement, trim sheets, tiling + vertex-color blends, texture painting, baking the look to game texture sets. Use when a material needs wear, dirt, a decal, trims or hand painting, not just wiring.
blender-texture-baking
Bake texture maps in Blender 5.2 Cycles - high-to-low normal maps with cage/extrusion, AO, curvature, ID, thickness, base color/roughness/metallic from procedurals, ORM packing, OpenGL vs DirectX, margins, GPU baking, fixing skewing/waviness/seams. Use when transferring sculpt or high-poly detail to game meshes or converting procedural materials to textures.