I installed the addon from the zip file - where is the addon UI/it doesn't work
The addon is in the N panel, the preset scenes are in the "preset scene" blend file that can be downloaded besides the addon. The preset scenes are the best way to start off your projects - just use the save as function of Blender to create a new file based on a preset scene or append a scene from it. Alternatively you can append a scene from the save file.
Occasionally, the addon might not work/appear after installing it for some people. What to do:
1. Close Blender and re-open it again. This most of the time fixes it.
2. Delete the addon and reinstall it.
Why are the caustics/waves/foam stretched or weird?
Make sure to resize the water cube/object in edit mode. Use the objects mapping mode for the UWS3D shader node. You can use UV mapping too but then using non-uniforming scaling on X and Y axes will stretch the procedural waves/foam textures too alongside the water object, and you need to create a new UV map for the object. UV map method can be good for rivers where water flows in a direction along a curve or waterfalls.
Why do the Displacement waves lack detail?
You need to have sufficient amount of geometry. Add a subdivision modifier and subdivide the selected water object multiple times. Also you can use the adaptive subdivision feature of blender, for that you need to go to Render tab\Feature set\experimental. After that the subdivision modifiers will become compatible with adaptaive subdivision mode. The basic water object you add with the addon already has good subdivision presets for this.
Why do the caustics look too sharp/less realistic than in the preset scenes file/promo pics?
The sharpness and strength of caustics depend on the size and strength of your light source. For example the default Nishita sky creates extremely bright caustics by default, so you need to make the whole sky and the sun way less bright. Ultimate Sky works correctly out of the box with the caustics and the preset scenes are already set up to look the best with the water materials (even with Nishita Sky). Sun lamps and other light sources (HDRI, other Sky addons) might also work differently so you may also need to change the sun brightness.
Use the "caustics sharpness" slider on the materials/shader UI to change how strong/bright the caustics are, usually best look around 0.6-0.7 values - also Caustic type 1 is brighter by default than caustic type 2 so it also depends on which one you decide to use in the shader.
Why are the waves not 3D?
You need to use the "Displacement" or "Displacement and Bump" mode instead of the default "Bump only" mode. Select the UWS3D material, go to the materials tab\displacement\ to change the settings.
What is the legacy shader that is available in the addon?
A very old version of the UWS from years ago. It has Eevee support and fast tricks to make the water look realistic despite not supporting volumetric depth. It is in the addon for people who might still have some use for it, or have very low end hardware insufficient for running the UWS3D in specific cases like animations. It is not updated anymore and compatibility/support is discontinued.
Why are dynamic ripples/foams not visible?
The dynamic effects require the water object to be subdivided with a decent amount of vertices. The water object needs to have the Proximity Core geonode modifier, and you need to select a collection that has the objects that you want the effects to apply to. You also need to go to the material and enable the ripple or dynamic foam effect with the sliders.
Why is there a Main shader and smaller shaders in the Legacy/Lite version?
Smaller shaders are good if your GPU struggles to display the complex water material in the viewport shading mode (in Eevee). In Cycles, there is no difference between the two type of shaders that is included. Since viewport shading is using Eevee instead of Cycles, the slow compiling time on the Main shader makes it a plausible reason to use the smaller shaders even when you are creating a scene for Eevee.
Does it work in the latest Blender version?
UWS3D v3.1-4.2 support Blender 4.0 and up. V2.6 to 3.0 work between Blender 3.0-3.6. Older versions work in Blender 2.91 to Blender 3.0.