一个为 1.12.2 添加高度可定制流体浸水功能的库模组!
流体浸水(Fluidlogging)是一项受原版 Waterlogging 机制启发的机制,其运作方式非常相似。主要区别在于 Fluidlogged API 支持非源流体以及所有模组流体!

如果你是一位整合包开发者,希望将 Fluidlogged API 添加到 CurseForge 或 Modrinth 之外分发的整合包中,请使用 File Director 以避免重新上传 Fluidlogged API 的文件。
通过 Fluidlogged API 的配置,任何方块都可以被设置为可流体浸水或不可流体浸水,不过它默认会使 某些类型的方块 变为可流体浸水。这些方块的任何正确编码的模组变体默认都受到支持。模组也可以在其端添加可流体浸水的方块。要查看完整的可流体浸水方块列表,在游戏中运行 /fluidlogged_api print 命令以创建包含所有活动流体浸水信息的文本文件。
此外,Fluidlogged API 会下载并应用 社区配置! 这是为了最大限度地减少玩家在跨模组实现完整流体浸水方面所需的工作量,但如果需要,可以在 fluidlogged_api/general.cfg 中完全禁用此行为。
Fluidlogged API 还大幅提高了流体碰撞的准确性,并修复了各种原版和模组相关的流体问题。部分原版漏洞修复包括:
- MC-2591 走过熔岩角落会受到伤害
- MC-4533 对角连接时出现的水图形故障
- MC-68129 水下平滑光照无法正常工作
- MC-100886 ID 为水或熔岩的下落沙子无法渲染
- MC-125771 方块选择框在水下不显示
- MC-127030 流动的水尝试连接到不应连接的浸水方块
- MC-127108 浸水方块在物理上不相连的一侧会将熔岩转化为黑曜石或圆石
- MC-127270 浸水方块内部的视觉水位无法正确调整
- MC-227302 水面上的平滑光照无法正常工作
| 已知不兼容项 | 已知解决方案 |
|---|---|
| Better Water Mesh | 无。 |
| Corail Tombstone | 使用 Corail Tombstone v4.6.0 或更高版本! |
| Oceanic Expanse | 使用 Oceanic Expanse v1.2.0 或更高版本! |
| Phosphor | 改用 Alfheim 或 燐/Hesperus! |
| The Aether II | Phosphor 随 The Aether II 捆绑提供。幸运的是,存在 The Aether II: Phosphor Not Included,正如其名所示! |
| Vintagium | 改用 Celeritas! |
常见问题解答:
这个模组是如何工作的?
阅读 源代码 是真正理解该模组内部工作原理的最佳方式,但我会在这里描述一个简化版本:
对于世界中的每个方块,原版会在每个区块中存储两个特性:必需的 IBlockState 和可选的 TileEntity。Fluidlogged API 添加了第三个特性并存储在每個区块中:可选的 FluidState,如果存在,则存储被流体浸水的流体。
该模组应用了 ASM(Forge 捆绑的一个字节码操作库),以允许原版和 Forge 正确读取和使用 FluidStates。
将此模组添加到现有世界中安全吗?
在添加任何新模组之前始终备份你的世界通常是个好主意。话虽如此,此模组不会改变 IBlockStates 的行为,因此将其添加到现有世界中应该是安全的!从现有世界中移除此模组也应该是安全的,只需注意现有的 FluidStates 将被移除,且一旦移除将无法恢复。
我如何使用此模组的配置?如何将此模组作为依赖项使用?
此模组的 wiki 最终将涵盖这两个主题,目前它仅涵盖如何使用此模组的配置。如果你想将此模组用作库(可选或必需依赖项),在我完成 wiki 之前,我能做的最好的事情就是引导你参考我的其他项目的源代码:Campfire、Seared Ladder Backport、Subaquatic。
如果遇到任何错误、崩溃或模组不兼容问题,我该怎么办?
将您发现的任何问题报告给该模组的 问题追踪器 将极大帮助我改进此模组!如果没有人们慷慨地抽出时间这样做,此模组就不会发展到今天的成就!
如果您希望在 1.12.2 之后的版本中使用流体记录功能,请查看 Fluidlogged(与 Fluidlogged API 无关)和 Towelette!
直接联系:jbred.dev@gmail.com
此模组不会移植。
A library mod that adds highly customizable fluidlogging to 1.12.2!
Fluidlogging is a mechanic that's inspired by Vanilla's Waterlogging mechanic, and that functions very similarly. The main difference is that Fluidlogged API has support for non-source fluids and all modded fluids!

