DACL для Minecraft: полное руководство по библиотеке конфигураций
Если вы разрабатываете моды для Minecraft и устали каждый раз писать собственный экран настроек с нуля, то DACL (DumbassConfigLib) — это именно то, что вам нужно. Это лёгкая и удобная библиотека конфигураций, созданная для упрощения работы с опциями модов. Вместо того чтобы изобретать велосипед, вы просто подключаете DACL и получаете готовый функционал для создания экранов настроек, валидаторов значений и поддержки ModMenu.
DACL для Minecraft — это не мод в привычном понимании, а инструмент для разработчиков. Обычным игрокам она не нужна напрямую, но именно благодаря таким библиотекам моды получают удобные и красивые меню конфигурации. Если вы хотите скачать DACL, имейте в виду: библиотека распространяется через Maven-репозиторий и подключается к вашему проекту как зависимость.
Что такое DACL и зачем она нужна
DumbassConfigLib — это библиотека конфигураций, которая используется в модах автора KaseToatz. Она предоставляет простой Java API для создания опций, их валидации и построения полноценных экранов настроек. Главное преимущество — минимализм и гибкость: вы описываете опции как обычные статические поля, а DACL берёт на себя всю рутину по отрисовке интерфейса и сохранению значений в JSON-файл.
Библиотека поддерживает Fabric и ориентирована на современные версии Minecraft. Она отлично работает с загрузчиком Fabric и легко интегрируется с ModMenu, что делает её идеальным выбором для мододелов, которые хотят быстро добавить настройки в свой проект. Если вы ищете способ упростить разработку, DACL для Minecraft станет надёжным помощником.
Как установить DACL в проект
Установка DACL происходит не через лаунчер, а через систему сборки Gradle. Вот пошаговая инструкция, как установить библиотеку:
- Добавьте Maven-репозиторий KaseToatz в блок repositories вашего build.gradle.
- В блок dependencies добавьте строку modCompileOnly с координатами com.kasetoatz:dumbassconfiglib и версией из вашего gradle.properties.
- Пропишите переменную dacl_version в gradle.properties, указав актуальную версию с официальной страницы версий.
- Синхронизируйте проект, чтобы Gradle подтянул зависимость.
После этого библиотека будет доступна в вашем коде. Кстати, если вы предпочитаете не возиться с ручной настройкой, в лаунчере foxygame.net реализована установка модов и библиотек в один клик, а каталог дополнений регулярно пополняется — там можно найти готовые сборки, где DACL уже подключён и настроен.
Создание опций конфигурации
Начните с создания точки входа мода, реализующей интерфейс ModInitializer. Затем добавьте опции как публичные статические поля. DACL поддерживает несколько типов опций: BoolOption для логических значений, IntOption для целых чисел и FloatOption для чисел с плавающей точкой.
Каждая опция принимает три обязательных параметра: текст, отображаемый в интерфейсе, уникальный идентификатор и значение по умолчанию. Например, BoolOption создаётся с текстом "Test boolean option", идентификатором "test_bool_opt" и значением false. Не забудьте добавить класс с опциями в fabric.mod.json в секцию entrypoints, чтобы он загружался при старте игры.
Валидаторы значений
Для опций с полем ввода можно добавить четвёртый параметр — AbstractValidator, который ограничит допустимые значения. RangeValidator позволяет задать нижнюю и верхнюю границы. Например, чтобы создать целочисленную опцию в диапазоне от 1 до 100, используйте RangeValidator с соответствующими параметрами. Любую из границ можно убрать, передав null.
Построение конфигурации и подопции
Когда все опции созданы, постройте конфигурацию через статический метод builder класса DumbassConfig. Укажите заголовок экрана и имя JSON-файла, затем последовательно добавьте опции через withOption. После сборки значения опций автоматически обновляются при изменении конфигурации, и вы можете получить их через getValue.
DACL также поддерживает подопции — это отдельные экраны со своими настройками. Создаются они через builder класса SubOption и могут вкладываться друг в друга на любую глубину, что позволяет строить сложные иерархические меню.
Интеграция с ModMenu
Чтобы добавить созданный экран настроек в ModMenu, сначала подключите его как зависимость. Затем создайте класс, реализующий ModMenuApi, и переопределите метод getModConfigScreenFactory, возвращающий ваш экран конфигурации. После этого добавьте новый класс в fabric.mod.json как entrypoint modmenu.
Благодаря автообновлению в лаунчере foxygame.net вы всегда будете работать с актуальными версиями библиотек, включая DACL, что избавляет от необходимости вручную отслеживать совместимость версий Minecraft и Fabric.
Заключение
DACL — это мощный, но при этом простой инструмент для разработчиков модов Minecraft. Она экономит время, предоставляя готовые решения для конфигураций, валидации и интеграции с ModMenu. Если вы хотите скачать DACL и начать использовать её в своих проектах, достаточно подключить библиотеку через Gradle и следовать документации. Поддерживаемые версии Minecraft и загрузчик Fabric делают её универсальным выбором для современной разработки модов.