Forge Config API Port — Minecraft Java Edition

原版 Minecraft 并没有内置用于方便配置游戏或模组设置的工具，这迫使开发者需要自行创建设置保存系统。Forge 模组加载器以其自身的配置系统提供了一个现成的解决方案，但 Fabric 在历史上一直缺乏统一的标准。正因如此，跨平台模组的创作者不得不为每个加载器编写独立的设置代码，在这上面耗费了大量时间。Forge Config API Port 库通过将 Forge 经过时间检验的配置接口移植到 Fabric 和 Quilt，从而解决了这一问题。

该库的工作原理

Forge Config API Port 充当了模组代码和游戏文件系统之间的中介。它在 Fabric 环境中完全再现了原始的 net.minecraftforge.common.ForgeConfigSpec 和 net.neoforged.fml.config 包。开发者只需使用标准的 Forge 语法编写一次配置说明，该库就会自动在磁盘上创建适当的文件并管理其加载。

TOML 配置文件格式

该库将所有设置以 TOML 格式保存。这种格式提供了一个方便使用普通文本编辑器阅读和编辑的结构。每个参数都可以包含注释、默认值以及明确的允许值范围（最小和最大数字）。在首次启动模组后，配置文件会自动出现在游戏根目录下的 config 文件夹中。它们具有 .toml 扩展名，名称由模组开发者指定。

自动同步与动态重载

Forge Config API Port 最重要的特性之一是其内置了对配置同步和动态重载的支持：

• 服务器与客户端之间的同步 (Sync)：当玩家连接到服务器时，服务器会自动将其设置发送给客户端。这可以防止服务器上的玩家因配置版本不同而产生冲突。

• 动态重载 (Reload)：该库实时跟踪 TOML 文件的更改。如果您在游戏过程中编辑并保存配置文件，Forge Config API Port 将立即更新内存中的参数，而无需重新启动 Minecraft 客户端。

这些机制自动运行，使开发者无需自己编写同步配置值的网络通信代码。

对玩家和开发者的意义

对于普通玩家来说，Forge Config API Port 并没有添加任何可见的内容、新的方块或物品。它的作用是确保其他模组能够正常工作。如果其他模组引用了该库的类，那么如果不安装此库，游戏将根本无法启动。由于 Forge 和 NeoForge 默认在其结构中就包含这些功能，因此该模组主要是 Fabric 用户需要的。

对于开发者而言，该库是创建跨平台项目时不可或缺的工具。它允许：

1. 节省数百行曾经用于为不同加载器开发独立设置保存逻辑的代码。

2. 由于配置文件在 Fabric 和 Forge 上具有相同的结构，因此可以为最终用户提供相同的模组管理体验。

3. 使用 Forge 强大的值验证工具，该工具可自动纠正用户的错误输入，并在崩溃时将参数恢复为默认值。

常见依赖此库的模组

以 Fuzs（或 Fuzs_）为名的库开发者在其所有热门模组中都使用了它。以下是一些著名的例子：

• Easy Magic：一款改变附魔台机制的模组，允许将物品保留在附魔台的物品栏中，并添加了增强附魔的新方法。

• Trading Post：一个将周围所有村民的交易选项整合到一个界面中的方块。

• Visuality：一款视觉效果模组，添加了由于各种生物动作而产生的逼真泥土颗粒、火花和水花溅射效果。

• Easy Shulker Boxes：允许直接在物品栏中与潜影盒交互，而无需将它们放置在地上。

除了 Fuzs 的项目外，还有数百名其他开发者正在使用 Forge Config API Port 将他们的工作从 Forge 移植到 Fabric，使玩家能够访问庞大的高质量内容库。