SH Better UI

SH-Better-UI

简体中文 · 安装 · 开发者文档

SH-Better-UI 是适用于 Forge 1.20.1 和 NeoForge 1.21.1 的 Minecraft 界面前置库。模组和整合包可以使用其中可复用的控件、材质和布局工具，制作菜单、配置界面和 HUD 覆盖层。

功能

• 玻璃材质与主题 — 使用液态玻璃、实时背景模糊、Slate 深色风格、空间阴影和动态主题构建界面。动态主题还能随游戏内时间、天气和周围环境变化。
• 可复用控件 — 添加可搜索输入框、物品和流体选择器、对话框、提示框、操作面板和可滚动布局。可选的 JEI 集成可提供配方与用途界面。即使不安装 JEI，也能使用通用搜索和材料选择功能。
• 富文本 — 在同一布局中混排带样式的文本、图片、物品和交互元素。实验性的游戏内编辑器支持实时预览、撤销与重做、JSON 导入与导出，以及 Java 导出。
• HUD 与实时活动 — 展示接入模组提供的进度、通知和操作。可停靠窗口支持折叠，并会记住自己的位置。
• 共用界面 API — 使用统一 UI 内核处理渲染、布局、输入、焦点、主题和资源管理。声明式页面、虚拟列表、原生容器集成和 KubeJS 绑定，可用于制作自定义模组与整合包界面。

安装

安装与 Minecraft 版本和模组加载器相匹配的 SH-Better-UI 文件及 Kotlin for Forge 版本。

SH-Better-UI 下载 · Kotlin for Forge

在游戏中试用

F7 和 F8 是默认快捷键。进入世界后即可运行演示命令。

开发者文档

在模组中声明 sh_better_ui 为依赖，并将对应的 SH-Better-UI 运行时 JAR 与模组一同发布。API 参考文档和示例项目介绍了如何在两种加载器上接入共用控件和统一 UI 内核服务。

源代码 · 英文 API 参考 · Forge 与 NeoForge 示例项目 · 报告问题

1.0.6 版本更新

面向从 1.0.3 升级的用户，介绍 Forge 和 NeoForge 两个版本的主要更新。

• Liquid Glass 与主题 — 改进边缘折射效果，新增可调节的模糊和透光度，并扩充材质图库。控制面板新增固定主题、动画速度和低性能模式选项。
• 富文本工具 — 新增行内图片、物品和交互内容，以及带实时预览和文档导出功能的实验性编辑器。
• 停靠窗口与实时活动 — 新增可折叠的停靠窗口（支持记住位置）和 F7 活动界面。
• 模组与整合包集成 — 新增统一 UI 内核、检查器中的布局与输入诊断、声明式页面、原生容器和 KubeJS 绑定。接入的界面可以使用同一套布局进行绘制、裁剪和指针命中测试。

简体中文

返回英文介绍 · 安装要求 · 开发文档

SH-Better-UI（焕界 UI 库） 是面向 Forge 1.20.1 和 NeoForge 1.21.1 的 Minecraft 共用界面库。模组和整合包可以使用库中的控件、材质和布局工具制作菜单、配置页面和 HUD。

主要功能

• 玻璃材质与主题：提供液态玻璃、实时背景模糊、Slate 深色主题和立体阴影。动态主题可随游戏内时间、天气和环境变化。
• 共用控件：提供搜索建议、物品与流体选择器、对话框、提示气泡、动作面板和滚动布局。安装 JEI 后可接入配方和用途界面，通用搜索与素材选择也可独立使用。
• 富文本：支持在同一段落中混排样式文本、图片、物品和可交互内容。实验性游戏内编辑器支持实时预览、撤销与重做、JSON 导入导出和 Java 导出。
• HUD 与实时活动：展示已接入模组提供的进度、通知和操作。可停靠窗口支持折叠并记住位置。
• 共用界面 API：统一 UI 内核提供渲染、布局、输入、焦点、主题和资源管理服务。开发者可使用声明式页面、虚拟列表、原生容器和 KubeJS 绑定制作自定义界面。

安装要求

选择与 Minecraft 版本和加载器匹配的 SH-Better-UI 文件，并安装对应的 Kotlin for Forge。

下载 SH-Better-UI · 下载 Kotlin for Forge

游戏内体验

F7 和 F8 为默认快捷键。示例命令在进入世界后使用。

开发文档

在模组中声明 sh_better_ui 依赖，并随整合环境安装对应加载器的 SH-Better-UI 运行包。API 文档和双端示例包含共用控件与统一 UI 内核的接入方式。

项目源码 · 简体中文 API 参考 · Forge 与 NeoForge 接入示例 · 提交问题

返回顶部