> For the complete documentation index, see [llms.txt](https://superior-worlds.gitbook.io/superior-worlds/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://superior-worlds.gitbook.io/superior-worlds/product-guides/world-builder.md).
# World Builder
Introducing Worldbuilder, a lightweight package that streamlines your terrain sculpting workflow from Quadspinner's Gaea terrain/heightmap generator to creating rich Unity worlds with vegetation scattered via heatmaps. Worldbuilder empowers artists and detail-oriented enthusiasts, offering a familiar concept called Layers, similar to Photoshop layers. These layers subdivide biomes into ecosystems or smaller zones, allowing you to sculpt vast environments with artistic freedom and simulate vegetation using realistic growth patterns from Gaea's node-based carving and mapping tools.
\
Non-Destructive?World Builder is part of a Gaea-to-Unity workflow that can be described as an iterative process with procedural stages that are inherently 'undoable.' Unlike the traditional concept of 'non-destructive' editing, it embraces a unique approach, more akin to working with clay rather than Lego bricks.
\
How it Works:Simply load your terrain with trees and detail objects, then use the World Builder Editor to establish layers by providing data masks or heatmaps for object placement. Trees and details are placed based on these samples, with density calculated using the Poisson Disk Sampling algorithm. This ensures precision and predictable scattering, allowing you to create layered forests, flourishing riverbanks, rocky beaches, riverbeds, and more.
Cooperation, not Replacement:Worldbuilder seamlessly integrates with Unity's default terrain tools, enhancing their functionality without replacing them. Embrace Gaea's Arboreal, Growth, and Vegetation nodes to create realistic vegetation masks and unlock endless possibilities. Unity's familiar toolset for placing or removing individual elements remains fully available.\
Version 1.0 Limitations
* Single terrain per scene. Multiple are possible with some extra work. Refer to PDF Documentation for details.
* 2km x 2km maximum terrain size - performance limited. Results may vary.
* Handpainting using the Unity Tools has some caveats. See documentation.
* Tested with 1024x1024 resolution heat maps. Please report issues with other resolutions.
\
I Challenge YouIf you are serious about your environments, give it a shot today. Let your imagination run wild as you work with clay and put your wildest imagination to the test. Best of all, everything in this workflow is free! I give my thanks to God for without his grace this project would not have come to pass.
\
Start Building Today:Download Gaea's free community version at the link below and embark on this powerful and innovative world creation journey.
\
---
# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.
## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.
Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:
```
GET https://superior-worlds.gitbook.io/superior-worlds/product-guides/world-builder.md?ask=&goal=
```
`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.
Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.