Smootheez Config Lib
Если вы когда-нибудь писали собственный мод для Minecraft или просто помогали другу с настройками, то знаете, насколько утомительно возиться с конфигурационными файлами. Постоянные проверки значений, ручное создание экранов настроек, бесконечные повторы одного и того же кода — всё это отнимает время, которое можно потратить на что-то более интересное. Именно здесь на сцену выходит Smootheez Config Lib (сокращённо SCL) — утилитарная библиотека, созданная для того, чтобы сделать управление конфигурациями простым и чистым.
Изначально автор разрабатывал её для своих собственных модов, но затем открыл доступ всем желающим. Сегодня это полностью бесплатный инструмент под лицензией MIT, который может использовать любой разработчик.
Что такое Smootheez Config Lib
Smootheez Config Lib — это библиотека, которая берёт на себя всю рутину, связанную с конфигурациями модов. Вместо того чтобы вручную прописывать чтение и запись файлов, создавать интерфейс и обрабатывать ввод пользователя, вы просто описываете параметры — а библиотека делает всё остальное автоматически.
Что именно она умеет:
- Управление конфигурационными файлами без лишнего кода.
- Автоматическая генерация экрана настроек.
- Автоматическое создание самого конфигурационного файла.
- Предпросмотр изменений прямо в игре.
- Стандартный экран конфигурации и вариант с описаниями.
- Редактирование значений в OptionList.
- Добавление новых значений в OptionList.
- Экран подтверждения действий.
Всё это избавляет от так называемого boilerplate-кода — шаблонных повторяющихся блоков, которые приходится писать снова и снова. Вместо десятков строк вы получаете несколько аннотаций и готовую систему настроек.
Совместимость и загрузчики
Smootheez Config Lib для Minecraft совместим с версиями 1.20.1 и выше. Библиотека ориентирована на загрузчик Fabric, что подтверждается структурой регистрации через fabric.mod.json и использованием entrypoint-механизма. Если вы разрабатываете мод именно под Fabric, интеграция пройдёт максимально гладко.
Отдельно стоит отметить, что настройки отображаются в игре только при наличии ModMenu — без него экран конфигурации не появится, хотя сам файл будет создан корректно.
Как установить и начать использовать
Для обычных игроков процесс прост: достаточно скачать Smootheez Config Lib и поместить файл в папку mods вместе с остальными модами. Библиотека не требует никакой дополнительной настройки — она просто работает в фоне, обеспечивая поддержку тех модов, которые от неё зависят.
Если же вы разработчик, то подключение выполняется через Gradle. Сначала добавьте репозиторий JitPack в build.gradle, а затем укажите зависимость с нужной версией — либо через переменную из gradle.properties, либо напрямую. После этого создайте класс конфигурации с аннотацией @Config, опишите параметры через ConfigOption и зарегистрируйте класс в разделе entrypoints файла fabric.mod.json. Всё — библиотека сама сгенерирует и файл, и экран настроек.
Кстати, если вы предпочитаете не возиться с ручной установкой, обратите внимание на лаунчер foxygame.net: в его каталоге дополнений Smootheez Config Lib можно добавить в сборку буквально в один клик, а система сама подберёт совместимую версию под ваш профиль.
Пример использования для разработчиков
Создание класса конфигурации
Внутри класса вы объявляете статические поля типа ConfigOption. Поддерживаются целые числа, дробные значения, булевы переменные, перечисления и списки опций. Для числовых параметров можно указать минимальное и максимальное значение, а также превратить их в слайдер или слайдер с процентами — это заметно улучшает взаимодействие с настройками.
Регистрация конфигурации
Достаточно добавить путь к классу в entrypoints под ключом scl. После запуска игры библиотека автоматически создаст конфигурационный файл и, при включённом параметре gui, сгенерирует экран настроек. Важное условие: имя конфигурации должно совпадать с идентификатором вашего мода.
Почему это удобно
Главная ценность Smootheez Config Lib в том, что она экономит время и снижает количество ошибок. Вам не нужно думать о том, как сохранить значение, как отобразить его в интерфейсе и как обработать подтверждение — библиотека закрывает все эти задачи единым интерфейсом. А предпросмотр в игре позволяет сразу видеть результат изменений, не перезапуская клиент.
Для игроков это означает более стабильные и понятные моды, для разработчиков — меньше рутины и больше свободы творчества. Учитывая открытую лицензию MIT, библиотеку можно свободно использовать в любых проектах, включая коммерческие.
Итог
Smootheez Config Lib — это небольшой, но крайне полезный инструмент для экосистемы Fabric. Он берёт на себя управление конфигурациями, автоматизирует создание файлов и экранов настроек и делает процесс разработки заметно приятнее. Если вы ищете способ упростить работу с настройками в своём моде или просто хотите, чтобы зависимые моды работали корректно, эта библиотека станет отличным выбором. Скачать Smootheez Config Lib можно на популярных площадках модов, а подключить его к проекту — буквально за несколько минут.
