Immersive Portals Paperized - сквозные порталы для Paper без модов

Immersive Portals Paperized - это серверный плагин для PaperMC, который даёт тот же эффект, что и знаменитый мод Immersive Portals, но без установки чего-либо на клиенте игрока. Заходишь с чистой ванилью - и видишь через портал в Незер, что там реально происходит. В реальном времени. Никаких модов, никакого Forge или Fabric.

Помнишь ванильные порталы? Фиолетовая плёнка, за которой ничего не разглядеть. Immersive Portals Paperized эту плёнку делает прозрачной: стоишь в Обычном мире, смотришь в раму - видишь лавовое озеро, гастов, крепость или базу соседа по фракции. Направление работает в обе стороны. А ещё можно строить собственные порталы между произвольными точками мира, между разными измерениями и даже между разными серверами одной сети.

Идея и название взяты у мода Immersive Portals. Код частично построен на наработках NetherView и BetterPortals. Так что это не самоделка с нуля, а осмысленный порт на современные версии Minecraft Java.

Кому и зачем это надо

Держишь сервер на Paper и не хочешь объяснять сотне игроков, как ставить моды? Здесь вся магия происходит на стороне сервера. Игрок заходит, порталы работают. Плюс не надо следить за совместимостью клиентских сборок. Подходит для лобби-серверов, хабов, квестовых карт, ролевых проектов и вообще всего, где вау-эффект стоит больше, чем пара миллисекунд на рендер.

Мод Immersive Portals - тяжеловесный для клиента. Тут нагрузка ложится на сервер: рендер идёт пакетами. И есть TPS-aware rendering - при просадке тиков рендер порталов автоматически облегчается. Хорошая задумка. На слабом VPS вряд ли вытянет много порталов сразу, но на нормальном железе - вполне. По типу проект близок к транспортным и tech-решениям, никакой хоррор или PvP-эстетики тут нет.

Основные возможности

Возможностей много, перечислю по-человечески, а не сухим списком:

• Сквозные незер-порталы - ванильная сеть порталов начинает работать как в моде.
• Рендер в реальном времени - не превью, не заглушка, а живая картинка.
• Кастомные порталы - создавай рамы любой формы и размеров между любыми точками.
• Межсерверные порталы - портал на одном сервере ведёт на другой сервер сети (нужен прокси).
• Эффекты и пресеты - можно накладывать разные визуальные пресеты на порталы.
• Интеграция с экономикой - через Vault портал можно сделать платным.
• Палочка выделения - удобный инструмент админа для разметки порталов.
• Совместимость с Folia - редкая и приятная штука на 2024-2025 год.
• Админ-GUI - открывается командой /bp menu.
• TPS-aware рендеринг - порталы сами снижают нагрузку при лагах.
• Защита от дюпов - предметы не будут размножаться на границах порталов.
• Поддержка нескольких миров - мир, Незер, Энд, дополнительные миры.
• Смешивание измерений - освещение и цвета по обе стороны могут смешиваться.
• Система световых блоков (Minecraft 1.18+) - корректная работа с освещением через портал.
• Отслеживание сущностей - мобы, предметы и прочие сущности видны сквозь портал, а не только блоки.
• Локализация - 25+ языков, включая русский.

В будущих обновлениях обещают проход через портал без блока (то есть просто шагнуть сквозь поверхность), стабилизацию, оптимизацию и авто-проверку обновлений через Modrinth.

Установка и зависимости

Плагин ставится в папку plugins как обычный Paper-плагин. Заявлена работа на Minecraft Java 1.21.x и смежных версиях.

Обязательная зависимость:

• PacketEvents - без него рендер порталов не работает вообще, он построен на пакетах.

Опциональные:

• Vault - если хочешь платные порталы.
• Multiverse-Core - управление мирами.
• My_Worlds - альтернатива для управления мирами.

Важный нюанс

Плагин в статусе Alpha (актуальная версия 1.1.2). Не жди идеальной стабильности. Полноценная поддержка Spigot не гарантируется: код плотно сидит на Paper API и специфичных фичах. На Purpur, Paper и Folia работает, на Spigot - как повезёт.

Советую сначала потестить на отдельном тестовом сервере. Сделай бэкап мира перед тем, как массово создавать порталы. А ещё - чем больше порталов одновременно видно в кадре, тем выше нагрузка. Не превращай лобби в лабиринт из 30 порталов рядом, иначе TPS просядет даже на нормальном железе.

Как создать портал

Процедура простая:

1. Возьми палочку: /bp wand.
2. Выдели углы в точке входа, выполни /bp setOrigin.
3. Выдели углы на выходе, выполни /bp setDestination.
4. Свяжи: /bp linkPortals. Для межсерверного портала - /bp linkExternalPortals.

