blender-sculpting

Blender Sculpting Skill

Version: 2.0.0 Last Updated: 2026-06-10 Dependencies: Blender 5.1+

---

API Notes (5.1+)

Viewport shading change (4.5.0+):

import bpy

# [FAIL] OLD
# space.shading.type = 'MATERIAL_PREVIEW'

# [OK] NEW (4.5.0+)
space.shading.type = 'MATERIAL'

# Valid modes: 'WIREFRAME', 'SOLID', 'MATERIAL', 'RENDERED'

Sculpting operators require Blender context - use the Blender MCP's execute_blender_code tool, which has full context. For high-resolution mesh deformation, direct vertex manipulation is more reliable than sculpt brush operators.

---

QUICK START

Create Base Terrain Mesh

import bpy

# Remove existing terrain
for obj in [o for o in bpy.data.objects if o.name.startswith('Terrain')]:
    bpy.data.objects.remove(obj, do_unlink=True)

# Create 100x100 grid terrain
size = 100
subdivisions = 100
vertices = []
faces = []

for y in range(subdivisions + 1):
    for x in range(subdivisions + 1):
        x_pos = (x / subdivisions - 0.5) * size
        y_pos = (y / subdivisions - 0.5) * size
        vertices.append((x_pos, y_pos, 0.0))

for y in range(subdivisions):
    for x in range(subdivisions):
        i = y * (subdivisions + 1) + x
        faces.append([i, i + 1, i + subdivisions + 2, i + subdivisions + 1])

mesh = bpy.data.meshes.new('TerrainMesh')
mesh.from_pydata(vertices, [], faces)
mesh.update()

obj = bpy.data.objects.new('Terrain', mesh)
bpy.context.collection.objects.link(obj)

for poly in mesh.polygons:
    poly.use_smooth = True

print(f'Terrain created: {len(vertices)} vertices, {len(faces)} faces')

Add Multires Modifier

import bpy

terrain = bpy.data.objects.get('Terrain')
if terrain:
    multires = terrain.modifiers.new('Multires', 'MULTIRES')
    print(f'Multires added to {terrain.name}')
    # To subdivide: use Blender UI or bpy.ops.object.multires_subdivide
    # after setting active object and entering Object mode

---

STANDARD WORKFLOWS

Workflow 1: Direct Vertex Terrain Sculpting