Starshadow Lib

★ Starshadow Lib

The foundation for Starshadow mods.

Starshadow Lib is a shared widget toolkit and utility library for Minecraft Fabric mods. It provides the building blocks that power Starshadow’s config screens, mod list, and splash screen — and you can use them in your own mods too.

“Widgets, layout, and rendering — the boring parts, done right.”

✨ Features

🎛️ Widget Toolkit

Ready-to-use Minecraft GUI widgets built on vanilla screen components:

| Widget | Description |
|——–|————-|
| ToggleWidget | On/off toggle switch with animation |
| SliderWidget | Numeric slider with configurable range |
| IntStepperWidget | Integer value with +/- buttons |
| EnumCycleWidget | Cycle through enum values with click |
| StarWidget | Base widget class for building custom widgets |

📐 Layout System

Utilities for consistent, responsive GUI layouts:

| Component | Description |
|———–|————-|
| EntryRow | Label + widget row with consistent alignment |
| Spacing | Standardized spacing constants for UI consistency |

📦 Container Widgets

Higher-level containers for organizing content:

| Container | Description |
|———–|————-|
| ScrollablePanel | Scrollable content area with smooth scrolling |
| SectionCard | Card-style container with header and collapsible content |
| VerticalTabBar | Tab strip for multi-section screens |

🎨 Rendering Utilities

| Utility | Description |
|———|————-|
| RenderBridge | Cross-version rendering abstraction layer |
| Colors | Standardized color palette constants |

🔧 Logging Helpers

| Utility | Description |
|———|————-|
| LogLevelHelper | Dynamic Log4j2 level control for debug logging toggles |

📦 Installation

For Mod Developers

Add to your build.gradle.kts:

dependencies {
    modstitchModImplementation("com.starshadow:starshadow-lib:${property("starshadow_version")}")
    include("com.starshadow:starshadow-lib:${property("starshadow_version")}")
}

For Players

Starshadow Lib is bundled inside mods that use it — you typically don’t need to install it separately. If a mod requires it as an external dependency:

1. Install Fabric Loader for your Minecraft version
2. Install Fabric API
3. Drop the Starshadow Lib .jar into your mods/ folder
4. Launch Minecraft

Supported: Minecraft 1.20.1 · 1.20.4 · 1.21.1 — Fabric only

🔨 Usage Examples

Toggle Widget

ToggleWidget toggle = new ToggleWidget(x, y, width, height,
    Text.literal("Enable Feature"),
    () -> config.isEnabled(),
    value -> config.setEnabled(value));

Slider Widget

SliderWidget slider = new SliderWidget(x, y, width, height,
    Text.literal("Volume"),
    0, 100, config.getVolume(),
    value -> config.setVolume(value));

Scrollable Panel

ScrollablePanel panel = new ScrollablePanel(x, y, width, height);
panel.addChild(new EntryRow(label, widget));
panel.addChild(new EntryRow(label2, widget2));

🧩 Compatibility

| Mod | Compatibility |
|—–|————-|
| Fabric API | ✅ Required |
| Starshadow Config | ✅ Uses Lib for config screen widgets |
| Starshadow Menu | ✅ Uses Lib for mod list UI |
| Starshadow Splash | ✅ Uses Lib indirectly via Config |

📋 Requirements

| Dependency | Required? |
|———–|———–|
| Fabric Loader | ✅ Yes |
| Fabric API | ✅ Yes |

Starshadow Lib has no dependencies beyond Fabric itself — it’s the foundation layer.

🌟 Build Better UIs

Stop reinventing widgets for every mod. Starshadow Lib provides a consistent, tested set of UI components so you can focus on what makes your mod unique.

Made with ❤️ by Ghent Starshadow
Licensed under MPL-2.0 — free to use, share, and modify.