OpenUI MC

OpenUI MC

一个可复用、声明式且响应式的Minecraft模组UI框架。

OpenUI MC

OpenUI MC 是一个客户端 UI 框架,供 Minecraft 模组开发者使用,用于构建精致、响应式的界面,而无需重新处理焦点、输入路由、布局、动画和控件生命周期等繁琐工作。

OpenUI MC logo

对于玩家

OpenUI MC 是一个库模组。它本身不会添加方块、物品、配方或游戏玩法。当另一个模组将 OpenUI MC 列为必需依赖时,请安装它,并确保 Minecraft 版本和加载器与该模组匹配。

对于模组开发者

  • 声明式的行、列、堆叠、内边距、裁剪、响应式布局、网格和虚拟列表
  • 响应式信号、计算值、效果、批处理、记忆状态和异步状态
  • 按钮、文本字段、开关、滑块、选择框、选项卡、表格、图表、表单和验证
  • 管理的焦点、键盘导航、指针捕获、拖放以及原版 Minecraft 控件
  • 对话框、弹窗、菜单、工具提示、通知、命令面板和分层覆盖层
  • 主题、动画、导航、错误边界和 UI 检查工具
  • 用于普通界面和菜单/容器界面的基类

OpenUI MC 让应用程序代码专注于状态和业务回调,而其运行时负责挂载组件、计算布局、渲染、分发输入、管理焦点并清理资源。

支持的平台

Minecraft 加载器 所需 Java
1.20.1 Fabric 17
1.20.1 Forge 17
1.21.1 Fabric 21
1.21.1 NeoForge 21
26.1.2 NeoForge 25

请下载与你的 Minecraft 版本和加载器都匹配的文件。构建版本为客户端专用,且不同 Minecraft 世代之间不可互换。

开发者文档

重要的 26.1.2 版本说明

Minecraft 26.1.2 使用了其提取的 GUI 渲染状态 API。OpenUI 支持该 API,但 FadeTransition 不可用,因为 Minecraft 不再为任意 UI 子树提供安全的限定范围不透明度操作。滑动和缩放过渡仍然可用。

支持与许可证

请在 GitHub 问题追踪器 上报告错误和兼容性问题。请包含 Minecraft 版本、加载器、OpenUI 版本和使用该库的模组。

OpenUI MC 由 NsTut 编写,并根据 MIT 许可证 分发。