Transform Points Node
- Category: General
- Edition: All editions
- Output type: Positions
- Typical place in a graph: after a set of positions, to move, turn or resize the whole set
Transform Points moves, rotates and scales a whole set of positions at once, around the middle of the biome. Use it to turn a grid of rows to a new angle, shift a pattern, or shrink a layout toward the center.

When to use it
- Turn rows of an orchard, a vineyard or a planted forest to a chosen angle.
- Move or resize a set of hand placed points.
- Not for: moving each point by a different amount (use Offset).
Inputs
| Slot | Type | Required | What to connect |
|---|---|---|---|
| Input | Positions | Yes | The points to transform. |
Outputs
| Slot | Type | What it holds |
|---|---|---|
| Output | Positions | The transformed points. Points moved outside the biome are kept in the list but skipped by output nodes. |
Properties
| Property | Default | Range | What it does |
|---|---|---|---|
| Offset | 0, 0 | Percent of the biome size | Moves the set along X and Z. 25 moves it a quarter of the biome. |
| Rotation | 0 | Degrees | Turns the set around the middle of the biome. |
| Scale | 100, 100 | Percent | Resizes the set around the middle of the biome along X and Z. 50 halves the distances. |
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
A Points grid (100 m) on a 1024 × 1024 m biome, shown through Dots and Expand.
| Rotation 30 | Scale 50, 50 | Offset 25, 0 |
|---|---|---|
![]() |
![]() |
![]() |
Rotating a grid that only covers the biome leaves empty corners. Scaling to 50 pulls points from outside the biome into view: Points makes extra points past the biome's far edges, so the shrunk grid fills from a quarter of the way in to the far edges, not just the middle. Moving by 25 leaves an empty strip where the set used to start.
Recipes
- Diagonal orchard: Points (Spacing 8, 12) → Transform Points (Rotation 35) → Thin Out with the orchard area → Tree Output.
Warning
Rotating or shrinking leaves gaps at the biome's edges, and shrinking a Points grid brings in its extra points from past the far edges. Start from a smaller Spacing or a larger area, and cut the result to where you want it with Thin Out.
Performance
Very cheap: one quick GPU step.
Related nodes
- Offset: moves each point by a map.
- Points, Select Position: sets to transform.
For AI agents
- Type name:
TransformPointsNode. Input =0, Output =100(Buffers). - Properties:
offset(Vector2, percent),rotation(degrees),scale(Vector2, percent, 100 = unchanged). - Matrix: translate(-0.5) then TRS(offset / 100, rotation about Y, scale / 100) then translate(+0.5), in biome UV space.
- Points pads its grid past the far edges (multiple of 8 per axis), so scaling below 100 brings padding points inside the biome (measured: Scale 50 filled 0.25 to 1 on both axes).

