Yet Another TPA

YATPA

YATPA — это проект плагина/мода для телепортации на современных серверах Minecraft.

YATPA выделяется тем, что объединяет полный набор инструментов для телепорт-запросов, домов, возврата, спавна, RTP, void, surface и смерти с кликабельным интерфейсом команд в чате (меню /tp, постраничные списки выбора и постраничные логи), а также предоставляет детальный контроль стоимости для каждого типа телепортации. Режим экономики настраивается как NONE, XP_LEVELS, ITEM или CURRENCY; Paper поддерживает CURRENCY через Vault (с EssentialsX или другим провайдером экономики Vault). У операторов есть опциональное GUI-меню для тонкой настройки параметров прямо в игре.

Скриншоты

Справка (через /TPAHELP)

Кликабельное меню телепортации (через /TP)

Кликабельные логи телепортации для операторов (через /TPLOG)

Кликабельный список домов (через /TPHOME LIST)

Кликабельный список игроков (через /TPA без указания имени)

Возможности

• Кликабельное меню телепортации:

  • /tp
  • Включает ярлыки для домов, RTP, спавна, возврата после смерти, TPA/TPHere, переключения, блокировки и разблокировки.
  • Списки игроков разбиты на страницы (по 5 на страницу) для /tpa, /tphere, /tpablock и /tpaunblock.

• Запросы на телепортацию к игрокам:

  • `/tpa `
  • `/tpahere или/tphere `
  • /tpaccept
  • /tpdeny
  • /tpatoggle
  • `/tpablock `
  • `/tpaunblock `

• Дома:

  • /tphome set [name]
  • `/tphome set default `
  • `/tphome delete `
  • /tphome list
  • /tphome [name] или /tpahome [name]
  • Список домов кликабельный и показывает координаты.
  • Дом по умолчанию помечен (default).

• Утилитарные телепортации:

  • /rtp
  • /spawn
  • /tpaback или /tpdeath (место последней смерти, одно использование на смерть)
  • /tpsurface (находит безопасное место на поверхности поблизости; отключено по умолчанию)
  • /tpvoid (переключает между безопасной позицией на крыше Nether и безопасной позицией под ней; отключено по умолчанию)

• Стоимость домов:

  • settings.costs.*.home взимает плату за телепортацию домой.
  • settings.costs.*.home_set взимает плату за установку или замену дома.

• Команды операторов:

  • `/ytp `
  • `/ytp `
  • `/ytp [realm]`
  • `/ytp [realm]`
  • `/tpoffline `
  • /tpalog [page]

• Внутриигровая админ-конфигурация (OP):

  • /yatpa settings
  • /yatpa gui (нативный редактор диалогов Paper/Fabric; Paper использует редактор инвентаря, когда сервер не предоставляет команду диалогов)
  • `/yatpa set `
  • /yatpa reload
  • /setspawn
  • Раздел Costs имеет отдельные подменю для XP, предметов и валюты. /tpsurface и /tpvoid можно включить в разделе Features.

• Страница помощи для игроков:

  • /tpahelp
  • /tphelp
  • /yatpa help
  • Публичная справка намеренно исключает админ-команды.
  • Когда стоимость телепортации включена, внизу отображается раздел Costs, в котором перечислены только телепортации с ненулевой стоимостью.

Меню диалога для операторов

Запустите /yatpa gui для современного внутриигрового редактора настроек. Он организует параметры YATPA по понятным категориям с встроенными переключателями, селекторами и текстовыми полями, с валидацией и кнопками сохранения. Paper переключается на редактор инвентаря, когда нативные диалоги недоступны; Fabric не требует клиентского мода YATPA.

Особенности поведения

• Запросы:

  • Таймаут и кулдаун соблюдаются.
  • Сообщения о принятии/отклонении кликабельны.
  • Если принятая отложенная телепортация отменяется (движение/урон), другой игрок уведомляется.

• Телепортации:

  • Отложенные телепортации показывают обратный отсчёт.
  • Стоимость проверяется до отсчёта и списывается при выполнении.
  • Игрокам сообщается, сколько именно они заплатили (XP, предметы или валюта).
  • ytp/rtp используют проверки безопасного приземления, чтобы избежать опасных блоков и лавы.
  • /tpaback и /tpdeath расходуют сохранённое место смерти после успешного использования и требуют новой смерти для обновления.

• Логирование телепортаций:

  • /tpalog разбит на страницы и кликабельный.
  • Строки логов включают контекстные детали (например, имя дома, целевого игрока, координаты или офлайн-цель), где это уместно.

• Стоимость и настройки:

  • Режимы стоимости: NONE, XP_LEVELS, ITEM, CURRENCY.
  • Поддерживаются стоимости RTP для конкретных измерений и переопределения минимальной/максимальной дистанции RTP.
  • Paper /yatpa gui и /yatpa set предоставляют прямой доступ к путям валюты.

