Server Sided Portals - Серверные Порталы

Server Sided Portals - мод для Майнкрафт, который решает давнюю проблему серверов: как добавить порталы в кастомные измерения, не заставляя игроков качать моды на клиент. По факту это API, работающее исключительно на стороне сервера. Вы можете создать портал в любое измерение, даже добавленное другим модом, а игроки зайдут с обычным ванильным клиентом и даже не заметят подвоха. Скачайте Server Sided Portals, если собираете сервер или сборку модов с уникальными мирами.

Что умеет этот мод

• Кастомные порталы - создавайте порталы с любой рамкой, привязанные к нужному измерению.
• Гибкий дизайн рамки - блоки для постройки рамки задаются через теги (поддерживает сразу несколько типов блоков).
• Свои зажигалки - настройте, какими предметами будет поджигаться портал, используя теги предметов.
• Только серверная часть - клиентский мод не требуется, всё работает под капотом сервера.
• Поддержка любых измерений - можно делать порталы из любого мира в любой другой, включая миры из других модов.
• Полная совместимость - работает как с ванильными, так и с модифицированными клиентами.
• Дружелюбность к датапакам и модам - простая интеграция через JSON или код.

Как это использовать

Мод можно юзать как вместе с датапаком, так и встроить в свой мод. Ниже базовый гайд по настройке через датапак.

Настройка через датапак

1. Создайте датапак - по стандартному гайду Майнкрафт.
2. Определите тип измерения - сгенерируйте JSON для кастомного измерения.
3. Создайте само измерение - настройте генерацию мира.
4. Укажите блоки рамки - создайте тег блока dimension_portal_frame (замените dimension на название вашего мира). Туда можно пихать несколько блоков или даже другие теги.
5. Выберите зажигалку (опционально) - создайте тег предмета dimension_portal_igniter для предметов, которые будут активировать портал.
6. Организуйте файлы - убедитесь, что все JSON-файлы лежат в одном неймспейсе (namespace).

Загрузите датапак вместе с модом, и порталы заработают. Можно добавлять кучу измерений, каждому со своими рамками и активаторами. Начиная с версии 2.1.0, появилась возможность задавать игровой режим для игроков при входе в мир или указывать кастомные точки входа вместо обычного Верхнего мира.

Интеграция в мод

Если вы разрабатываете свой мод, просто закиньте JSON-файлы в папку ресурсов: resources/data/mod_id/. Если хотите дать юзерам возможность включать/выключать датапак, используйте API Cobweb static datapack. Создание мода вместо датапака дает больше свободы - можно добавлять дополнительный функционал и расширять свои измерения. В API также встроен набор полезных утилит, подробнее о них можно почитать в Javadoc.

Важный нюанс: Если портал не загорается, в 90% случаев проблема в неправильном неймспейсе. Проверьте, чтобы название тега и папки датапака совпадали с названием измерения.

Совместимость

Мод	Загрузчик	Совместимость
Crying Portals	Все	Несовместим
Immersive Portals	Все	Несовместим
BetterNether	Fabric	Совместим
Very Many Players	Fabric	Совместим при use_async_portals=false
Canary	Forge	Совместим при отключении быстрых порталов

Зависимости

Мод	Загрузчик	Требование
Cobweb	Все	Обязательно

Мод поддерживает NeoForge, Forge и Fabric для Minecraft 1.21 и ниже. Для работы сервера на BungeeHost (https://bungee.host) этот мод устанавливается в 1 клик, а игрокам вообще не нужно ничего скачивать - просто заходят и играют.