blender-geometry-nodes

Blender Geometry Nodes Skill

Version: 2.0.1 Last Updated: 2026-10-10 Dependencies: Blender 5.1+

---

API Note (Blender 5.1+)

Use type='NODES' (not type='GEOMETRY_NODES', which was removed in 4.5):

import bpy
modifier = obj.modifiers.new("GeometryNodes", type='NODES')

bpy.ops works normally via the Blender MCP - use direct data API for explicit control, operators when convenient.

---

QUICK START

Scattering System

import bpy

# Create base plane
verts = [(-5,-5,0), (5,-5,0), (5,5,0), (-5,5,0)]
faces = [[0,1,2,3]]
mesh = bpy.data.meshes.new("BasePlane")
mesh.from_pydata(verts, [], faces)
mesh.update()

obj = bpy.data.objects.new("ScatterBase", mesh)
bpy.context.collection.objects.link(obj)

# Create NODES modifier
modifier = obj.modifiers.new("Scattering", type='NODES')

# Create node tree
node_tree = bpy.data.node_groups.new("ScatterSystem", type='GeometryNodeTree')
modifier.node_group = node_tree

nodes = node_tree.nodes
links = node_tree.links
nodes.clear()

# Build node tree
input_node = nodes.new('NodeGroupInput')
output_node = nodes.new('NodeGroupOutput')
distribute = nodes.new('GeometryNodeDistributePointsOnFaces')
instance = nodes.new('GeometryNodeInstanceOnPoints')
cube = nodes.new('GeometryNodeMeshCube')

# Position nodes
input_node.location = (-400, 0)
distribute.location = (-200, 0)
instance.location = (0, 0)
cube.location = (-200, -200)
output_node.location = (200, 0)

# Connect nodes
links.new(input_node.outputs[0], distribute.inputs[0])
links.new(distribute.outputs[0], instance.inputs[0])
links.new(cube.outputs[0], instance.inputs[2])
links.new(instance.outputs[0], output_node.inputs[0])

print(f"Created: {len(nodes)} nodes, {len(links)} links")

---

STANDARD WORKFLOWS

Workflow 1: Point Distribution System

Use When: Scatter objects across surfaces with density control

import bpy

# Create target surface
mesh = bpy.data.meshes.new("Surface")
verts = [(-10,-10,0), (10,-10,0), (10,10,0), (-10,10,0)]
faces = [[0,1,2,3]]
mesh.from_pydata(verts, [], faces)
mesh.update()

obj = bpy.data.objects.new("Surface", mesh)
bpy.context.collection.objects.link(obj)

# Add geometry nodes
modifier = obj.modifiers.new("Distribution", type='NODES')
node_tree = bpy.data.node_groups.new("PointDistribution", type='GeometryNodeTree')
modifier.node_group = node_tree

nodes = node_tree.nodes
links = node_tree.links
nodes.clear()

group_input = nodes.new('NodeGroupInput')
group_output = nodes.new('NodeGroupOutput')
distribute = nodes.new('GeometryNodeDistributePointsOnFaces')
instance = nodes.new('GeometryNodeInstanceOnPoints')
sphere = nodes.new('GeometryNodeMeshUVSphere')
random_value = nodes.new('FunctionNodeRandomValue')

distribute.inputs["Density"].default_value = 50.0
sphere.inputs["Radius"].default_value = 0.2
random_value.data_type = 'FLOAT_VECTOR'

group_input.location = (-600, 0)
distribute.location = (-400, 0)
instance.location = (-200, 0)
sphere.location = (-400, -200)
random_value.location = (-400, -400)
group_output.location = (0, 0)

links.new(group_input.outputs[0], distribute.inputs[0])
links.new(distribute.outputs[0], instance.inputs[0])
links.new(sphere.outputs[0], instance.inputs[2])
links.new(random_value.outputs[1], instance.inputs[6])  # Rotation
links.new(instance.outputs[0], group_output.inputs[0])

print(f"Distribution system: {len(nodes)} nodes")