VoxelFlow Studio
VoxelFlow Studio’s server exposes approval-gated MCP tools for inspecting and editing live Blockbench voxel projects.
Read editor connection/status and inspect live project geometry, textures, bone mapping, and keyframes.
Create an editable Bedrock robot model with palette, rig, and idle/walk/attack clips.
Create static cube-based props with up to 128 parts and 16 named materials.
Recolor prop materials or the atlas while preserving artist-painted pixels.
Map bones for an existing humanoid hierarchy and generate native idle/walk/attack keyframes.
Validate the live project with deterministic quality gates.
Export a Bedrock resource asset ZIP with geometry, textures, animations, manifest, source, and report.
Undo the latest VoxelFlow change, poll operation status, cancel pending approvals, and preview existing animation clips.
Require Blockbench artist approval for edits/exports; validation does not certify Minecraft runtime compatibility.
Provides MCP tools for designing and editing Minecraft-style models in Blockbench, including cubes, named materials, groups, rotations/pivots, texture atlases and per-face UVs, approval/undo workflows, and exporting editable .bbmodel files plus Bedrock geometry, textures, and applicable animation resources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@VoxelFlow Studio Create a brown leather backpack with gold buckles and straps."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
VoxelFlow Studio
Turn prompts into editable Minecraft-style models.
Describe a leather bag, a crystal staff, or your own cube-based object in a connected ChatGPT/Codex desktop chat. VoxelFlow brings the design into Blockbench with editable parts, a pixel texture, and export checks. Keep creating with prompts or finish the details by hand.
Website · Interactive setup guide · Install the beta · Examples · Contribute · Roadmap

From an idea to a model
Try it without an AI account: load the Blockbench plugin and choose the Bag, Staff, or Robot example in the Create panel. For chat-driven creation, use a supported local desktop host. Prompt gallery · Installation help · Starter contributions
Create a brown leather backpack with gold buckles, shoulder straps, and a front pocket.
Describe it in chat. The assistant designs the parts and materials through VoxelFlow's MCP tools.
Review it in Blockbench. Approve the proposed change, inspect the model, and adjust it with native editing and Undo.
Export the result. Save the editable
.bbmodeland checked Bedrock resource assets.
The prompt belongs in your AI chat; Blockbench is the model workspace. Bag, Staff, and Robot examples also work locally without an AI account.
Related MCP server: Blockbench MCP
What works today
Capability | Desktop beta 0.3.4 |
General props | Up to 128 cubes, 16 named materials, and 32 groups, with rotations and pivots |
Texturing | PNG atlas, per-face UVs, native painting, and named recoloring that preserves painted pixels |
Characters | Configurable Atlas robot, mapping of suitable existing humanoid rigs, editable idle/walk/attack clips |
Artist control | Native approval dialogs, Undo, stale-proposal checks, and retry deduplication |
Export | Editable Blockbench source and Bedrock geometry, textures, and applicable animation resources |
Desktop integration | Bundled MCP server, 15 tools, 2 prompts, setup/modeling skills, and a Windows companion launcher |
This is an early desktop beta. Version 0.3.5 adds individual part editing in the current tab: move, resize, rotate, adjust pivots, or assign an existing prop material with approval and Undo. Custom animated creatures, inventory items, wearable attachments, and gameplay behavior are future work. Resource exports still need Minecraft integration and in-game testing. See supported scope and Bedrock integration.
Install
Requires Node.js 22+, Blockbench desktop 5.2+, and a desktop ChatGPT/Codex host supporting local plugins. Windows is tested; macOS/Linux are not yet verified.
Download the desktop beta ZIP · Release notes · Full installation guide
Extract the ZIP. Load its
plugins/voxelflow-studio/blockbench/voxelflow_studio.jsin Blockbench using File → Plugins → Load Plugin from File.Double-click
plugins/voxelflow-studio/Start VoxelFlow.cmdand keep the companion running.In Blockbench, open Tools → VoxelFlow Studio → Connect and confirm the automatically filled local connection.
Open the extracted folder as a local project in your supported desktop host and install VoxelFlow Studio from the VoxelFlow desktop beta source. Start a fresh local chat.
There is no npm install or build step for the desktop download. Codex CLI users can instead register the source directly:
codex plugin marketplace add KumarManuSaraswat/voxelflow-studio
codex plugin add voxelflow-studio@voxelflow-desktop-betaThe Blockbench plugin and local companion are still required. See the install guide for those steps, other operating systems, pairing, and uninstalling.
GitHub availability does not mean public ChatGPT directory availability. This release is installed locally. Public directory submission and account-level ChatGPT testing remain outstanding; the desktop-only submission route currently requires approved-partner eligibility. See distribution status.
Examples and verification
Open the editable adventurer bag, arcane staff, or Atlas robot in Blockbench. Specifications, textures, and validation reports are included alongside them.

