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
presetselect—still-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
waterlinePositionnumber—Surface position (0.1–0.95)
waveHeightnumber—Wave height (0–1)
wavePeriodnumber—Wave period (0.1–1)
waveComplexitynumber—Wave complexity (0–1)
chopnumber—Surface choppiness (0–1)
surfaceColorcolor—Surface color
depthColorcolor—Deep water color
shimmerIntensitynumber—Highlight shimmer (0–1)
flowDirectionnumber—Flow direction in radians (0–6.28)
flowStrengthnumber—Flow field strength (0–1)
depthLaneselect—foreground, midground, background
atmosphericModeselect—none, tinted, desaturated

water:reflection

PropertyTypeDefaultDescription
presetselect—calm-lake, rippled, dark-water, golden
seednumber42Random seed
skyColorcolor—Reflected sky color
terrainColorcolor—Reflected terrain color
reflectionStrengthnumber—Reflection strength (0–1)
reflectionBlurnumber—Blur amount (0–1)
reflectionDistortionnumber—Distortion amount (0–1)
waterlinePositionnumber—Waterline position (0.2–0.9)
depthLaneselect—foreground, ground-plane, background

water:shoreline

PropertyTypeDefaultDescription
presetselect—sandy-beach, rocky-shore, muddy-riverbank, grassy-bank, tidal-flat, cliff-base, marsh-edge
seednumber42Random seed
waterlinePositionnumber—Position (0.1–0.95)
widthnumber—Shore width (0.01–0.25)
colorcolor—Shore color
wetColorcolor—Wet sand color
foamIntensitynumber—Foam intensity (0–1)
debrisTypeselect—none, seaweed, driftwood, shells, pebbles
waveBreakStyleselect—spilling, plunging, surging

water:ice

PropertyTypeDefaultDescription
presetselect—frozen-lake, thin-ice, pack-ice, frost-glass
seednumber42Random seed
iceThicknessnumber—Ice thickness (0–1)
crackDensitynumber—Crack density (0–1)
frostIntensitynumber—Frost intensity (0–1)
snowCovernumber—Snow cover (0–1)
iceColorcolor—Ice color
crackColorcolor—Crack 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"
    }
  }
}