Fluidlogged API

一个为 1.12.2 添加高度可定制流体记录的库模组！

流体记录是一项受原版含水机制启发、功能极其相似的机制。主要区别在于，流体重置 API 支持非源流体以及所有模组中的流体！

如果你是一位整合包开发者，想要将流体重置 API 添加到在 CurseForge 或 Modrinth 之外分发的整合包中，请使用 文件指导 以避免重新上传流体重置 API 的文件。

---

任何方块都可以通过流体重置 API 的配置文件设置为可流体重置或不可流体重置，但它会默认使某些特定类型的方块可流体重置。任何编码正确的这些方块的模组变体都会默认被支持。模组也可以从自身添加可流体重置的方块。要查看完整的可流体重置方块列表，请在游戏中运行 /fluidlogged_api print 命令，以创建包含所有活动流体重置信息的文本文件。

除此之外，流体重置 API 还会下载并应用社区配置！这是为了最大限度地减少玩家为在所有模组间实现完整流体重置所需的工作量，但如果需要，可以在 fluidlogged_api/general.cfg 中完全禁用此行为。

---

流体重置 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 或更高版本！
磷	请改用 阿尔夫海姆 或 燐/Hesperus！
以太 II	磷与以太 II 捆绑在一起。幸运的是，有不含磷的以太 II，它正如其名！
Vintagium	请改用 Celeritas！

---

问答 / 解答：

这个模组是如何工作的？

阅读源代码是真正理解这个模组内部工作原理的最佳方式，但我将在此处描述一个简化版本：

对于世界中的每个方块，原版有两个存储在每个区块中的特性：一个必需的 IBlockState 和一个可选的 TileEntity。流体重置 API 添加了第三个存储在每个区块中的特性：一个可选的 FluidState，如果存在流体重置流体，它将会存储该流体。

这个模组应用 ASM（一个随 Forge 一起提供的字节码操作库）来让原版和 Forge 能够正确读取和使用 FluidStates。

添加这个模组到现有世界安全吗？

在添加任何新模组之前，备份你的世界通常是个好主意。话虽如此，这个模组不会改变 IBlockStates 的行为，所以将其添加到现有世界应该没有问题！从现有世界中移除这个模组也应该没问题，只是请注意，现有的 FluidStates 将会被移除，并且移除后将无法恢复。

如何使用这个模组的配置文件？如何将这个模组作为依赖项使用？

这个模组的维基最终将涵盖这两个主题，但目前它只涵盖了如何使用这个模组的配置。如果你想将流体重置 API 用作库（可选或必需依赖项），在我完成维基之前，我能做的最好的事情是向你推荐我这些其他项目的源代码：Campfire、Seared Ladder Backport、Subaquatic。

如果我遇到任何错误、崩溃或模组不兼容，该怎么办？

向你发现的任何问题报告到本模组的问题追踪器，将极大地帮助我改进这个模组！没有人们慷慨地花时间这样做，这个模组就不会有今天的成就！

---

如果你希望获得 1.12.2 之后版本的流体重置功能，请查看 流体重置（与流体重置 API 无关联）和 毛巾！

直接联系：jbred.dev@gmail.com

此模组将不会移植。