genart.dev
Plugins

Water

Water effects — surface waves, reflections, foam, shoreline, caustics, and ice.

Water simulation with 6 layer types covering surface rendering, reflections, foam, shoreline transitions, underwater caustics, and ice. 33 presets across all water conditions.

Installation

npm install @genart-dev/plugin-water

Layer Types

Type IDDisplay NameDescription
water:surfaceWater Surface3 wave algorithms (calm, ocean, flow) with 11 presets
water:reflectionReflectionFresnel-based terrain/sky mirroring with distortion
water:foamFoamLangmuir circulation, bubble rafts, whitecaps
water:shorelineShorelineWave breaks, debris, wet sand with 7 presets
water:causticsCausticsUnderwater light patterns (noise-based)
water:iceIceIce cracks, frost crystals, snow cover

Properties

water:surface

PropertyTypeDefaultDescription
presetselectstill-lake, pond, misty-lake, moonlit-water, choppy-sea, ocean-swell, stormy-ocean, tropical-shallows, coastal-surf, mountain-stream, river
seednumber42Random seed (0–99999)
algorithmselect"calm"calm, ocean, flow
waterlinePositionnumberSurface position (0.1–0.95)
waveHeightnumberWave height (0–1)
wavePeriodnumberWave period (0.1–1)
waveComplexitynumberWave complexity (0–1)
chopnumberSurface choppiness (0–1)
surfaceColorcolorSurface color
depthColorcolorDeep water color
shimmerIntensitynumberHighlight shimmer (0–1)
flowDirectionnumberFlow direction in radians (0–6.28)
flowStrengthnumberFlow field strength (0–1)
depthLaneselectforeground, midground, background
atmosphericModeselectnone, tinted, desaturated

water:reflection

PropertyTypeDefaultDescription
presetselectcalm-lake, rippled, dark-water, golden
seednumber42Random seed
skyColorcolorReflected sky color
terrainColorcolorReflected terrain color
reflectionStrengthnumberReflection strength (0–1)
reflectionBlurnumberBlur amount (0–1)
reflectionDistortionnumberDistortion amount (0–1)
waterlinePositionnumberWaterline position (0.2–0.9)
depthLaneselectforeground, ground-plane, background

water:shoreline

PropertyTypeDefaultDescription
presetselectsandy-beach, rocky-shore, muddy-riverbank, grassy-bank, tidal-flat, cliff-base, marsh-edge
seednumber42Random seed
waterlinePositionnumberPosition (0.1–0.95)
widthnumberShore width (0.01–0.25)
colorcolorShore color
wetColorcolorWet sand color
foamIntensitynumberFoam intensity (0–1)
debrisTypeselectnone, seaweed, driftwood, shells, pebbles
waveBreakStyleselectspilling, plunging, surging

water:ice

PropertyTypeDefaultDescription
presetselectfrozen-lake, thin-ice, pack-ice, frost-glass
seednumber42Random seed
iceThicknessnumberIce thickness (0–1)
crackDensitynumberCrack density (0–1)
frostIntensitynumberFrost intensity (0–1)
snowCovernumberSnow cover (0–1)
iceColorcolorIce color
crackColorcolorCrack color

MCP Tools

ToolDescription
add_water_surfaceAdd surface with 3 algorithms and 11 presets
add_water_reflectionAdd Fresnel-based reflection layer
add_water_foamAdd foam, whitecaps, and bubble rafts
add_water_shorelineAdd shoreline with wave breaks and debris
add_water_causticsAdd underwater caustic light patterns
add_water_iceAdd ice cracks, frost, and snow
list_water_presetsList presets filtered by category
set_water_conditionsSet wave conditions across all surface layers

Example

{
  "tool": "design_add_layer",
  "arguments": {
    "type": "water:surface",
    "properties": {
      "preset": "moonlit-water",
      "seed": 256,
      "algorithm": "calm",
      "shimmerIntensity": 0.6,
      "surfaceColor": "#1a2a3a",
      "depthColor": "#0a1520"
    }
  }
}