YetAnotherConfigLib — библиотека для конфигурации модов

Yet Another Config Lib — новая библиотека для создания настраиваемых интерфейсов в модах для Minecraft. Она появилась, чтобы заполнить пробел в экосистеме Fabric.

Зачем нужна ещё одна библиотека?

Разработчики модов для Fabric уже имеют на выбор несколько решений, но у каждого из них есть свои недостатки.

• Cloth Config API считается устаревшей, так как её автор больше не планирует добавлять новые функции.
• SpruceUI изначально не задумывалась как инструмент для конфигурации, из-за чего её интерфейс может казаться перегруженным.
• OwoLib — это многофункциональная библиотека, где конфигурация является лишь одной из многих опций, что увеличивает её общий размер.

YACL создавалась с учётом этих проблем, предлагая свежий и целенаправленный подход.

Преимущества YACL

Библиотека разработана с оглядкой на опыт предшественников, что позволило сразу сделать всё правильно.

• Простой API, вдохновлённый внутренней библиотекой конфигурации мода Sodium.
• Стилистика, соответствующая Minecraft. Интерфейс YACL идеально вписывается в общий стиль игры.

Возможности

Библиотека предлагает богатый набор функций для создания гибких настроек:

Гибкие элементы управления

• Кастомные виджеты: вы можете создавать собственные контроллеры, если стандартные варианты не подходят.
• Разные контроллеры для одного типа данных:
  • Числа: слайдеры или текстовые поля.
  • Строки: выпадающие списки, переключатели или обычные поля ввода.
  • Логические значения: флажки или текстовые индикаторы ВКЛ/ВЫКЛ.

Расширенные описания

• Текст с интерактивными элементами: поддерживаются кликабельные ссылки и всплывающие подсказки на основе текстовых компонентов Minecraft.
• Визуальный контент: вставка изображений в формате WebP, включая анимированные.
• Кастомные секции: возможность заменить изображение на свой собственный элемент отрисовки.

Организация и удобство

• Полноценный выбор цвета с помощью встроенного пипетки.
• Полная поддержка управления с клавиатуры, оптимизированная для использования с модами вроде Controlify.
• Высокий уровень организации: настройки можно группировать с помощью вкладок (категорий) и сворачиваемых блоков.
• Встроенная сериализация: библиотека берёт на себя работу с чтением и записью конфигурационных файлов, минимизируя риск ошибок в коде.
• Альтернативный Kotlin DSL для любителей этого языка.

Как начать использовать?

Полная документация по использованию библиотеки доступна в официальном вики.

Как это выглядит?

Лицензия

Проект распространяется под лицензией GNU Lesser General Public License, v3.0.