Box
A six-sided box shape with width, depth, height and per-axis segment counts.
Box is a six-sided box with width, depth and height. It is the default type for a newly created parametric shape and the workhorse of blockout.
Geometry
A closed box of six quad faces. Width runs along local X, Depth along local Z and Height along local Y, with the pivot at the center of the bottom face. A box of height h therefore occupies y=0 to y=h, and a part stacked on top belongs at @0,h,0.
Raising the segment counts divides each face into a grid. Modifiers such as Bend and Twist need those divisions to deform smoothly, so add them up front on a box you intend to deform.
Parameters
| Label | Script key | Default | Range | Description |
|---|---|---|---|---|
| Width | w | 1 | 0.01 ~ 10000 | Width along local X, in meters |
| Depth | d | 1 | 0.01 ~ 10000 | Depth along local Z, in meters |
| Height | h | 1 | -10000 ~ 10000 | Height along local Y, in meters |
| Width Segs | widthsegs | 1 | 1 ~ 128 | Divisions along X |
| Depth Segs | depthsegs | 1 | 1 ~ 128 | Divisions along Z |
| Height Segs | heightsegs | 1 | 1 ~ 128 | Divisions along Y |
A negative Height grows the box downward from the pivot. A value of 0 is clamped to the minimum thickness (0.01).
How to create
-
Press and drag in empty space. The rectangle you drag becomes the base footprint (Width × Depth).
-
Click to confirm the base, then move the mouse up to set the Height.
-
Click again to finish.
Scene view editing
An arrow handle sits on each of the six faces. The X handles drive Width, the Z handles Depth and the Y handles Height. A plain drag pins the opposite face in space and moves the pivot; a Shift drag grows both sides symmetrically around the center.
Tips
Only raise the segment counts when you need them — all three axes at 128 produces roughly 98,000 faces on a single object.
For thin wide slabs such as walls and floors, you can also turn on Collider Mode and use the shape as collision-only geometry.
Script
In a script this shape is written as box.
box "Crate" w=1 h=1 d=1 @0,0,0
box "Wall" w=4 h=3 d=0.2 widthsegs=4 heightsegs=3 @0,0,2
See also — Shape Type List · Creating Shapes and Modes · Scene Script Syntax
