Fake Fabric Loader

Что делает Fake Fabric Loader

Fake Fabric Loader - служебный мод для Minecraft Java, созданный прежде всего для пользователей Quilt Loader. Он пере реализует часть внутреннего API Fabric Loader через его публичный API, чтобы некоторые неправильно написанные моды не завершали запуск с ошибкой совместимости.

Проще говоря, проект помогает Quilt корректнее взаимодействовать с модами, которые обращаются к внутреннему классу net.fabricmc.loader.FabricLoader, хотя должны использовать официальный публичный интерфейс net.fabricmc.loader.api.FabricLoader. Для обычного игрока это выглядит как небольшой фикс совместимости, но для самого загрузчика разница довольно важная.

Зачем нужен этот мод

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

Особенно полезен проект в сборках модов на Quilt, где обновления Fabric Loader могут выходить с задержкой или отдельный мод требует номер версии, которого фактически нет в установленной конфигурации. Практический пример такой несовместимости - RRLS: Fake Fabric Loader способен скрыть проблему с жёстким требованием версии загрузчика, но не превращает Quilt в Fabric и не меняет его реальную внутреннюю реализацию.

Поэтому это не мод, который добавляет новые блоки, предметы или механики. В игровом процессе ничего не меняется: он работает на уровне запуска, проверки версий и совместимости модов.

Важный нюанс с версией загрузчика

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

Из этого следует главное ограничение: если требуемая версия действительно содержит новую функцию, которой нет в текущем загрузчике, Fake Fabric Loader её не добавит. В таком случае мод может запуститься дальше, а затем завершиться с крашем при обращении к отсутствующему классу или методу.

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

Совместимость и поддерживаемые версии

• Основная среда использования - Quilt Loader.
• В актуальных сборках проект также выпускается для Fabric и Quilt.
• Поддерживаются клиентские и серверные конфигурации.
• Игровые версии охватывают Minecraft 1.14-1.21.x, а также 26.1.x и 26.2.
• Для каждой целевой версии Fabric Loader используется отдельный файл.
• Файлы отличаются заявленным номером загрузчика, при этом функционально остаются одинаковыми.
• Это не порт на Forge и не способ добавить поддержку Forge-модов.

Исходная идея проекта рассчитана на Quilt: портирование именно этой реализации на Fabric или Forge не требуется, поскольку проблема возникает из-за обращения модов к внутренностям Fabric Loader и особенностей совместимости Quilt.

Предупреждения при обращении к внутреннему API

Fake Fabric Loader старается показывать предупреждения, когда мод обращается к внутреннему API Fabric Loader. Это полезно не только для запуска сборки, но и для поиска настоящей причины несовместимости.

Если в логе появляется такое предупреждение, проблема обычно находится в стороннем моде. Разработчику следует заменить вызовы внутреннего класса net.fabricmc.loader.FabricLoader на публичный API net.fabricmc.loader.api.FabricLoader, а не добавлять зависимость от Fake Fabric Loader.

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

Кому пригодится Fake Fabric Loader

Утилита пригодится игрокам, которые собирают Quilt-сборку модов и сталкиваются с сообщением о неподходящей версии Fabric Loader, хотя сам мод по факту не использует уникальные возможности этой версии. Также проект может помочь при запуске серверной сборки, если один из модов проверяет версию загрузчика слишком строго.

А вот для стабильной сборки на постоянной основе лучше устранить первопричину: обновить проблемный мод, выбрать подходящую версию Quilt или использовать релиз Fabric Loader, который действительно соответствует требованиям. Иначе после обновления Minecraft проблема может вернуться в другом месте.

Fake Fabric Loader известен как необычная Cursed Utility, то есть нестандартная утилита совместимости. Она не украшает Minecraft и не добавляет контент, зато иногда позволяет запустить сборку, которая без этого останавливается ещё до появления главного меню.

Что изменится в игре

На геймплей мод не влияет. Не появятся новые мобы, предметы, биомы или настройки мира. Изменения касаются только этапа запуска Minecraft и взаимодействия загрузчика с модами:

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

По факту Fake Fabric Loader стоит рассматривать как временный слой совместимости. Он полезен, когда нужно быстро проверить сборку или запустить конкретный мод на Quilt, но не заменяет исправление кода и не гарантирует работу любой комбинации версий.