The beta was checked on Windows, Blockbench 5.2.2, and Node 24.11.1, with 84 automated tests for that live-tested baseline. A real Codex CLI prompt designed a 20-cube lantern, created after native approval and exported successfully. A fresh desktop extraction works without node_modules. Minecraft runtime behavior and ChatGPT account onboarding remain unverified. Read the evidence.
Version 0.3.4 passes 102 automated tests and fresh-extraction package checks. Its repeated-part and compact-inspection additions have not yet had a new live Blockbench UI run.
Develop
Version 0.3.4 adds token-efficient modeling: locally expanded repeated parts and compact inspection, with full geometry still available on demand.
git clone https://github.com/KumarManuSaraswat/voxelflow-studio.git
cd voxelflow-studio
npm ci
npm run checkLoad dist/voxelflow_studio.js in Blockbench. Run npm run bridge, then connect from the VoxelFlow panel using the port and session token in that terminal. Keep connection credentials private.
Command | Purpose |
| Type checking, tests, build, and reproducible examples |
| Exercise the real MCP/editor path; requires native approvals |
| Build both standalone desktop ZIPs |
| Check a fresh extraction and bundled MCP startup |
| Read-only local package, MCP discovery, and editor preflight |
| Compare explicit/compact JSON sizes; these are not billing estimates |
| Package the source, builds, examples, and community docs |
Architecture · MCP setup · Prompt workflow · Manual checks · Support
Build with us
VoxelFlow is an MIT-licensed community project, initially maintained by @KumarManuSaraswat. Artists, developers, documentation writers, and testers are welcome. Useful starting points include prompt/model examples, platform testing, clearer onboarding, and the next modeling tools on the roadmap.
Read Contributing before a pull request. Our governance describes how contributors can become maintainers and how the project can move into a dedicated organization as it grows. Community participation follows the Code of Conduct; vulnerability reports follow the security policy.
Support development
Sponsor VoxelFlow's maintainer on GitHub to help fund maintenance, clearer installation, compatibility testing, better model editing, Minecraft export improvements, and contributor documentation.
VoxelFlow remains MIT licensed. Sponsorship supports the maintainer's work; it does not purchase a feature, deadline, or support guarantee. Proposed priorities are tracked in the roadmap, with progress in issues and releases.
License and acknowledgments
Original project code is MIT licensed. Bundled dependencies retain their license notices; development dependency information is in THIRD_PARTY_NOTICES.txt.
Built on Blockbench and the Model Context Protocol. VoxelFlow Studio is an independent project and is not affiliated with or endorsed by Mojang, Microsoft, OpenAI, or Blockbench's maintainers.
Available Tools
14 toolsapply_materialsApply MaterialsADestructiveIdempotent
Propose recoloring the VoxelFlow atlas while preserving pixels painted by the artist. Does not rebuild geometry or animations. Requires Blockbench approval.
Inputs: palette (required), request_id (required). Returns: ok, data, error
apply_prop_materialsApply Prop MaterialsADestructiveIdempotent
Propose changing named colors on an existing VoxelFlow prop. First inspect_project to read its actual material names. Supply only the names/colors to update; preserve other materials, painted pixels and geometry. Requires Blockbench approval.
Inputs: materials (required), request_id (required). Returns: ok, data, error
cancel_operationCancel OperationAIdempotent
Cancel a pending approval without changing the scene. Running exports must be cancelled in the native Save dialog.
Inputs: operation_id (required). Returns: ok, data, error
create_modelCreate ModelADestructiveIdempotent
Propose an editable humanoid robot with palette, articulated rig, and idle/walk/attack clips in a NEW Bedrock project tab. Translate natural language into AssetSpec; only robot/bedrock is implemented. Returns pending_approval. Ask the artist to approve in Blockbench, then poll get_operation. Eye color is bright cyan, not an emissive shader.
Inputs: spec (required), request_id (required). Returns: ok, data, error
create_propCreate PropADestructiveIdempotent
Create a Minecraft-style prop from the user’s natural-language request: bags/backpacks, staffs, swords, shields, furniture, chests, lanterns, or other objects representable by cubes. YOU design a structured PropSpec with 1–128 named cube parts and 1–16 named hex-color materials. There is NO category whitelist or keyword parser. Y is up, front is negative Z, coordinates/pivots must be -128..128 pixels, from < to, rotations in degrees. Organize related parts with group names; include recognizable silhouette and details. This tool builds real geometry, part groups, PNG atlas and UVs in a NEW Blockbench tab. It creates a static prop, not a humanoid or a registered game item. Returns pending_approval; wait for the artist to approve in Blockbench, then poll get_operation. Do not claim emissive materials or gameplay behavior.
Inputs: spec (required), request_id (required). Returns: ok, data, error
export_assetExport AssetADestructiveIdempotent
Propose a Bedrock resource asset ZIP with geometry, current PNG, animations, controllers, client entity, manifest, source bbmodel and report. Requires passing gates and editor approval, then a native Save dialog. Poll until applied; cancelled is not success. No arbitrary output path accepted.
Inputs: target (required), request_id (required). Returns: ok, data, error
generate_animationsGenerate AnimationsADestructiveIdempotent
Propose real native idle/walk/attack keyframes for a validated mapped humanoid. Replaces only the named preset clips after approval; speed/intensity do not rebuild the model.
Inputs: options (required), request_id (required). Returns: ok, data, error
generate_rigGenerate RigADestructiveIdempotent
Propose a body-part mapping for an existing humanoid hierarchy. Exact/alias detection is conservative; provide all 11 mapped bone names when detection is ambiguous. Does not invent joints or move imported geometry. Requires approval and a valid existing hierarchy.
Inputs: request_id (required), mapping. Returns: ok, data, error
get_editor_statusGet Editor StatusARead-onlyIdempotent
Read live Blockbench connection, project, version and format. Returns connected:false when unavailable; never simulates an editor.
Inputs: no named parameters. Returns: ok, data, error
get_operationGet OperationARead-onlyIdempotent
Read a proposed operation by its request_id. Only applied means the scene/export action completed. pending_approval means the artist must approve in Blockbench. Retry an uncertain command only with its original request_id and parameters.
Inputs: operation_id (required). Returns: ok, data, error
inspect_projectInspect ProjectARead-onlyIdempotent
Read actual geometry, bone mapping, textures and native keyframe summaries of the active Blockbench project.
Inputs: no named parameters. Returns: ok, data, error
preview_animationPreview AnimationA
Select and play or stop an existing idle, walk, or attack clip in the real Blockbench animation timeline. Does not create or edit keyframes.
Inputs: clip (required), playing. Returns: ok, data, error
undo_last_changeUndo Last ChangeADestructiveIdempotent
Propose undoing the most recent VoxelFlow edit using native Undo. Refuses to undo unrelated artist edits. Requires editor approval.
Inputs: request_id (required). Returns: ok, data, error
validate_assetValidate AssetARead-onlyIdempotent
Run deterministic quality gates against the LIVE project, including unsupported geometry, hierarchy, pivots, texture/UVs and actual native keyframes. This does not certify Minecraft runtime compatibility.
Inputs: no named parameters. Returns: ok, data, error
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 14 tools
Most tools have clearly distinct targets: get_editor_status/inspect_project are reads, create_model vs create_prop split humanoid vs prop, generate_rig/generate_animations/preview_animation are separated, and validate_asset/export_asset are distinct lifecycle stages. The main overlap is apply_materials (recolor the atlas) vs apply_prop_materials (change named colors on a prop), which an agent could easily misselect since both sound like material editing on VoxelFlow assets.
All 14 tools follow a consistent snake_case verb_noun pattern (get_editor_status, create_model, generate_rig, validate_asset, cancel_operation, etc.). There are no mixed conventions or vague standalone verbs; apply_materials is slightly less specific in its noun but still fits the pattern.
14 tools is well within the ideal range and each tool maps to a real step in the asset pipeline: inspect, create, material edit, rig, animate, preview, validate, export, undo, plus operation polling/cancel. Nothing appears redundant beyond the apply_materials pair.
The surface covers a full lifecycle: read state, create model/prop, edit materials, rig, animate, preview, validate, export, undo, and async operation handling. Minor gaps exist — there is no tool to list pending operations (only get_operation by known request_id) and no way to edit or add geometry after creation beyond materials/undo, but agents can work around these.
Maintenance
Related MCP Connectors
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Pixel art for your game, from your coding agent. Generate sprites, items and tiles in your game's style (64 to 1024 px), make variants, reskins and N/E/S/W directions, then edit everything in a full pixel art editor that syncs into your project. Works with Claude, Claude Code, Cursor and ChatGPT; sign in with OAuth, no API key.
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
Turn text or an image into an animation-ready 3D model (GLB): generate, rig, animate, retexture.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects Claude AI to Blockbench through Model Context Protocol, enabling AI-assisted 3D modeling, texture creation, and block model manipulation with real-time command execution and feedback.34MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Blockbench for Minecraft 3D modeling, including project creation, cube placement, UV layout, and texture painting.GPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to build, texture, animate, and export Minecraft/GeckoLib cube models inside Blockbench via the Model Context Protocol.MIT
- AlicenseNot gradedqualityDmaintenanceConnects Claude AI to Blockbench through the Model Context Protocol, enabling AI-assisted 3D modeling, texture creation, and block model manipulation. It supports creating, modifying, and deleting models, applying textures and materials, and tracking commands in real time.MIT