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 залишається найпоширенішим спільним стандартом.