Nature node
forest
Populate a terrain with trees and rocks. Input: a heightfield (from heightfield/hf_* nodes) or a mesh. Positions are scattered by density, thinned by min_distance, limited by slope, a normalised height band (tree line), an optional mask layer and an 'avoid' layer (rivers, roads). A few unique tree variants per species are generated once and instanced with random yaw and scale, so 500 trees cook in a few seconds. Output prim attribs: name ('pine_1/leaves', 'rock_0', ...), material (bark, leaf, rock), Cd, instance (int). Detail attribs trees, rocks. Terrain is passed through.
Inputs
- 0terrain (heightfield or mesh)
Parameters 18
speciesstringComma-separated tree species to mix (oak, pine, birch, palm, dead). Repeat a name to weight it, e.g. 'pine,pine,oak'.
densityfloatTrees per hectare (10,000 m2) before slope/mask rejection. Natural forest 200-600, open woodland 30-80.
max_treesintHard cap on the number of trees.
min_distancefloatMinimum spacing between trunks (m).
slope_maxfloatNo trees on slopes steeper than this (degrees).
height_rangevector 2Allowed band of normalised terrain height (0 = lowest, 1 = highest point): upper value acts as the tree line.
maskstringOptional density mask layer (heightfield) or point attribute (mesh), 0..1.
avoidstringOptional layer where trees must NOT grow (value > 0.3), e.g. 'river', 'project' (roads). Ignored if missing.
altitude_speciestoggleConifers (pine) favour high ground, broadleaf trees low ground.
scale_rangevector 2Random uniform scale per tree.
variantsintUnique tree meshes generated per species (instances are copies with random rotation/scale).
detailmenuTree mesh detail (low recommended for >100 trees).
rock_ratiofloatRocks scattered per tree (also on steeper slopes up to slope_max + 15).
outputmenumesh = full tree/rock geometry; points = only instance points (P, orient, pscale, species, variant, up) for copy_to_points.
keep_inputtogglePass the terrain through together with the forest.
seedintRandom seed.
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 forest), ask the AI for it by name, or add it with a graph op from the API or MCP:
{"op":"add","type":"forest","name":"my_forest","params":{},"inputs":["src"]}Any parameter can also be an expression such as "=sin(F*0.1)". See Parameters & expressions.