From a new or existing level to an ocean with shore waves, a lake, a river and a waterfall. Follow the steps in order. Each one points to the chapter with the details.

The demo island: ocean, lagoon, cliff lake, river and waterfalls.

The demo island: ocean, lagoon, cliff lake, river and waterfalls.

1. Turn on the plugins

You need Unreal Engine 5.6 or newer. We build and test in 5.6.

Turn these on in Edit > Plugins, then restart the editor.

Plugin Why New project default
Procedural Content Generation Framework (PCG) Builds the ocean grid and cuts the waterfalls around rocks. Off. Turn it on.
Geometry Script Generate Shoreline scans the terrain with it. Off. Turn it on.
Scriptable Tools Framework The buoyancy editor mode needs it. Off. Turn it on.
Niagara, Python Editor Script Plugin, Editor Scripting Utilities Waves, buoyancy, ripples, Set Up Water and the shader installer use them. Already on once PCG is on.

2. Check the project settings

Set these once in Edit > Project Settings. Type the name in the search box to find each one. The first two need a restart of the editor.

Setting Value What breaks without it
Engine > Rendering > Virtual Textures > Enable virtual texture support On Without it, the shore stays flat and the beach shows no wash.
Engine > Rendering > Postprocessing > Custom Depth-Stencil Pass Enabled with Stencil Glass walls, domes and the water portal don't show the water look.
Engine > Rendering > Translucency > Order Independent Transparency On Foam, mist and splash sheets sort properly over the water.
Engine > Rendering > Software Ray Tracing > Generate Mesh Distance Fields On No foam around rocks and banks on the ocean, lakes and rivers.
Engine > Rendering > Shadows > Virtual Shadow Maps On (recommended) The demo is lit with them. The water itself doesn't need them.

Optional: keep the pearl glow up close

Without this, the underwater pearl lights (chapter 4) fade as you swim close. To keep the glow:

  1. Open Config/DefaultEngine.ini in your project folder.
  2. Find the [ConsoleVariables] section. If it's missing, add it at the end of the file.
  3. Add this line under it: r.LocalFogVolume.GlobalStartDistance=10
  4. Save the file and restart the editor.

3. Check the shader folder

The ocean simulation needs three small shader files in YourProject/Shaders/StylizedWater/, next to the Content folder. A project made from the pack has them already. In any other project, we install them for you:

  1. Add the pack to your project.

  2. Open the editor. On start, EUO_StylizedWaterShaderInstaller checks the folder and writes any missing file.

    When it writes something, it shows a message and asks for a restart.