What a lake is

BP_Lake is a flat sheet of water at one height. Use it for ponds, lakes, lagoons and pools.

Its Water Mesh is a plane you scale over the basin. The shoreline is wherever the plane meets the terrain.

The look comes from a material instance of M_Lake. It gives you calm water, heightmap waves or Gerstner waves, crest and shore foam, caustics, sparkles and stars.

Below the surface it can show god rays and dust. Characters leave rings when they wade through it.

The demo's cliff lake. Its water spills over the lip into the waterfall below.

The demo's cliff lake. Its water spills over the lip into the waterfall below.

Place a lake

Heads up: the water doesn't follow the ground. The terrain has to dip below the plane.

  1. Drag BP_Lake into the level.

  2. Set its Z location to the water level.

  3. Scale it so the Water Mesh covers the basin and runs a little way into the banks.

  4. Under 01. Appearance, leave Water Style on DA_WaterStyle_Tropical, the default. It sets Material to MI_Lake_Tropical, the instance the demo's cliff lake uses.

    For a second look, duplicate it or make a new instance of M_Lake, then pick it in Material. Always tune an instance, never the master.

  5. Set Wave Type to match the instance. Set it by hand.

    Buoyancy and the underwater waterline follow this setting.

  6. Use SM_LakeLab_Waves_Large for the Water Mesh, or any plane with a dense grid.

    Waves need a dense mesh. The default engine plane has only four vertices. The demo mesh has 66,000. Shorter waves want a denser mesh.

  7. Turn on the actor's Dampen Shallow Waves if the instance uses it. See "Shallow water" below.

  8. Select BP_WaterManager and press Set Up Water under 01. Setup. The lake now writes its height for buoyancy and the underwater look.

<aside> ℹ️

For floating objects, the lake is the rectangle of its Water Mesh. Islands and holes inside that rectangle still count as water for physics. Keep boats away from them, or build the water from several smaller lakes.

</aside>

Controls on the actor

Control What it does
Water Style (01. Appearance) A style asset that pairs the lake, river and waterfall materials. Picking one sets Material to its lake material. We ship DA_WaterStyle_Tropical.
Material (01. Appearance) The material instance for the water surface. Your own instance stays until you pick a different style.
Wave Type (03. Waves) Match it to the Material (step 5 above).
Dampen Shallow Waves (03. Waves) Match it to Dampen Shallow Waves in the Material. Floating objects and the underwater waterline then use smaller waves near shallow ground.
Use Displacement, Displacement Mesh (02. Mesh) Leave it off. A dense Water Mesh already shows the waves.
Underwater Material, Use Underwater Particles, Underwater Dust Material (04. Underwater) Underwater Material is the lake's underwater profile: the fog and colour while the camera is in this lake. It starts with PPMI_Underwater. Use Underwater Particles shows god rays and floating specks below the surface, and Underwater Dust Material styles the specks. More in chapter 4.
Ripple Interval (05. Interaction) Seconds between checks for things that make rings on this lake.