YuTeleport - безопасная телепортация для сервера Майнкрафт

Сервер без нормальной телепортации превращается в мучение. Игроки теряются в ресурсном мире, падают в лаву при RTP, не могут вернуться на базу после смерти. Обычно проблему костылят тремя-четырьмя плагинами, которые постоянно дерутся за одни и те же команды. YuTeleport (коротко YuTP) решает всё это одним комплектом: случайный телепорт, публичные варпы, дома, запросы TPA, возврат и обмен координатами - и всё это проходит через единый движок с правами, кулдаунами, оплатой и проверкой безопасности. По сути это серверный плагин, а не мод или датапак, никакой загрузчик не нужен.

Если вы собираете выживание, RPG-сервер или анархию с ресурсным миром - это тот случай, когда один плагин закрывает сразу несколько болезненных мест. Админы, которым нужно быстро поднять игровой мир на BungeeHost, оценят, что YuTeleport ставится туда в один клик и не требует дополнительных API, кроме опциональных Vault, PlayerPoints и PlaceholderAPI.

Что это и зачем

YuTeleport - это не просто утилита для рандомного телепорта. Это полноценная система перемещений: от запроса до прибытия. Внутри единый конвейер проверяет права, доступ к миру, кулдаун, необходимость ожидания, безопасность точки, списывает и возвращает деньги, отправляет события для сторонних плагинов. Раньше эта логика расползалась по модулям и другим плагинам, и отлаживать её приходилось по кускам. Здесь всё централизовано.

Текущая версия 2.0.1.2, формат конфига - config-version 20. Заявлена работа на Minecraft 1.8.x - 1.26.x в экосистеме Bukkit, Spigot, Paper, Purpur, Folia, а также на гибридных ядрах вроде Mohist, Magma, Arclight и Youer. На Folia плагин задействует Region/Entity/Global-планировщики и не лезет в сущности чужого региона.

Случайный телепорт (RTP) с безопасной высадкой

Главная боль любого RTP-плагина - игрок приземляется в лаву, в блок, за границу мира или на край бездны. YuTeleport проверяет точку до высадки:

• под ногами твёрдый блок;
• есть место для тела и головы;
• соблюдены лимиты мира по высоте и границам;
• нет ли опасных блоков: воды, лавы, огня, кактусов, паутины, сладких ягод, магмы;
• фильтр биомов - можно исключить океаны, включить только леса и прочее через * и шаблоны вроде *OCEAN*;
• для Незера и сложных измерений - перебор вертикальных позиций.

Каждый мир настраивается отдельно: радиус, центральная точка (не обязательно (0,0)), форма кольца - круг или квадрат, список разрешённых и запрещённых блоков и биомов. Это удобно для ресурсных миров, спавна новичков и ивент-карт.

Пример: /yuteleport biome:*FOREST* телепортирует в лес, а /yuteleport <player> <world> biome:*PLAINS* - конкретного игрока в нужный мир с фильтром.

Асинхронный поиск и кэш точек

Классическая проблема RTP - подгрузка чанков в главном потоке и просадки TPS в час пик. YuTeleport на Paper 1.13+ умеет искать точки асинхронно (search-mode: async), а при отсутствии поддержки автоматически откатывается на синхронный режим с логом. Ещё есть предварительный кэш: плагин заранее готовит от 1 до 16 безопасных точек на мир, и при попадании в кэш игрок ждёт меньше. По опыту, на большом онлайне с частым RTP это заметно сглаживает лаги, но кэш стоит ставить не больше 5-8 точек на мир, иначе фоновая генерация сама начнёт съедать ресурсы.

Варпы, дома и TPA

Варпы бувают трёх типов: public - для всех, private - только для создателя и админов, restricted - доступ по праву yuteleport.warps.<name>. Есть описание, переименование, лимиты по правам и группам. Дома у каждого игрока свои, с публичным доступом и описанием, можно запретить установку в отдельных мирах (ивент-миры, шахты). TPA поддерживает /tpa, /tpahere, принятие, отклонение, отмену, игнор запросов и массовую рассылку tpahere all. Запросы истекают по таймеру, новый запрос заменяет старый, чтобы у цели не копилась очередь.

Отдельно приятно, что при отключённом модуле его команды не регистрируются - значит, не будет конфликтов с EssentialsX или CMI по /warp, /home, /tpa, /back. Это важный нюанс: на серверах, где уже стоит EssentialsX, не приходится вручную вырезать команды, достаточно отключить ненужный модуль в конфиге.

