Что такое YetAnotherConfigLib (YACL)
YetAnotherConfigLib (сокращённо YACL) — это библиотека для создания экранов конфигурации в Minecraft. Она предназначена для разработчиков модов, которые хотят предоставить игрокам удобный графический интерфейс для настройки параметров своего мода. YACL не добавляет в игру новый контент, не меняет геймплей и не содержит собственных настроек — это исключительно инструмент для других модов.
Основная идея YACL — дать возможность создавать конфигурационные экраны с помощью простого билдера (builder pattern), не углубляясь в сложные манипуляции с GUI Minecraft. Библиотека берёт на себя отрисовку элементов управления, обработку ввода и сохранение значений. Разработчику достаточно описать структуру настроек: категории, группы, типы полей (целые числа, строки, переключатели, списки и т.д.), а YACL сгенерирует готовый экран.
YACL позиционируется как лёгкая и минималистичная библиотека. Она не включает в себя систему автосохранения или автоконфигурации — управление файлами конфигурации остаётся на усмотрение разработчика. Это делает её гибкой и подходящей для проектов, где уже есть своя логика работы с настройками.
Зачем нужна отдельная библиотека конфигурации
В Minecraft существует несколько способов реализации настроек мода: от простых текстовых файлов до встроенных экранов на основе стандартного GUI. Однако каждый из этих подходов имеет недостатки. Текстовые файлы неудобны для игроков, а создание собственного интерфейса требует значительных усилий и знаний внутреннего устройства игры.
Библиотеки конфигурации, такие как YACL, решают эту проблему, предоставляя готовые компоненты для создания экранов настроек. Разработчику не нужно писать код для кнопок, ползунков, выпадающих списков и обработки событий — всё это уже реализовано в библиотеке. Игроки получают единообразный и интуитивно понятный интерфейс, независимо от того, какой мод они настраивают.
YACL особенно популярен в сообществе Fabric, где долгое время не было стандартной библиотеки конфигурации. Он заполнил эту нишу и стал одним из основных инструментов для мододелов. Благодаря поддержке NeoForge, Forge и Quilt, YACL может использоваться в модах для разных загрузчиков, что делает его универсальным решением.
Поддерживаемые версии Minecraft и загрузчики
YACL активно развивается и поддерживает широкий спектр версий Minecraft — от 1.19 до 26.2 (актуальная версия на момент написания). Для каждой версии выпускаются отдельные сборки под разные загрузчики: Fabric, NeoForge, Forge и Quilt.
Например, для версии 26.2 доступны сборки для NeoForge и Fabric. Для 1.21.11 — Fabric и NeoForge. Для 1.19.4 — Fabric, Forge и Quilt. Версия 3.9.4 является последней стабильной для 26.2, а для более старых версий, таких как 1.19.2, используется ветка 2.x.x.
Важно: YACL не является самостоятельным модом — он работает только как зависимость для других модов. Если вы устанавливаете мод, который требует YACL, вам нужно скачать соответствующую версию библиотеки и поместить её в папку mods вместе с основным модом. Без YACL мод, использующий его, не запустится или будет работать некорректно.
Как установить YACL на Fabric
Установка YACL на Fabric не отличается от установки любого другого мода. Сначала необходимо установить сам Fabric Loader и Fabric API. После этого скачайте файл YACL, соответствующий вашей версии Minecraft и загрузчику Fabric. Например, для версии 1.21.11 файл будет называться yet_another_config_lib_v3-3.8.1+1.21.11-fabric.jar.
Перенесите скачанный JAR-файл в папку .minecraft/mods. Если такой папки нет, создайте её вручную. После запуска игры YACL будет автоматически загружен и готов к использованию модами, которые его требуют.
Обратите внимание: YACL не требует отдельной настройки — он работает «за кулисами». Вы не увидите его в списке модов в главном меню, но он будет отображаться в списке установленных модов в лаунчере или в меню «Моды» в игре. Если мод, использующий YACL, установлен корректно, его настройки будут доступны через стандартное меню мода (обычно через кнопку «Config» в списке модов или через специальную команду).
Установка на NeoForge, Forge и Quilt
YACL поддерживает не только Fabric, но и другие популярные загрузчики. Для NeoForge процесс аналогичен: установите NeoForge нужной версии, скачайте файл YACL с пометкой -neoforge и поместите его в папку mods. Например, для 26.2 это будет yet_another_config_lib_v3-3.9.4+26.2-neoforge.jar.
Для Forge (например, для версии 1.19.4) используется файл yet-another-config-lib-forge-3.1.1+1.19.4.jar. Установка также сводится к копированию в папку mods после установки самого Forge.
Для Quilt требуется установить Quilt Loader и QSL (Quilt Standard Libraries). Файл YACL для Quilt обычно совпадает с версией для Fabric, но рекомендуется уточнять на странице загрузки. Например, для 1.19.4 используется тот же файл, что и для Fabric: yet-another-config-lib-fabric-3.1.1+1.19.4.jar.
Важно: не пытайтесь использовать файл для Fabric на NeoForge или наоборот — это приведёт к ошибкам загрузки. Всегда проверяйте маркировку в имени файла.
Версии YACL: что означают номера
Названия файлов YACL содержат информацию о версии библиотеки, версии Minecraft и загрузчике. Разберём на примере: yet_another_config_lib_v3-3.9.4+26.2-fabric.jar.
yet_another_config_lib_v3— название библиотеки и мажорная версия (v3).3.9.4— версия самой библиотеки (мажорная.минорная.патч).+26.2— версия Minecraft, для которой предназначен файл.fabric— загрузчик.
В более старых версиях (2.x.x) формат мог отличаться: например, yetanotherconfiglib-2.2.0-for-1.19.2.jar. Здесь 2.2.0 — версия библиотеки, 1.19.2 — версия игры.
Разработчики рекомендуют всегда использовать последнюю стабильную версию YACL для вашей версии Minecraft, так как в новых версиях исправляются ошибки и добавляются новые возможности. Однако если мод, который вы устанавливаете, требует конкретную версию YACL, лучше придерживаться её, чтобы избежать несовместимости.
Особенности использования YACL для разработчиков
YACL предоставляет разработчикам мощный и гибкий API для создания конфигурационных экранов. Основой является билдер YetAnotherConfigLib.Builder, который позволяет добавлять категории (группы настроек) и внутри них — отдельные параметры с различными типами: целые числа, числа с плавающей точкой, строки, булевы значения, перечисления, списки и даже цвета.
Каждый параметр может иметь описание, диапазон допустимых значений, контроллер ввода (ползунок, текстовое поле, выпадающий список и т.д.) и функцию сохранения. YACL автоматически обрабатывает события изменения значения и обновляет интерфейс.
Библиотека также поддерживает вложенные категории, что позволяет создавать иерархические структуры настроек. Для продвинутых случаев есть возможность добавлять кастомные виджеты и обрабатывать пользовательские события.
Важно: YACL не занимается сохранением конфигурации в файл — разработчик должен самостоятельно реализовать загрузку и сохранение настроек (например, в JSON или TOML). Библиотека только предоставляет интерфейс для их отображения и редактирования.
Почему YACL называют «ещё одной библиотекой конфигурации»
Название «YetAnotherConfigLib» (в переводе «ещё одна библиотека конфигурации») отражает иронию: на момент создания YACL уже существовало несколько библиотек для конфигурации, но ни одна из них не удовлетворяла потребности сообщества Fabric. Разработчики решили создать свою, которая была бы лёгкой, современной и удобной.
YACL быстро набрал популярность благодаря простоте использования, хорошей документации и активной поддержке. Сегодня он используется в сотнях модов, включая такие известные, как Sodium, Lithium, Phosphor (в некоторых версиях) и многие другие. Несмотря на название, YACL стал стандартом де-факто для конфигурации в экосистеме Fabric и NeoForge.
Если вы устанавливаете мод, который требует YACL, не пугайтесь — это не лишний мод, а необходимая библиотека, без которой настройки мода не будут работать. Установка занимает минуту и не влияет на производительность игры.
Частые проблемы и их решение
Самая распространённая проблема — использование неправильной версии YACL. Если мод требует YACL 3.8.1 для 1.21.11, а вы установили 3.9.4 для 26.2, игра может вылететь или мод не загрузится. Всегда проверяйте соответствие версий на странице загрузки мода.
Вторая проблема — отсутствие Fabric API или QSL при использовании Fabric/Quilt. YACL сам по себе не требует Fabric API, но многие моды, использующие YACL, зависят от него. Установите Fabric API отдельно.
Третья проблема — конфликт с другими библиотеками конфигурации. YACL не конфликтует с Cloth Config, Configured или другими подобными библиотеками, так как они работают независимо. Однако если два мода используют разные версии YACL, возможны проблемы. В таких случаях старайтесь обновить все моды до совместимых версий.
Если после установки YACL мод не показывает экран настроек, проверьте, что мод действительно использует YACL (некоторые моды могут иметь свои собственные экраны). Также убедитесь, что файл YACL находится в папке mods и не повреждён.
Вопросы и ответы
Можно ли использовать YACL без Fabric API?
Да, YACL сам по себе не требует Fabric API. Однако многие моды, которые зависят от YACL, могут требовать Fabric API для других функций. Рекомендуется устанавливать Fabric API в любом случае, если вы используете Fabric.
Как узнать, какую версию YACL требует мой мод?
Обычно информация о зависимостях указывается на странице мода в описании или в разделе «Требования». Также можно посмотреть в файле мода fabric.mod.json (если открыть JAR архиватором) — там перечислены требуемые версии YACL.
YACL замедляет игру или потребляет много памяти?
Нет, YACL — очень лёгкая библиотека. Она загружается только при открытии экрана конфигурации и не влияет на производительность в обычной игре. Размер JAR-файла составляет около 1 МБ.
Почему YACL не отображается в списке модов в главном меню?
YACL — это библиотека, а не игровой мод. Она не добавляет кнопок в главное меню и не изменяет интерфейс. Вы можете увидеть её в списке установленных модов в лаунчере или в меню «Моды» в игре (если оно поддерживается).
Можно ли использовать YACL с OptiFine?
Да, YACL совместим с OptiFine, так как работает на уровне загрузчика модов и не конфликтует с оптимизациями OptiFine. Однако если у вас возникают проблемы, попробуйте использовать альтернативы OptiFine, такие как Sodium, которые также поддерживают YACL.
Что делать, если после установки YACL игра вылетает?
Проверьте соответствие версий YACL и Minecraft, а также загрузчика. Убедитесь, что вы скачали файл для правильного загрузчика (Fabric/NeoForge/Forge/Quilt). Также проверьте, нет ли конфликтов с другими модами — временно удалите остальные моды и оставьте только YACL и мод, который его требует.
Поддерживает ли YACL русский язык в интерфейсе?
YACL не имеет собственного перевода, так как это библиотека. Однако моды, использующие YACL, могут локализовать свои экраны настроек, включая русский язык. Всё зависит от конкретного мода.