Wavify

Dynamic ocean and shoreline waves for Minecraft

Wavify adds ambient water waves to oceans, beaches, shores, and islands to make Minecraft’s water feel more alive and dynamic.

Waves are most noticeable along coastlines, where larger swells can roll toward beaches and rocky terrain. Waves may also interact with nearby blocks, creating more dramatic shorelines and cliffside water effects. During full moons, some waves can emit a subtle nighttime glow.

## About This Project
Wavify is an independently maintained fork inspired by the original Tidal mod.

This project exists to keep the wave system playable and functional on newer Minecraft versions while also addressing bugs, crashes, and gameplay issues encountered during testing. It is not an official continuation of the original project and is not affiliated with or endorsed by the original author.

The focus of this fork is:
- Updating compatibility for newer Minecraft versions
- Fixing reproducible bugs and crashes
- Improving general stability and gameplay behavior
- Continuing maintenance when possible

Because the original project was still in an early/experimental state, some unfinished systems and edge cases may still exist.

Known Issues

Some issues and limitations may still be present, including:
- Incomplete or missing wave sound effects
- Limited configuration options
- Rendering or overlay systems that may still need optimization
- Occasional unusual wave behavior or performance spikes in certain environments

If you encounter problems, please report them with as much detail as possible so they can be reproduced and investigated properly.

Chunk Reloading

Wave generation relies on environmental calculations that are performed in the background. If waves appear incorrect or fail to spawn properly, you can refresh nearby chunk data using:

`F3 + A`

Wavify

Dynamic ocean, shoreline, and river waves for Minecraft

Wavify adds ambient water motion to Minecraft, bringing oceans, beaches, shores, islands, and rivers to life with dynamic wave systems that feel far more natural and active than vanilla water.

Along coastlines, larger ocean swells roll toward beaches, cliffs, and rocky terrain, helping shorelines feel more alive and atmospheric. In rivers, waves now follow the flow of the water itself instead of behaving like ocean waves, creating a more believable sense of movement through bends, shallows, and narrow channels. During full moons, some waves can emit a subtle nighttime glow.

Features

• Dynamic ocean and shoreline waves
• New river wave system designed specifically for inland water
• Ocean waves no longer spawn in rivers
• Direction-aware river wave flow that follows the river's actual current
• Support for standing/shallow-water wave behavior in fast river sections
• Ambient ocean and river sound loops that fade in as you approach water and fade out as you leave, with separate volume control
• Iris/Oculus shader compatibility with an auto-applied Y-offset that lets the shaderpack's water reflections and refractions render over the wave geometry — no manual setup required
• Off-thread coastline and river scanning keeps wave generation from stuttering the main thread, even on detailed shorelines
• Expanded configuration options including river-waves toggle, wave Y offset, shader-mode Y sink, sound volume, render radius, and per-biome color overrides
• Fully client-side, with no server installation required

About This Project

Wavify is an independently maintained fork inspired by the original Tidal mod.

This project exists to keep the wave system playable and functional on newer Minecraft versions while also expanding on the original idea with new systems, fixes, polish, and quality-of-life improvements. It is not an official continuation of the original project and is not affiliated with or endorsed by the original author.

The focus of this fork includes:

• Updating compatibility for newer Minecraft versions
• Fixing reproducible bugs and crashes
• Improving overall wave behavior and visual polish
• Expanding the mod beyond oceans with dedicated river wave features
• Improving shader support, audio, and configuration
• Continuing maintenance and refinement when possible

Recent Improvements

This fork now includes several major upgrades over earlier versions:

• Added dedicated river waves instead of relying only on ocean-style behavior
• Prevented beach/ocean wave logic from leaking into river biomes
• Improved how waves behave near shorelines and inland water
• Added fade-in/fade-out ambient audio for oceans and rivers, with distance-based volume
• Iris/Oculus shader compatibility with a tunable Y-sink that lets shader water effects render over wave geometry
• Off-thread scanning for coastlines and river flow to reduce main-thread stutter
• Expanded config options for easier tuning and customization
• General stability, rendering, and behavior improvements

Known Issues

Wavify is still a complex environmental effects mod, so some edge cases may still exist depending on terrain, world shape, shader pack, and performance settings.

Possible issues may include:

• Occasional unusual wave behavior in complex terrain
• Rare performance spikes in heavily detailed coastal or river areas
• Some environmental edge cases that may still need tuning
• Visual inconsistencies with certain shader packs or resource pack combinations
• On some shader packs (Bliss in particular, and other packs that aggressively process gbuffers_entities_translucent), the wave body may appear darker than intended. The included Y-sink mitigates this but does not fully fix it — adjust Shader Wave Y Sink in the config to tune

If you encounter problems, please report them to me on my Discord with as much detail as possible so they can be reproduced and investigated properly.

Chunk Reloading

Wave generation relies on environmental calculations that are performed in the background. If waves appear incorrect or fail to spawn properly, you can refresh nearby chunk data using:

F3 + A