add_cube
Add a cube to a Blockbench model with from-to coordinates. Supports single-axis rotation and inflate for rounding. Returns cube uuid and face UVs for painting.
Instructions
Add a cube to the model. Coordinates are in Blockbench units. Cubes support rotation (degrees) and inflate (round/shrink without moving) — use them; flat axis-aligned boxes look robotic. For compound multi-axis angles, parent the cube to a rotated group instead. Prefer add_cubes to build many cubes at once. Returns the created cube with uuid and resolved face UVs (paint onto those with paint_faces).
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | Upper corner [x,y,z]. | |
| from | Yes | Lower corner [x,y,z]. | |
| name | No | ||
| faces | No | Optional per-face setup, keyed by north/south/east/west/up/down. Each: {uv:[x1,y1,x2,y2], rotation, texture: name|uuid}. | |
| autouv | No | 0 disabled, 1 auto, 2 relative auto. | |
| box_uv | No | Use box UV (default follows the format). | |
| origin | No | Rotation pivot [x,y,z] (defaults to `from`). | |
| parent | No | uuid or name of the parent group. | |
| inflate | No | Inflate (+) or shrink (-) all faces in place — use for rounding/taper. | |
| rotation | No | Rotation in degrees [x,y,z]. Single-axis is most reliable per cube. | |
| uv_offset | No | [u,v] offset for box UV. |