WaveWater

# WaveWater

WaveWater is a client-side Fabric mod for Minecraft 1.20.1 that transforms oceans, rivers, and underwater exploration with clearer water, animated waves, and brighter aquatic effects.

## Features

- Clearer long-distance underwater visibility with brighter, more natural lighting

- Bright aqua-blue and emerald water colors that still preserve biome variation

- Increased surface transparency with smooth, depth-based blending

- Animated multi-directional waves with calmer clear-weather motion and waves up to approximately three blocks high during thunderstorms

- Brighter white wave crests near shore, shoreline wash, splash particles, and wave sounds

- Visual wave-synchronized bobbing for players and boats

- Slowly moving caustic light patterns on the seafloor

- Configurable underwater bubbles, light motes, and surface light shafts

- Improved visibility and brightness while submerged in lava or powder snow

- In-game settings opened with the `B` key

- Configurable wave render distance from 4 to 32 chunks (16 chunks by default)

## Requirements

- Minecraft 1.20.1

- Fabric Loader 0.16.10 or newer

- Fabric API 0.92.0 or newer

- Java 17 or newer

## Installation

1. Install Fabric Loader for Minecraft 1.20.1.

2. Install Fabric API.

3. Place the WaveWater JAR in your Minecraft `mods` folder.

4. Launch the Fabric profile.

WaveWater is a client-side visual mod. Its waves, shoreline wash, and buoyancy are visual effects; it does not replace server-side water blocks or Minecraft's normal collision rules. The visible wave range is also limited by the chunks currently loaded and rendered by Minecraft.

## Configuration

Press `B` in game to open the BetterWater settings. The key can be changed from Minecraft's Controls menu. You can adjust the particle amount, toggle individual underwater particle effects, and choose a wave render distance from 4 to 32 chunks.

## License

Wave is distributed under the MIT License.