Fabric Loader запускает Fabric-моды, а Fabric API — это дополнительная библиотека для модов. Новый Loader не заменит отсутствующий API и не исправит файл мода, собранный для другой версии Minecraft. Поэтому на Fabric-сервере на mcfreehost сначала проверь весь набор версий и конкретное сообщение при запуске. Только после этого меняй затронутый компонент и тестируй вход подходящим клиентом.
Содержание проверено: 7 октября 2026 года. Это руководство посвящено Java с Fabric. Плагины Paper, файлы Forge/NeoForge и нативные серверы Bedrock относятся к другим программным путям. Конкретная версия Loader не рекомендуется как подходящая для любого пака.
Minecraft, Loader и API — это три разных параметра
| Компонент | Что определяет | Где сравнивать |
|---|---|---|
| Minecraft | Версия игры и основа данных мира | Лог запуска сервера и фактически запущенный экземпляр клиента |
| Fabric Loader | Загрузку модов и проверку заявленных требований | Лог запуска, управление программным обеспечением и требования пака |
| Fabric API | Функции библиотеки для модов, которым она нужна | Файл мода в папке mods и метаданные его загрузки |
| Модпак и отдельные моды | Контент, зависимости и нужная сторона | Версия пака, серверный пакет, данные о файле/проекте |
| Java | Среда выполнения, в которой запускаются Minecraft и моды | Лог запуска/краша и требования выбранной версии игры |
Эти три компонента должны соответствовать требованиям твоего пака. Самый свежий релиз библиотеки — это не общий номер версии для всех трёх.
В разделе про установку модов Fabric объясняет, что нужно проверять версию игры, семейство Loader и редакцию Java. Файл Fabric API для другой ветки Minecraft не станет совместимым от простого переименования. Точно так же мод Forge, положенный в папку Fabric, не превращается в мод Fabric.
1. Зафиксировать фактический набор версий
Перед любым вмешательством запиши эти данные для сервера и используемого экземпляра клиента:
Minecraft: точная версия игры
Fabric Loader: фактически загруженная версия
Fabric API: имя файла и опубликованная версия
Модпак: название и конкретная версия пака
Java: среда выполнения, указанная в логе запуска
Последнее изменение: что отличается с момента последнего успешного запуска
Это шаблон для твоих заметок, а не готовый совместимый набор версий. Особенно при нескольких экземплярах лаунчера недостаточно, чтобы правильная версия была установлена где-то: нужно запускать именно этот экземпляр. Обновление лаунчера, версия пака и обновление Minecraft — это разные изменения.
Для готового модпака начни с его документированного серверного пакета и предусмотренной версии клиента. Не обновляй каждый мод по отдельности до «последней» версии. Сборка пака может намеренно использовать более старый файл. Для самой загрузки клиента и входа поможет руководство по входу на сервер с модпаком.
2. Выбрать правильный файл API и страницу мода
Открой список файлов официального проекта Fabric API и отфильтруй его по своей версии Minecraft. Затем проверь, соответствует ли выбранный файл требованиям пака и затронутых модов. Одной даты публикации для ответа на этот вопрос недостаточно: новый релиз может быть предназначен для другой ветки игры.
Для каждого дополнительного файла проверь:
- Опубликован ли он для Fabric и одобрен ли для твоей версии Minecraft?
- Относится ли он к клиенту, выделенному серверу или к обеим сторонам?
- Какие дополнительные библиотеки требует именно эта версия?
- Не лежит ли в папке сервера ещё более старая версия того же мода?
Второй файл API рядом со старым — это не чистая замена. Прежде чем ставить подходящую версию, сохрани прежний файл вне активной папки mods. Произвольно переименованный JAR всё равно может загрузиться, поэтому действительно убери старый активный файл из этой папки.
Моды, влияющие только на графику или управление, часто нужны только на клиенте. Поэтому не копируй всю папку клиента на сервер без проверки. Метаданные модов Fabric различают окружения client, server и *. Решающими остаются данные проекта или серверного пакета; неверно заявленный мод всё равно может вылететь позже.
3. Правильно читать сообщение
Открой в панели управления сервером вывод при запуске. Если сбой начинается со списка зависимостей вроде Incompatible mods found!, зафиксируй: какой мод, какое требование и какая имеющаяся версия указаны.
| Наблюдение | Значение | Целевой следующий шаг |
|---|---|---|
| Отсутствует необходимый мод | Обязательная зависимость не выполнена | Получить недостающую библиотеку для той же ветки Minecraft |
| Имеющийся API слишком старый | Мод требует другую версию или диапазон версий API | Выбрать одобренный для этого файл API; заменить старую активную версию |
| Мод требует другую версию Minecraft | Скачанный файл мода не подходит для ветки игры | Найти подходящую версию мода; не обновлять для этого вслепую существующий мир |
| Loader не удовлетворяет требованию | Загруженная версия Loader не соответствует требованию пака | Подготовить смену Loader как изменение стартового ПО |
| Один и тот же идентификатор мода встречается несколько раз | Два активных файла могут предоставлять один и тот же мод | Проверить список файлов и содержимое пака на дубликаты |
| Запуск проходит дальше и падает лишь с исключением | Проверка зависимостей не полностью объясняет ошибку | Изучить отчёт о запуске/краше и последнее изменение |
Список может содержать несколько взаимосвязанных требований. Решай указанный конфликт как единый набор; верхняя строка не обязательно является единственной причиной. После этого проверь новый вывод запуска, а не продолжай разбирать старое сообщение.
Ошибка Mixin или NoClassDefFoundError сама по себе не доказывает отсутствие Fabric API. Руководство Fabric по отчётам о крашах объясняет значимые цепочки ошибок, системные данные и список модов. Мод, названный первым, может быть причастен, но не обязательно виноват в одиночку. Если сервер вообще не запускается, руководство по ошибкам запуска поможет выявить и причины вне выбора версий.
4. Внести изменения на mcfreehost и протестировать с возможностью отката
Сначала сделай резервную копию мира, конфигурации и прежнего набора версий. Копии одних лишь файлов модов недостаточно для отката после конвертации мира. Запланируй изменение на время, когда твоя группа не играет, и корректно останови сервер через панель управления.
Loader относится к стартовому ПО. Для его смены используй предусмотренный способ выбора ПО/версии твоего сервера; не клади JAR Loader в mods в качестве якобы API. При смене или переустановке прочитай показанное сообщение о сохранении данных. Если полной резервной копии ещё нет, остановись перед подтверждением. А вот API и другие библиотеки модов, наоборот, кладутся в mods как подходящие файлы модов.
Для управляемого модпака следуй его пути обновления и установки. Последующее обновление пака может снова заменить ручную подмену файлов. Поэтому фиксируй собственные изменения и выясни, совместимы ли они вообще с нужной версией пака. О том, как управлять автоматическими обновлениями, рассказывает руководство по обновлениям.
После изменения проверь по порядку:
- Сервер достигает рабочего состояния; новый лог запуска показывает ожидаемые версии игры и Loader.
- Клиент с предусмотренной версией пака действительно может зайти.
- Важная для вашей игры функция мода работает в нужном мире.
- После чистой перезагрузки мир и настройки сохраняются.
Успешный запуск ещё не подтверждает успешный вход с модпаком. И наоборот, более новый API не решает нехватку RAM. Если запуск проходит, а сервер перегружается только новыми чанками или множеством сущностей, отделяй этот вопрос ресурсов от ошибки версий. Для бесплатных серверов действуют ограничения бесплатного старта; дополнительная библиотека не увеличивает доступный RAM.
Если новое состояние не работает, прекрати дальнейшие изменения и восстанови документированное старое состояние ПО вместе с резервной копией, сделанной до изменения. Не запускай мир, уже загруженный в более новом Minecraft, как импровизированный даунгрейд на более старом ПО. Для обращения за помощью запиши версию пака, последнее изменение и важные строки лога; перед отправкой проверь логи на наличие данных доступа.
FAQ
Могу ли я всегда ставить самую новую версию Fabric Loader?
Loader поддерживает несколько версий игры, но это не гарантия для любой сборки пака. Проверь требования пака и модов, сохрани текущее состояние и протестируй переход. Обновление Loader не заменит неправильно выбранный файл мода.
Должен ли номер версии Fabric API совпадать с номером Minecraft?
Нет. У Fabric API собственный номер версии. Решающими являются версии Minecraft, указанные для этого файла, и требования модов, которые им пользуются.
Нужен ли Fabric API и на сервере, и на клиенте?
Это зависит от модов на соответствующей стороне. Если им нужен Fabric API, там должна быть подходящая версия. Данные пака и проекта подскажут, какие файлы предназначены для клиента, а какие для сервера.
Должен ли у клиента и сервера быть одинаковый Loader?
Один лишь номер Loader вход не определяет. Обе стороны должны выполнять требования своих модов. Для готового пака используй на обеих сторонах предусмотренную им версию и следи за совпадением версии Minecraft; не меняй Loader независимо от пака.
Можно ли просто отключить отсутствующую обязательную зависимость?
Отключённая проверка зависимостей не сделает недостающие функции доступными. Найди подходящий файл или вернись к рабочему состоянию пака. Правка файла метаданных не является обычным способом исправления в этом руководстве.
Почему я не могу зайти, хотя сервер успешно запустился?
При запуске сервер проверяет только собственное окружение. Неправильно запущенный экземпляр клиента, другая версия пака или недостающий общий контент могут обнаружиться только при входе. Сравни тогда фактические версии и конкретное сообщение об ошибке клиента.
Источники и основа проверки
- Fabric: установка модов — версия игры, семейство Loader и установка.
- Fabric: установка и серверный лаунчер — Loader как часть стартовой установки.
- Fabric API: опубликованные файлы — соответствие версиям игры.
- Fabric: метаданные модов — окружения и заявленные зависимости.
- Fabric: чтение отчётов о крашах — цепочки ошибок и системные данные/данные о модах.
Источники были проверены 7 октября 2026 года. Конкретный набор версий остаётся решением для твоего пака; эта статья не утверждает, что проводился новый тест запуска или входа для твоего индивидуального мира.