WarpPortals

WarpPortals превращает стандартное перемещение по точкам в детализированный процесс: от анимированных порталов с визуальными эффектами до системы оплаты и прав доступа.

WarpPortals разработан для серверов, которые хотят сделать перемещение по точкам осознанным, настраиваемым и отполированным процессом, а не просто очередной мгновенной командой телепортации.

Вы можете сохранить классическое поведение /warp, превратить точки в анимированные порталы или комбинировать оба стиля в зависимости от команды, конкретного варпа, ранга игрока или области сервера.

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

🪄 Команды

Большинство владельцев серверов используют три основных рабочих процесса:

Если прямой телепорт отключен в конфигурации, команда /warp <name> автоматически откроет портал.

Перемещение игроков

Игроки используют /warp <name> для обычного перемещения и /portal <name> тогда, когда они должны открыть анимированный портал.

Управление варпами

Администраторы создают варпы, стоя в точке назначения, и выполняя команду /warpportals setwarp <name>. Плагин сохраняет мир, координаты, yaw и pitch. Точки можно удалить позже с помощью /warpportals delwarp <name>.

Доступ и цены

Администраторы могут устанавливать отдельные цены для прямого телепорта и создания портала. Также можно привязать кастомное право доступа к варпу, что упрощает создание точек только для определенных рангов без создания множества алиасов команд.

После редактирования конфигурации, хранилища, сообщений или кастомных команд используйте /warpportals reload для обновления плагина без перезагрузки сервера.

🔑 Права доступа

Настройки прав доступа по умолчанию намеренно просты:

Кастомные права варпов не зашиты в код. Вы можете использовать любую строку права и назначить её через ваш плагин прав доступа.

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

WarpPortals использует три основные области конфигурации:

Основные настройки телепортации

teleport:
  delay-seconds: 3
  cancel-on-move: true
  title: true
  actionbar: false

Установите delay-seconds на 0, чтобы отключить таймер. Любое значение выше 0 включает время подготовки перед телепортацией.

Прямой телепорт или портал

commands:
  direct-warp-teleport: true

Когда значение true, команда /warp <name> телепортирует игрока напрямую. Когда false, команда открывает портал.

Оптимизация

optimizations:
  cache-warps: true
  shared-particle-scheduler: true
  portal-spatial-index: true
  cache-portal-calculations: true
  cache-settings: true
  cache-vault-provider: true

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

Настройки портала

portal:
  protection-mode: block
  material: TINTED_GLASS
  width: 1.25
  height: 2.5
  distance-from-player: 1.5
  min-distance: 10
  animation-enabled: true
  use-display-transitions: true
  animation-ticks: 10
  hold-ticks: 60

portal.min-distance предотвращает открытие портала, если игрок находится слишком близко к точке назначения. Установите 0, чтобы отключить проверку.

portal.use-display-transitions позволяет клиентам Minecraft анимировать каждую сущность отображения (display) от начального к конечному состоянию. Отключайте только если вам нужна старая анимация на стороне сервера, обновляемая каждый тик.

Пример сохраненного варпа

warps:
  vip:
    world: world
    x: 120.5
    y: 70.0
    z: -40.5
    yaw: 180.0
    pitch: 0.0
    permission: warpportals.warp.vip
    costs:
      teleport:
        enabled: true
        type: xp
        amount: 100
        item: DIAMOND
      portal:
        enabled: true
        type: item
        amount: 5
        item: DIAMOND

Поле permission необязательно. Оставьте его пустым, если любой игрок с доступом к варпам может использовать эту точку.

Типы стоимости

Стоимость телепорта и создания портала разделена, поэтому открытие портала может стоить иначе, чем прямой телепорт.

Кастомные команды

custom-commands:
  spawn:
    aliases:
      - hub
    warp: spawn
    mode: direct
    delay-seconds: 0
    cooldown-seconds: 0
    message: ""
    cost:
      enabled: false
      type: xp
      amount: 0
      item: DIAMOND

Используйте mode: direct для мгновенного или тайм-зависимого телепорта. Используйте mode: portal, когда команда должна открывать портал.

Языки

Английский и польский языки включены по умолчанию. Вы можете добавить свой файл в папку messages (например, de_de.yml) и указать его в config.yml.

❓ Вопросы и ответы

Ожидаемые ошибки

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