If you're a modpack developer wanting to add Fluidlogged API to a modpack distributed outside of CurseForge or Modrinth, use File Director to avoid reuploading Fluidlogged API's files.
Any blocks can be made fluidloggable or non-fluidloggable through Fluidlogged API's configs, however it does make certain types of blocks fluidloggable by default. Any properly coded modded variants of these blocks are supported by default. Mods may also add fluidloggable blocks from their end. To see the full list of fluidloggable blocks, run the /fluidlogged_api print command in-game to create text files containing all active fluidlogging information.
Along with this, Fluidlogged API will download and apply community configs! This is to minimize the amount of work that players must do to have complete fluidlogging across mods, but this behavior can be fully disabled in fluidlogged_api/general.cfg if desired.
Fluidlogged API also heavily improves fluid collision accuracy, and fixes various Vanilla and modded fluid-related issues. Some Vanilla bug fixes include:
- MC-2591 Walking over the corner of lava deals damage
- MC-4533 Water graphical glitch when connecting diagonally
- MC-68129 Smooth lighting doesn't work properly underwater
- MC-100886 Falling sand with ID of water or lava does not render
- MC-125771 Block selection not showing up underwater
- MC-127030 Flowing water attempts to connect to waterlogged blocks when it shouldn't
- MC-127108 Waterlogged blocks turn lava into obsidian or cobblestone on physically unconnected sides
- MC-127270 Visual water level inside waterlogged blocks does not adjust correctly
- MC-227302 Smooth lighting doesn't work properly on the water surface
| Known Incompatibilities | Known Solutions |
|---|---|
| Better Water Mesh | None. |
| Corail Tombstone | Use Corail Tombstone v4.6.0 or later! |
| Oceanic Expanse | Use Oceanic Expanse v1.2.0 or later! |
| Phosphor | Use Alfheim or 燐/Hesperus instead! |
| The Aether II | Phosphor comes bundled with The Aether II. Luckily there exists The Aether II: Phosphor Not Included, which does as the name suggests! |
| Vintagium | Use Celeritas instead! |
Q / A:
How does this mod work?
Reading through the source code would be the best way of truly understanding the inner workings of this mod, but I'll describe a simplified version here:
For each block in the world, Vanilla has two features that get stored in each chunk: a required IBlockState and an optional TileEntity. Fluidlogged API adds a third feature that gets stored in each chunk: an optional FluidState, which stores the fluidlogged fluid if present.
This mod applies ASM (a bytecode manipulation library that's bundled with Forge) to allow Vanilla and Forge to properly read and make use of FluidStates.
Is this mod safe to add to existing worlds?
It's generally a good idea to always back up your worlds before adding any new mods. That being said, this mod doesn't change the behavior of IBlockStates, so adding it to existing worlds should be fine! Removing this mod from existing worlds should also be fine, just note that existing FluidStates will be removed and won't be recoverable upon doing so.
How do I use this mod's configs? How do I use this mod as a dependency?
This mod's wiki will eventually cover both of those topics, for now it only covers how to use this mod's config. If you want to use Fluidlogged API as a library (optional or required dependency), the best I can do until I finish the wiki is reference you to the source code of these other projects of mine: Campfire, Seared Ladder Backport, Subaquatic.
What should I do if I run into any bugs, crashes, or mod incompatibilities?
Reporting anything you find to this mod's issue tracker would greatly help me improve this mod! Without people generously taking the time to do so, this mod would not be where it is today!
If you want fluidlogging for versions beyond 1.12.2, check out Fluidlogged (not affiliated with Fluidlogged API) and Towelette!
Direct contact: jbred.dev@gmail.com
This mod will not be ported.
下载 Fluidlogged API
下载 Fluidlogged API
下载 Fluidlogged API
下载 Fluidlogged API
下载 Fluidlogged API
下载 Fluidlogged API
下载 Fluidlogged API
下载 Fluidlogged API
下载 Fluidlogged API
下载 Fluidlogged API
关于这个资源的讨论、问题反馈与使用心得
还没有讨论,来发第一帖吧
你是这个资源的作者?登录后可认领此资源。
相似资源
模组
一个用于收集生物掉落物的多区块模组。
模组
可定制的鞘翅模组,支持装饰纹饰、旗帜图案等更多功能!
模组
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
模组
查看物品与配方
模组
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
模组
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
评论 0
登录后参与评分
还没有评论,来抢沙发吧