Stylized Water 2 documentation

Stylized Water 2

Stylized Water 2
Version: 1.6.8
Review

8.Roadmap #

There really is no shortage of ideas, and there are still plenty of things I want to work on! These are some features that are slated for R&D or are in an early stage. A general design principle if that everything should remain plug & play, and can be disabled entirely to avoid a performance impact for unused features.

I must, however, stress that anything written here is not concrete and subject to change.

The Trello board, used to manage development tasks can be publically viewed here:

Trello Board

Stylized Water 3

The Stylized Water 2 asset was initially released in November 2020. It has been regularly updated and extended through free updates, version 1.0.0 and 1.6.0 are miles apart. Development is purely funded by the purchase of new licenses, instead of the purchase of “update packages”. Which, in the long run, is not sustainable. Unfortunately the asset store ecosystem does not facilitate this, except by splitting versions into separate assets altogether.

In 2024, with the release of Unity 6, future development will branch off into Stylized Water 3, so that users who contributed in 2020-2023 can choose to receive updates onwards in 2024-20xx, and benefit from a range of new features. Whilst SW2 can remain stable and available for projects in the final stages of development. Bug fixes will still be applied, but new features target SW3.

For both the Underwater Rendering and Dynamic Effects extensions, a separate SW3-version will be released. An upgrade for these should be expected, but isn’t guaranteed.

Features slated for Stylized Water 3

  • Revised demo scene, aiming to house all examples in one environment
  • Refractored waves, by using a precomputed set of parameters through the use a “Wave Profile”, this allows using up to 64 individual wave layers
    • Support for waves on rivers.
  • Water decals, a shader graph that snaps geometry to the water surface. Includes several premade textures (eg. duckweed, oil- spill and slick)
  • GPU-based water height readbacks. Water height, including any dynamic effects, can be read out in C#
  • Foam bubbles, creates a slightly lighter color underneath the surface foam effect.
  • Render Graph support
  • Wave crest foam particles, for ocean spray (VFX Graph)
  • Ocean mesh, with high vertex density near the camera that taper of into large triangles on the horizon.

Improvements:

  • Render features (including extensions) are merged into a single render feature
  • Dynamic Effects will be fully DOTS and SRP-Batcher compatible
  • Surface foam for wave crests has a min/max height range slider

After release (R&D):

  • Further improvement of screen-space reflections.
  • Water effect trigger script functionality.
  • Refactored Planar Reflections to adhere to URP best practices (currently relies on an obsolete API, soon to be deprecated entirely).
  • Support for Tessellation when URP’s “GPU Resident Drawer” is enabled (if at all possible).
  • MicroVerse content prefabs.

Support for WebGL is rapidly fizzling out, in favor of WebGPU.

WebGL does not support Compute Shaders nor Texture Arrays, two very important technical concepts. At least two features in Stylized Water 3 make use of these, so inherently won’t work in WebGL. On release, the asset will be marked as incompatible with WebGL entirely.

Seeing as development continues with Stylized Water 3, new features or improvements will not be backported to Stylized Water 2

Stylized Water 3 will not contain an integration for Dynamic Water Physics 2. It has consistently been the source of support overhead (people assuming I’m the author, questions about physics, wild goose chases for issues that turn out not to be related to SW and DWP2 not keeping their docs up-to-date with SW2).

Instead the author of DWP2 will be offered a free license to SW3 to develop and maintain an integration, should they wish to.

Extensions

This is all to share some ideas and experiments, they may end up never being released, or are indefinitely on hold. There’s also a limit to how much you can cram into a shader, historically many water assets have been deprecated due to rising complexity, which is to be avoided

Features that are complex, and require a sizeable amount of development time will be published as separate paid extensions. Rather than making a single high priced asset, the intend is to keep things modulair.

In order of importance/completion:

Flowmap painter (extension asset)

Create a flowmap object, with a specific box-size and enables you to paint a flow map within this area. The painter is GPU based, so isn’t per-vertex, and allows for greater detail. This allows the use of brushes (modeled after Substance Painter).

Splines can be used to drive the flow, next to manual painting. But this specific feature would be rebuilt on Unity’s native spline tool when it releases.

Status: Previously prototyped, basic functionality worked, but the painter tool needs a lot of UX work. Feature is also doubtfully useful, the flow of the water will mainly be noticeable when using surface foam and strong reflections. Not unimportant: every texture that uses the flow map requires to be sampled twice. In many AAA games you’ll mainly see this used on rivers.

Color gradient

Rather than using a 2 colors to set the deep and shallow color, a gradient can be used.

Status: Binned, mainly because it visually makes a very minor difference, unless going for an rainbow-colored lake. It also creates a troublesome situation where it’s no longer clear to tell what exactly the deep and shallow color is, for underwater rendering and translucency.

Released

Dynamic Effects (extension asset)

This replaces and combines the previously prototyped Surface Modifiers and Interaction extensions

A decal-like system that allows the water surface to be displaced and its foam and normals to be modified. These decals are projected from a top-down perspective onto the water surface.

In practical terms, it means particle systems, trail renderers and static meshes can be used to influence the appearance of the water.

Bonus: The displacement also works with the underwater rendering water line!

The normals of the water surface are recalculated from the created displacement (Y-axis only), ensuring any and all lighting effects look correct. For example, a wave actually makes the surface appear to curve.

Shown here is a single “Beach Wave” particle system that emits particles moving forward. The ‘Color Over Lifetime’ module is used to control the fading of displacement and foam.

The boat wake above uses two TrailRenderer components, and a ‘ripples’ particle system.

A ripples particle effect is attached to the surfers here

Status: Released

1.5.0

  • Color absorption feature, darkens the underwater color based on depth (physically accurate shading)
  • Improved refraction, taking the curvature of the surface into account more accurately.
  • Improved surface foam, where it appears to dissipate based on the “intensity”. Visually, this translates to way better foam caps on wave crests.

1.4.0

  • Conversion to a new “scriptable shader” framework. This allows the shader code to first be passed through a C# template parser. Meaning that things like integrations and support for extensions will be automatically configured. Plus this’ll make it easier to implement URP version specific code, safeguarding against breaking changes.

Underwater rendering (extension asset)

Allows a camera to be partially submerged, and draws a waterline effect on the camera lens. Underneath the water surface, fog and caustics are drawn and the water refracts the scene below the water.

Status: Released!

Tessellation (feature update)

Dynamically subdivides the water geometry to create more vertices near the camera. This allows to have very detailed waves near the camera, without needing a high-poly mesh.

Status: Added in version 1.1.2 through a free update

Yes No Suggest edit
Last updated on September 24, 2024
7 of 7 users found this section helpful
Suggest Edit