Cloth Config API

Cloth Config API - это библиотека (API) для Майнкрафт, которая предоставляет разработчикам модов простой и гибкий инструмент для создания экранов настроек (config screens). Если вы когда-нибудь хотели добавить в свой мод удобное меню с ползунками, переключателями и текстовыми полями - эта библиотека сделает процесс максимально простым.

Зачем это нужно

В ванильном Minecraft нет встроенного интерфейса для конфигурации модов. Каждый автор выкручивается как может: кто-то пишет свой велосипед с текстовыми файлами, кто-то использует сторонние решения вроде ModMenu. Cloth Config API стандартизирует этот процесс - вы описываете структуру настроек в коде, а библиотека сама генерирует аккуратный GUI.

Что даёт игрокам

Если мод использует Cloth Config API, игрок получает:

• Красивое меню настроек прямо в игре (через ModMenu или отдельную кнопку).
• Возможность менять параметры без правки файлов.
• Подсказки и ограничения для каждого поля (например, диапазон чисел).

Особенности

• Поддержка разных типов полей: целые числа, дробные, строки, булевы значения, списки.
• Автоматическая валидация ввода.
• Локализация (можно переводить названия опций).
• Работает на Fabric и Forge (включая NeoForge).
• Легко интегрируется с другими библиотеками (например, ModMenu).

Для разработчиков

Подключить Cloth Config API к своему моду - дело нескольких строк кода. Вы создаёте класс конфига с аннотациями или используете builder-подход, а библиотека сама строит интерфейс. Это экономит кучу времени по сравнению с ручным рисованием экранов.

Совместимость

Cloth Config API поддерживает Minecraft 1.14-1.21 (зависит от версии библиотеки). Работает на Fabric, Forge и NeoForge. Для использования нужен сам Cloth Config API и, как правило, ModMenu (чтобы открыть настройки из главного меню).

Если вы собираетесь разрабатывать моды - обязательно добавьте эту библиотеку в зависимости. Игроки оценят удобные настройки без лишних телодвижений.