kUI

kUI

kUI 是 KALPE 模组背后的共享界面层。

一个界面,整理游戏中的所有 HUD

按 K。把快捷栏拖到更合适的位置。缩小计分板。隐藏准星。把某个模组的卡片从你的生命值条下方移开。关闭界面,一切保持原样。


Description

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 编辑器。安装任何基于它的模组后,该模组的元素会出现在同一界面中,与其他所有元素一起排列。

Development

正在构建带有 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 就会免费跟随用户选择的强调色。

GitHub 上的完整集成指南 →

五个步骤,并为唯一棘手之处提供了可直接复制的模板:处理 kUI 未安装的情况。在 recommends 而非 depends 下声明它,将你的 dev.kui 引用置于单个门面类之后,没有该库的玩家会看到一个说明应安装什么内容的界面,而不是启动失败。

Licence

kUI 可免费使用,也可免费随附分发。你可以基于它构建,也可以原样再分发它——包括将其捆绑在你自己的模组内——无需许可,无需付费。

不允许的是发布修改过的 kUI,或以其他名称、或作为你自己的作品发布它。私下为你自己的副本打补丁,用于调试或准备向上游提交修复,是明确允许的。

Copyright © 2026 KALPE. 完整许可证 →