Готово, портал создан. Дальше можно задать ему имя, цену и пресет эффектов через отдельные команды.

Команды

Все команды живут под длинным префиксом /immersiveportalspaperized, но есть короткие алиасы - /p и /bp.

• /bp reload - перезагрузить плагин и конфиг
• /bp reconnect - переподключиться к прокси, если связь отвалилась
• /bp wand - выдать палочку для выделения
• /bp setOrigin - установить текущее выделение как точку входа
• /bp setDestination - установить текущее выделение как точку выхода
• /bp linkPortals - связать вход и выход
• /bp linkExternalPortals - связать вход с выходом на другом сервере
• /bp createfromcoords - создать портал по координатам, без игрока и палочки
• /bp remove - удалить ближайший портал в радиусе 20 блоков
• /bp removebyname - удалить все порталы с указанным именем
• /bp setPortalName - задать имя ближайшему порталу
• /bp getportalname - узнать имя ближайшего портала
• /bp setprice - задать цену ближайшего портала
• /bp setpreset - задать пресет эффектов
• /bp getallowNonPlayerTeleportation - узнать, проходят ли через портал предметы и мобы
• /bp setAllowNonPlayerTeleportation - разрешить или запретить телепорт мобов и предметов через портал
• /bp setseethroughportal - включить или выключить сквозной просмотр лично для себя
• /bp toggleseethroughportal - переключить сквозной просмотр
• /bp menu - открыть админ-GUI

Права (Permissions)

• immersiveportalspaperized.user - использовать порталы (по умолчанию: включено)
• immersiveportalspaperized.see - видеть сквозь порталы (по умолчанию: включено)
• immersiveportalspaperized.select - палочка и админ-меню
• immersiveportalspaperized.wand - использование палочки
• immersiveportalspaperized.link - связывание порталов
• immersiveportalspaperized.linkexternal - межсерверные порталы
• immersiveportalspaperized.remove - удаление своих порталов
• immersiveportalspaperized.remove.others - удаление чужих порталов
• immersiveportalspaperized.setname - переименование, цена, пресеты
• immersiveportalspaperized.setname.others - то же для чужих порталов
• immersiveportalspaperized.getname - узнавать имена порталов
• immersiveportalspaperized.createfromcoords - создание порталов по координатам
• immersiveportalspaperized.reload - перезагрузка конфига
• immersiveportalspaperized.reconnect - переподключение к прокси
• immersiveportalspaperized.getallowNonPlayerTeleportation - проверка телепорта мобов и предметов
• immersiveportalspaperized.setAllowNonPlayerTeleportation - переключение этой опции

По умолчанию обычный игрок может ходить через порталы и видеть сквозь них (права .user и .see). Всё, что связано с созданием, редактированием и удалением, по умолчанию только для операторов.

Конфигурация

Файл конфига создаётся при первом запуске: plugins/ImmersivePortalsPaperized/config.yml. Там настраивается куча всего - связи между мирами, пресеты эффектов порталов, настройки прокси и параметры производительности. Комментарии в конфиге подробные, разобраться реально.

Хот-релоад - /bp reload, перезапуск сервера не нужен.

Межсерверные порталы и прокси

Если хочешь связать порталы между разными серверами - нужен прокси. Обычно это Velocity или BungeeCord. Под такие схемы хорошо подходит хостинг BungeeHost - там прокси-сеть и установка серверов делается в один клик, и подобные штуки с межсерверными порталами разворачиваются без боли. Особенно если делаешь хаб, связанный с игровым миром, или что-то вроде RPG-сети с переходами между картами. BungeeHost выручит и если хочешь просто поиграть с друзьями с таким порталом - развернуть сервер с прокси можно буквально за минуту.

И да, при использовании прокси следи за настройками reconnect - если связь с прокси падает, порталы перестают работать, пока не выполнишь /bp reconnect.

Стоит ли ставить

Если у тебя Paper-сервер, а игроки не хотят возиться с модами - это пока лучшее решение на рынке. Полноценных аналогов, которые работают полностью на стороне сервера, почти нет. Плагин альфа, но функционал уже солидный: и рендер, и кастомные порталы, и экономика, и мультимир, и отслеживание сущностей.

Слабый VPS - лучше не ставь, будет просадка. Нормальный сервер с 4+ гигабайтами и современным CPU - можно. Для лобби, хабов и квестовых карт - вообще идеально.

Скачать плагин Immersive Portals Paperized стоит хотя бы ради того, чтобы один раз показать игрокам портал, через который видно Нижний мир. Реакция обычно - "как это работает без модов?". Работает. Пакетами, на стороне сервера.