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
- On the Asset Store press Add to My Assets; in Unity open Window > Package Manager > My Assets, Download, Import.
- 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.
- 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
- GameObject > Umi Water > Lake or Ocean.
- GameObject > Umi Water > Floating Object, press Play.
- GameObject > Umi Water > Water Particles (once per scene; tag the camera
MainCamera) for splash and wake foam. - Pick a look with Look Preset in the
WaterSurfaceinspector.
Import the samples from Package Manager (this package > Samples) or from the Welcome window: start with IslandLake.
What is in this package
| Module | What 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