
Lumina UI
一个快速、灵活的GUI库:flexbox布局、主题、流畅动画、渐变、HTML/CSS屏幕、60+控件、HUD和服务器同步菜单

Lumina UI 是一个用于在 Minecraft 模组中构建美观、快速且灵活界面的库。
它是其他模组的依赖项:单独使用时仅添加一个小型演示(/lumina demo)。
同时支持 Forge 1.20.1 和 NeoForge 1.21.1,API 相同,因此编写一次的 UI 代码可在两者上运行。
为什么选择 Lumina
- 开箱即用的现代外观。 圆角、边框、柔和阴影、发光和渐变由 SDF 着色器绘制,在任何 GUI 缩放下都清晰锐利。
- 快速。 布局和样式会被缓存,不可见元素会被跳过,UI 空闲时不运行任何内容,帧渲染几乎不产生内存分配。
- 灵活。 每个控件、布局、样式属性和事件都可以用普通 Java 代码替换或扩展。无需反射,无需注解。
- 响应式。 将控件绑定到信号,它们便会自行更新。
功能
- 布局: flexbox(gap、grow/shrink、justify、align)、堆叠层、网格、绝对定位、响应式断点、UI 缩放。
- 样式: 带令牌的主题(更改强调色或圆角半径,整个 UI 会平滑跟随)、多种样式类、悬停/按下/聚焦/禁用状态、逐属性过渡。
- 颜色: RGB、HSV、HSL、OKLCH;最多 8 个色标的线性、径向和锥形渐变;混合模式;背景模糊。
- 动画: 关键帧、序列、循环、yoyo、23 种缓动曲线和弹簧。
- HTML 和 CSS: 用标记和样式表描述屏幕,直接在标记中绑定逻辑,使用 F3+T 热重载,通过资源包覆盖。
- 60+ 控件: 按钮、文本和数字输入框、滑块、开关、复选框、单选组、下拉框、按键绑定输入框、日期和颜色选择器、标签页、侧边导航、窗口、上下文菜单和径向菜单、工具提示、表格、树、支持数万行的虚拟列表、图表、带验证的表单、向导、Markdown 以及带语法高亮的书籍。
- 游戏控件: 支持拖放的物品栏槽位、3D 中的生物和玩家、3D 物品和方块结构、世界预览、小地图和世界地图。
- 游戏内 HUD: 条、仪表、计时器、Boss 血条、提示和通知流,绑定到实时游戏数据。
- 服务器同步的容器屏幕: 使用 Lumina UI 的自定义箱子和机器,像原版菜单一样同步。
- 配置屏幕 由简单描述生成,保存为 TOML。
- UI 中的原版效果: 火焰、爆炸、下落 TNT、雪、雨和粒子。
- 实时语言切换: 打开的屏幕会立即翻译,无需重建。
- 无障碍: 色盲校正、高对比度主题、文本缩放、减少动态效果、焦点朗读。
- 开发者工具: UI 检查器、手柄导航、主题编辑器。
快速示例
Signal<Integer> clicks = Signal.of(0);Panel window = Panel.column().gap(10).add(
new Label("Lumina UI").scale(1.5f),
Label.bound(clicks.map(c -> "Clicks: " + c)),
new Button("Press me", () -> clicks.update(c -> c + 1)));
Minecraft.getInstance().setScreen(new LuminaScreen(Component.literal("Example"),
screen -> new UiRoot(Panel.box(StackLayout.centered()).fill().add(window))));
面向开发者
开发者指南涵盖添加依赖、创建第一个屏幕、完整 API 以及如何扩展它:Wiki: Developer Guide。
许可证
Lumina UI 采用 GNU LGPL 3.0 许可:你可以在任何模组中使用它,包括闭源模组;对库本身的修改版本必须以相同许可证保持开源。
面向玩家
仅在另一个模组需要时安装 Lumina UI。将适用于你的加载器的 jar 放入 mods 文件夹。
正在加载版本记录…
正在加载评论…
评论在新手盒子客户端中发表,这里同步展示。