YuTeleport (Ю телепорт)

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

Возможности

• Случайная телепортация по миру с отдельными радиусом, центром, диапазоном высоты, формой области и правилами для каждого мира.
• Проверка безопасной точки: исключаются лава, вода, огонь, кактусы, паутина, пустота, граница мира и другие заданные опасные блоки. Можно ограничивать биомы и блоки белым или чёрным списком, включая шаблоны с *.
• Варпы: личные, публичные и ограниченные правом yuteleport.warps.<name>. Для них доступны описания, переименование и лимиты.
• Дома игроков с описанием, публикацией для других игроков и доступом к домам конкретного игрока для администрации.
• TPA-запросы на телепортацию к игроку или призыв игрока к себе; запрос можно принять, отклонить, отменить или временно игнорировать.
• Команда возврата сохраняет точки смерти, позиции до телепортации плагином и внешними плагинами.
• После телепортации игрок может отправить свои координаты всем онлайн-игрокам; получатели переходят к точке кликом в чате.
• Задержку телепортации можно показывать в чате, BossBar или ActionBar. Её разрешается отменять движением, уроном, взаимодействием, сообщением в чате и командами.
• Стоимость перемещений поддерживает Vault и PlayerPoints; при отмене или неудаче средства возвращаются.
• Для групп прав можно отдельно задавать стоимость, кулдауны и лимиты домов и варпов через yuteleport.group.<group>.
• Для случайной телепортации поддерживаются асинхронный поиск чанков и предварительный поиск безопасных точек, что снижает нагрузку на сервер.
• PlaceholderAPI добавляет плейсхолдеры %yuteleport_*% для состояния модулей, кулдаунов, цен, числа домов и статистики.

Команды

• Случайная телепортация: /yuteleport, /ytp, /rtp; поиск в биоме — /yuteleport biome:<pattern>.
• Телепортация другого игрока: /yuteleport <player> [world] [biome:<pattern>].
• Управление плагином: /yuteleport reload, /yuteleport help.
• Варпы: /warp [name], /setwarp <name> [restricted|public|private] [description], /delwarp <name>, /warp rename <old> <new>, /warp desc <name> <description>.
• Дома: /home [name], /homes [player], /sethome [name] [public|private] [description], /delhome <name>, /home <player>:<name>.
• TPA: /tpa <player>, /tpahere <player>, /tpaccept [player], /tpdeny [player], /tpacancel, /tpaignore, /tpaall.
• Возврат: /back, /back death, /back list, /back clear.
• Координаты: /yuteleport share, /yuteleport join <share_id>.

Названия команд и их псевдонимы меняются в конфиге. Отключённые модули не регистрируют свои команды, поэтому не конфликтуют с EssentialsX, CMI и похожими плагинами.

Права

• Основные: yuteleport.use, yuteleport.biome, yuteleport.teleport.others, yuteleport.reload.
• Варпы: yuteleport.warp.use, yuteleport.warp.set, yuteleport.warp.delete, yuteleport.warp.public, yuteleport.warp.admin, yuteleport.warps.<name>.
• Дома: yuteleport.home.use, yuteleport.home.set, yuteleport.home.delete, yuteleport.home.public, yuteleport.home.others.
• Лимиты: yuteleport.warp.limit.<number>, yuteleport.home.limit.<number>, а также yuteleport.warp.limit.unlimited и yuteleport.home.limit.unlimited.
• TPA: yuteleport.tpa.use, yuteleport.tpa.here, yuteleport.tpa.ignore, yuteleport.tpa.all.
• Возврат и координаты: yuteleport.back.use, yuteleport.back.death, yuteleport.back.clear, yuteleport.share.
• Обход ограничений: yuteleport.bypass.wait, yuteleport.bypass.cooldown, yuteleport.bypass.cost.

Настройка

В конфигурации для каждого модуля задаются warmup-seconds, cooldown-seconds, cost, доступные миры и условия безопасности. Общие и отдельные правила доступа к мирам находятся в teleports.defaults.world-access, teleports.rtp.world-access, teleports.warp.world-access, teleports.home.world-access, teleports.tpa.world-access, teleports.share.world-access и teleports.back.world-access.

Для случайной телепортации полезны search-mode: async и блок предварительно подготовленных точек precache. У возврата настраиваются количество записей, срок их хранения, приоритет точек и safety-rescue, который ищет безопасное место, если сохранённая позиция оказалась сломана.

Требования

Плагин работает на серверах семейства Bukkit, Spigot и Paper, включая Purpur, Leaves, Folia и совместимые гибридные ядра. Для экономики подключается Vault или PlayerPoints, а PlaceholderAPI нужен для плейсхолдеров. На Paper совместимых ядрах используется асинхронная загрузка чанков для поиска точки, а на Folia учитывается региональное планирование.