Building node

building

Procedural building massing model with a real facade: walls split into bays with recessed windows (glass, sills, frames, mullions), a ground storey with shop windows or an entrance door with canopy, string-course ledges between storeys, plinth, and a roof (flat with parapet and rooftop plant boxes, or gable / hip / shed with overhang). Without input it builds one width x depth building centred at the origin standing on y=0. With input 0, one building is built per closed polygon (footprints are read in X/Z, base at the polygon's lowest Y); prim attributes 'floors' (int) or 'height' (float, metres) on footprint prims override the floor count. Output prim attribs: name ('bldgN/facade', '/roof', '/ledges', ...), material (wall, glass, frame, trim, roof, door, metal) and Cd. Detail attribute building_height. Typical: floors 3-8, detail=high for close-ups, low for many buildings.

Inputs

Parameters 27

widthfloat
Default 14Range 1 to …

Footprint size along X (when no footprint polygon is connected).

depthfloat
Default 11Range 1 to …

Footprint size along Z (when no footprint polygon is connected).

floorsint
Default 5Range 1 to 200

Number of storeys. 1-3 houses, 4-8 apartment blocks, 15-60 towers.

floor_heightfloat
Default 3.2Range 2 to …

Storey height in metres (3.0 residential, 3.6-4 offices).

ground_heightfloat
Default 4Range 2 to …

Height of the ground storey (taller for shops/lobbies).

ground_floormenu
Default shopOptions shop door windows none

Ground storey style: shop = big shop windows with sign band and an entrance on the front side; door = entrance + normal windows; windows = like upper floors; none = blank plinth.

module_widthfloat
Default 2.7Range 0.8 to …

Target width of one facade bay (window module); each wall is divided into a whole number of bays.

window_widthfloat
Default 0.55Range 0.05 to 0.95

Window width as a fraction of the bay width.

window_heightfloat
Default 0.55Range 0.1 to 0.9

Window height as a fraction of the storey height.

sill_heightfloat
Default 0.9Range 0 to …

Window sill height above the storey floor (m).

recessfloat
Default 0.18Range 0 to …

How deep windows sit into the wall (m) - gives depth/shadow.

frame_widthfloat
Default 0.07Range 0.01 to …

Window frame profile width (detail=high).

door_widthfloat
Default 1.6Range 0.6 to …

Entrance width (m).

ledgestoggle
Default on

Horizontal string-course ledges between storeys.

ledge_heightfloat
Default 0.22Range 0.01 to …

Ledge thickness (m).

ledge_depthfloat
Default 0.12Range 0 to …

How far ledges stick out (m).

roofmenu
Default flatOptions flat gable hip shed

Roof type. Pitched roofs (gable/hip/shed) need a rectangular 4-point footprint, otherwise flat is used.

roof_heightfloat
Default 3Range 0 to …

Ridge height above the top storey for pitched roofs.

overhangfloat
Default 0.4Range 0 to …

Eave overhang of pitched roofs (m).

parapet_heightfloat
Default 0.9Range 0 to …

Flat roofs: parapet wall height (0 = none).

rooftop_unitsint
Default 3Range 0 to 50

Flat roofs: number of AC/plant boxes on the roof.

detailmenu
Default highOptions low medium high

Facade detail: low = flat walls with glass panels (cities, ~2 polys/window), medium = recessed windows + sills, high = adds frames, mullions, lintels.

random_colorstoggle
Default on

Pick wall/trim/frame/roof colours from a palette by seed.

wall_colorcolour
Default [0.76, 0.7, 0.6]

Wall colour when random_colors is off.

seedint
Default 0

Variation seed (colours, rooftop units).

translatevector 3
Default [0, 0, 0]

Position of the generated asset

rotate_yfloat
Default 0

Rotation around Y in degrees

Use it

Add it from the node menu (right-click empty graph space or Tab, then type building), ask the AI for it by name, or add it with a graph op from the API or MCP:

{"op":"add","type":"building","name":"my_building","params":{},"inputs":["src"]}

Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.