Fabric API и Cloth Config: что просит мод и какой файл выбрать

Почему Fabric Loader и Fabric API устанавливаются отдельно

В документации Fabric разделены задачи загрузчика и API. Loader загружает моды и проверяет их зависимости. Игровые и версионные функции вынесены в Fabric API, который нужен многим, но не всем проектам.

На практике в лаунчере можно видеть профиль Fabric и при этом получить сообщение, что Fabric API отсутствует. Противоречия здесь нет: профиль подтверждает запуск загрузчика, а требуемый мод-библиотека ещё не добавлен.

Cloth Config — другой проект. Его автор описывает библиотеку экранов конфигурации и публикует варианты для нескольких загрузчиков. Поэтому название Cloth Config тоже нужно проверять вместе с платформой файла.

Как прочитать сообщение о зависимости

Сначала выпиши три вещи: какой мод остановил запуск, какой идентификатор библиотеки он просит и какой диапазон версий указан. В сообщении загрузчика может стоять техническое имя вроде fabric-api или cloth-config, а на странице проекта — обычное название.

Подбирай файл в таком порядке. Большой номер новой библиотеки не гарантирует, что она собрана для старого Minecraft. И наличие похожей библиотеки для Forge не делает её Fabric-зависимостью.

Что проверить при установке

• Открой папку нужного экземпляра через лаунчер. Не ориентируйся только на название общей папки .minecraft.
• В Versions проекта выставь версию Minecraft и загрузчик своего экземпляра.
• Сверь требования к библиотеке на странице основного мода или в сообщении загрузчика.
• Скачай готовый JAR и положи его в mods, оставив одну подходящую версию.
• Повтори запуск и сохрани новое сообщение, если оно изменилось.

Если лаунчер умеет устанавливать зависимости сам, всё равно проверь выбранный экземпляр и итоговый список. Автоматическая установка полезна, но она не объединяет моды разных загрузчиков в одну совместимую сборку.

Для GeckoLib на Forge 1.20.1 есть отдельная инструкция с конкретным примером JAR.

Почему не стоит убирать проверку версии

Fabric документирует механизм переопределения зависимостей для разработчиков сборок. Сами авторы предупреждают, что обычным игрокам он не предназначен. Удаление ограничения не добавляет в старую библиотеку код, который ждёт мод.

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

После ошибки не обновляй весь профиль разом. Сохрани рабочую копию и меняй только недостающий компонент. Если после этого появилась другая зависимость, разберись с ней отдельно: так останется понятная цепочка изменений.