WaterTileEffectParameters improvement request

[ctrlaltmilk]

I've been tinkering with a custom water effect and it would be very helpful if WaterTileEffectParameters had better documentation on its properties. Most of the effect parameters are undocumented - the specific properties I'd most like information on are:

• specular_lightness
• foam_color
• foam_color_multiplier
• tick_scale
• animation_speed
• animation_scale
• dark_threshold
• reflection_threshold
• specular_threshold
• near_zoom
• far_zoom

[Osmo]

I +1 this request; some of the properties are bizzare
For example, based on my testing, specular_lightness does not control the color of specular highlights, neither does it seem to affect any other color.
Instead, it seems to control the speed at which the water shader oscillates, which is... i simply have no words to describe how confusing this is.

[Bilka]

Thanks for pointing this out, added docs for 2.1.18:

Screenshot_20260904_195237.png (196.96 KiB) Viewed 147 times

far_zoom:

If they are set to a tuple, the properties animation_scale, dark_threshold, reflection_threshold and specular_threshold are linearly interpolated between each of their two values based on the current zoom level expressed as a ratio between near_zoom and far_zoom. E.g. if current zoom level is equal to far_zoom, the second tuple value is picked.

[Osmo]

Thank you!