Home

Welcome to the VaOcean wiki!

UNFORTUNATELY PLUGIN IS DEPRECATED (CAN BE USED WITH UE4.4 ONLY)

Latest release: 0.4-a6-fix1 (09 August 2014)

Attn.!: Demo project is available now!

Overview

VaOcean is the ocean surface simulation plugin for Unreal Engine 4.

The plugin includes:

• Component that renders displacement and gradient (normal) maps in real time
• Sample content, including water shader and grid meshes to be used on scene
• Set of global shaders that perform FFT calculation and other tech stuff on GPU

You can use not only FFT-based ocean shader, but also ocean shader that is just a classic material shader. Check simple ocean setup article to know more!

Features

Some key things you should know about the VaOcean:

• Based on Jerry Tenssendorf’s paper "Simulating Ocean Water"
• Displacement is generated from Phillips spectrum (statistic model), processed by fast Fourier transform
• Spectrum per-frame update, FFT and displacement map generation are performed on GPU (it's really fast!)
• Currently algorythm uses only 512x512 maps
• Ocean shading is running as material shader

Ocean material shader is quite simple, and can be easily extended to fit your requirements. Current shading components:

• Water body color: using near, mid and far color mixed by Fresnel term
• Perlin distance-based noise applied both to normals and displacement to remove pattern tiling artifacts
• UE4 screen-space dynamic reflections. It's not the best way to handle a reflection for waves, but the only one we can use with dynamic objects like warships and VFXs now
• Waves subsurface scattering, based on fake LightVector. To use it right way, you should pass your scene's sun location vector to material instance via blueprints.

Futher improvements are on the way! Energy-based foam, physics body reaction (like FluidSurface in UE3/UDK), splashes and bursts, rigid body swimming simulation and even more!

Installation

1. Download the plugin binaries for the latest release
2. Make a "Plugins" folder under your game project directory, then copy plugin binaries to any subdirectory under "Plugins".
3. Copy global shaders from Shaders/ plugin directory to your engine installation shaders directory (f.e. ./Unreal Engine/4.4/Engine/Shaders).
4. Compile your game project normally. Unreal Build Tool will detect the plugins and compile them as dependencies to your game.
5. Launch the editor (or the game). Plugin will be initially disabled, but you can turn it on in the editor UI.
6. Open the Plugins Editor (Window -> Plugins), search for VaOcean plugin (you can find it in the Environment section) and enable it by clicking the check box.
7. Restart the Editor. The plugin will be automatically loaded at startup.

How To

• Simple ocean setup
• Actor buoyancy setup

You can contribute with your own articles! :)