Starshadow Lib

★ Starshadow Lib

Основа для модов Starshadow.

Starshadow Lib — это общая библиотека виджетов и утилит для модов Minecraft на Fabric. Она предоставляет строительные блоки, на которых работают экраны настроек Starshadow, список модов и экран загрузки — и вы тоже можете использовать их в своих модах.

"Виджеты, компоновка и рендеринг — скучные части, сделанные правильно."

✨ Возможности

🎛️ Набор виджетов

Готовые к использованию виджеты GUI Minecraft, построенные на ванильных компонентах экрана:

Виджет	Описание
ToggleWidget	Переключатель вкл/выкл с анимацией
SliderWidget	Числовой слайдер с настраиваемым диапазоном
IntStepperWidget	Целочисленное значение с кнопками +/-
EnumCycleWidget	Переключение значений enum по клику
StarWidget	Базовый класс виджета для создания собственных виджетов

📐 Система компоновки

Утилиты для единообразной, адаптивной компоновки GUI:

Компонент	Описание
EntryRow	Строка с меткой и виджетом с единообразным выравниванием
Spacing	Стандартизированные константы отступов для единообразия UI

📦 Виджеты-контейнеры

Контейнеры более высокого уровня для организации содержимого:

Контейнер	Описание
ScrollablePanel	Прокручиваемая область содержимого с плавной прокруткой
SectionCard	Контейнер в стиле карточки с заголовком и сворачиваемым содержимым
VerticalTabBar	Панель вкладок для экранов с несколькими разделами

🎨 Утилиты рендеринга

Утилита	Описание
RenderBridge	Слой абстракции рендеринга для разных версий
Colors	Стандартизированные константы цветовой палитры

🔧 Помощники логирования

Утилита	Описание
LogLevelHelper	Динамическое управление уровнем Log4j2 для переключения отладочного логирования

---

📦 Установка

Для разработчиков модов

Добавьте в ваш build.gradle.kts:

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

Для игроков

Starshadow Lib входит в состав модов, которые её используют — обычно устанавливать её отдельно не нужно. Если мод требует её как внешнюю зависимость:

1. Установите Fabric Loader для вашей версии Minecraft
2. Установите Fabric API
3. Поместите .jar Starshadow Lib в папку mods/
4. Запустите Minecraft Поддерживается: Minecraft 1.20.1 · 1.20.4 · 1.21.1 — только Fabric

---

🔨 Примеры использования

Виджет-переключатель

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

Виджет-слайдер

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

Прокручиваемая панель

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

---

🧩 Совместимость

Мод	Совместимость
Fabric API	✅ Требуется
Starshadow Config	✅ Использует Lib для виджетов экрана настроек
Starshadow Menu	✅ Использует Lib для UI списка модов
Starshadow Splash	✅ Использует Lib косвенно через Config

---

📋 Требования

Зависимость	Обязательна?
Fabric Loader	✅ Да
Fabric API	✅ Да

У Starshadow Lib нет зависимостей кроме самого Fabric — это базовый слой.

🌟 Создавайте лучшие UI

Хватит изобретать виджеты заново для каждого мода. Starshadow Lib предоставляет единообразный, проверенный набор компонентов UI, чтобы вы могли сосредоточиться на том, что делает ваш мод уникальным.

Сделано с ❤️ от Ghent Starshadow Лицензия MPL-2.0 — свободно для использования, распространения и изменения.