• Ограничения и маршрутизация:

  • Ограничения по измерениям могут отключать только /rtp или все телепортации YATPA.
  • /rtp поддерживает чёрный список и опциональную маршрутизацию в обычный мир.
  • Место спавна настраивается через settings.spawn.* и /setspawn.

• Примечание о платформах:

  • Списание валюты через Vault/EssentialsX в этом релизе только для Paper.
  • Jar для Paper использует API Bukkit и помечен как совместимый с Folia, поэтому работает на Paper, Purpur, Spigot, Bukkit и Folia. Нативные диалоги используются, когда доступны; редактор инвентаря остаётся запасным вариантом на серверах семейства Bukkit без них.
  • Поведение команд/интерфейса в этом README применимо как к Paper, так и к Fabric, если не указано иное.

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

Файлы конфигурации Paper:

• paper/src/main/resources/config.yml
• paper/src/main/resources/messages.xml
• paper/src/main/resources/plugin.yml

Стандартные файлы конфигурации/ресурсов Fabric:

• fabric/src/main/resources/yatpa-fabric.properties
• fabric/src/main/resources/yatpa-fabric.yml
• fabric/src/main/resources/messages-fabric.xml

Данные времени выполнения (Paper) хранятся в папке данных плагина:

• data/players.yml
• data/homes.yml
• data/offline.yml

Данные времени выполнения (Fabric) хранятся в:

• config/yatpa/store.json

Пример Config YAML

settings:
  max_homes_default: 3
  request_timeout_seconds: 60
  request_cooldown_seconds: 30
  teleport_delay_seconds: 5
  cancel_on_move: true
  cancel_on_damage: true
  spawn_radius: 50
  rtp_cooldown_seconds: 300
  rtp:
    default_min_distance: 64
    default_max_distance: 2500
    rtp_to_overworld: false
    overworld_name: "world"
    blacklisted_worlds: []
    # Optional per-realm overrides
    realm_min_distance:
      overworld: 96
      nether: 48
      end: 128
    realm_max_distance:
      overworld: 3000
      nether: 1500
      end: 4000
  dimension_restrictions:
    # Use world names, realm aliases (overworld/nether/end), or namespaced ids.
    # For namespaced ids in YAML, quote the key, for example "minecraft:the_nether".
    disable_rtp:
      nether: true
    disable_teleport:
      # "minecraft:the_end": true
  landing:
    mode: EXACT # EXACT or RANDOM_OFFSET
    random_offset_max: 4
  features:
    enabled: true
    tpa: true
    tpahere: true
    homes: true
    rtp: true
    tpsurface: false
    tpvoid: false
  costs:
    enabled: false
    mode: NONE # NONE, XP_LEVELS, ITEM, CURRENCY
    xp_levels:
      tpa: 4
      tpahere: 4
      home: 16
      home_set: 0
      back: 0
      # Per-realm RTP overrides (optional; overrides global if set)
      rtp:
        overworld: 30
        nether: 0
        end: 0
      spawn: 8
    item:
      material: DIAMOND
      tpa: 2
      tpahere: 2
      home: 20
      home_set: 0
      back: 0
      # Per-realm RTP overrides (optional; overrides global if set)
      rtp:
        overworld: 30
        nether: 0
        end: 0
      spawn: 10
    currency:
      tpa: 0.0
      tpahere: 0.0
      home: 0.0
      home_set: 0.0
      back: 0.0
      # Per-realm RTP overrides (optional; overrides global if set)
      rtp:
        overworld: 0.0
        nether: 0.0
        end: 0.0
      spawn: 0.0
  spawn:
    enabled: true
    x: 0
    y: 100
    z: 0
    yaw: 0
    pitch: 0
    world: world
sounds:
  request_sent: ENTITY_EXPERIENCE_ORB_PICKUP
  request_received: BLOCK_NOTE_BLOCK_PLING
  countdown: BLOCK_BELL_USE
  success: ENTITY_ENDERMAN_TELEPORT
  cancelled: BLOCK_GLASS_BREAK
effects:
  request_sent: PORTAL
  request_received: ENCHANT
  countdown: WAX_OFF
  success: END_ROD
  cancelled: SMOKE

Fabric config.properties поддерживает те же ограничения одним из способов:

• settings.dimension_restrictions.disable_rtp=overworld,minecraft:the_nether
• settings.dimension_restrictions.disable_teleport=minecraft:the_end,my_custom_dimension
• Динамические ключи вида settings.dimension_restrictions.disable_teleport.minecraft:the_nether=true

Права (Paper)

• yatpa.op.reload (по умолчанию: op)
• yatpa.op.tp (по умолчанию: op)
• yatpa.op.tpoffline (по умолчанию: op)
• yatpa.op.tpalog (по умолчанию: op)
• yatpa.op.setspawn (по умолчанию: op)

Лицензия

Лицензировано под GNU General Public License v3.0 (GPL-3.0-only).