EclipseUI

Мод EclipseUI для Minecraft — библиотека интерфейсов конфигурации

EclipseUI — это современная библиотека для создания экранов настроек в модах Minecraft. Она позволяет разработчикам легко добавлять настраиваемые интерфейсы с поддержкой тем, различных виджетов и интеграции с ModMenu. Проект доступен для загрузчиков Fabric и NeoForge и распространяется под лицензией MIT.

🎨 Гибкие темы и виджеты

EclipseUI — это легковесная библиотека для создания настраиваемых экранов конфигурации в модах Minecraft. Она предлагает два встроенных стиля оформления: Faithful, который воспроизводит классический ванильный стиль Minecraft, и Modern с плоским, минималистичным дизайном. Разработчики получают доступ к богатому набору виджетов: переключатели (toggles), ползунки (sliders), выпадающие списки (dropdowns), выбор цвета (color pickers) и текстовые поля (text fields). Это позволяет создавать интуитивно понятные интерфейсы для настройки поведения мода без необходимости писать сложную логику отрисовки.

🔗 Готовая интеграция с ModMenu

Одной из ключевых особенностей библиотеки является автоматическая интеграция с ModMenu. Это означает, что созданные через EclipseUI экраны настроек сразу же появляются в главном меню игры, что значительно упрощает доступ для игроков к конфигурации модов. Такая функциональность встроена «из коробки», избавляя разработчиков от необходимости самостоятельно реализовывать логику открытия меню и обработки событий нажатия кнопки.

📝 Быстрый старт: создание экрана настроек

Для начала работы достаточно вызвать статический метод `EclipseUI.configScreen()`. В примере ниже показано создание экрана с заголовком, родительским контейнером и выбором темы (Theme.MODERN). Внутри категории «General» добавлены два элемента: переключатель для включения функции и ползунок для настройки диапазона значений. Каждый виджет привязывается к свойству объекта конфигурации через методы `.binding()` или `.bindingInt()`, что обеспечивает двустороннюю связь между UI и данными.

🛠 Настройка зависимостей для разработчиков

Чтобы использовать библиотеку в своём проекте, необходимо добавить соответствующий репозиторий JitPack и подключить зависимость в файл сборки (Gradle). Для загрузчика Fabric используется метод `modImplementation`, а для NeoForge — стандартный `implementation`. Указанные версии (v1.0.2) соответствуют текущим релизам библиотеки.

📚 Документация и лицензия

Полное руководство по интеграции EclipseUI доступно в разделе Usage Guide, где подробно описаны все возможности библиотеки и приведены дополнительные примеры. Для отладки и предложения новых функций можно использовать раздел GitHub Issues. Проект распространяется под лицензией MIT, что позволяет свободно использовать, изменять и распространять код библиотеки в любых проектах, включая коммерческие.

Связанные материалы

• Cloth Config API — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод
• Fabric Language Kotlin — похожий мод
• Just Enough Items (JEI) — похожий мод

Автор: Coredex · Лицензия: MIT