Introduction
Geometry Script is a scripting API for Blender’s Geometry Nodes. It makes complicated node trees more managable and easy to share.
- Full coverage of nodes available in your Blender version
- Clean, easy to use Python API
- Typed node functions generated from your Blender version, with errors that say what to change
- External IDE integration for better completions and hot reload
- Repeat, simulation, for-each and closure zones
Here’s a simple example of what’s possible with a short script:
Geometry Script
from geometry_script import *
@tree("Repeat Grid")
def repeat_grid(geometry: Geometry, width: int = 3, height: int = 3):
mesh = grid(
size_x=width, size_y=height,
vertices_x=width, vertices_y=height,
).mesh
points = mesh_to_points(mesh=mesh).points
return instance_on_points(points=points, instance=geometry).instances