LibJF — 在 Minecraft 中支持第三方模组的技术库与核心

LibJF — 在 Minecraft 中支持第三方模组的技术库与核心

LibJF 是作者 JFronny 制作的一个模块化前置库，包含了一组用于他自己模组的共享组件。在玩家的电脑上，这个模组通常不会单独安装，而是作为强制性的前置依赖——如果没有它，相应的模组将无法启动。LibJF 不会向 Minecraft 添加配方、生物或新方块。它的任务与众不同：将重复性的功能——配置文件格式、翻译系统、本地 HTTP 服务器、两个实用标签——提取到一个独立的项目中，并在同一开发者的不同模组中重复使用。

在整合包中的作用

该库被分为独立的模块，每个模块负责自己的任务：配置文件的格式及其游戏内菜单、物品标签、翻译、网络组件。依赖于 LibJF 的模组只加载它们实际使用的模块。因此，在首次启动游戏后，config/ 文件夹中不会只出现一个文件，而是会出现多个——每个活动模块一个文件。

玩家会立刻注意到的一个基本效果是配置的自动重新加载。watchForChanges 参数默认是开启的：如果你更改了任何通过 LibJF 运行的配置文件，无需重启游戏即可应用更改。

物品与盔甲的通用标签

LibJF 添加了两个标签，既可用于其他模组，也可用于原版数据包：

标签本身是空的——它们由数据包或第三方模组填充。例如，要在生存模式中使全套皮革盔甲“刀枪不入”，只需创建一个小数据包，将 minecraft:leather_helmet、minecraft:leather_chestplate、minecraft:leather_leggings 和 minecraft:leather_boots 添加到 libjf:overpowered 标签文件中即可。

翻译子系统

libjf-translate-v1 模块使开发者的其他模组能够访问字符串翻译服务。该库本身不在聊天或界面中翻译任何内容——它只决定如果消费者模组调用它们时，请求将通过哪个外部服务。支持四种提供商选项：

• Google — 公开的 Google 翻译接口 (默认值)。

• DeepLX — DeepL API 的开放实现。

• LibreTranslate — 自托管的开源解决方案；需要单独指定实例地址。

• Noop — 一个桩函数，原样返回输入的文本；便于测试和完全禁用翻译。

一个独立的 throttleMillis 参数设置了服务调用之间的最小暂停时间。此限制是必要的，以避免消费者模组频繁请求导致免费 API 临时封禁。

本地 Web 服务器

libjf-web-v1 模块在游戏内启动一个小型的 HTTP 服务器。当需要给客户端提供超出常规网络数据包的内容（例如静态页面或预览文件）时，作者的其他模组会使用它。在玩家的标配环境中，此模块通常处于静默状态：端口仅在本地 (127.0.0.1) 开放，文件共享功能是禁用的。

私服管理员可以通过单独的配置参数，将 config/wwwroot 文件夹中的任意文件作为静态资源共享——这是一个可选功能，默认未激活。

总结

LibJF 是一个依赖库，当整合包包含同一开发者的模组，或者包含使用了 libjf:overpowered 或 libjf:shulker_boxes_illegal 标签的数据包时，就需要用到它。与同类的其他前置库相比，它的特点是具有模块化架构，并带有一个本地 HTTP 服务器以及一个翻译层，这是大多数辅助库所不提供的。对于普通的纯原版 Minecraft Java 版整合包，安装 LibJF 毫无意义；而对于带有 JFronny 模组的整合包，它是必不可少的组件。