feather-engine.vercel.app

{
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "type": "object",
  "properties": {
    "enabled": {
      "type": "boolean"
    },
    "buoyancy": {
      "description": "Upward force multiplier for dynamic bodies in the volume.",
      "type": "number",
      "minimum": 0,
      "maximum": 3
    },
    "drag": {
      "description": "Linear drag in water; higher slows objects faster.",
      "type": "number",
      "minimum": 0,
      "maximum": 6
    },
    "angularDrag": {
      "description": "Rotational damping hint for water interaction.",
      "type": "number",
      "minimum": 0,
      "maximum": 4
    },
    "surfaceBounce": {
      "description": "Extra upward bounce when objects hit the water surface.",
      "type": "number",
      "minimum": 0,
      "maximum": 2
    },
    "waveAmplitude": {
      "description": "Wave height in world units.",
      "type": "number",
      "minimum": 0,
      "maximum": 2
    },
    "waveFrequency": {
      "description": "Wave cycles per world unit.",
      "type": "number",
      "minimum": 0.05,
      "maximum": 2
    },
    "waveSpeed": {
      "description": "Wave scroll speed.",
      "type": "number",
      "minimum": 0,
      "maximum": 6
    },
    "style": {
      "description": "Ready-made look: ocean | pool | lake | toxic | lava | custom. Sets all the visual fields below.",
      "type": "string",
      "enum": [
        "ocean",
        "pool",
        "lake",
        "toxic",
        "lava",
        "custom"
      ]
    },
    "shallowColor": {
      "description": "Hex tint near the surface / shallow edges.",
      "type": "string"
    },
    "deepColor": {
      "description": "Hex tint of deep water (also the underwater fog color).",
      "type": "string"
    },
    "foamColor": {
      "description": "Hex foam color.",
      "type": "string"
    },
    "surfaceOpacity": {
      "description": "Rendered water-surface opacity (clear pool low, murky high).",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "reflectivity": {
      "description": "Fresnel + sky-reflection strength 0-1.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "foam": {
      "description": "Crest + shoreline foam amount 0-1.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "sparkle": {
      "description": "Animated micro-ripple sparkle / sun-glint sharpness 0-1.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "caustics": {
      "description": "Animated caustic shimmer across the surface 0-1.",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "emissiveIntensity": {
      "description": "Self-illumination glow (use for lava/toxic).",
      "type": "number",
      "minimum": 0,
      "maximum": 2
    },
    "underwaterFog": {
      "description": "Tint the screen + murk the view while the camera is submerged.",
      "type": "boolean"
    },
    "flowStrength": {
      "description": "Current strength: 0 = still lake, >0 = flowing river/waterfall (surface scrolls + bodies drift).",
      "type": "number",
      "minimum": 0,
      "maximum": 4
    },
    "flowAngle": {
      "description": "Current direction in degrees on XZ (0 = +X, 90 = +Z).",
      "type": "number",
      "minimum": 0,
      "maximum": 360
    },
    "rainStrength": {
      "description": "Rain on the water: 0 = clear, >0 speckles the surface with raindrop ripple rings (use for storms).",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    },
    "name": {
      "type": "string"
    },
    "position": {
      "description": "Center of the water volume. Default [0,1,0].",
      "minItems": 3,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "scale": {
      "description": "Volume size [width,height,depth]. Default [10,2,10].",
      "minItems": 3,
      "maxItems": 3,
      "type": "array",
      "items": {
        "type": "number"
      }
    },
    "color": {
      "description": "Underlying box tint hex (the animated surface is driven by style/shallowColor/deepColor). Default #2BA8FF.",
      "type": "string"
    },
    "opacity": {
      "description": "Underlying box opacity. Default 0.45 (the surface has its own surfaceOpacity).",
      "type": "number",
      "minimum": 0,
      "maximum": 1
    }
  }
}