Skip to main content

WaterSystem

18 tools in this family (folder Editor/Tools/WaterSystem/ in the bridge package). Effect: writes changes the project or the scene, read-only does not, destructive deletes or overwrites and the client asks before running it.

ToolEffectDescription
water_add_buoyancy_bodywritesRegister a Rigidbody for Archimedean buoyancy. F_buoy = ρ·V·g per sample point, scaled by submerged
water_add_river_flowwritesAdd a directional river-flow zone. Any BuoyancyBody whose sample point enters the AABB receives a
water_add_wave_layerwritesAppend a single Gerstner wave layer to a surface's wave stack. Use this for fine-grained tuning
water_apply_profilewritesApply a built-in profile preset to an existing surface. Replaces the surface's wave stack and ALL
water_configure_causticswritesConfigure underwater caustics — the dancing light patterns on submerged surfaces. Two layers pan
water_configure_colorwritesSet the surface's shallow-water color, deep-water color, and the Beer-Lambert depth falloff (m).
water_configure_foamwritesConfigure foam appearance (color, intensity, texture, scale, speed, shoreline width). Shoreline foam…
water_configure_reflectionswritesConfigure reflection mode for a water surface: None | PlanarMirror | ReflectionProbe | ScreenSpac…
water_configure_refractionwritesSet how the surface distorts the scene below it. Strength 0..1 controls offset magnitude.
water_configure_underwaterwritesSet underwater rendering parameters: fog color, exponential fog density, fresnel power (for surface
water_configure_waveswritesReplace a surface's wave stack with a generated stack of N layers, optionally seeded. Use the
water_configure_wet_surfaceswritesSet the global wet-surface config. Surfaces near water (within distance metres) appear wet with
water_create_surfacewritesCreate a new water surface (Ocean / Lake / River / Pool). The surface is registered with the water
water_export_profileread-onlyExport a surface's WaterProfile to JSON. Optionally writes the JSON to disk (project-relative path)
water_hook_weatherwritesWhen weather changes, blend the wave stack of one (or all) water surface(s) to the matching preset.
water_sample_heightread-onlyQuery the water surface Y-coordinate and normal at a world XYZ position. Returns the composite wave
water_trigger_splashwritesPost a splash event at a world position. Subscribers (VFX manager, audio manager) drain the queue
water_validate_setupread-onlyValidate that a water surface is properly configured: profile assigned, mesh generated, bounds valid…