Umi WaterOverviewGetting startedSamplesComponentsScriptingFAQLimitsCore vs ProChangelog

Umi Water

Realistic water for Unity 6000.0+ with the Universal Render Pipeline (URP 17.0+): Gerstner waves, a water surface to the horizon, voxel buoyancy, wake foam and spray, underwater fog. Free and complete on its own. Umi Water Pro (FFT ocean, rivers, shores, ripples, caustics, reflections) and Umi Boat Physics (mesh-based hull hydrodynamics) add to it.

Documentation: https://docs.fatalbug.dev/umi-water/ (the same pages are in this package's Documentation~ folder).

Install

  1. On the Asset Store press Add to My Assets; in Unity open Window > Package Manager > My Assets, Download, Import.
  2. Umi Water Pro and Umi Boat Physics need this package of the same version: install Umi Water first, then the add-on. Update all Umi packages together.
  3. Open Window > Umi Water > Welcome (the start page) or Window > Umi Water > Setup Check. In every URP asset Depth Texture and Opaque Texture must be on; the Setup Check does it with one button.

First water

  1. GameObject > Umi Water > Lake or Ocean.
  2. GameObject > Umi Water > Floating Object, press Play.
  3. GameObject > Umi Water > Water Particles (once per scene; tag the camera MainCamera) for splash and wake foam.
  4. Pick a look with Look Preset in the WaterSurface inspector.

Import the samples from Package Manager (this package > Samples) or from the Welcome window: start with IslandLake.

What is in this package

ModuleWhat it has
Umi Water (this package)WaterSurface (finite water, TrySample / TrySampleAny / Displace), WaterInfinite (open sea to the horizon, levels of detail), Gerstner waves (WaveProfile), the Umi/Water shader with underwater fog, voxel Buoyancy, WaterInteractor (a wader, a paddle or any moving object makes foam, spray and ripples), WaterParticles, WaterMask
Umi Water Pro (separate package)FFT ocean, shores and shore waves, rivers with waterfalls, interactive ripples, caustics, light shafts, planar reflection, the Umi/Water Pro shader with SSR
Umi Boat Physics (separate package)HullHydrodynamics: hydrostatics, drag, slamming and wake foam on the hull's triangles

Your code

Ask the water only through WaterSurface:

if (WaterSurface.TrySampleAny(position, out WaterSample sample, out WaterSurface surface))
    Debug.Log($"height {sample.Height}, normal {sample.Normal}, velocity {sample.Velocity}");

Documentation

Getting started · Samples · Components · Scripting · FAQ · Limits · Core vs Pro · Changelog · Third-Party Notices