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
| Path | What 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/blenderSession | The bpy/bmesh/mathutils session: objects, meshes, modifiers, materials, viewport, flush to the document and bundle. |
modules/pythonParser, pythonRuntime | The Python subset the scripts run in (Luau-hosted, not CPython). |
modules/animation, rigging | Armatures, pose, vertex groups, ARMATURE deform, auto weights, keyframes/actions/F-Curves, constraints, IK, drivers, NLA; clip baking. |
modules/sceneOps | Empties, duplicates, collections, collection instances, zero_instance, origin_set, cursor, snapping. |
modules/curves, meshOps, polygonTopology, xform | Curve/text meshing, edit-mode operators, topology and evaluation, matrix math. |
modules/referenceCompare | Silhouette scoring against a reference image. |
modules/bpy, hardSurface, kestrel | Older core geometry layer and hard-surface helpers used by the session. |
workspace/ModelingWorkspace.scene | Additive 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.