SimpleTPA

SimpleTPA: простой плагин для управления телепортациями

SimpleTPA — это легковесный плагин для серверов Minecraft, разработанный Blizzard. Его основная задача — предоставить администраторам и игрокам удобный инструмент для организации системы телепортаций. Плагин поддерживает как стандартные запросы на телепорт к другому игроку, так и обратную модель, где игрок просит другого телепортироваться к нему. Система включает в себя гибкую настройку звуков, сообщений (с поддержкой MiniMessage и legacy-кодов), таймеров охлаждения (cooldown) и опциональный режим «разминки» перед телепортацией, чтобы избежать случайных перемещений. Плагин полностью совместим с современными загрузчиками серверов, включая Folia, Paper, Purpur, Spigot и Bukkit, а также работает с версиями игры от 1.21 до 26.2.

🛠️ Назначение и базовая механика

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

Плагин реализует две основные модели взаимодействия: стандартный запрос /tpa, когда отправитель просит телепортироваться к цели, и обратный запрос /tpahere, когда игрок просит, чтобы его телепортировали к нему. Это решает проблему асимметрии в перемещениях, позволяя игрокам быстро собираться в группах или перемещаться между локациями без необходимости договариваться голосом или писать в чат.

Одной из ключевых особенностей является поддержка множественных одновременных запросов. Если игрок отправляет запросы нескольким людям или получает их от нескольких собеседников, плагин позволяет выбирать конкретную цель командой, указывая имя игрока. Это предотвращает путаницу и «сломанную» игру при наличии нескольких активных запросов в очереди. Также реализована функция teleport-warmup (разминка), которая заставляет игрока стоять на месте в течение заданного времени после подтверждения запроса. Это критически важно для предотвращения ситуаций, когда игрок начинает бежать сразу после подтверждения, что может привести к некорректному телепорту или «телепортации сквозь стены» из-за изменения позиции в моменте перемещения.

⚙️ Глубокая настройка конфигурации

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

В секции settings можно настроить время ожидания (tpa_request_timeout) и охлаждения (tpa_cooldown). По умолчанию запрос действует 60 секунд, а повторная отправка возможна только через 30 секунд, что предотвращает спам запросами. Также доступна автоматическая проверка обновлений на Modrinth каждые 12 часов. Важным параметром является allow_multiple_requests: если включен, игроки могут иметь несколько активных запросов одновременно, что критично для крупных серверов с активным общением.

Секция sounds позволяет заменить стандартные звуки на любые другие из игры. Например, звук отправки запроса можно заменить на звук сбора опыта (entity.experience_orb.pickup), а подтверждения — на телепорт эндамена (entity.enderman.teleport). Это делает интерфейс более узнаваемым и приятным для слуха, помогая игрокам мгновенно реагировать на события без чтения чата.

Секция messages содержит шаблоны всех текстовых уведомлений. В них используются плейсхолдеры, такие как %player%, %target%, %seconds%, которые динамически подставляются при отправке сообщения. Поддерживаются как старые коды цвета (§), так и новые теги MiniMessage. Плагин автоматически конвертирует legacy-коды в MiniMessage, если это требуется, но предпочтительнее использовать MiniMessage для совместимости с современными загрузчиками.

📜 Полный список команд и управление

Плагин предоставляет расширенный набор команд для игроков и администраторов. Базовые команды доступны всем игрокам с соответствующими правами доступа:

*   `/tpa [Игрок]` — отправляет запрос на телепортацию к указанному игроку. Если игрок указан, запрос отправляется только ему. Если игрок не указан, запрос отправляется всем игрокам, которые принимают TPA.
*   `/tpahere [Игрок]` — отправляет запрос, просящий указанного игрока телепортироваться к вам.
*   `/tpaccept [Игрок]` — принимает ожидающий запрос. Если запросов несколько, нужно указать имя игрока, от которого пришел запрос.
*   `/tpdeny [Игрок]` — отклоняет ожидающий запрос.
*   `/tpacancel [Игрок]` — отменяет отправленный вами запрос.
*   `/tpatoggle` — включает или выключает прием входящих запросов.
*   `/tpa version` — показывает версию плагина и ссылку на обновление.
*   `/tpa help` — выводит список всех доступных команд.

