Мод не загружается: Mixin apply failed, Missing dependency и другие

Ошибки

Игра падает при запуске, и в логе стена текста. Разберём сообщения, которые встречаются чаще всего, и способ найти виноватого, когда сообщение ни о чём не говорит.

Лог запуска Minecraft с ошибкой загрузки мода

Missing dependency

Mod 'X' requires 'fabric-api' version 0.92.0 or above

Моду нужен другой мод, которого нет. Самый частый случай — забытый Fabric API: без него не работает большинство Fabric-модов, и это отдельный файл, который надо скачать. Реже требуются библиотеки вроде Architectury, GeckoLib или Cloth Config.

Лог обычно называет и нужную версию — ставьте именно её, а не «самую новую».

Incompatible mods found

Incompatible mods found! net.fabricmc.loader.impl.FormattedException

Прямой конфликт: моды объявили, что вместе не работают. Классика — Sodium и OptiFine: оба переписывают отрисовку, вместе их ставить нельзя. Читайте, какие два мода названы, и оставляйте один.

Mixin apply failed

org.spongepowered.asm.mixin.injection.throwables.InjectionError:
Critical injection failure: ... in mixins.example.json failed

Самое пугающее на вид и одно из самых простых по сути. Мод пытался вклиниться в код игры и не нашёл того, что ожидал. Практически всегда означает: мод собран под другую версию игры. Реже — два мода лезут в одно и то же место.

Проверьте версию мода, и если она правильная — ищите второй мод, который трогает ту же механику.

Проверить всю сборку на совпадение версий разом: проверка совместимости модов.

Мод не загружается молча

Ошибок нет, но мода в игре нет. Две причины:

Как найти виноватого за пять шагов

Когда лог не называет мод прямо, работает деление пополам:

  1. Уберите половину модов в отдельную папку.
  2. Запустите. Заработало — виноват в убранной половине; нет — в оставшейся.
  3. Возьмите ту половину, где виноватый, и снова поделите пополам.
  4. Повторяйте.

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

Чего инструменты проверить не могут

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

Если вылет случается в игре, а не при запуске

Это чаще всего не конфликт, а память. Симптом — вылет через полчаса игры или при заходе в новую область. Смотрите, не упирается ли сборка в -Xmx.

Сколько памяти нужно сборке — калькулятор RAM.

Частые вопросы

Как быстро найти, какой мод ломает сборку?

Делением пополам: уберите половину модов и запустите. Если заработало — виноват в убранной половине. Так любой мод находится за пять-шесть шагов.

Почему мод не видно в игре, хотя ошибок нет?

Чаще всего он положен не в ту папку или собран под другой загрузчик: файл под Forge в папке модов Fabric просто игнорируется.

Читайте также