Skip to main content
Glama

VoxelFlow Studio

Turn prompts into editable Minecraft-style models.

Checks License: MIT Status: desktop beta

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

An editable adventurer backpack created in Blockbench with VoxelFlow

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.

  1. Describe it in chat. The assistant designs the parts and materials through VoxelFlow's MCP tools.

  2. Review it in Blockbench. Approve the proposed change, inspect the model, and adjust it with native editing and Undo.

  3. Export the result. Save the editable .bbmodel and 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

  1. Extract the ZIP. Load its plugins/voxelflow-studio/blockbench/voxelflow_studio.js in Blockbench using File → Plugins → Load Plugin from File.

  2. Double-click plugins/voxelflow-studio/Start VoxelFlow.cmd and keep the companion running.

  3. In Blockbench, open Tools → VoxelFlow Studio → Connect and confirm the automatically filled local connection.

  4. 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-beta

The 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.

An editable arcane staff created in Blockbench with VoxelFlow

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 check

Load 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

npm run check

Type checking, tests, build, and reproducible examples

npm run demo -- --prop bag

Exercise the real MCP/editor path; requires native approvals

npm run package:desktop

Build both standalone desktop ZIPs

npm run verify:desktop

Check a fresh extraction and bundled MCP startup

npm run doctor

Read-only local package, MCP discovery, and editor preflight

npm run measure:payloads

Compare explicit/compact JSON sizes; these are not billing estimates

npm run package

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 tools
apply_materialsApply MaterialsA
DestructiveIdempotent

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 MaterialsA
DestructiveIdempotent

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 OperationA
Idempotent

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 ModelA
DestructiveIdempotent

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 PropA
DestructiveIdempotent

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 AssetA
DestructiveIdempotent

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 AnimationsA
DestructiveIdempotent

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 RigA
DestructiveIdempotent

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 StatusA
Read-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 OperationA
Read-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 ProjectA
Read-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 ChangeA
DestructiveIdempotent

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 AssetA
Read-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

    A4/5.0

    Scored across 14 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers