el4cteo/blender-skills

blender-sculpting

Sculpting in Blender 5.3 - 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-gam…

查看源码

使用方法

  1. 复制安装命令,在自己的智能体环境安装前先检查源码包。
  2. 从原始文档核对所需工具、凭据和支持的宿主。
  3. 说明输入材料与期望交付物,并对照来源检查输出。
npx skills add https://github.com/el4cteo/blender-skills --skill blender-sculpting

开始前需了解

  • 安装不包含模型订阅、API 额度或访问文件的权限。
  • 仓库星数和安装量反映活跃情况,不等于独立质量或安全测试。
仓库原始内容

按源仓库内容呈现,保留标题、案例、代码、表格、链接以及原文引用的演示图片。

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), including mesh_filter. Never enter Sculpt Mode headless.
  • Headless or MCP: use scripts/sculpt_ops.py for 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 with look. Hand detailed brushwork to the human.

Professional workflow

  1. 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.
  2. Unify: voxel remesh (remesh=0.02 for a 2 m character, smaller for detail) fuses parts and gives even density. Repeat it while the big forms change.
  3. 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.
  4. 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.
  5. 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).
  6. 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)

Purposesculpt_brush_type
Build volumeCLAY_STRIPS, CLAY, CLAY_THUMB, LAYER, INFLATE, BLOB
Shape / moveGRAB, SNAKE_HOOK, ELASTIC_DEFORM, POSE, BOUNDARY, CLOTH, NUDGE, ROTATE, THUMB
Details / edgesDRAW, DRAW_SHARP, CREASE, PINCH
Flatten / hard surfacePLANE (flatten/fill/scrape), MULTIPLANE_SCRAPE
Clean upSMOOTH, SIMPLIFY (dyntopo), DISPLACEMENT_ERASER/SMEAR (multires)
Masking / groupingMASK, 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 (look shading solid) before adding detail.
  • Floaters/kitbash for hard-surface details on organic models: separate objects, combined at bake time.
  • Before baking, run blender-asset-qa on 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_remesh destroys 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).
  • symmetrize on 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_mode and sculpt on the active key (facial work, blender-facial-shapekeys).
来自同一仓库

更多 Skills

全部 Skills
el4cteo
社区

blender-environment-kits

Game environments in Blender 5.3 - terrain from noise or heightmaps (erosion, terraces, play areas, slope/height materials, 16-bit heightmaps + splat maps for UE/Unity), biome scatter by slope/height/mask with Poisson spacing, modular kit metrics and validation (grid, pivots, seams, texel density). Use for levels, landscapes, forests, modular buildings, dungeons.

1小时安装量
4
GitHub Stars
2464
最近更新
11月17日
el4cteo
社区

blender-geometry-nodes

Geometry Nodes in Blender 5.3 - fields, domains, attributes, instancing, zones (simulation/repeat/for-each), closures/bundles, lists, SDF grids, node tools, baking, plus a JSON-to-node-tree builder and socket inspector. Use for scattering, procedural assets/environments, parametric tools and modifier inputs.

1小时安装量
4
GitHub Stars
2464
最近更新
11月17日
el4cteo
社区

blender-lighting-lookdev

Lighting, cameras and look-dev in Blender 5.3 - studio 3-point and product lighting, HDRI environments, sun/sky exteriors, interiors, light linking, physically based light units, camera focal lengths/composition/DOF, cyclorama backdrops, looping turntables for asset presentation. Use when presenting assets, setting up scenes for rendering, or judging materials under consistent light.

1小时安装量
4
GitHub Stars
2464
最近更新
11月17日
el4cteo
社区

blender-rendering

Render with Blender 5.3 Cycles/EEVEE/Workbench - quality presets, GPU setup, adaptive sampling, denoising, light paths, color management (AgX, Khronos PBR Neutral, ACES), PNG/EXR/MP4 output, passes, the 5.0 compositor API, CLI and multi-camera batch rendering. Use for any still, animation or turntable render.

1小时安装量
4
GitHub Stars
2464
最近更新
11月17日