Split Positions Node
- Category: General
- Edition: All editions
- Output type: Positions (2 to 100 outputs)
- Typical place in a graph: after a set of positions, before several outputs, to share one placement between kinds of objects
Split Positions deals each position out to exactly one of its outputs, at random, by weight. Use it to mix species from one placement: one Scatter split three ways into pine, fir and birch, so they never land on the same spot and keep one overall density.

When to use it
- Mix several kinds of tree, rock or prop in one area without overlaps.
- Give one kind a larger share than another, by weight.
- Not for: removing points (use Thin Out); joining sets (use Append).
Inputs
| Slot | Type | Required | What to connect |
|---|---|---|---|
| Input | Positions | Yes | The points to share out. Points already removed stay removed in every output. |
Outputs
| Slot | Type | What it holds |
|---|---|---|
| Output 1 to Output N | Positions | The same list in each, with only that output's share of points valid. Together the outputs hold each input point exactly once. |
Properties
| Property | Default | Range | What it does |
|---|---|---|---|
| Output Count | 2 | 2 to 100 | The number of outputs. |
| Weight 1 to Weight N | 1 | 1 and up, whole numbers | The share each output gets: an output with weight 3 gets three times as many points as one with weight 1. |
| Seed | Random | Any integer | Changes which output each point goes to. It is combined with the biome's seed. |
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. |
Example
A Points grid (60 m) split into 2 outputs with equal weights, each shown through Dots and Expand, packed with RGBA Merge: output 1 in red, output 2 in green. Each grid point is in one output only, about half each.
Recipes
- Mixed forest: Scatter → Split Positions (3 outputs, weights 3, 2, 1) → three Tree Output nodes, one per species.
- Rocks of several sizes: one Scatter → Split Positions → several Object Output nodes with different scale multipliers.
Tip
Splitting one set beats several separate Scatter nodes: the kinds share one spacing and never overlap.
Performance
Very cheap: one quick GPU step per output.
Related nodes
For AI agents
- Type name:
SplitPositionsNode. Input =0(Buffer); outputs100+ i (Buffers), i from 0 to outputCount − 1. - Properties:
outputCount(2 to 100),seed. Weights (1 to 1,000,000) are set per output in the editor (SetWeight(index, weight)); not settable withvista_graphitor_node_set. - Each valid point picks a ticket hash(index, seed) mod totalWeight; ranges of tickets map to outputs. Every output buffer has the input's length; points not chosen are invalid.