ukulib — Minecraft 模组
ukulib 是 uku3lig 系列模组的公共辅助库,提供现成的设置菜单和统一界面,是这些模组正常运行所必需的依赖项。
ukulib 是 uku3lig 系列模组的公共辅助库,提供现成的设置菜单和统一界面,是这些模组正常运行所必需的依赖项。
ukulib — Minecraft 模组
该文章测试和撰写所使用的 Minecraft 版本:26.1.2
支持的版本范围:b1.7.3 – 26.1.2
依赖项:Fabric API(用于 Fabric 版本构建)
ukulib 是由开发者 uku3lig 制作的 Minecraft 辅助模组库。它本身只是一个程序框架,同一作者的其他客户端模组都建立在其之上。该文件作为必需依赖被放入 mods 文件夹:没有它,主模组根本无法启动游戏。
在整合包中的作用
该库包含现成的设置界面组件,以及用于处理命令、定位和文本的基础工具。基于它编写模组的作者不需要从零实现选项菜单——只需接入 ukulib 并使用其现成的控件。所有基于该库构建的模组都拥有相同的配置风格,接近原版 Minecraft 界面,不依赖第三方 UI 框架。
该库包含现成的设置界面组件。基于它编写模组的作者不需要从零实现选项菜单——只需接入 ukulib 并使用其现成的控件。
共用的模组列表界面
玩家唯一会直接接触到的库的部分,是一个单独的菜单,列出所有与 ukulib 集成的模组。它通过加载器的标准模组浏览界面打开。界面上只显示在清单中注册了入口点的模组——点击列表中的项目会直接进入对应模组的设置页面。
设置界面是什么样的
基于该库构建的配置页面拥有统一的外观:中间是参数列表,底部是取消和完成按钮。数值通过标准控件修改——布尔值使用开关,数值范围使用滑块,字符串值使用输入框,可枚举选项使用循环选择按钮。

基于 ukulib 的模组设置界面截图片段
使用该库的模组会以 TOML 格式写入自己的设置文件,并将其放在 config 文件夹中,与自己的配置文件放在一起。库本身没有任何可修改的自有设置——文件夹中的任何 .toml 文件都属于使用该库的模组,而不属于 ukulib。
结论
ukulib 只解决一个问题——通过为开发者提供现成的设置菜单模板和基础工具,它消除了同一作者的模组之间的代码复制粘贴,并将它们的设置统一为共同的风格。适合那些已经用 uku3lig 的模组搭建好客户端、并希望游戏不会因缺少依赖而崩溃启动的玩家。
安装
一次典型安装大约 5 分钟。流程相同,只是 Loader 和对应构建不同。
- 1Install a mod loader (Forge, Fabric or NeoForge) that matches your Minecraft version.
- 2Download the mod file (.jar) built for that same version.
- 3Place the .jar into your .minecraft/mods folder.
- 4Launch Minecraft with the modded profile and check the mod loads in-game.











