Platform

Что такое Platform

Platform - библиотечный мод для Minecraft: Java Edition, созданный на базе Architectury. Он почти не добавляет в игру собственный контент, новые блоки или предметы. Его задача другая: дать разработчикам единый набор инструментов для модов, которые должны работать сразу на нескольких загрузчиках.

Проще говоря, Platform выступает общим слоем между модом и API Fabric, Forge, NeoForge или Quilt. Благодаря этому разработчику не приходится отдельно реализовывать одни и те же функции для каждой платформы. Для игрока это означает более удобную установку совместимых модов и меньше дублирующих библиотек в сборке.

Platform особенно полезен как core-зависимость для других проектов. Среди поддерживаемых модов указаны Offlimits и CaveBiomeAPI.

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

Сам по себе Platform не добавляет заметных игровых механик. Вы не получите новый биом, оружие или интерфейс только после установки этой библиотеки. Ее работа проявляется через другие моды, которым нужны общие инструменты для регистрации контента и взаимодействия с Minecraft.

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

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

Возможности библиотеки

Platform включает набор утилит для разработки модов под разные загрузчики:

• Конструктор экземпляра мода - помогает унифицировать начальную настройку проекта.
• Встроенный конструктор реестров - упрощает регистрацию предметов, блоков и других игровых объектов.
• Реестры изменения и размещения биомов - позволяют другим модам работать с генерацией мира и настройкой биомов.
• Инструменты интеграции с ванильным Minecraft - набор простых средств для подключения собственных функций к стандартным механикам игры.
• Создание и изменение вкладок творческого режима - зависимые моды могут добавлять свои предметы в подходящие вкладки или настраивать их содержимое.
• Вспомогательные классы - готовые утилиты для типовых задач при разработке.

Отдельные инструменты Platform связаны с такими системами Minecraft:

• регистрация объектов;
• частицы;
• типы древесины;
• сделки жителей;
• сетевое взаимодействие;
• конфигурации;
• игровые события.

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

Для чего нужен Platform в сборке модов

Главная проблема, которую решает Platform, связана с различиями между загрузчиками. Fabric и Forge используют разные API и подходы к подключению контента. NeoForge и Quilt тоже имеют собственные особенности. Мод, рассчитанный сразу на несколько платформ, должен учитывать эти различия.

Architectury дает общую основу, а Platform дополняет ее готовыми утилитами для регистрации, конфигураций, событий и сетевых пакетов. В результате один и тот же зависимый проект проще поддерживать на разных версиях Minecraft и загрузчиках.

Для игрока это выглядит так: в списке файлов сборки появляется библиотечный мод, который сам ничего не меняет, зато позволяет запуститься другому проекту. Удалять Platform без проверки зависимостей не стоит. Если его использует Offlimits, CaveBiomeAPI или другой установленный мод, после удаления игра может показать ошибку о недостающей зависимости.

Fabric, Forge, NeoForge и Quilt

Platform рассчитан на кроссплатформенную разработку. Поддержка конкретного загрузчика зависит от версии файла и самого мода, который использует библиотеку. В доступных версиях проекта заявлены Fabric, Forge, NeoForge и Quilt.

Для Fabric требуется Fabric API. Его нужно устанавливать отдельно, если он не включен в вашу сборку. Внутренняя ссылка на необходимую библиотеку: Fabric API.

Не стоит смешивать файлы от разных загрузчиков. Версия Platform для Fabric не заменяет сборку для Forge или NeoForge, даже если номер Minecraft совпадает. Также важно сверять версию игры: файл для Minecraft 1.21.1 не предназначен автоматически для 1.20.1 или 1.19.2.

Поддерживаемые версии Minecraft

На странице проекта заявлена поддержка следующих версий игры:

• Minecraft 1.21.1;
• Minecraft 1.20.1;
• Minecraft 1.19.2;
• Minecraft 1.16.5.

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

Установка и проверка зависимостей

Platform устанавливается в папку mods как обычный библиотечный мод. Перед запуском проверьте, для какого загрузчика предназначен файл. На Fabric дополнительно нужен Fabric API, а для Forge, NeoForge или Quilt могут требоваться другие зависимости, указанные в файле конкретного мода.

Если после установки появляется сообщение о missing dependency или отсутствующей библиотеке, сначала проверьте именно эти пункты:

• совпадает ли версия Minecraft;
• подходит ли загрузчик;
• установлен ли Fabric API для Fabric;
• не используется ли файл Platform от другой версии игры;
• установлен ли мод, который действительно требует эту библиотеку.

Обычно Platform не требует отдельной настройки. Конфигурации и игровые команды зависят от модов, которые подключают его функции.

Совместимость с другими модами

Platform предназначен для работы в составе сборок модов и рассчитан на использование другими библиотеками и контентными проектами. Его не следует воспринимать как замену Fabric API, Forge API или NeoForge API. Это дополнительный общий слой, который упрощает доступ к нужным функциям.

В подтвержденный список связанных проектов входят Offlimits и CaveBiomeAPI. Если один из них указан в зависимостях, Platform должен находиться в сборке одновременно с ним.

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

Важный нюанс

Platform нужен не каждой сборке Minecraft. Если ни один установленный мод не указывает его в зависимостях, добавлять библиотеку без причины нет смысла. Зато при наличии такой зависимости это обязательный компонент, даже если в главном меню или игровом мире не видно никаких изменений.

По сути, Platform - это технический фундамент для модов, которым требуется общий код на Fabric, Forge, NeoForge и Quilt. Он помогает разработчикам поддерживать несколько загрузчиков, а игрокам - запускать совместимые проекты в одной сборке без отдельных реализаций каждой базовой функции.