Blender Design
Plugin marketplaces
This plugin belongs to AIGC content creation.
| Category | Marketplace | Purpose |
|---|---|---|
| Full-stack development | Full Stack Plugins | Architecture and UI design, code understanding, quality checks, code review, workflow governance, and server operations |
| AIGC content creation | Full AIGC Plugins | Image, video, audio, music, 3D, and multimodal content creation |
Build, review, and export editable Blender scenes from your coding agent through a guarded local Harness, with milestone previews and rollback checkpoints instead of disposable renders.
English | 简体中文 · Install · Quick start · Skills · Architecture · Troubleshooting
Positioning
blender-design drives a real Blender session through a closed, structured command surface. It creates and edits scene objects, materials, lights, cameras and animation, captures milestone previews, and exports files you keep. Arbitrary Python is disabled by default, Blender data mutates only on the main thread, and irreversible actions require an action-bound authorization. The marketplace entry is partme-ai-blender pinned to v0.16.1, with one stdio MCP server, and the verified runtime baseline is Blender 4.2.23 in CI plus Blender 5.2.1 UI acceptance on macOS arm64.
Installation
Prerequisites
- Blender 4.2–5.2 installed and launchable; the checked matrix is
config/blender-release-matrix.json. - Python 3.11–3.13 available for the bundled MCP runtime.
ffmpegandffprobeonPATHwhen you export video.- Disk space for checkpoint snapshots and frame sequences.
From the plugin marketplace
codex plugin marketplace add partme-ai/full-aigc-plugins
codex plugin add blender-design@full-aigc-plugins
Restart the host, open a new task, and start with a read-only request such as capability.list before changing anything.
Optional: attach to an already-open Blender window
Run python3 scripts/package_connector.py dist/partme-blender-mcp-addon-0.7.0-rc.2.zip, install that ZIP in Blender via Edit → Preferences → Add-ons → Install from Disk, enable PartMe Blender MCP, then press N and click Start MCP Server. Do not install a second Blender MCP Add-on alongside it.
Quick start
flowchart LR
A[Prompt and plan] --> B{Mode}
B -->|Managed| C[Launch temporary Harness]
B -->|Connector| D[Attach through the Add-on]
C --> E[Main-thread commands]
D --> E
E --> F[Checkpoint, preview, validation]
F --> G[Verified exports plus receipts]
Ask for a scene, review the milestone previews, then export:
Use managed mode. Create a matte-orange desktop speaker with a rounded body, a black front
grille, and one control knob. Show camera, front, side, and top previews, then export
.blend, .glb and .png into my output folder and verify every file.
Expected observation: Blender launches, the Harness loads temporarily, preview images appear per milestone, and the export step returns hashes instead of a success claim.
What you can build
| Workflow | Built-in path | Verifiable output |
|---|---|---|
| Model a product or environment | blender-design, blender-hard-surface, blender-procedural-modeling |
Editable meshes, modifiers, Geometry Nodes groups |
| Rig and animate a character | blender-character-rigging, blender-character-animation |
Armature, weights, IK controls, keyed action |
| Look development and render | blender-uv-material, blender-render-compositing |
UV layout, PBR materials, Eevee/Cycles frames |
| White-model previs | blender-previs, blender-video-original, blender-video-recreate |
Timed shots, camera motion, preview video |
| Review against a target | blender-visual-loop, blender-design-loop |
Immutable screenshots, visual verdicts, committed transactions |
| Export and hand off | blender-export, blender-to-dreamina, blender-seedance-pipeline |
.blend/.glb/.png/.mp4 receipts, Jimeng handoff link |
Skills
| Skill | What it does |
|---|---|
blender-ai-replication |
Replicates a reference image as 3D geometry through iterative vision critique. |
blender-asset-library |
Fetches CC0 HDRI and PBR assets with explicit download-size discipline. |
blender-background-jobs |
Runs snapshot-isolated exports, frame sequences and bakes off the foreground scene. |
blender-character-animation |
Animates a registered rig and one prop with IK, constraints and continuity checks. |
blender-character-rigging |
Builds armatures, skin weights, IK controls, pole targets and joint limits. |
blender-cinematography |
Designs cameras, lenses, path motion, focus, framing and handheld response. |
blender-connector |
Connects to an already-open Blender window through the pinned PartMe Add-on. |
blender-curves |
Builds editable paths, profiles, cables, rails and curve-driven props. |
blender-design |
Turns an idea into a scene through milestone modeling, materials, lights and animation. |
blender-design-loop |
Runs a dream → build → screenshot → critique → iterate loop against a target image. |
blender-export |
Exports an approved snapshot to verified model, image, video, EXR, USD or Alembic artifacts. |
blender-grease-pencil |
Creates Grease Pencil layers, materials, frame drawings and mixed 2D/3D scenes. |
blender-hair |
Creates and inspects Hair Curves from surface-local strand points and radii. |
blender-hard-surface |
Builds hard-surface, product, mechanical and prop geometry with registered commands. |
blender-harness |
Launches a managed session and dispatches the closed JSON command envelope. |
blender-harness-driving |
Drives the Harness from a shell client and keeps the scene-revision chain coherent. |
blender-inspect |
Inspects an active scene read-only before design, modification or export. |
blender-managed |
Starts a non-invasive session without installing a Blender Add-on. |
blender-mcp-setup |
Sets up or diagnoses the MCP connection, Add-on state and session discovery. |
blender-preview |
Captures camera, front, side and top previews for milestone review. |
blender-previs |
Turns a story or shot list into a colour-coded white-model previs video. |
blender-procedural-modeling |
Builds reusable Geometry Nodes systems and parameterized environments. |
blender-quality-validation |
Measures geometry, character, prop, collision, motion and camera acceptance criteria. |
blender-recover |
Rolls back a failed milestone or resumes from the last confirmed checkpoint. |
blender-render-compositing |
Configures Eevee/Cycles, passes, colour management, baking and compositor nodes. |
blender-retopology |
Sets up, projects, transfers layers for and validates retopology surfaces. |
blender-scene-assembly |
Organizes scenes, collections, object identity, transforms and visibility. |
blender-sculpt-surface |
Refines detail with masks, displacement, sculpt strokes, voxel remesh and Multires. |
blender-seedance-pipeline |
Drives a Blender preview through the validated Dreamina 3D pipeline. |
blender-sequence-editing |
Assembles VSE timelines with timing, speed, transitions and audio fades. |
blender-simulation |
Configures rigid body, collision, cloth, soft body, smoke and fluid caches. |
blender-to-dreamina |
Hands a local render to the official Jimeng uploader and returns a web link. |
blender-tracking |
Loads footage, creates markers, solves a camera and validates reprojection error. |
blender-use |
Routes a Blender request to the right managed or Connector workflow. |
blender-uv-material |
Prepares UVs and PBR materials including colour-space and normal-map semantics. |
blender-video-original |
Turns a prose concept into a timed, editable white-model video. |
blender-video-recreate |
Reconstructs a reference video's shots and camera motion as an editable scene. |
blender-visual-loop |
Iterates against a target with immutable screenshots and commit/rollback. |
Slash commands
| Command | What it does |
|---|---|
/blender |
Entry point; routes design, previs, inspect, export and recovery requests. |
/blender-setup |
First-run setup: Add-on, connection mode and Harness preflight. |
/blender-design |
Milestone-based modeling, materials, lighting, camera and animation. |
/blender-inspect |
Scene and runtime inspection: objects, session, transactions, dependencies. |
/blender-preview |
Viewport snapshots and milestone screenshots for iterative review. |
/blender-previs |
White-model previs from a shot list plus the Seedance handoff package. |
/blender-render |
Final renders, compositor nodes and sequence output. |
/blender-export |
Verified multi-format export with receipts. |
/blender-recover |
Resume or roll back an interrupted job from the transaction ledger. |
/blender-dreamina |
Hand artifacts to the official Jimeng uploader. |
/blender-seedance |
Preview → validate → submit → download through Seedance. |
MCP tools
mcp.json declares one stdio server, partme_blender, started with node ./scripts/mcp_bootstrap.mjs. It exposes the Harness command registry rather than free-form scripting:
| Tool | Purpose |
|---|---|
capability.list / capability.describe / preview.capture |
Read the catalog, describe the running mode, capture milestone previews |
scene.inspect / scene.screenshot |
Read the scene and grab a screenshot |
object.*, material.*, modifier.* |
Create and edit scene content on the main thread |
job.submit / job.status / job.resume |
Run and resume snapshot-isolated background work |
export.extended |
Export approved artifacts and return a receipt |
The generated inventory is docs/verification/capability-counts.json: 196 commands across 35 domains in managed mode, 201 across 36 in Connector mode.
Configuration
| Variable | Purpose | Default |
|---|---|---|
CODEX_BLENDER_DESCRIPTOR |
Path to the Harness session descriptor | Written by the launcher |
CODEX_BLENDER_FFMPEG |
Override the FFmpeg binary | ffmpeg on PATH |
CODEX_BLENDER_FFPROBE |
Override the ffprobe binary | ffprobe on PATH |
config/blender-release-matrix.json records supported builds and config/production-profile.json records excluded domains. No API key is stored: session authorization uses ephemeral HMAC tokens with a 60-second TTL.
Architecture and security
Codex owns orchestration and approvals; Blender owns scene data; this plugin owns workflow instructions, the Harness transport and the validators. The authors receive no scene data.
- Transports are a private Unix domain socket on macOS, a Named Pipe on Windows, and tokenized loopback TCP only as a fallback.
- Deletion, overwrite,
expert_python, path escape and budget overruns are gated by single-use, action-bound tokens. - Checkpoints and the transaction journal live under the runtime directory; background jobs never restart by themselves, and a missing frame is detected by hash and re-rendered alone.
| Evidence | Status |
|---|---|
| macOS arm64 managed and Connector runtime | PASS, recorded in docs/verification/harness-runtime.md |
| Windows Server 2025 x64 background recovery, Rigify, Named Pipe | PASS, docs/verification/windows-l4-rigify.md |
| Windows foreground UI takeover and Jimeng Web handoff | Not verified or blocked; do not present either as working |
Troubleshooting
| Symptom | Check first | Resolution |
|---|---|---|
| Blender does not launch | Installation and PATH |
Install Blender 4.2+ and retry managed mode |
| Video export fails | ffmpeg and ffprobe |
Install both or set the two override variables |
UNKNOWN_COMMAND |
capability.list for this session |
Use an advertised command or switch mode |
SESSION_REVOKED |
Authorization TTL | Re-authorize the action |
Upgrade
codex plugin marketplace upgrade full-aigc-plugins
codex plugin add blender-design@full-aigc-plugins
Current packaged version: 0.16.1+codex.20261018 (development preview).
Contributing and support
Open functional issues at https://github.com/full-aigc-plugins/blender-design-plugin/issues. State the Blender version and platform you verified on, whether the change alters the command registry or authorization policy, and include the affected tests. New commands belong in the registry, not in free-form Python.
No comments yet. Be the first to write one.