Foliage

Foliage is the mode for planting trees, grass, flowers and rocks on the ground. Scatter inside the brush circle, or over a whole selection at once. You can also set a shape with the tree and rock generator and place them one at a time. If you have painted biomes, foliage that matches each cell’s biome is chosen.

How to open

Method	Description
Main toolbar	Press the Foliage (scatter) button in the mode row.
Landscape mode	Choose Scatter from the Mode list in the Terrain · water section.

Foliage mode has no default shortcut.

Quick start

Enter Foliage (scatter) mode.
In Stacks (the scatter set), choose one of Forest (oak · birch), Meadow, Flower field or Rock.
Set the Radius. The brush circle appears in the viewport.
Click the ground. It scatters inside the circle.
For a large area, select a region and press Scatter in selection.

One scatter is one undo step. Results go into the Outliner’s Foliage folder as Foliage actors per kind. Names have the form 흩뿌리기/<group>, such as 흩뿌리기/나무 · 흩뿌리기/풀, and the same group is gathered into one actor.

Placing a single tree

Choose a tree or rock in Preset of the Tree · rock generator section.
Shift+click the ground. One is placed at that spot.

Planting on floors under a ceiling

Since 0.9.11: When you click a floor under a ceiling such as a floating slab or overhang, plants go on that floor.

Previously, scattering and Shift+click single trees were planted on the topmost ground of the column (on top of the ceiling). Now the clicked layer is used as the reference. Ordinary terrain with nothing above works as before. The Landscape height brush and green ghost use the same reference.

Scatter rules

Points are drawn evenly while keeping a minimum spacing (Poisson disk). For each drawn point, the conditions below are checked.

Condition	Description
Density	Only this fraction of the spots is actually planted.
Max slope°	Nothing is planted where it is steeper than this.
Ground types	Plants only on these blocks. If empty, plants on any ground.
Height limit	When on, plants only between Min height and Max height.

If a point passes the conditions, one entry is chosen from the Entry list by Ratio. Block groups are rotated in 90° steps; props are placed with random rotation and size.

Since 0.9.4: Blocks written without a state (such as grass_block in imported maps) also match the Ground types condition.

Default sets

Set	Min spacing	Density	Max slope°	Ground types
Forest (oak · birch)	6	1	35	Grass block · dirt
Meadow	1.5	0.7	45	Grass block
Flower field	2	0.6	40	Grass block
Rock	8	0.8	50	(any ground)

Share sets as JSON files (np-terrain-scatter) with Load… and Save…. Saving checks spacing, density, height range and empty entries, and does not save if there is a problem.

Editing entries

Add and edit entries with the buttons below the Entry list.

Button	What it does
Block · Tree · Rock · Prop	Adds a new entry of that kind.
Duplicate · Delete · Up · Down	Duplicates, deletes or reorders the selected entry.

Choose an entry to edit it below.

Set Name, Group (tree · grass · flower · rock · prop · other) and Ratio. The group becomes the result actor’s name.
For a block group, write one line = dx dy dz block in the text field and press Apply blocks. dy 0 is directly above the ground.
For a prop, set Prop id, Min size, Max size and Random rotation.

To add a prop, check its prop id in the Content Browser, type it in the Prop id field, and press Add prop. For importing props, see Importing custom models.

Foliage by biome

When Follow biomes is on (default on), each cell is scattered with the foliage set of the biome at that spot. Paint biomes with Biome paint in Light and biomes.

At biome borders, the two sets blend over Biome border blend blocks. Farther from the border, each biome’s own set is used.
Biomes may have different minimum spacing. At borders, the sparser spacing is used.
Biomes without a set, and areas with no painted biome, use the Entry list above as is.
One line at the bottom of the panel shows the biome link status.

The following 27 biomes have biome sets.

Plains · Sunflower Plains · Meadow · Forest · Flower Forest · Birch Forest · Old Growth Birch Forest · Dark Forest · Pale Garden · Taiga · Snowy Taiga · Old Growth Spruce Taiga · Old Growth Pine Taiga · Snowy Plains · Desert · Badlands · Savanna · Jungle · Bamboo Jungle · Swamp · Mangrove Swamp · Cherry Grove · Mushroom Fields · Windswept Hills · Beach · River · Ocean

Tree · rock generator

The generator starts with presets for 7 trees (oak · birch · spruce · jungle · cherry blossom · ancient · fantasy) and 7 rocks (gray boulder · mossy boulder · flat slab · rock pile · sandstone rock · standing stone · basalt pile).

Choose one in Preset.
When you change values, the pictures below (side · front) update immediately. The size and block count are shown too.
See a different shape with the same values with Another variant.
Press Add to scatter to put N variants into the Entry list. Entries with the same name are updated.
Or Shift+click the ground to place just one.

Option	Description
Name · Seed · Variants (1 – 16) · Ratio	Common values. The same seed gives the same shape.
Tree: Type · Log · Foliage · Decor · Accent ratio	Tree type and blocks used. The log axis is automatic.
Tree: Trunk (Height · Height ± · Thickness 1 – 3 · Bend)	Trunk shape. Height goes up to 48.
Tree: Branches (Branch count · Angle° · Length (× trunk) · Start height)	Branch shape.
Tree: Foliage (Shape · Radius · Height (ellipsoid · layered) · Density · Leaves at branch tips)	Leaf mass. Shape is sphere · ellipsoid · layered (cone); radius goes up to 10.
Tree: Roots (Root count · Root length)	Roots spreading from the base.
Rock: Preset values · Type	Type is boulder · rock pile · standing stone (pointed).
Rock: Size (diameter) · Elongation · Flatness · Roughness · Pattern scale	Rock shape. Diameter goes up to 24.
Rock: Material · Sort by brightness · Boundary noise	List of materials that change from bottom → top. Sort by brightness puts darker ones at the bottom.
Rock: Moss ratio · Moss block · Small stones (pile) · Embed depth	Finishing values.

Duplicate, delete, load and save the preset list with the icon buttons.

Options

Option	Range	Default	Description
Stacks (set)	Forest (oak · birch) · Meadow · Flower field · Rock	Forest	Starting set. Choosing one changes the values and entries below.
Radius	1 – 256	16	Radius of the circle scattered per click.
Follow biomes	On/Off	On	Uses the set matching each cell’s biome.
Biome border blend	0 – 32	6	Blend width (blocks) at biome borders.
Min spacing	0.5 – 64	Set value	Minimum distance between planted items.
Density	0 – 1	Set value	Fraction of drawn spots actually planted.
Max slope°	0 – 90	Set value	Nothing is planted where it is steeper than this.
Seed	0 – 99999	1	The same seed and spot give the same result.
Ground types	Block list (comma-separated)	Set value	Example: `grass_block[snowy=false], dirt`. If empty, any ground.
Height limit · Min height · Max height	−64 – 320	Off	When on, plants only within this height range.

Shortcuts

Key	Action
Click	Scatter inside the brush circle
`Shift`+click	Place one of the current generator preset
`[` · `]` (or `-` · `=`)	Radius −1 · +1. `Shift` = larger step
`Ctrl`+`Z`	Undo the last scatter

Tips / cautions

For a dense forest, mix a few tree entries with grass entries and make the minimum spacing small.
If trees overlap, raise the minimum spacing to about twice the tree’s leaf radius.
The rock generator covers the original ground only for its Embed depth. Other cells are placed only in empty cells.
A single item over 60,000 blocks is cut off. If an error appears in the info line below the preview, reduce the values.
Scattered Foliage actors can be hidden or deleted per kind in the Outliner.