Hello 👋
I’m excited to share Godot SceneBuilder — a powerful addon for Godot 4 that revolutionizes how you work with 3D meshes. Whether you’re building vast environments or intricate structures, this tool will save you time and boost performance.
What Does It Do?
SceneBuilder lets you:
- Procedurally scatter meshes in circles, grids, or custom patterns.
- Create spirals (perfect for staircases or organic structures) with adjustable height, turns, and radius growth.
-
Merge instances into a single
MeshInstance3DusingSurfaceTool, drastically reducing draw calls and improving performance. - Extend functionality with your own GDScript algorithms — no core modifications needed!
Why You’ll Love It
-
Editor-native: Runs entirely within Godot Editor (
@tool). -
Smart rotation: Align instances to face the center or follow tangents using
atan2. - Flexible: Override materials, tweak transformations, and create custom scatter patterns.
- Performance-focused: Merging meshes means fewer draw calls — ideal for complex scenes.
Get Started in 4 Steps
- Download the repository.
- Copy
addons/scenebuilderinto your project’sres://directory. - Enable the plugin in Project > Project Settings > Plugins.
- Add a SceneBuild node, assign a mesh, pick a pattern (e.g.,
CircleorGrid), adjust parameters, and click Build!
Go Advanced: Custom Functions
Want unique patterns? Edit ScatterFunctions.gd to define your own logic. Pass arguments directly from the Inspector — supports floats, booleans, and strings. Example:
static func my_custom_shape(amount: int, distance_to_center: float, ...args) -> Array:
var points = []
# Your magic here
return points
Then select Custom in the editor, set your function name, and pass args like true, 5.5, "hello".
Visuals & Docs
Check out the GitHub repo for screenshots and detailed configuration guides.
License & Support
- License: MIT (feel free to use and modify).
- Support: Star the repo on GitHub to help others discover it!
Follow me for more Godot tools:
Happy developing! 🚀
Top comments (0)