Для администраторов (OP) доступны дополнительные команды:
*   `/tphere [Игрок]` — принудительно телепортирует игрока к вам. Требует права `tpa.command.tphere`.
*   `/tpo [Игрок]` — телепортирует вас к последней известной позиции (логин-локация) указанного игрока. Полезно для поиска оффлайн-игроков. Требует права `tpa.command.tpo`.
*   `/tpreload` — перезагружает конфигурацию без перезапуска сервера. Требует права `tpa.reload`.
*   `/tpdebug` — включает логирование событий в консоль для отладки. Требует права `tpa.debug`.

🔊 Настройка звуковых эффектов

SimpleTPA позволяет настраивать звуковые уведомления для каждого действия, связанного с телепортацией. Это помогает игрокам мгновенно понимать статус запроса без необходимости читать чат. Звуки выбираются из списка стандартных звуков Minecraft.

Доступные настройки:

• tpa_request_sent — звук при отправке запроса (по умолчанию: entity.experience_orb.pickup).
• tpa_request_received — звук при получении запроса (по умолчанию: entity.player.levelup).
• tpa_accept — звук при принятии запроса (по умолчанию: entity.enderman.teleport).
• tpa_deny — звук при отклонении запроса (по умолчанию: entity.villager.no).
• tpa_expired — звук при истечении срока действия запроса (по умолчанию: entity.item.break).
• tpa_toggle_enabled — звук при включении приема запросов (по умолчанию: block.note_block.bass).
• tpa_toggle_disabled — звук при выключении приема запросов (по умолчанию: block.note_block.pling).
• tpa_teleport_cancelled — звук при отмене телепорта из-за движения (по умолчанию: entity.villager.no).

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

Пример конфигурации звуков:
`yaml
sounds:
tpa_request_sent: "entity.experience_orb.pickup"
tpa_request_received: "entity.player.levelup"
tpa_accept: "entity.enderman.teleport"
tpa_deny: "entity.villager.no"
tpa_expired: "entity.item.break"
`

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

🎨 Кастомизация текстовых сообщений

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

Примеры использования:

• %player% — имя игрока, который отправил или получил запрос.
• %target% — имя цели телепортации.
• %seconds% — количество секунд, оставшихся до истечения или ожидания.
• %url% — ссылка на страницу загрузки плагина (для уведомлений об обновлениях).

Также поддерживаются плейсхолдеры от сторонних плагинов, таких как LuckPerms. Например, в настройке player_display_format можно указать %luckperms_prefix% | %player%, чтобы в сообщениях отображалось префикс игрока вместе с его ником. Это делает сообщения более информативными и стилизованными под дизайн вашего сервера.

Плагин автоматически переводит старые коды цвета (§) в формат MiniMessage, если это необходимо, но рекомендуется использовать MiniMessage для лучшей совместимости с современными версиями Minecraft и загрузчиками.

Пример настройки формата сообщений:
`yaml
messages:
tpa_request_received: " %player% sent you a TPA-Request! /tpaccept or /tpdeny "
player_display_format: "%luckperms_prefix% | %player%"
`

Использование плейсхолдеров позволяет создавать уникальные уведомления, которые сразу идентифицируют статус игрока (например, "VIP", "Admin"), добавляя слой визуальной иерархии в систему телепортации.

🔗 Интеграции и дополнительные функции

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

**PlaceholderAPI:**
Плагин поддерживает форматируемые плейсхолдеры. Если установлен PlaceholderAPI, можно использовать специальные метки в сообщениях, которые будут заменяться данными из других плагинов. Например, `%luckperms_prefix%` или `%rank%`. В конфигурации есть параметр `use_placeholderapi_formatting`, который включает эту функцию. Если плагин не установлен, эти плейсхолдеры будут отображаться как текст.

**Click-Message:**
Плагин поддерживает создание кликабельных сообщений в чате. При отправке или получении запроса игрок может увидеть сообщение с кнопками «✔ Accept» и «✖ Deny». При клике на кнопку выполняется соответствующая команда (`/tpaccept` или `/tpdeny`). Это упрощает управление, особенно на мобильных устройствах или при быстром общении. Настройка находится в секции `clickable_messages` и включает текст кнопки, цвет, ховер-текст и команду.

**Update Notifications:**
Плагин проверяет наличие новых версий на Modrinth каждые 12 часов и отправляет уведомление в консоль и игрокам, если доступна новая версия. Это помогает администраторам следить за обновлениями безопасности и новыми функциями.

**Пример настройки кликабельных сообщений:**
```yaml
clickable_messages:
  accept_text: "[✔ Accept]"
  accept_hover: "Click to accept the TPA!"
  accept_command: "/tpaccept"
  accept_color: "GREEN"
  deny_text: "[✖ Deny]"
  deny_hover: "Click to deny the TPA!"
  deny_command: "/tpdeny"
  deny_color: "RED"
```

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

