Godot engine addon to randomly fill an area with props or other scenes. Mirror of https://codeberg.org/hungryproton/proton_scatter
GDScript
3,009
347 commits
updated Sep 27, 2026
Place anything you want in your scenes, in a procedural, non-destructive way.
This is an add-on for Godot 4, which automates the positioning of assets in a scene. If you have a lot of props to place, and you would rather not do it by hand, ProtonScatter may be useful to you.
| Placing grass on arbitrary geometry | Editing the showcase scene |
The showcase scene composition was entirely done using ProtonScatter. First, large rocks are randomly placed within an area, then trees, grass and other details are projected onto the rocks' colliders surface.
The basic setup is as follows:
A ProtonScatter (1) node holds the positionning rules (2) that can be edited in the inspector. This panel is very similar to Blender's modifier stack panel. Some modifiers create points, others change their transforms. You mix different modifiers in order to obtain the result you need.
One or more ScatterItem nodes to select which asset you want to place.
One or more ScatterShape items to define the area where the scattering happens.
 |  |  |
|---|---|---|
| Placing items aligned on a grid | Placing items randomly | Placing items along an edge |
Scatter currently ships with three shape types: Box, Sphere and Path. They can be combined to create more complex shapes. Notice how in the last example, the box is shown in red. This means the shape is marked as 'negative' and new items won't appear inside.
 |  |  |  |
|---|
Most of the examples above placed items on the floor or on a flat plane, but nothing stops you from using the full 3D space. The mushrooms are placed in the space, then projected in a random direction until they hit a tree. The tower in the background is done by stacking individual bricks using two array modifiers.
v3 branch and install it from there.ProtonScatter node and look at the Modifier Stack in the inspector.Doc button in the top right corner. Click it to access the built-in documentation.
demo folder:
(top 24 of 61)
1,791 followers · starred Nov 2022
678 followers · starred May 2023
901 followers · starred Mar 2023
966 followers · starred May 2023
Godot engine addon to randomly fill an area with props or other scenes. Mirror of https://codeberg.org/hungryproton/proton_scatter
GDScript
3,009
347 commits
updated Sep 27, 2026
Place anything you want in your scenes, in a procedural, non-destructive way.
This is an add-on for Godot 4, which automates the positioning of assets in a scene. If you have a lot of props to place, and you would rather not do it by hand, ProtonScatter may be useful to you.
| Placing grass on arbitrary geometry | Editing the showcase scene |
The showcase scene composition was entirely done using ProtonScatter. First, large rocks are randomly placed within an area, then trees, grass and other details are projected onto the rocks' colliders surface.
The basic setup is as follows:
A ProtonScatter (1) node holds the positionning rules (2) that can be edited in the inspector. This panel is very similar to Blender's modifier stack panel. Some modifiers create points, others change their transforms. You mix different modifiers in order to obtain the result you need.
One or more ScatterItem nodes to select which asset you want to place.
One or more ScatterShape items to define the area where the scattering happens.
| | |
|---|---|---|
| Placing items aligned on a grid | Placing items randomly | Placing items along an edge |
Scatter currently ships with three shape types: Box, Sphere and Path. They can be combined to create more complex shapes. Notice how in the last example, the box is shown in red. This means the shape is marked as 'negative' and new items won't appear inside.
| | | |
|---|
Most of the examples above placed items on the floor or on a flat plane, but nothing stops you from using the full 3D space. The mushrooms are placed in the space, then projected in a random direction until they hit a tree. The tower in the background is done by stacking individual bricks using two array modifiers.
v3 branch and install it from there.ProtonScatter node and look at the Modifier Stack in the inspector.Doc button in the top right corner. Click it to access the built-in documentation.
demo folder:
(top 24 of 61)
1,791 followers · starred Nov 2022
678 followers · starred May 2023
901 followers · starred Mar 2023
966 followers · starred May 2023