# SuperGUILib V2 – Enhanced Minecraft GUI Library<\/p>\n
A modern, easy-to-use GUI library for Minecraft 1.21.11 (Fabric) that makes creating beautiful user interfaces simple and fun!<\/p>\n
## \ud83c\udfae What is SuperGUILib?<\/p>\n
SuperGUILib is a powerful toolkit that helps Minecraft mod developers create stunning graphical user interfaces without dealing with complex rendering code. Think of it as a “GUI builder” that lets you create menus, settings screens, and interactive displays with just a few lines of code!<\/p>\n
**Perfect for:**
\n– Settings menus
\n– Custom inventories
\n– Interactive displays
\n– Configuration screens
\n– In-game tools and utilities<\/p>\n
## \u2728 Key Features<\/p>\n
– \ud83c\udfa8 **Beautiful Pre-styled Components** – Buttons, sliders, text fields, and more
\n– \ud83d\uddb1\ufe0f **Interactive Elements** – Click sounds, hover effects, cooldowns
\n– \ud83d\udcdc **Auto-scrolling** – Automatically handles content overflow
\n– \ud83c\udfaf **Item Display** – Show Minecraft items with tooltips
\n– \ud83c\udfb5 **Custom Sounds** – Add audio feedback to your UI
\n– \ud83d\udcf1 **Responsive Design** – Adapts to different screen sizes
\n– \ud83d\ude80 **Easy to Use** – Simple builder pattern API<\/p>\n
## \ud83d\ude80 Quick Start<\/p>\n
### Try It In-Game<\/p>\n
Run these commands to see examples:
\n“`
\n\/sgl-v2 testgui – Enhanced examples menu with all features
\n\/sgl testgui – Original examples menu
\n“`<\/p>\n
### Create Your First GUI<\/p>\n
“`java
\nimport org.stepan1411.super_gui_lib.client.api.GuiBuilder;
\nimport net.minecraft.client.gui.screen.Screen;<\/p>\n
public class MyFirstGUI {
\n public static Screen create() {
\n return GuiBuilder.create(“My Settings”)
\n .panelSize(300, 200)<\/p>\n
.label(“Welcome to My Mod!”)
\n .color(0xFFFFFF00)
\n .add()<\/p>\n
.button(“Click Me”)
\n .onPress(() -> System.out.println(“Hello!”))
\n .add()<\/p>\n
.slider(“Volume”)
\n .value(0.7)
\n .onChange(value -> setVolume(value))
\n .add()<\/p>\n
.build();
\n }
\n}
\n“`<\/p>\n
That’s it! You just created a GUI with a label, button, and slider in under 20 lines of code!<\/p>\n
## \ud83d\udcda Code Examples<\/p>\n
### Example 1: Simple Settings Menu<\/p>\n
“`java
\nScreen settingsGui = GuiBuilder.create(“Game Settings”)
\n .panelSize(350, 250)<\/p>\n
.slider(“Master Volume”)
\n .value(0.8)
\n .fillColor(0xFF00FF00)
\n .onChange(vol -> game.setVolume(vol))
\n .add()<\/p>\n
.slider(“Brightness”)
\n .value(0.5)
\n .fillColor(0xFFFFAA00)
\n .onChange(bright -> game.setBrightness(bright))
\n .add()<\/p>\n
.button(“Apply”)
\n .surface(Surface.DARK_PANEL)
\n .onPress(() -> saveSettings())
\n .add()<\/p>\n
.button(“Cancel”)
\n .onPress(() -> closeScreen())
\n .add()<\/p>\n
.build();
\n“`<\/p>\n
### Example 2: Interactive Button with Cooldown<\/p>\n
“`java
\nGuiBuilder.create(“Combat Menu”)
\n .panelSize(300, 200)<\/p>\n
.button(“Quick Attack”)
\n .cooldownSeconds(1.0) \/\/ 1 second cooldown
\n .onPress(() -> player.attack())
\n .add()<\/p>\n
.button(“Heavy Attack”)
\n .cooldownSeconds(3.0) \/\/ 3 second cooldown
\n .surface(Surface.flat(0xFF660000))
\n .onPress(() -> player.heavyAttack())
\n .add()<\/p>\n
.build();
\n“`<\/p>\n
### Example 3: Text Input Form<\/p>\n
“`java
\nGuiBuilder.create(“Player Registration”)
\n .panelSize(350, 250)<\/p>\n
.label(“Enter your name:”).add()<\/p>\n
.textField()
\n .placeholder(“Name…”)
\n .textOnly() \/\/ Only letters allowed
\n .maxLength(20)
\n .onChange(name -> playerName = name)
\n .add()<\/p>\n
.label(“Enter your age:”).add()<\/p>\n
.textField()
\n .placeholder(“Age…”)
\n .numbersOnly() \/\/ Only numbers allowed
\n .maxLength(3)
\n .onChange(age -> playerAge = age)
\n .add()<\/p>\n
.button(“Submit”)
\n .onPress(() -> registerPlayer())
\n .add()<\/p>\n
.build();
\n“`<\/p>\n
### Example 4: Custom Styled Menu<\/p>\n
“`java
\nGuiBuilder.create(“Styled Menu”)
\n .panelSize(400, 300)
\n .panelSurface(Surface.flat(0xE0101010).and(Surface.outline(0xFF00AAFF)))<\/p>\n
.label(“Super Cool Menu”)
\n .color(0xFF00FFFF)
\n .scale(2.0f)
\n .shadow(true)
\n .add()<\/p>\n
.button(“Neon Button”)
\n .size(250, 25)
\n .surface(Surface.flat(0xFF003366).and(Surface.outline(0xFF00FF00)))
\n .onPress(() -> doSomething())
\n .add()<\/p>\n
.build();
\n“`<\/p>\n
## \ud83c\udfa8 Available Components<\/p>\n
| Component | Description | Use Case |
\n|———–|————-|———-|
\n| **Button** | Clickable button with cooldown support | Actions, navigation |
\n| **Slider** | Horizontal\/vertical value selector | Volume, brightness, settings |
\n| **Label** | Text display with styling | Titles, descriptions |
\n| **TextField** | Text input with validation | User input, search |
\n| **ItemDisplay** | Show Minecraft items with tooltips | Inventories, showcases |
\n| **VolumeMeter** | VU-meter style indicator | Audio levels, progress |
\n| **ScrollContainer** | Auto-scrolling container | Long content lists |<\/p>\n
## \ud83c\udfaf Component Features<\/p>\n
### Buttons
\n– Custom colors and surfaces
\n– Click sounds
\n– Cooldown system
\n– Hover effects
\n– Dynamic text updates<\/p>\n
### Sliders
\n– Horizontal and vertical
\n– Custom colors (track, fill, handle)
\n– Value labels
\n– Real-time callbacks
\n– Smooth dragging<\/p>\n
### Text Fields
\n– Placeholder text
\n– Text-only or numbers-only validation
\n– Max length limits
\n– Custom colors
\n– Border styling<\/p>\n
### Item Display
\n– Show any Minecraft item
\n– Automatic tooltips
\n– Scalable size
\n– Custom backgrounds
\n– Dynamic updates<\/p>\n
## \ud83d\udce6 Installation<\/p>\n
### For Mod Developers<\/p>\n
1. Download `SuperGUILib-*.jar`
\n2. Add to your project’s `libs` folder
\n3. Update `build.gradle`:<\/p>\n
“`gradle
\ndependencies {
\n modImplementation files(‘libs\/SuperGUILib-*.jar’)
\n include files(‘libs\/SuperGUILib-*.jar’)
\n}
\n“`<\/p>\n
### Building from Source<\/p>\n
“`bash
\n.\/gradlew build
\n“`<\/p>\n
The compiled JAR will be in `build\/libs\/`<\/p>\n
## \ud83d\udcd6 Documentation<\/p>\n
Full documentation available SGL-WIKI:
\n– [Home](SGL-WIKI\/Home.md) – Overview and introduction
\n– [Quick Start](SGL-WIKI\/Quick-Start.md) – Get started in 5 minutes
\n– [Components Guide](SGL-WIKI\/Components.md) – All components explained
\n– [Examples](SGL-WIKI\/Examples.md) – Real-world code examples
\n– [Advanced Features](SGL-WIKI\/Advanced-Features.md) – Scrolling, cooldowns, styling<\/p>\n
## \ud83c\udfae In-Game Commands<\/p>\n
Test all features with these commands:<\/p>\n
“`
\n\/sgl-v2 testgui – Enhanced V2 menu (recommended!)
\n\/sgl testgui – Original examples menu
\n“`<\/p>\n
## \ud83c\udf08 Color Format<\/p>\n
SuperGUILib uses ARGB (Alpha-Red-Green-Blue) format:<\/p>\n
“`
\n0xAARRGGBB
\n \u2502\u2502\u2502\u2502\u2502\u2502\u2514\u2514\u2500 Blue (00-FF)
\n \u2502\u2502\u2502\u2502\u2514\u2514\u2500\u2500\u2500 Green (00-FF)
\n \u2502\u2502\u2514\u2514\u2500\u2500\u2500\u2500\u2500 Red (00-FF)
\n \u2514\u2514\u2500\u2500\u2500\u2500\u2500\u2500\u2500 Alpha (00=transparent, FF=opaque)
\n“`<\/p>\n
**Examples:**
\n– `0xFFFF0000` – Opaque red
\n– `0x80FF0000` – Semi-transparent red
\n– `0xFF00FF00` – Opaque green
\n– `0x800033FF` – Semi-transparent blue<\/p>\n
—<\/p>\n
**Need help?** Check the Wiki<\/p>\n","protected":false},"excerpt":{"rendered":"
Super GUI Lib – A library for creating beautiful GUIs without assets.<\/p>\n","protected":false},"featured_media":137899,"template":"","meta":{"_minecraft_slug":"sgl","_minecraft_project_id":"L1dy58eG","_minecraft_author":"Stepan1411_Studio","_minecraft_license":"LicenseRef-All-Rights-Reserved","_minecraft_downloads":97,"_minecraft_follows":1,"_minecraft_client_side":"required","_minecraft_server_side":"unsupported","_minecraft_storage_type":"zip","_minecraft_archive_name":"sgl.zip","_minecraft_size_bytes":675372,"_minecraft_version_count":3,"_minecraft_updated_at":"2026-05-16T17:34:39.021618Z","_minecraft_date_created":"2026-04-20T02:56:09.956849Z","_minecraft_date_modified":"2026-05-13T10:36:17.009070Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/sgl","_minecraft_icon_attachment_id":137899,"_minecraft_imported_at":"2026-06-08T03:43:40+00:00","_minecraft_import_hash":"104d00f7722ec9ee39982ce6d0572685","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[97,873,92],"mod_loader":[99],"minecraft_version":[41],"class_list":["post-137898","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-fabric","mod_category-library","mod_category-utility","mod_loader-fabric","minecraft_version-1-21-11"],"yoast_head":"\n