Changelog
Umi Water, Umi Water Pro and Umi Boat Physics ship with one version number; the changes of all three are here. Update all Umi packages together.
[0.36.0] - 2026-11-19
The first version for the Asset Store.
Packages
- Umi Water (
dev.fatalbug.water, free): Gerstner waves,WaterSurface(finite water) andWaterInfinite(open sea to the horizon), theUmi/Watershader with underwater fog, voxelBuoyancy,WaterInteractor,WaterParticles,WaterMask, look presets, quality levels,WaterTime(one wave clock for every client), Setup Check, Welcome window, Scene view overlay. - Umi Water Pro (
dev.fatalbug.waterpro): FFT ocean, shores and shore waves, rivers (Unity Splines) with waterfalls and rapids, interactive ripples, caustics, light shafts, planar reflection, theUmi/Water Proshader with SSR. - Umi Boat Physics (
dev.fatalbug.waterboats):HullHydrodynamics. - Pro and Boats need Umi Water of the same version; a mismatch is named in one console error and in the Setup Check.
Samples
- Package Manager > Samples: Common and Core Samples (Umi Water), Pro Samples, Boat Sea Trial (11 scenes). Importing any sample imports Common (shared scripts, sky, materials, sounds, tuned PC / Mobile URP assets). The Welcome window has Import samples and lists the imported scenes.
Documentation
- Online documentation at https://docs.fatalbug.dev/umi-water/ (also
Documentation~in each package): getting started, samples, components (every inspector's Documentation link and the?button open the section of its component), scripting, FAQ, known limits, Core vs Pro.Third-Party Notices.mdin each package. - The Welcome window lists the Umi add-ons and where to get them.
Behaviour
Buoyancysettles in 2–3 bobs (Radiation Damping, default 0.2) and rides the waves' orbits (Wave Push, default 1); set both to 0 for the plain Archimedes behaviour.- Setup Check: Info when Play shows a quality below High (the Android / iOS build target is Low) and when an XR package is installed; a warning when
Buoyancy/HullHydrodynamicssits on a kinematic or trigger-only body; an error when URP Compatibility Mode is on (the water's passes run in the Render Graph only). Umi/Water Procompiles without warnings in a player build.
API
- The query API is
WaterSurface.TrySample,TrySampleAny,SampleAnyandDisplace; extensions of your own derive fromWaterSurfaceExtensionand override its render hooks. The editor helpers, the surface role interfaces and the plumbing between the modules areinternal.