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
- 0footprints (optional closed polygons)
Parameters 27
widthfloatFootprint size along X (when no footprint polygon is connected).
depthfloatFootprint size along Z (when no footprint polygon is connected).
floorsintNumber of storeys. 1-3 houses, 4-8 apartment blocks, 15-60 towers.
floor_heightfloatStorey height in metres (3.0 residential, 3.6-4 offices).
ground_heightfloatHeight of the ground storey (taller for shops/lobbies).
ground_floormenuGround 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_widthfloatTarget width of one facade bay (window module); each wall is divided into a whole number of bays.
window_widthfloatWindow width as a fraction of the bay width.
window_heightfloatWindow height as a fraction of the storey height.
sill_heightfloatWindow sill height above the storey floor (m).
recessfloatHow deep windows sit into the wall (m) - gives depth/shadow.
frame_widthfloatWindow frame profile width (detail=high).
door_widthfloatEntrance width (m).
ledgestoggleHorizontal string-course ledges between storeys.
ledge_heightfloatLedge thickness (m).
ledge_depthfloatHow far ledges stick out (m).
roofmenuRoof type. Pitched roofs (gable/hip/shed) need a rectangular 4-point footprint, otherwise flat is used.
roof_heightfloatRidge height above the top storey for pitched roofs.
overhangfloatEave overhang of pitched roofs (m).
parapet_heightfloatFlat roofs: parapet wall height (0 = none).
rooftop_unitsintFlat roofs: number of AC/plant boxes on the roof.
detailmenuFacade detail: low = flat walls with glass panels (cities, ~2 polys/window), medium = recessed windows + sills, high = adds frames, mullions, lintels.
random_colorstogglePick wall/trim/frame/roof colours from a palette by seed.
wall_colorcolourWall colour when random_colors is off.
seedintVariation seed (colours, rooftop units).
translatevector 3Position of the generated asset
rotate_yfloatRotation 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.