MAX-786/claude-3d-harness / library/cc/text-to-blender
text-to-blender
VerifiedDrive Blender from natural language. Converts plain-English requests ("model a sword and render it with cinematic lighting", "make this glass look frosted", "set up three-point lighting", "export this scene as glTF for the web") into Blender Python code executed via the Blender MCP server. Acts as the orchestrator that picks and chain-loads specialised sub-skills (blender-modeling, blender-materials, blender-lighting, blender-cameras, blender-rendering, blender-animation, blender-export, wireframe-to-3d, blender-pro-workflow, blender-skill-harmonizer, quality-refinement-autoloop). Use this skill whenever the user wants Claude to do anything in Blender, including creating geometry, applying materials, lighting a scene, framing a camera, rendering, animating, or exporting. Make sure to invoke this skill even if the user does not say "Blender" — also covers requests like "create a 3D model of...", "render this...", "make a glTF from...", "set up a scene with...", or any 3D-creation task. Requires the Blender MCP addon (ahujasid/blender-mcp) running on port 9876.
references/blender-version-compat.md
View on GitHub# Blender Version Compatibility Matrix
This plugin is developed against **Blender 5.1.1** (validated end-to-end on macOS). Most patches include forward/backward compatibility for **Blender 4.x** users.
## Compat-critical patches in this plugin
| Patch | Blender 4.x behaviour | Blender 5.x behaviour | Strategy |
|-------|----------------------|----------------------|----------|
| EEVEE engine name (`blender-rendering` Recipe 3) | `BLENDER_EEVEE` (4.0–4.1) or `BLENDER_EEVEE_NEXT` (4.2+) | `BLENDER_EEVEE` (5.x renamed back) | `try`/`except` with fallback — works on every version |
| Action F-curve access (`blender-animation` Recipe 3) | `action.fcurves` (legacy actions) | `action.layers[].strips[].channelbags[].fcurves` (layered actions only) | `get_fcurves_compat()` helper: tries `.fcurves` first, falls back to walking layers |
| `Mesh.use_auto_smooth` attribute | exists | **REMOVED** | Code wraps in `hasattr(mesh, 'use_auto_smooth')` or simply uses `bpy.ops.object.shade_smooth()` instead |
| `Subsurface IOR` and `Weight` BSDF inputs (`blender-materials` Recipe 9) | Reachable by string-key lookup | `enabled=False` flag blocks string-key lookup | `set_input(node, name, value)` helper iterates inputs to find by name |
| Coloured-glass volume density (`blender-materials` Recipe 6b) | Same physics — recipe values are version-agnostic | Same | No special handling needed |
## What's NOT cross-tested
- **Blender 3.x and earlier**: Not supported. Many recipes use Principled BSDF v2 inputs (Coat Weight, Sheen Weight, Subsurface Weight) that don't exist on the older Principled BSDF.
- **Blender 4.0 specifically**: Not directly tested in this validation pass. The compat helpers should work but the `BLENDER_EEVEE_NEXT` engine name introduced in 4.2 means a 4.0 user hits the fallback path — verified to be `BLENDER_EEVEE`.
## Validation status (as of v0.9.0)
| Blender version | Status | Notes |
|----------------|--------|-------|
| 5.1.1 | ✅ Fully validated | All scenes (sword, bottle, chair, aviator wireframe) tested end-to-end |
| 4.2 / 4.3 / 4.4 LTS | ⚠️ Compat code present, **not directly tested** | The try/except + helper patterns should work; would need a 4.x install to confirm |
| 4.0 / 4.1 | ⚠️ Compat code present, **not directly tested** | Same as 4.2 — should work via fallback paths |
| 3.x and earlier | ❌ Not supported | Principled BSDF v1 missing required inputs |
## How to confirm cross-version compat in your install
After installing this plugin, run a quick smoke test:
```python
# In Blender's Scripting workspace — paste and run:
import bpy
# 1. Test engine fallback
scene = bpy.context.scene
try:
scene.render.engine = 'BLENDER_EEVEE_NEXT'
print(f"engine: NEXT path used, resolved to {scene.render.engine}")
except (TypeError, ValueError):
scene.render.engine = 'BLENDER_EEVEE'
print(f"engine: fallback path used, resolved to {scene.render.engine}")
# 2. Test BSDF input access
mat = bpy.data.materials.new('test')
mat.use_nodes = True
b = mat.node_tree.nodes['Principled BSDF']
disabled_inputs = [inp.name for inp in b.inputs if not inp.enabled]
print(f"disabled BSDF inputs (need set_input helper): {disabled_inputs}")
bpy.data.materials.remove(mat, do_unlink=True)
# 3. Test Action API
print(f"version: {bpy.app.version_string}")
print(f"Action.layers attribute: {hasattr(bpy.types.Action, 'layers')}")
```
Expected output on Blender 5.1.1:
```
engine: fallback path used, resolved to BLENDER_EEVEE
disabled BSDF inputs (need set_input helper): ['Weight', 'Subsurface IOR']
version: 5.1.1
Action.layers attribute: True
```
If you see a different version with `disabled BSDF inputs: []` and the `BLENDER_EEVEE_NEXT` succeeds (resolving to that exact name), you're on Blender 4.2-4.4.
If you find recipes that fail on your version, please file an issue at https://github.com/RobLe3/cc-blender-skill/issues with:
- `bpy.app.version_string`
- The specific recipe / SKILL.md section
- The error message
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 472k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |