SuperGUILib V2 - 增强版 Minecraft GUI 库
一款适用于 Minecraft 1.21.11 (Fabric) 的现代、易用的 GUI 库,让创建美观的用户界面变得简单而有趣!
? 什么是 SuperGUILib?
SuperGUILib 是一个强大的工具包,帮助 Minecraft 模组开发者创建出色的图形用户界面,无需处理复杂的渲染代码。把它想象成一个“GUI 构建器”,让你只需几行代码就能创建菜单、设置屏幕和交互式显示界面!
非常适合:
- 设置菜单
- 自定义物品栏
- 交互式显示
- 配置屏幕
- 游戏内工具和实用程序
✨ 主要特性
- ? 精美预样式组件 - 按钮、滑块、文本字段等
- ?️ 交互元素 - 点击音效、悬停效果、冷却时间
- ? 自动滚动 - 自动处理内容溢出
- ? 物品显示 - 展示 Minecraft 物品并附带提示框
- ? 自定义音效 - 为 UI 添加音频反馈
- ? 响应式设计 - 适应不同屏幕尺寸
- ? 易于使用 - 简单的构建器模式 API
? 快速入门
在游戏中尝试
运行以下命令查看示例:
/sgl-v2 testgui - 包含所有功能的增强版示例菜单
/sgl testgui - 原始示例菜单
创建你的第一个 GUI
import org.stepan1411.super_gui_lib.client.api.GuiBuilder;
import net.minecraft.client.gui.screen.Screen;
public class MyFirstGUI {
public static Screen create() {
return GuiBuilder.create("My Settings")
.panelSize(300, 200)
.label("Welcome to My Mod!")
.color(0xFFFFFF00)
.add()
.button("Click Me")
.onPress(() -> System.out.println("Hello!"))
.add()
.slider("Volume")
.value(0.7)
.onChange(value -> setVolume(value))
.add()
.build();
}
}
就是这样!你刚刚在不到 20 行代码中创建了一个包含标签、按钮和滑块的 GUI!
? 代码示例
示例 1:简单设置菜单
Screen settingsGui = GuiBuilder.create("Game Settings")
.panelSize(350, 250)
.slider("Master Volume")
.value(0.8)
.fillColor(0xFF00FF00)
.onChange(vol -> game.setVolume(vol))
.add()
.slider("Brightness")
.value(0.5)
.fillColor(0xFFFFAA00)
.onChange(bright -> game.setBrightness(bright))
.add()
.button("Apply")
.surface(Surface.DARK_PANEL)
.onPress(() -> saveSettings())
.add()
.button("Cancel")
.onPress(() -> closeScreen())
.add()
.build();
示例 2:带冷却时间的交互按钮
GuiBuilder.create("Combat Menu")
.panelSize(300, 200)
.button("Quick Attack")
.cooldownSeconds(1.0) // 1 秒冷却时间
.onPress(() -> player.attack())
.add()
.button("Heavy Attack")
.cooldownSeconds(3.0) // 3 秒冷却时间
.surface(Surface.flat(0xFF660000))
.onPress(() -> player.heavyAttack())
.add()
.build();
示例 3:文本输入表单
GuiBuilder.create("Player Registration")
.panelSize(350, 250)
.label("Enter your name:").add()
.textField()
.placeholder("Name...")
.textOnly() // 仅允许字母
.maxLength(20)
.onChange(name -> playerName = name)
.add()
.label("Enter your age:").add()
.textField()
.placeholder("Age...")
.numbersOnly() // 仅允许数字
.maxLength(3)
.onChange(age -> playerAge = age)
.add()
.button("Submit")
.onPress(() -> registerPlayer())
.add()
.build();
示例 4:自定义样式菜单
GuiBuilder.create("Styled Menu")
.panelSize(400, 300)
.panelSurface(Surface.flat(0xE0101010).and(Surface.outline(0xFF00AAFF)))
.label("Super Cool Menu")
.color(0xFF00FFFF)
.scale(2.0f)
.shadow(true)
.add()
.button("Neon Button")
.size(250, 25)
.surface(Surface.flat(0xFF003366).and(Surface.outline(0xFF00FF00)))
.onPress(() -> doSomething())
.add()
.build();
? 可用组件
| 组件 | 描述 | 用途 |
|---|---|---|
| Button | 支持冷却时间的可点击按钮 | 操作、导航 |
| Slider | 水平/垂直值选择器 | 音量、亮度、设置 |
| Label | 带样式的文本显示 | 标题、描述 |
| TextField | 带验证的文本输入 | 用户输入、搜索 |
| ItemDisplay | 展示 Minecraft 物品及提示框 | 物品栏、展示柜 |
| VolumeMeter | VU 表风格指示器 | 音频电平、进度 |
| ScrollContainer | 自动滚动容器 | 长内容列表 |
? 组件特性
按钮
- 自定义颜色和表面样式
- 点击音效
- 冷却系统
- 悬停效果
- 动态文本更新
滑块
- 水平和垂直方向
- 自定义颜色(轨道、填充、手柄)
- 数值标签
- 实时回调
- 平滑拖拽
文本字段
- 占位符文本
- 仅字母或仅数字验证
- 最大长度限制
- 自定义颜色
- 边框样式
物品显示
- 展示任意 Minecraft 物品
- 自动提示框
- 可缩放大小
- 自定义背景
- 动态更新
? 安装
面向模组开发者
- 下载
SuperGUILib-*.jar - 添加到项目的
libs文件夹 - 更新
build.gradle:
dependencies {
modImplementation files('libs/SuperGUILib-*.jar')
include files('libs/SuperGUILib-*.jar')
}
从源代码构建
./gradlew build
编译后的 JAR 文件位于 build/libs/ 目录中
? 文档
完整文档见 SGL-WIKI:
- Home - 概述与简介
- Quick Start - 5分钟快速上手
- Components Guide - 所有组件详解
- Examples - 真实代码示例
- Advanced Features - 滚动、冷却时间、样式等高级功能
? 游戏内指令
使用以下指令测试所有功能:
/sgl-v2 testgui - 增强版 V2 菜单(推荐!)
/sgl testgui - 原始示例菜单
? 颜色格式
SuperGUILib 使用 ARGB(Alpha-Red-Green-Blue)格式:
0xAARRGGBB
││││││└└─ 蓝色 (00-FF)
││││└└─── 绿色 (00-FF)
││└└───── 红色 (00-FF)
└└─────── 透明度 (00=透明, FF=不透明)
示例:
0xFFFF0000- 不透明红色0x80FF0000- 半透明红色0xFF00FF00- 不透明绿色0x800033FF- 半透明蓝色
需要帮助? 查看 Wiki
你是这个资源的作者?登录后可认领此资源。
相似资源
一个用于收集生物掉落物的多区块模组。
显示你正在注视的方块的信息。(适用于 Minecraft 1.16+ 的 Hwyla/Waila 分支)
查看物品与配方
在游戏画面角落显示附近世界地形、玩家、生物和实体的地图。可创建路径点,帮助你找到标记过的位置。
使用 JavaScript 编辑配方、添加自定义物品、编写世界事件!
适用于 MC 1.18+ 的 Effekseer 加载器
评论 0
登录后参与评分
还没有评论,来抢沙发吧