Log inGet started
Package

ZeroBlender.package

README.md

ZeroBlender

Blender-style modeling inside Zero. Install this package and you get the whole surface: the .zblend document type, the tools that edit it, the Python/bpy runtime behind them, the layer previews live in, and the workflow that drives a modeling job to the end.

Contents

PathWhat it is
zblend.assetType/The .zblend document (Zero's .blend): editable scene.json, history, images, and a live output.bundle. Scene-instantiable, previewed, searchable. Its ref methods open and edit documents (below); M.modules exposes every module here to instances.
blender.toolbox/Blender MCP-compatible tools: execute_blender_code, get_scene_info, get_object_info, get_viewport_screenshot, bpy_api_lookup, get_addon_status, compare_to_reference. api.json is the implemented bpy surface.
modules/blenderSessionThe bpy/bmesh/mathutils session: objects, meshes, modifiers, materials, viewport, flush to the document and bundle.
modules/pythonParser, pythonRuntimeThe Python subset the scripts run in (Luau-hosted, not CPython).
modules/animation, riggingArmatures, pose, vertex groups, ARMATURE deform, auto weights, keyframes/actions/F-Curves, constraints, IK, drivers, NLA; clip baking.
modules/sceneOpsEmpties, duplicates, collections, collection instances, zero_instance, origin_set, cursor, snapping.
modules/curves, meshOps, polygonTopology, xformCurve/text meshing, edit-mode operators, topology and evaluation, matrix math.
modules/referenceCompareSilhouette scoring against a reference image.
modules/bpy, hardSurface, kestrelOlder core geometry layer and hard-surface helpers used by the session.
workspace/ModelingWorkspace.sceneAdditive layer holding document previews, on render layer modelingWorkspace (hidden from the editor camera, drawn by screenshots).
model.workflow/Multi-pass modeling job: reference → model → critic/builder rounds → finish.
modeling.agentSkill/The modeling skill that starts the workflow.

Usage

-- Make or open a document and edit it
local doc = asset.create("zblend", "Lantern", { folder = "models" })
doc:run([[import bpy
bpy.ops.mesh.primitive_cylinder_add(radius=0.1, depth=0.3)]])
doc:screenshot("ISO")
doc:sceneInfo()
doc:open()                      -- load as a live session, returns its name

-- Place it (live: placed copies follow edits and play its clips)
doc:instantiate(entity.find("Shelf"))

-- Frozen copy
doc:exportBundle("/zero/source/models/Lantern_v1.bundle")

Agents use the blender toolbox directly with session="<folder>/<Name>", or start the model workflow for a full modeling job (zero workflow start --name model --args '{"subject":"..."}').

Documents default to modeling/models/<name>.zblend; user data (models, references, reports) is not part of the package.