# 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
```luau
-- 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.