Incompatible mods found в Minecraft: как исправить ошибку Fabric

Гайд относится к Minecraft Java Edition с Fabric. Перед заменой файлов закрой игру и сохрани копию папки сборки, особенно миров в saves. Пока разбираешься, не меняй версию Minecraft без необходимости: сначала попробуй подобрать моды под уже выбранную.

1. Прочитай подсказку под заголовком

Сохрани скриншот всего окна ошибки. Найди раздел с возможным решением — A potential solution has been determined — и подробности ниже. Формулировки отличаются между версиями загрузчика, но смысл повторяется:

Например, fabric-api … is missing указывает на отсутствующий Fabric API. А требование новой версии fabricloader относится к загрузчику. Названия похожи, действия разные. Вот на этом месте легко потратить вечер впустую.

2. Раздели три разные версии

Minecraft, Fabric Loader и сам мод имеют собственные номера версий. Число 1.21.1 — версия игры, а не загрузчика. У мода может быть совершенно другой номер выпуска; он не обязан совпадать с номером Minecraft.

Открой настройки запускаемой сборки и запиши версию игры. Затем на странице нужного файла проверь поддерживаемые версии Minecraft и загрузчик. Для Fabric выбирай выпуск под Fabric. Файл для Forge или NeoForge напрямую его не заменяет; иногда такой файл просто не загрузится, без этого окна ошибки.

Ориентируйся на список совместимости конкретного выпуска. Один файл может поддерживать несколько версий игры, но соседние номера сами по себе совместимость не гарантируют. Переименовать .jar тоже не поможет: содержимое от этого не изменится.

3. Добавь именно ту зависимость, которую требует ошибка

Fabric Loader запускает моды, а Fabric API предоставляет функции, которыми пользуются многие из них. API устанавливается отдельно: скачай подходящий файл .jar и положи в mods. Он нужен многим модификациям, но не абсолютно всем. Это различие отмечено в инструкции Fabric по установке модов.

Ошибка может требовать и другую библиотеку. Открой раздел зависимостей на странице мода и установи обязательные компоненты, соблюдая версии и тип загрузчика. Не скачивай всё подряд: Fabric API не заменяет остальные библиотеки.

Уже установленная зависимость тоже может не подходить по версии. Тогда замени её файл совместимым, а старый вынеси за пределы mods. Две версии одной библиотеки рядом — дополнительная проблема, а не запасной вариант.

4. Проверь папку именно запускаемой сборки

В официальном Minecraft Launcher открой «Установки» и папку нужного профиля. Если назначен отдельный игровой каталог, моды должны лежать в нём. Сторонние лаунчеры часто хранят каждую сборку отдельно — используй их кнопку открытия папки экземпляра.

Стандартный путь Windows выглядит так:

%appdata%\.minecraft\mods

Но он подходит только при стандартном каталоге игры. Замена файла в другой сборке ничего не исправит. Проверь расширения файлов: обычные моды Fabric кладут в mods как .jar, без распаковки. Удаляемые версии пока перенеси в отдельную папку вне mods.

5. Обнови Loader, если сообщение требует именно его

Когда мод требует более новый fabricloader, установка Fabric API не решает причину. Возьми установщик на официальном сайте Fabric, закрой лаунчер и выбери прежнюю версию Minecraft с подходящей версией Loader. После установки запускай обновлённый профиль.

В лаунчере с управлением сборками загрузчик обычно меняют в настройках экземпляра. Конкретные шаги зависят от программы. Не переключай всю сборку на другую версию игры только ради обновления Loader: это отдельные настройки. Подробнее — в руководстве по обновлению Fabric.

6. Если ошибка осталась

Запусти сборку снова и перечитай окно: после исправления одной зависимости может проявиться следующая. Если сообщение называет Java, проверь версию Java, которую использует именно профиль лаунчера. Установка ещё одной Java в Windows не обязательно переключает игру на неё; выбирай версию по требованиям игры и сборки.

Для проверки создай отдельный тестовый экземпляр с той же версией Minecraft, Fabric Loader, проблемным модом и его обязательными зависимостями. Запускается? Возвращай остальные моды небольшими группами. Зависимые моды проверяй вместе с библиотеками, иначе получишь новые ошибки нехватки компонентов.

Если окно исчезло, но игра вылетает дальше, изучи logs/latest.log в каталоге этой сборки. Отчёт в crash-reports появляется не при каждой неудаче запуска. Для обращения за помощью приложи полный текст ошибки, версии компонентов и журнал; способы поиска описаны в документации Fabric.

Переустановка Windows к этой проверке не относится. И не отключай проверку зависимостей ради исчезновения окна: она сообщает о конкретном несоответствии. Рабочее решение — исправить его и повторить запуск.