Placement

Terrain Surface Locator

Finds floor or ceiling surfaces inside a bounded vertical scan.

placement.locator.vertical_terrain

Terrain Surface LocatorMin Y-16Max Y16Scan orderDescending ⏷SurfaceFloor ⏷Placement cap1

What it does

Find a floor or ceiling at each horizontal placement position. The locator reads the terrain before structures are placed, so a tree cannot land on top of another tree placed by the same world generation.

Set Min Y and Max Y around your terrain, then choose Floor in Surface and Descending in Scan order to look for ground from above. Keep Placement cap low at first so you can see which surface is being selected.

Inputs and outputs

NameTypeDefaultWhat it changes
Inputs
Min YInteger-16The lowest world height included in the search.
Max YInteger16The upper search boundary, excluded.
Placement capInteger1 · 1–2147483647Higher values allow more surfaces to be kept at each horizontal position.
Settings
Scan orderChoiceDescendingChooses whether to search from the top down or the bottom up. One of: Ascending, Descending.
SurfaceChoiceFloorChooses floors under air or ceilings above air. One of: Floor, Ceiling.
Output
OutputPlacement locatorThe empty positions beside the selected terrain surfaces, ready for placement.

Good to know

Include the ground in the search

A locator cannot find a surface outside its height window. Expand the search around the visible terrain before changing the anchor or template.

Search from below for cave floors

A top-down search reaches the highest floor first. Limit the search to the cave height or reverse Scan order when you want an underground surface.

See also