Versions Compared

Key

  • This line was added.
  • This line was removed.
  • Formatting was changed.

...

Property

Descriptions

Depth

Specifies how deep the water volume should be.

Speed

Specifies at which speed the water should be moving. Not used for water volumes, inherited from Area Shapes.

Fog Density

Specifies the density of the fog.

Fog Color

Lets you choose the underwater fog color.

Fog Color Multiplier

Lets you choose how bright the underwater fog color is.

Fog Color Affected By Sun

If true, Sun Color value set in the Environment Editor will affect fog color of the water volume.

Fog Shadowing

If enabled, the surface of the water volume will receive shadows. You can control the shadow darkness, valid input 0-1.

NOTE: r_FogShadowsWater needs to be set to '1' for this to function, which is currently only enabled on Very High Spec.
If you use Vol Fog Shadows in Level Settings, you lose control of shadow darkness (automatically set to full).
The benefit here is that the fog in the water volume will receive volumetric shadows! See the below Usage Examples section for comparisons.

Cap Fog At Volume Depth

If false, fog will continue to render below the specified Depth of water volume.

U Scale

Specifies how much the water surface (bump) texture is tiled horizontally.

V Scale

Specifies how much the water surface (bump) texture is tiled vertically.

Caustics

Enables Caustics for this entity.

Caustic Intensity

Controls the intensity of the caustics (this scales the normals of the surface when rendering to the caustic map, producing stronger caustics).

Image Modified
Image Modified
Image Modified
Intensity 1Intensity 4Intensity 8


Caustic Tiling

This is a multiplier for the tiling applied to the surface normals during caustic generation. It allows you to scale the caustics generation independently from the surface material in cases of strong tiled normals or vice-versa.

Image Modified
Image Modified
Image Modified
Tiling 1Tiling 4Tiling 8


Caustic Height

Controls the height above the water entity in which caustics can be cast. This can be used to cause caustics on overhangs and other nearby objects.

Image Modified
Image Modified
Image Modified
Height 1Height 3Height 6


Advanced


Fixed Volume

Will trace a ray down from the volume's initial shape's center to find a 'vessel' entity and 'spill' the requested amount of water into it. For static entities, it'll try to boolean-merge any surrounding static that intersects with the first vessel (use "No Dynamic Water" flag on brushes that don't need that). Volume's shape will then be adjusted dynamically to match the vessel's geometry.

Volume Accuracy

Water level will be calculated until the resulting volume is within this (relative) difference from the target volume (if it's set to 0 it'll run up to a hardcoded iteration limit).

Extrude Border

Will extrude the border by this distance. It's particularly useful if wave sim in on since waves can raise the surface and thus reveal open edges if they lie exactly on the vessel geometry.

Convex Border

Will take convex hull of the border. Mainly useful if the border would otherwise have multiple contours, which areas don't support.

Object Size Limit

The Only object that has volume larger than this will take part in water displacement (set in fractions of FixedVolume).

Wave Sim Cell

Size of a cell for wave simulation (0 means no waves). Can be enabled regardless of whether FixedVolume is used or not. Use smaller sizes like 0.05-0.2m to have enough details on smaller volumes, and larger ones if you need to fill a large vessel/area.

Wave Speed

Sets how "fast" the water looks.

Wave Damping

Standard damping.

Wave Timestep

Might need to be decreased to maintain stability if more aggressive values for speed are used.

Min Wave Vel

Sleep threshold for the simulation.

Depth Cells

Sets how deep the moving layer of water is (in WaveSimCell units). Larger values make waves more 'dramatic'.

Height Limit

Sets a hard limit on wave height (in WaveSimCell units).

Resistance

Sets how strongly moving objects transfer velocity to the water.

Sim Area Growth

If changing water level is expected to make the area expand, the wave sim grid should take it into account from the beginning. This sets the projected growth in fractions of the original size. If wave sim is not used this has no effect.

...