概述

一个图形用户界面库，简化了创建原版风格的 GUI 的过程。

这是前置模组，单独安装不会有任何效果。

为何选择ModularUI？

Minecraft 本身以及 Forge 的 GUI 代码的质量并不高，而且您只需要稍微添加几个控件，代码很快就会变得非常混乱。

使用 ModularUI，您可以通过将 GUI 控件（Component/Widgets）添加到具有布局功能的面板（Panel）来快速创建自定义 GUI。

您不必手动计算控件位置（Pos）和控件大小，ModularUI 非常动态，允许创建非常复杂的客户端 GUI，甚至双端（Server-Client，服务端-客户端）同步 GUI，GUI 中的流体槽（Slot）就是一个很好的例子。 

Minecraft 和 Forge 并没有提供任何向 GUI 内添加流体槽或储罐的功能。使用 ModularUI，您只需调用

.child(new FluidSlot().syncHandler(new FluidTank(16000)))

当然还需要一些细节的处理和设置。

特点

• 类似 Windows 的面板（Panel）系统；

• 控件与树状结构，使得代码可读性更好；

• 自动处理控件渲染与交互功能；

• 在服务器和客户端之间轻松同步值；

• 适合仅客户端 GUI 与双端互联 GUI ；

• GUI 主题（Theme）通过JSON加载，可以使用资源包分发；

• TileEntity 绑定 GUI 的良好选择；

• HEI/JEI 支持；

• 支持 Inventory Tweaks；

• 可拖动的窗口系统；

历史上的ModularUI

• ModularUI（此概念）在 GTCE 中首次亮相，由 Archengius 负责；

• 2021年12月30日，GTCEu 首次发布，并对内置于 GTCE 本体中的 ModularUI 进行了增强与改进；

• 2022年1月16日，Rongmario 在 CleanroomMC 组织中创建了 ModularUI 仓库；

• 同年2月19日，brachy84 接手并开始负责维护 ModularUI 项目；

• 同年5月21日，ModularUI 1.0.0 版本在 CurseForge 上发布；

• miozune 将 ModularUI 移植到 1.7.10 ，并且用于 GTNH 项目；

• 经过连续三个月的维护后，brachy84 重写了部分代码；

• 重写部分持续扩大，直到它覆盖了原 ModularUI 的大部分特征，于是 ModularUI 2 发布了；

• 2023年3月21日，ModularUI 2.0.0 版本正式登陆CurseForge发布平台。

此后，ModularUI 维持持续更新/被维护状态。

计划功能｜TODO

高优先级

• 同步（已完成）；

• 原版槽位兼容（已完成）；

• 适当的交互管理（已完成）；

• 依赖父控件/子控件的控件方位和大小（已完成）；

• 文本框（已完成）；

• Tooltips（已完成）。

控件

• Phantom槽位（已完成）；

• 滑块（已完成）；

• 触控板；

• 取色器-可通过拖动来设置数字的按钮（已完成）；

• 列表-可滚动（已完成）；

• 可排序列表-用于InventoryBogoSorter（已完成）；

• 槽位组-Builder构建器和整理功能（已完成）；

• 对话框（已完成）；

• 弹出式菜单（已完成）；

• 下拉式菜单；

• 环形式“饼”型菜单

低优先级

• 物品槽功能-例如Shift右键（已完成）；

• 布局控件（已完成）；

• 纵、横、网格等（已完成）；

• 可滚动功能（已完成）；

• 文本编辑器；

• 主题（已完成）；

• 动画（已完成）；

• JSON 创建 GUI；

• 注入原版 GUI；

• 直接在屏幕上显示错误报告处理；

• 父级控件可覆盖子级（已完成）。

即将制作

• Config库；

• 按键绑定；

• 创建 JEI UI；

• 正确的将 ModularUI 控件等元素显示到任意 GUI 中；

• 音效；

• 把主题改为IDrawable（已完成）；

HoloUI

• 修复/删除当前旋转；

• 互动功能；

画廊