Spread Node
- Category: General
- Edition: All editions
- Output type: Positions
- Typical place in a graph: after a set of positions, to turn each one into a small cluster
Spread turns each position into a cluster: it adds 7 or 15 new positions around every point, at random directions and distances. Applied to a grid it gives the clumps that natural vegetation grows in, a mother tree with saplings around it, a boulder with smaller rocks. Scatter includes the same step as its Spread Count and Spread Distance.

When to use it
- Clumps of trees, bushes, flowers or rocks from a sparse set of points.
- More points around hand placed or spawned positions, such as rubble around ruins.
- Not for: thinning points (use Thin Out); moving points by a map (use Offset).
Inputs
| Slot | Type | Required | What to connect |
|---|---|---|---|
| Positions | Positions | Yes | The points to spread from. With nothing connected, nothing comes out. |
| Distance | Mask | No | Scales Distance at each source point: tight clusters where it is dark, wide ones where it is bright. |
Outputs
| Slot | Type | What it holds |
|---|---|---|
| Output | Positions | Each source point followed by its new points. New points share their source's validity, so points already removed stay removed. |
Properties
| Property | Default | Range | What it does |
|---|---|---|---|
| Count | 7 | 0, 7 or 15 | New points per source point. Other values snap to one of these: 1 to 8 become 7, 9 to 15 become 15. |
| Distance | 0.05 | 0 to 1, fraction of the biome width | How far new points may land: each between a fifth of this and all of it, in a random direction. 0.05 is about 50 m on a 1 km biome. |
| Seed | 0 | Any integer | Picks other random directions and distances. It is combined with the biome's seed. |
| Keep Source Points | On | On, Off | Off removes the original points, leaving only the cluster around where they were. |
Common properties
| Property | What it does |
|---|---|
| Id | The node's unique name in this graph, shown for reference. You cannot edit it. Scripts and the AI workflow CLI use it to find the node. |
| Split Execution | Lets this node run over several frames so the editor stays responsive during long generations. It only works when Allow Split Execution is on in the graph settings. This node finishes in one step, so splitting only adds a short pause around it; leave it off. |
| Bypass | Skips the node. The positions pass through unchanged. |
Examples
All examples spread a Points grid (100 m) on a 1024 × 1024 m biome, shown through Dots and Expand.
| Source grid | Count 7, Distance 0.05 |
|---|---|
![]() |
![]() |
| Count 15 | Count 15, Distance 0.1, Keep Source Points off |
![]() |
![]() |
With a small Distance each grid point becomes a tight clump and the grid still shows. At 0.1 (about 100 m, the grid spacing) the clusters overlap and the grid disappears.
Recipes
- Natural forest: Points → Spread → Thin Out with a forest mask → Tree Output.
- Tighter clumps on poor ground: a soil mask into Distance, so clusters spread wide on good soil and stay tight on poor ground.
Note
The output is 8 or 16 times the size of the input. Spreading an already dense set multiplies the cost of everything after it.
Tip
A Distance close to the spacing of the source points hides their grid.
Performance
Very cheap: one quick GPU step. The cost is in the larger number of points afterwards.
Related nodes
For AI agents
- Type name:
SpreadNode. Inputs Positions =0(Buffer), Distance =1(Mask); Output =100(Buffer). - Properties:
count(snapped to MultipleOf8(clamp(v, 0, 15)) − 1: 0, 7 or 15),distance(0 to 1, fraction of biome width),seed,keepSourcePoints. - Output length = input × (count + 1). New point offset = distance × (distance map) × lerp(0.2, 1, rand) in a random direction.


