
kUI
kUI 是 KALPE 模组背后的共享界面层。
一个界面,整理游戏中的所有 HUD
按 K。把快捷栏拖到更合适的位置。缩小计分板。隐藏准星。把某个模组的卡片从你的生命值条下方移开。关闭界面,一切保持原样。

kUI 是 KALPE 系列模组共用的界面层。来自每个 kUI 模组的每个 HUD 元素都会进入同一个注册表,通过同一个渲染钩子绘制,并在同一个编辑器中排列。两个模组再也不会把各自的卡片叠在一起,绘制顺序也变成了由你掌控的数字,而不是取决于哪个模组碰巧先加载。
原版 HUD 也在其中。 快捷栏、生命值、饥饿值、护甲、氧气、坐骑生命值、经验条与等级、手持物品名称、动作栏、准星、标题文本、字幕、Boss 血条、状态效果、计分板、玩家列表和聊天栏都可以移动、缩放和隐藏——无需 mixin,无需资源包,也没有任何东西会阻止游戏将它们放回原来的位置。
原版元素周围的选择框是测量出来的,而非猜测:kUI 用元素自身的渲染器在一个临时状态上运行,并取得其实际绘制内容的真实边界。选择框会贴合你实际拥有的计分板,包含它实际拥有的行。
在编辑器中
| 拖拽 | 移动任何元素 |
| 滚轮 | 调整大小 |
| Ctrl + 滚轮 | 淡化模组元素 |
| 右键 | 显示 / 隐藏 |
| 中键 | 循环切换元素外观(若其有多种外观) |
| Ctrl + 点击 | 多选,然后编组 |
| 双击 | 进入组内编辑单个成员 |
| 方向键 | 微调 1px,按住 Shift 为 10px |
编组的元素会作为一个整体移动——快捷栏和与之紧贴的血条已预先编组,因为只移动快捷栏而不带走生命值条,几乎从来不是任何人想要的。
保持停靠状态的元素会自动堆叠在其角落的车道中,因此无论你添加多少模组,它们都不会重叠。将某个元素拖到任意位置,它就会切换为自由放置,以距最近角落的偏移量存储,这样在你调整窗口大小时它也会保持原位。
一种强调色,处处统一
在编辑器中选定一种颜色,所有 kUI 模组都会跟随它——面板、边框、高亮、HUD 卡片。模组可以在其身份重要的地方携带自己的强调色,你也可以覆盖它。全局 UI 缩放、每元素缩放和每元素不透明度都位于同一处。
你的布局存储在 config/kui/layout.json 中,按模组为键,因此你卸载的模组永远不会干扰其他模组,任何单个元素都可以单独重置。
要求
Fabric,仅客户端。需要 Fabric API。为 1.21.8 和 1.21.11 构建——请下载与你版本匹配的文件。
单独使用时,kUI 为你提供原版 HUD 编辑器。安装任何基于它的模组后,该模组的元素会出现在同一界面中,与其他所有元素一起排列。

正在构建带有 HUD 的 Fabric 模组?kUI 为你提供注册表、布局引擎、编辑器、主题和绘制原语,因此你只需编写元素本身,别无其他:
KuiMod.of("mymod", "My Mod")
.accent(0xFF9B3D)
.settings(MySettingsScreen::new)
.element(new MyElement())
.register();
这就是全部的集成工作。你的元素会自动获得拖拽、缩放、淡化、编组、与其他模组元素的 z 轴排序能力,以及在共享编辑器中的位置——这些你都不必编写,并且其行为与配置中其他所有 kUI 模组完全一致。
使用 Theme.accent(modId) 和 Draw.roundedCard 进行绘制,而不是硬编码颜色和矩形,你的 HUD 就会免费跟随用户选择的强调色。
五个步骤,并为唯一棘手之处提供了可直接复制的模板:处理 kUI 未安装的情况。在 recommends 而非 depends 下声明它,将你的 dev.kui 引用置于单个门面类之后,没有该库的玩家会看到一个说明应安装什么内容的界面,而不是启动失败。

kUI 可免费使用,也可免费随附分发。你可以基于它构建,也可以原样再分发它——包括将其捆绑在你自己的模组内——无需许可,无需付费。
不允许的是发布修改过的 kUI,或以其他名称、或作为你自己的作品发布它。私下为你自己的副本打补丁,用于调试或准备向上游提交修复,是明确允许的。
Copyright © 2026 KALPE. 完整许可证 →
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。