Gaea Documentation
The documentation is being updated for version 1.3. Some sections may be incomplete.

The Lakes node simulates rainfall on the terrain and creates physically accurate lakes. Even when overriding with custom masks for precipitation, the physics simulation ensures your lakes are as physically accurate as possible using Gaea's erosion engine.

This node has hidden ports. You can access the hidden ports through the connect menus or by dropping a connection in the middle of the node to trigger the auto-connect menu. See Convenience Features.


There are multiple outputs to help you with the post-generation tasks such as colorization, surface separation, and more.

The main output is a heightfield with the lake surface embedded into the terrain.

The Lakes mask gives you an exact hard mask of the water.

The Depth mask gives you the depth of the water bodies. You may sometimes need to use Autolevel to see the depth as it can be quite subtle with smaller water bodies. However, if you use CLUTer to colorize it, using the built in Autolevel option should suffice.

The Shore mask gives you the full coverage of the shore surrounding all water bodies. To avoid mask overlap (which can create aliasing artifacts) the Shore mask contains the water bodies as well. When coloring, you can layer the shore first then the water. (See Color Production-water) Or if you wish to get a shore only mask, then you can subtract the Lakes mask from the Shore output.

The Surface output is not a mask but a heightfield. It is a hidden port only available by dropping a connection on the center of the node and selecting it from the ports menu that pops up.

It gives you just the surfaces of the lakes at their exact altitude. This can be used to create a separate mesh or displacement map for further usage in other applications. Or advanced control (see Controlling Water).

If this is the normal output,

then this is the Surface output visualized as a heightfield.


Flood Control creates a constant amount of water from the bottom up before running the precipitation simulation. This can be used to add extra water to the terrain more efficiently than simply increasing the rainfall. You can also use it bolster the water level of lower lakes while preserving the size of lakes at higher altitudes.

You can Flood Control to create a sea shore as well.

For example, this is our standard Lakes output.

By enabling Flood Control our terrain is flooded first, then additional rainfall occurs adding to the existing water.

If you set Precipitation to 0, and just use Flood Control, you can create lakes in the lower parts of the terrains.

Custom Lake Positions

The optional Rain input allows you define where rainfall occurs. However, since we are dealing with a physics simulation, the mask position needs to be uphill of where you want the lakes to form instead of simply painting a mask of that final destination itself.

If you place a mask up on the tallest peak, the rainfall simulation will occur only here.

And the water will flow downhill and automatically rest in a position where a lake could naturally form with such precipitation.

If you place a mask up in the lowest area with no major slopes:

Then the lake is formed in that low area only. You can see it still goes downhill a bit to a natural resting spot dictated by gravity.

Remember, you can use Flood Control to bolster smaller lake bodies instead of modifying your mask shape or increasing the precipitation simulation.


Lake Formation

PrecipitationThe amount of rainfall that should occur in the precipitation simulation.
Small LakesFavor or discourage smaller lake bodies. Allowing smaller lakes can be useful for creating swampy environments or puddles.
Flood ControlFlood the terrain with a minimum amount of water, in addition to the Precipitation.
Water FloorThe altitude to which water is flooded with Flood Control. You can enter a precise height such as `500m` by right-clicking.

Shore Formation

Shore SizeThe size of the shore surrounding all water bodies created by the node.
Altitude BiasBias the altitude of the shoreline.
Size BiasBias the size of the shoreline.
Snowfall Rivers

Official Website | Discord | YouTube | Instagram | LinkedIn

This documentation is licensed under the MIT License, a very permissive open-source license.