Fluidlogged API

作者：embeddedt, Cleanroom 等

一款为 1.12.2 添加高度可自定义流体填充功能的前置库模组！

模组 Forge 前置库外观实用游戏机制装饰

截图

介绍

介绍由机器翻译自 Modrinth 原页面，仅供参考。

为 1.12.2 添加高度可自定义流体填充功能的前置库模组！

流体填充是一种机制，灵感来自原版的水填充机制，运作方式也非常相似。主要区别在于，Fluidlogged API 支持非源头流体以及所有模组添加的流体！

如果你是整合包开发者，想在 CurseForge 或 Modrinth 以外的平台发布包含 Fluidlogged API 的整合包，请使用 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 水面上的平滑光照无法正常工作

问 / 答：

这个模组是如何运作的？

要真正了解这个模组的内部工作原理，最好阅读源代码。这里我会简单介绍一下：

对于世界中的每个方块，原版都会在每个区块中存储两项内容：必需的 IBlockState 和可选的 TileEntity。Fluidlogged API 增加了第三项内容并将其存储在每个区块中：可选的 FluidState，用于存储存在时含水方块中的流体。

此模组使用 ASM（Forge 附带的字节码操作前置库），让原版和 Forge 能够正确读取并使用 FluidStates。

将此模组添加到现有地图中安全吗？

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

我如何使用这个模组的配置？我如何将这个模组作为前置库使用？

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

如果我遇到任何漏洞、崩溃或模组不兼容问题，我该怎么办？

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