Three.js Water Pro V3: Multiplayer Ocean Physics, WebGPU Foam, and Real Rain

On June 5, 2026, Dan Greenheck released Three.js Water Pro V3 — the most feature-complete ocean rendering library available for the web. V3 is a major quality-focused update that rewrites the wave simulation core, adds multiplayer-ready determinism, and introduces a set of visual effects that were simply impossible in V2.

The Core Change: Deterministic Waves

In V2, wave simulation ran on the client's frame rate. Two players in the same game would see slightly different wave states, making synchronized physics — a boat's buoyancy, a floating object's position — unreliable. V3 replaces this with a fixed-step simulation engine paired with a tick-sync primitive. Two clients receiving the same seed and tick count will produce identical wave state, making networked ocean interactions consistent for the first time.

WebGPU Foam

Persistent wave-crest foam is V3's most visually striking addition, and it requires WebGPU to run. As waves break, foam accumulates at the crest and slowly dissipates as it rolls off — matching the behavior you see on any real ocean or large lake. This is the kind of effect that previously required a dedicated engine like Unreal or Unity; it now works in a browser tab.

New Effects

  • Sea spray emitters: Up to 16 emitters and 32 probes, attachable to scene objects like boat hulls. Spray responds to wave amplitude and emitter velocity.
  • Rain: Wind-driven rain streaks with corresponding ripple patterns on the water surface. The two systems are physically linked — wind direction affects both.
  • Sun-shadow caustics: Shadow-casting objects now block the caustic light patterns on the seafloor, so a hull or a rock creates a realistic shadow in the dancing light below.

Improved Wave Realism

The underlying wave spectrum was also updated. The previous version produced waves with a mechanical regularity that looked fine in demos but felt artificial under close inspection. V3's updated spectrum generates more organic, irregular patterns — chop, swell, and cross-sea states all look meaningfully different from one another.

Breaking Changes

V3 ships with several breaking API changes. The wave simulation constructor signature changed, the foam system requires explicit WebGPU renderer detection, and the emitter attachment API is new. Greenheck has published a migration guide alongside the release.

Why This Matters for Web 3D

Three.js Water Pro V3 is a signal of where web-based 3D rendering is heading. With WebGPU now production-ready in all major browsers — Chrome, Firefox, and Safari 26 — techniques that were GPU-compute-only are landing in JavaScript libraries for the first time. What used to take a specialized game engine is becoming accessible to any web developer who can npm install a package.

For game developers, simulation builders, and interactive artists working with Three.js, V3 sets a new baseline for what water in a browser can look like.