Umi WaterOverviewGetting startedSamplesComponentsScriptingFAQLimitsCore vs ProChangelog

Umi Water — samples

How to start, then what each sample shows. The first steps with your own scene are in Getting started; trouble — FAQ.

1. Which samples you get

11 scenes in four samples: Package Manager > the package > Samples > Import (or Welcome > Import samples); they land in Assets/Samples/<package>/<version>/. Umi Water's Common sample holds the free camera, the sample look (sky, post), the lit materials, the sounds and tuned PC / Mobile URP assets every scene uses: importing any other Umi sample imports it too. Each folder has its own assembly: a Core-only project compiles the Core samples without Pro or Boats.

ModuleSceneShowsStart here if you want
Common—FreeCamera, SampleLook, DemoSpawner, WaveProfileSwitcher, materials, sky(imported with any sample)
CoreIslandLakeisland, lake and infinite sea, voxel floatersthe first look at the asset
CoreWaveProfilesGerstner waves, three profiles, floaters, buoystune waves, see buoyancy
CoreFloatingObjectsfloaters of different density, beach, a waderbuoyancy on your own objects
CoreUnderwaterunderwater fog, a boat with a WaterMask cockpita camera below the surface
ProOpenOceanFFT ocean, four sea statesa realistic ocean
ProRiverAndLakespline river, waterfall, rapids, muddy water, soundrivers
ProInteractiveRipplesripples from a swimmer and thrown objectscharacters in water
ProUnderwaterEffectscaustics, light shafts, particles, lens dropsunderwater look
ProReflectionsscreen-space + planar reflection (P)reflections
ProShorelinewaves fading on a beach, shore waves, foambeaches
BoatsBoatSeaTrialdrivable speedboat, mesh vs voxel hullsboats

Requirements: Unity 6000.0+, URP with Depth Texture and Opaque Texture on (Window > Umi Water > Setup Check fixes it), the Input System or the old Input Manager (both work). Pro's FFT ocean and ripples need compute shaders: desktop, not WebGL / GLES3; on phones they are off by default (Allow On Mobile).

2. Controls (every scene)

KeyDoesWhere
RMB + mouselookevery scene (free camera)
W A S D, Q / E, Shiftmove, down / up, fastfree camera
Fthrow a floating object from the cameraevery scene (in BoatSeaTrial it is a mesh-model object)
1 2 3 (4)switch wave profile / sea statescenes with a switcher
N, Bnight (torch); the foam's bioluminescence (on its own)IslandLake
Pplanar reflection on / offReflections
Gdrop an object at the river's sourceRiverAndLake
↑ ↓ ← → (W S A D)throttle / steerBoatSeaTrial (WASD only while the free camera is off)
X, R, Cengine idle, reset boat, chase / free cameraBoatSeaTrial

The sample panels and labels are drawn with IMGUI (OnGUI), which allocates garbage every frame: it is fine for a demo, not a pattern to copy into a game (use uGUI or UI Toolkit there). The scene selector in the main toolbar (and Welcome > Open a demo scene…) opens any imported sample.

3. The samples

Format: Hierarchy object → component → the setting that matters (why).

Core

IslandLake — a lake in an island's hills and an infinite sea around it, both on Core's material (Umi/Water).

WaveProfiles — one surface, three Gerstner profiles. Water → WaterSurface (resolution 320; profile Moderate).

FloatingObjects — flat water, a tilted beach, floaters of different density.

Underwater — Core's underwater fog, no add-on. Shallow seabed with sunken crates and pillars.

Pro

OpenOcean — Ocean → WaterSurface + WaterInfinite + WaterOcean (FFT; Spectrum asset) + WaterEffects.

RiverAndLake — Water → WaterSurface + WaterShore (water depth baked into a water map asset, so the scene does not bake when it loads) + WaterEffects.

InteractiveRipples — still water: every wave is made by something. Water → WaterSurface (profile Flat) + WaterInfinite + WaterRipples (a height-field simulation around the camera) + WaterEffects.

UnderwaterEffects — the same scene as Underwater with WaterEffects: caustics on the seabed, light shafts, underwater particles, lens drops when the camera leaves the water. The skiff's WaterMask still works with them.

Reflections — a row of tall pillars, a jetty, a far island.

Shoreline — Water → WaterSurface (profile Moderate) + WaterShore (Shore Adaptation: depth baked from the ground; Shore Waves on: height 0.8 m, period 6 s, start depth 6 m).

Boats

BoatSeaTrial — infinite sea, a drivable speedboat on HullHydrodynamics (the mesh model: buoyancy per triangle, planing, drag, wake, spray). Core + Boats only.