Cloth Config API — мод для экранов настроек в Minecraft

Cloth Config API — мод для экранов настроек в Minecraft

Cloth Config API — библиотека, которую требуют десятки модификаций в Minecraft, чтобы показать свои настройки в виде меню в игре вместо текстового файла. Сама она ничего в игру не добавляет: ни предметов, ни блоков, ни новых механик. Это зависимость — без неё моды, которые её подключили, не запустятся и выведут ошибку в списке модификаций.

Когда мод нужен

Библиотеку устанавливают не самостоятельно, а вместе с другими модификациями. Понять, нужна ли она для конкретной сборки, можно двумя способами:

• В описании мода на Modrinth или CurseForge в списке Dependencies указан Cloth Config API.

• Игра закрывается при запуске сборки, а в журнале (logs/latest.log) возникает упоминание об отсутствующем cloth-config или cloth-config-2.

Внутреннее имя cloth-config-2 относится к тому же моду — это идентификатор, появившийся начиная со второй крупной версии библиотеки. Если кто-то пишет «нужен cloth-config-2», речь идёт о современной версии Cloth Config API.

Как открыть настройки мода

На Forge и NeoForge список установленных модификаций встроен в главное меню игры — пункт Mods. Рядом с каждым модом, подключившим Cloth Config, появляется иконка настроек. Клик открывает отдельный экран со всеми параметрами именно этой модификации.

На Fabric стандартного списка модов в загрузчике нет, поэтому доступ к экранам Cloth Config реализуется через сторонний инструмент просмотра модификаций — он показывает список установленного и даёт нажать кнопку рядом с нужным пунктом.

Настройки мода с помощью Cloth Config 

Как выглядит сам экран

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

В верхней части экрана для конфигов с десятками параметров есть поле поиска — оно фильтрует список по названию. Возле параметров, для которых автор модификации задал описание, при наведении курсора появляется подсказка с пояснением.

Если ввести значение вне допустимого диапазона или в недопустимом формате, поле подсвечивается, а кнопка сохранения становится неактивной до тех пор, пока ошибку не исправили. Возле каждого параметра есть кнопка сброса — возвращает значение к тому, что автор модификации отметил как стандартное.

Вывод

Cloth Config API — это инфраструктурная зависимость: без неё часть модификаций просто не запустится, но сам мод в игре не даёт ничего видимого без других подключённых модов. Его роль — свести настройки разных модификаций в Minecraft к общему визуальному стандарту вместо десятка разнотипных интерфейсов. На Fabric и в мультиплатформенных сборках Cloth Config API остаётся самым распространённым общим стандартом.