Cloth Config API——Minecraft 中用于设置界面的模组

Cloth Config API——Minecraft 中用于设置界面的模组

Cloth Config API 是一个库，数十个 Minecraft 模组都需要它，以便将各自的设置显示为游戏内菜单，而不是文本文件。它本身不会向游戏添加任何内容：没有物品、没有方块，也没有新机制。它是一项依赖项——没有它，引用它的模组将无法启动，并会在模组列表中报错。

何时需要这个模组

这个库不是单独安装的，而是与其他模组一起安装。要判断某个整合包是否需要它，有两种方法：

• 模组在 Modrinth 或 CurseForge 上的描述在 Dependencies 列表中注明了 Cloth Config API。

• 启动整合包时游戏关闭，而日志（logs/latest.log）中出现缺失 cloth-config 或 cloth-config-2 的提示。

内部名称 cloth-config-2 属于同一个模组——这是从该库的第二个大版本开始出现的标识符。如果有人写“需要 cloth-config-2”，指的就是现代版本的 Cloth Config API。

如何打开模组的设置

在 Forge 和 NeoForge 上，已安装模组的列表内置于游戏主菜单中——即 Mods 选项。在每个接入了 Cloth Config 的模组旁边，会出现一个设置图标。点击它会打开一个单独的界面，列出该模组的所有参数。

在 Fabric 上，加载器中没有标准的模组列表，因此对 Cloth Config 界面的访问要通过第三方的模组查看工具实现——它会显示已安装内容的列表，并让你点击所需条目旁边的按钮。

借助 Cloth Config 进行模组设置 

界面本身是什么样子

该模组的所有界面都按同一套方案组织：左侧是参数分类，中间是参数本身，底部是“保存”和“取消”按钮。每个参数都用与其值类型相对应的界面元素来显示。 

在界面上方，对于带有数十个参数的配置，有一个搜索框——它会按名称筛选列表。对于模组作者设置了描述的参数，将光标悬停时会出现带有说明的提示框。

如果输入的值超出允许范围或格式不合法，该字段会被高亮显示，保存按钮将保持不可用，直到错误被修正为止。每个参数旁边都有一个重置按钮——它会将值恢复为模组作者标记为默认的值。

结论

Cloth Config API 是一项基础设施依赖：没有它，部分模组根本无法启动，但在没有其他接入模组的情况下，这个模组本身在游戏中不会带来任何可见的内容。它的作用是把不同 Minecraft 模组的设置统一到一个共同的视觉标准，而不是十几种各不相同的界面。在 Fabric 和跨平台整合包中，Cloth Config API 仍然是最普及的通用标准。