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.
npm install @genart-dev/plugin-water
Type ID Display Name Description water:surfaceWater Surface 3 wave algorithms (calm, ocean, flow) with 11 presets water:reflectionReflection Fresnel-based terrain/sky mirroring with distortion water:foamFoam Langmuir circulation, bubble rafts, whitecaps water:shorelineShoreline Wave breaks, debris, wet sand with 7 presets water:causticsCaustics Underwater light patterns (noise-based) water:iceIce Ice cracks, frost crystals, snow cover
Property Type Default Description 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
Property Type Default Description 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
Property Type Default Description 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
Property Type Default Description 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
Tool Description 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
{
"tool" : "design_add_layer" ,
"arguments" : {
"type" : "water:surface" ,
"properties" : {
"preset" : "moonlit-water" ,
"seed" : 256 ,
"algorithm" : "calm" ,
"shimmerIntensity" : 0.6 ,
"surfaceColor" : "#1a2a3a" ,
"depthColor" : "#0a1520"
}
}
}