Мод не загружается: Mixin apply failed, Missing dependency и другие
ОшибкиИгра падает при запуске, и в логе стена текста. Разберём сообщения, которые встречаются чаще всего, и способ найти виноватого, когда сообщение ни о чём не говорит.
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
Самое пугающее на вид и одно из самых простых по сути. Мод пытался вклиниться в код игры и не нашёл того, что ожидал. Практически всегда означает: мод собран под другую версию игры. Реже — два мода лезут в одно и то же место.
Проверьте версию мода, и если она правильная — ищите второй мод, который трогает ту же механику.
Проверить всю сборку на совпадение версий разом: проверка совместимости модов.Мод не загружается молча
Ошибок нет, но мода в игре нет. Две причины:
- Не тот загрузчик. Файл под Forge, лежащий в папке модов Fabric, просто игнорируется. Смотрите на имя файла: в нём обычно указан загрузчик.
- Не та папка. Мод должен лежать в
mods, плагин — вplugins. У проектов, которые бывают и тем и другим, файлы разные.
Как найти виноватого за пять шагов
Когда лог не называет мод прямо, работает деление пополам:
- Уберите половину модов в отдельную папку.
- Запустите. Заработало — виноват в убранной половине; нет — в оставшейся.
- Возьмите ту половину, где виноватый, и снова поделите пополам.
- Повторяйте.
Из ста модов виновник находится за семь шагов, из тридцати — за пять. Это дольше, чем прочитать лог, но работает всегда, в том числе когда конфликтуют двое и по отдельности оба исправны.
Чего инструменты проверить не могут
Совпадение версий — условие необходимое, но не достаточное. Два мода могут заявлять одну и ту же версию игры и всё равно конфликтовать: переписывать одну часть кода, спорить за идентификаторы, требовать разных версий общей библиотеки. Такое видно только в логе запуска, и никакой справочник этого не предскажет.
Если вылет случается в игре, а не при запуске
Это чаще всего не конфликт, а память. Симптом — вылет через полчаса игры или при заходе в новую область. Смотрите, не упирается ли сборка в -Xmx.
Частые вопросы
Как быстро найти, какой мод ломает сборку?
Делением пополам: уберите половину модов и запустите. Если заработало — виноват в убранной половине. Так любой мод находится за пять-шесть шагов.
Почему мод не видно в игре, хотя ошибок нет?
Чаще всего он положен не в ту папку или собран под другой загрузчик: файл под Forge в папке модов Fabric просто игнорируется.