UModeler X MCPis live — model with an AI agent
UModeler X

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

LabelScript keyDefaultRangeDescription
Widthw10.01 ~ 10000Width along local X, in meters
Depthd10.01 ~ 10000Depth along local Z, in meters
Heighth1-10000 ~ 10000Height along local Y, in meters
Width Segswidthsegs11 ~ 128Divisions along X
Depth Segsdepthsegs11 ~ 128Divisions along Z
Height Segsheightsegs11 ~ 128Divisions 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

  1. Press and drag in empty space. The rectangle you drag becomes the base footprint (Width × Depth).

  2. Click to confirm the base, then move the mouse up to set the Height.

  3. 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

Box | UModeler X Manual