JustWaves 0.3
=============

Waves for vanilla water. Nothing else.

Most wave shaders come welded to a full lighting overhaul, so if you want moving water
you also get new shadows, new fog, new colours and half your framerate. JustWaves only
replaces the program Minecraft uses to draw translucent blocks. Everything else — sky,
terrain, lighting, clouds, entities — falls through to Iris's defaults and looks exactly
like it does with shaders off.

INSTALL
  1. You need Iris. https://irisshaders.dev
  2. Put JustWaves.zip in .minecraft/shaderpacks — the ZIP FILE, do not extract it.
  3. Options -> Video Settings -> Shader Packs -> JustWaves.zip -> Apply

  If you'd rather have it as a folder so you can edit it, that works too, but the outer
  folder has to be named JustWaves, like this:
      shaderpacks/JustWaves/shaders/gbuffers_water.vsh
  Extracting the zip straight into shaderpacks gives you a folder called "shaders",
  which Iris reads as an empty pack and you get no waves at all.

NEW IN 0.3
  Shoreline gaps      The wave no longer dips below the normal water level, so it can't
                      open a hole at a beach or over the seabed. See Lift Troughs below.
  Torn shallow water  Fixed: on part-filled water the top face moved and the sides
                      didn't, so the surface pulled away from its own block. This was
                      most of the flicker in streams and at river edges.
  Backlit glow        Crests glow green when the light is behind them. Thin water really
                      does this, and it's the thing that most separates sea from a blue
                      surface with a shine on it.
  Foam breakup        Foam tears into patches and streaks instead of drawing a clean line
                      along every crest.
  Glint sparkle       The highlight shatters into moving glitter rather than one blob.
  Dusk handover       The glint crossfades from sun to moon instead of snapping over on
                      a single tick.
  LOW and HIGH presets fixed. Both set four values that weren't among the values those
  options are allowed to take, so the presets never fully applied. Since 0.2.

WHAT IT DOES
  Gerstner waves      Sharp crests, wide flat troughs. Real water isn't a sine wave.
  Sky reflection      The water reflects the sky, strongest at grazing angles.
  Fresnel             Clear when you look down into it, mirror when you look across it.
  Sun & moon glint    Follows whichever is up, with sparkle, and hands over at dusk.
  Backlit glow        Crests light up green with the sun behind them.
  Crest foam          The tops break white, in patches, and more so in rain.
  Storm response      Waves build when it rains.
  Lunar tides         Slow rise and fall, bigger at full and new moon like the real thing.
  Calm rivers         Flowing water gets a fraction of the wave. Streams have no swell.
  Calm shallows       Part-filled water gets a smaller wave. It has less room to make one.
  Underwater          Light bands across the underside of the surface, and it turns
                      silver when you look along it. That's total internal reflection.

SETTINGS
  Shader Pack Settings -> three pages: Waves, Surface, Tides.
  LOW / MEDIUM / HIGH profiles if you'd rather not fiddle.

  Lift Troughs is the one worth understanding. Minecraft's ocean is full water blocks
  right up to the sand, so nothing in a shader can tell where the beach is. What opens
  the gap is the trough going down: the seabed is at the water's resting height, so the
  moment the surface drops under it you are looking through the side of the water. Water
  that only ever rises can't expose anything. Turn it up if you see gaps, down if you
  want deeper troughs and don't care.

KNOWN LIMITS
  - Water is still made of blocks. Very large Wave Height with Lift Troughs turned down
    can still pull the surface away from a steep shore.
  - Boats and mobs float at the flat vanilla water level. A shader only draws; it can't
    move anything. If you want water that actually pushes your ship around, that's a
    mod's job — try Sable Waves, which is built for exactly that and stacks with this.
  - ProtoManly's Weather doesn't work with Iris at all, so you can't run this with it.

Lighting, shadows and the rest may come later. Water first.
