Waterfall
A lightweight and performance-friendly Minecraft mod that limits the height of natural waterfalls and lavafalls while adding immersive evaporation effects.
Waterfall prevents endless floating water and lava columns by detecting exposed vertical flows and causing them to dissipate after a configurable height limit. Designed to preserve natural-looking terrain generation without affecting rivers, oceans, canals, lava pools, or most player-built fluid systems.
Features
- Limit the maximum height of natural waterfalls and lavafalls
- Smart fluid detection that only targets exposed vertical flows
- Vanilla-inspired evaporation and smoke particle effects
- Fully configurable through TOML config
- Multiplayer compatible
- Lightweight and optimized for minimal performance impact
How It Works
The mod detects waterfalls and lavafalls by checking for vertical fluid columns surrounded by air on all four horizontal sides. Once the flow exceeds the configured maximum height, the fluid dissipates and visual particle effects appear.
Not Affected
- Oceans and rivers
- Lava lakes and pools
- Water or lava touching solid blocks horizontally
- Aqueducts and enclosed fluid channels
Visual Effects
When a flow reaches its limit, the mod generates immersive particle effects:
- Waterfalls produce cloud and falling water particles
- Lavafalls produce smoke and lava particles
Configuration
Config file location:
config/waterfall-common.toml
#Enable or disable the mod entirely
enabled = true
[waterfall]
#Maximum height (in blocks) of a vertical waterfall before it evaporates
# Default: 12
# Range: 1 ~ 100
maxHeight = 12
#Show cloud/splash particle effects when a waterfall evaporates
enableEvaporationEffect = true
#Density of evaporation particles (0.0 = none, 1.0 = maximum)
# Default: 0.5
# Range: 0.0 ~ 1.0
particleDensity = 0.5
[lavafall]
#Maximum height (in blocks) of a vertical lavafall before it evaporates
# Default: 12
# Range: 1 ~ 100
maxHeight = 12
#Show smoke/flame particle effects when a lavafall evaporates
enableEvaporationEffect = true
Default Settings
- Enabled by default
- Maximum flow height: 12 blocks
- Particle effects enabled
- Adjustable particle density
Requirements
- Minecraft 1.21.1
- NeoForge 21.1.228+
- Java 21
License
Licensed under the MIT License.