Возврат /back

/back возвращает на последнюю доступную точку, /back death - на место смерти, /back list - история с кликабельными записями, /back clear - очистка. Плагин запоминает точки перед собственными телепортами, смерти и внешние телепорты от других plugins. Перемещения меньше заданного порога (по умолчанию 3 блока) не пишутся, чтобы не засорять историю. История хранится в data/back, максимум по умолчанию - 5 записей, срок жизни - 1800 секунд. Отдельно настраиваются кулдаун, стоимость, безопасная спасательная проверка и приоритет источников (сначала смерть, потом свой телепорт, потом внешний).

Обмен координатами

После успешного телепорта в сообщении появляется кнопка "Поделиться текущей локацией". Клик рассылает координаты всем онлайн-игрокам, и они могут перейти по ним кликом. У шар есть свой кулдаун, срок жизни, ограничение на число активных в памяти и отдельная оплата. Удобно для сбора команды, ивентов и находок ресурсов.

Экономика и права

Поддерживаются Vault и PlayerPoints. Цена задаётся по типу телепорта, миру и группе прав. При неудаче, отмене или устаревании на Folia деньги возвращаются автоматически, есть защита от двойного списания и повторная проверка баланса после ожидания. PlayerPoints работает с целыми числами - стоимость округляется вверх, возврат идёт по той же логике.

Группы прав настраиваются через yuteleport.group.<group>: можно дать VIP уменьшенные кулдауны и больше домов, а MVP - бесплатные телепорты без ожидания. Если несколько групп совпадают, применяется первая по порядку в конфиге.

Ожидание, прерывания и обратная связь

Все модули используют общий счётчик ожидания. Каналы отображения - чат, BossBar, ActionBar или тихое ожидание, можно комбинировать. Прерывания по движению, урону, взаимодействию, чату и командам настраиваются отдельно. Права yuteleport.bypass.wait, yuteleport.bypass.cooldown и yuteleport.bypass.cost позволяют обходить ожидание, кулдаун и оплату соответственно.

PlaceholderAPI, API и события

После установки PlaceholderAPI доступны плейсхолдеры %yuteleport_*%: версия, платформа, режим поиска, состояния модулей, кулдауны и цены по типам, количество домов и максимум, видимые варпы, число ожидающих TPA, процент успеха. Пригодится для скорбордов, TAB, меню, квестов, достижений и статистики.

Разработчики получают API через ServicesManager Bukkit. API умеет запускать телепорты, читать состояния модулей, кулдауны, цены, списки варпов и домов, статистику. События: PlayerTeleportStartEvent, PlayerTeleportDestinationEvent, PlayerTeleportCancelEvent, PlayerTeleportCompleteEvent. Команды и API используют одни и те же точки входа, поэтому сторонние плагины не обойдут права, доступ к мирам, кулдауны, экономику и проверки безопасности.

Совместимость и нюансы

Плагин кросс-версионный: BossBar работает с 1.9+, гекс-цвета &#RRGGBB нативно с 1.16+, на старых версиях даунгрейдятся до легаси-цветов. На 1.18+ автоматически читаются минимальная и максимальная высоты мира, включая миры с отрицательной высотой. На Paper используется асинхронная загрузка чанков, на Folia - региональные планировщики.

Если Vault, PlayerPoints или PlaceholderAPI не установлены, плагин продолжает работать, просто отключает соответствующие функции с понятным сообщением в логе.

Важный нюанс для админов: перед установкой на живой сервер сделайте бэкап папок data/ и конфигов домов и варпов - при первом запуске новой версии конфиг мигрирует под config-version 20, и откатиться без копии будет неприятно. И ещё: на гибридных ядрах вроде Mohist безопасная высадка может иногда пропускать нестандартные блоки модов, поэтому перед запуском ресурсного мира прогоните тестовый RTP с флагом debug, если он есть в вашей сборке.

Итог

YuTeleport - это must-have для серверов, где телепортация должна быть предсказуемой и безопасной. Он закрывает RTP, варпы, дома, TPA, /back и обмен координатами в одном плагине, не требуя ставить пять разных. Для админа - меньше конфликтов и единая настройка прав и экономики; для игрока - понятные кнопки, звуки и безопасные точки. Скачать YuTeleport стоит и тем, кто только поднимает выживание, и тем, кто хочет заменить зоопарк утилит одним аккуратным решением.