blender-pipeline

What This Skill Does

The blender-pipeline skill serves as a headless automation engine for 3D asset workflows using the Blender Python API (bpy). It allows developers and artists to integrate Blender's powerful 3D processing capabilities directly into command-line environments, CI/CD pipelines, or autonomous agent workflows. By leveraging headless execution, users can bypass the graphical interface to perform batch processing, file format conversions (FBX, glTF, OBJ), automated sprite sheet generation, and procedural asset creation. This skill effectively turns your server or local machine into a scalable 3D production factory, ensuring consistent asset standards without manual intervention.

Installation

Installation varies by platform, but the focus is on providing the blender CLI to the environment:

• Linux (Recommended): Use sudo snap install blender --classic to ensure the latest version is available.
• macOS: Install via Homebrew using brew install --cask blender.
• Verification: Confirm installation by running blender --version or testing the bpy module with blender -b --python-expr "import bpy; print('bpy OK:', bpy.app.version_string)". Ensure your environment PATH is correctly configured to locate the executable, as OpenClaw relies on standard shell execution patterns to trigger the blender-pipeline functions.

Use Cases

This skill is ideal for:

• Automated asset conversion: Programmatically converting character or environment models from FBX to glTF for web-based games.
• Sprite sheet automation: Generating consistent 8-directional or isometric sprite sheets from 3D character rigs for 2D/2.5D game engines.
• Batch processing: Applying standardized textures or modifiers to hundreds of models simultaneously.
• Procedural content generation: Automatically generating low-poly environment props (trees, rocks, debris) with unique seeds to populate procedurally generated levels.

Example Prompts

1. "Convert all FBX files in the ./assets/characters folder to glTF format and save them into the ./web-assets directory using the blender-pipeline."
2. "Generate an 8-directional sprite sheet from character.blend at 128x128 resolution, including all animation frames for the idle action."
3. "Run a batch process to procedurally generate 10 variations of low-poly trees with different seeds and export them as GLB files."

Tips & Limitations

• Argument Order: Always define the blend file and flags in the correct order. The blender CLI is sensitive; put -b and file inputs before output arguments.
• GPU Acceleration: For rendering, ensure you use the --cycles-device flag and provide a setup script to enable CUDA, OPTIX, or METAL headers, as headless modes do not default to GPU rendering.
• Resource Management: Headless rendering can be resource-intensive. Ensure your environment has sufficient RAM and VRAM when processing multiple heavy files in parallel.
• Versioning: Ensure the server-side version of Blender matches the version used during development to prevent incompatible script behaviors in the API.