Waterfall

一款轻量级且对性能友好的 Minecraft 模组,用于限制自然瀑布和熔岩瀑布的高度,并添加沉浸式的蒸发效果。
Waterfall 通过检测暴露的垂直流体柱并在达到可配置的高度限制后使其消散,从而防止无限悬浮的水和熔岩柱。该模组旨在保留自然的地形生成外观,同时不影响河流、海洋、运河、熔岩池或大多数玩家建造的流体系统。
功能特性
- 限制自然瀑布和熔岩瀑布的最大高度
- 智能流体检测,仅针对暴露的垂直流动
- 源自原版风格的蒸发和烟雾粒子效果
- 完全可通过 TOML 配置文件进行自定义
- 支持多人游戏
- 轻量级优化,对性能影响极小

工作原理
该模组通过检查四周水平方向均被空气包围的垂直流体柱来识别瀑布和熔岩瀑布。一旦流动超过配置的最大高度,流体便会消散,并出现视觉粒子效果。
不受影响
- 海洋和河流
- 熔岩湖和熔岩池
- 在水平方向接触固体方块的水或熔岩
- 高架渠和封闭的流体通道
视觉效果
当流动达到其限制时,模组会生成沉浸式的粒子效果:
- 瀑布产生云朵和下落水滴粒子
- 熔岩瀑布产生烟雾和熔岩粒子
配置
配置文件位置:
config/waterfall-common.toml
# 启用或禁用整个模组
enabled = true
[waterfall]
# 垂直瀑布在蒸发前的最大高度(以方块为单位)
# 默认值: 12
# 范围: 1 ~ 100
maxHeight = 12
# 当瀑布蒸发时显示云/溅射粒子效果
enableEvaporationEffect = true
# 蒸发粒子的密度 (0.0 = 无, 1.0 = 最大)
# 默认值: 0.5
# 范围: 0.0 ~ 1.0
particleDensity = 0.5
[lavafall]
# 垂直熔岩瀑布在蒸发前的最大高度(以方块为单位)
# 默认值: 12
# 范围: 1 ~ 100
maxHeight = 12
# 当熔岩瀑布蒸发时显示烟雾/火焰粒子效果
enableEvaporationEffect = true
默认设置
- 默认启用
- 最大流动高度:12 个方块
- 粒子效果已启用
- 可调节粒子密度
依赖要求
- Minecraft 1.21.1
- NeoForge 21.1.228+
- Java 21
许可证
本模组遵循 MIT License 授权。
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.
评论 0
登录后参与评分
还没有评论,来抢沙发吧