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

Parameters 18

speciesstring
Default pine,oak,birch

Comma-separated tree species to mix (oak, pine, birch, palm, dead). Repeat a name to weight it, e.g. 'pine,pine,oak'.

densityfloat
Default 40Range 0 to …

Trees per hectare (10,000 m2) before slope/mask rejection. Natural forest 200-600, open woodland 30-80.

max_treesint
Default 600Range 0 to 100000

Hard cap on the number of trees.

min_distancefloat
Default 4Range 0 to …

Minimum spacing between trunks (m).

slope_maxfloat
Default 32Range 0 to 90

No trees on slopes steeper than this (degrees).

height_rangevector 2
Default [0, 0.72]

Allowed band of normalised terrain height (0 = lowest, 1 = highest point): upper value acts as the tree line.

maskstring
Default ""

Optional density mask layer (heightfield) or point attribute (mesh), 0..1.

avoidstring
Default river

Optional layer where trees must NOT grow (value > 0.3), e.g. 'river', 'project' (roads). Ignored if missing.

altitude_speciestoggle
Default on

Conifers (pine) favour high ground, broadleaf trees low ground.

scale_rangevector 2
Default [0.75, 1.25]

Random uniform scale per tree.

variantsint
Default 3Range 1 to 12

Unique tree meshes generated per species (instances are copies with random rotation/scale).

detailmenu
Default lowOptions low medium high

Tree mesh detail (low recommended for >100 trees).

rock_ratiofloat
Default 0.12Range 0 to 5

Rocks scattered per tree (also on steeper slopes up to slope_max + 15).

outputmenu
Default meshOptions mesh points

mesh = full tree/rock geometry; points = only instance points (P, orient, pscale, species, variant, up) for copy_to_points.

keep_inputtoggle
Default on

Pass the terrain through together with the forest.

seedint
Default 0

Random seed.

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