Forgified Fabric API

Что такое Forgified Fabric API

Forgified Fabric API (сокращённо FFAPI) - это прямой порт стандартной библиотеки Fabric API, адаптированный под загрузчик NeoForge. Если говорить проще: берётся код Fabric API и переносится на НеоФорж, чтобы разработчики могли использовать привычный интерфейс программирования при создании модов сразу под две платформы.

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

В экосистеме Майнкрафт существует два основных загрузчика - Fabric и Forge. NeoForge - относительно новый форк Forge, который набирает популярность, особенно начиная с Minecraft 1.20.1 и выше. Проблема в том, что Fabric API предоставляет кучу удобных хуков, которых нет в NeoForge из коробки. Разработчикам приходится либо писать свой велосипед, либо тащить зависимости.

Forgified Fabric API решает эту задачу. Он позволяет использовать Fabric API как общую библиотеку при работе с кодом игры на обеих платформах. Это не значит, что любой мод с Fabric запустится на NeoForge по щелчку - FFAPI не является слоем абстракции. Код, специфичный для конкретного загрузчика, всё равно нужно обрабатывать отдельно. Но значительная часть логики мода может быть общей, что сильно экономит время.

Что входит в состав

Fabric API покрывает несколько ключевых областей, и Forgified Fabric API переносит их все:

• Доступ к скрытой функциональности - частицы, биомы, измерения. В ванильном Minecraft часть этих механик труднодоступна для прямого вызова, и Fabric API открывает к ним удобный доступ
• События и хуки - система ивентов, которая позволяет модам реагировать на игровые действия без прямого вмешательства в базовый код. Это улучшает совместимость между модами, так как они не перезаписывают одни и те же классы
• Синхронизация реестров - критически важная штука для многопользовательской игры. Без правильной синхронизации клиент и сервер могут по-разному понимать, какие предметы и блоки зарегистрированы, что приводит к рассинхрону и крашам
• Информация в краш-репортах - мод добавляет полезные данные в отчёты об ошибках, что упрощает отладку
• Продвинутый рендеринг - API рендеринга, созданный с учётом совместимости с оптимизационными модами и модами на графику. Это значит, что визуальные моды меньше конфликтуют между собой

Кому это реально нужно

Разработчикам модов

Если вы пишете мод и хотите, чтобы он работал и на Fabric, и на NeoForge - FFAPI значительно упрощает жизнь. Вы используете Fabric API как общий слой, а платформенно-зависимый код выносите отдельно. Это не убирает необходимость тестировать сборку на каждом загрузчике, но сокращает объём дублирующегося кода.

Обычным игрокам

Если вы просто скачиваете моды - вам может потребоваться Forgified Fabric API как зависимость. Некоторые моды для NeoForge используют FFAPI, и без него просто не запустятся. В таком случае просто установите его как обычный мод в папку mods.

Важные нюансы

• Не путайте с обычным Fabric API. Forgified Fabric API ставится на NeoForge, а не на Fabric. Если у вас Fabric - вам нужен оригинальный Fabric API, а не этот порт
• Версии Minecraft. FFAPI регулярно обновляется и синхронизируется с upstream-репозиторием Fabric API. Убедитесь, что версия FFAPI соответствует вашей версии NeoForge и Minecraft
• Не все моды заработают. Даже с FFAPI мод, написанный исключительно под Fabric, не запустится на NeoForge автоматически. Проект помогает разработчикам, а не является эмулятором
• Совместимость с оптимизацией. Рендеринг API спроектирован с расчётом на работу вместе с модами вроде Sodium и Iris, но на NeoForge экосистема оптимизации другая, так что проверяйте совместимость вручную

Итог

Forgified Fabric API - узкоспециализированный инструмент, который имеет смысл скачивать, если вы занимаетесь моддингом на NeoForge или устанавливаете мод, который явно требует FFAPI как зависимость. Для обычной игры он не нужен, но без него часть кроссплатформенных модов просто не запустится. Если планируете поднять сервер с модами на NeoForge - обратите внимание на список зависимостей, FFAPI там встречается нередко.