📊 Совместимость и технические требования

SimpleTPA совместим с широким спектром платформ и версий Minecraft, что делает его универсальным решением для большинства серверов.

Поддерживаемые загрузчики:
Плагин работает на серверах, использующих загрузчики: Bukkit, Folia, Paper, Purpur и Spigot. Это охватывает как классические сервера на Spigot/Paper, так и высокопроизводительные сервера на базе Folia (для многопоточной обработки). Важно отметить, что для загрузчиков Folia и Paper существует отдельная сборка файла, которую нужно использовать.

Поддерживаемые версии игры:
Плагин поддерживает версии Minecraft от 1.21 до 26.2. Это включает все основные обновления, такие как 1.21.1, 1.21.5, 1.21.10, 1.21.11 и другие. Для каждой версии игры и загрузчика есть своя совместимая сборка.

Файл для установки:
Файл плагина имеет расширение .jar и весит около 397 КБ. В архиве содержится 348 файлов, включая классы Java и ресурсы. Файл не содержит встроенных зависимостей (bundled jars), поэтому его можно безопасно установить на любой сервер, поддерживающий указанный загрузчик.

Процесс установки:

1. Скачайте файл SimpleTPA-Paper-1.6.jar (или соответствующий сборку для вашего загрузчика) с официального источника.
2. Поместите файл в папку plugins на сервере Minecraft.
3. Перезапустите сервер или используйте команду /reload, если плагин поддерживает горячую перезагрузку (обычно требуется перезапуск для первичной загрузки).
4. Проверьте консоль на наличие ошибок загрузки.
5. Откройте файл plugins/SimpleTPA/config.yml и настройте параметры под нужды вашего сервера.
6. Настройте права доступа в вашем файле прав (например, permissions.yml или через плагин управления правами).

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

⚠️ Ограничения и особенности использования

Несмотря на гибкость, плагин имеет определенные ограничения, которые следует учитывать при планировании использования.

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

Зависимость от Modrinth для обновлений:
Функция проверки обновлений настроена на работу с платформой Modrinth. Если вы планируете распространять плагин через другие источники (например, GitHub или собственные хостинги), вам нужно будет изменить параметр modrinth_project_slug в конфигурации или отключить проверку обновлений, чтобы избежать ошибок или ложных уведомлений.

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

Ограничения по правам:
Администраторы должны внимательно настроить права доступа, чтобы избежать ситуаций, когда обычные игроки получают доступ к командам администраторов (например, /tphere или /tpo). По умолчанию права разделены, но в файле конфигурации прав можно изменить их по умолчанию.

Пример конфигурации для русскоязычного сервера:
`yaml
messages:
tpa_request_received: " %player% отправил вам запрос на телепорт! Используйте /tpaccept или /tpdeny "
tpa_accept_success: " Вы приняли запрос от %player% "
tpa_deny_success: " Вы отклонили запрос от %player% "
`

Такая кастомизация позволяет адаптировать плагин под любые языковые и культурные особенности вашего сообщества.

🔧 Примеры конфигурации для разных сценариев

Для наглядности приведены примеры настройки ключевых параметров в файле config.yml, которые помогут быстро настроить плагин под конкретные задачи.

Пример настройки времени ожидания и охлаждения:
`yaml
settings:
tpa_cooldown: 60 # Игрок может отправить новый запрос только через 60 секунд
tpa_request_timeout: 120 # Запрос действует 120 секунд
teleport_warmup_enabled: true # Включить режим разминки
teleport_warmup_seconds: 10 # Игрок должен стоять 10 секунд перед телепортом
`

Пример настройки звуков:
`yaml
sounds:
tpa_request_sent: "entity.experience_orb.pickup"
tpa_request_received: "entity.player.levelup"
tpa_accept: "entity.enderman.teleport"
tpa_deny: "entity.villager.no"
`

Пример настройки кликабельных сообщений:
`yaml
clickable_messages:
accept_text: "[✔ Принять]"
accept_hover: "Кликните, чтобы принять запрос!"
accept_command: "/tpaccept"
accept_color: "GREEN"
`

Пример настройки сообщений с плейсхолдерами:
`yaml
messages:
tpa_request_received: " %player% отправил вам запрос! Используйте /tpaccept или /tpdeny "
`

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

Связанные материалы

• EternalCore — похожий плагин
• GriefPrevention — похожий плагин

Автор: Blizzard · Лицензия: Apache-2.0