BlossomTpa

Мод BlossomTpa для Minecraft — утилита для команд перемещения

BlossomTpa — это мод для серверов Minecraft в серии Blossom, предоставляющий команды перемещения (/tpa, /tpahere) и связанные утилиты. Мод работает на загрузчиках Fabric и Quilt для версий игры 1.21 и новее. Он позволяет администраторам и игрокам управлять запросами на телепортацию, настраивать таймауты, задержки и использовать специальные права для автоматического принятия или принудительного выполнения заявок.

Основной функционал и команды

BlossomTpa — это утилита для серверов Minecraft, расширяющая стандартные возможности телепортации. Мод добавляет в игру набор команд для управления запросами на перемещение между игроками. Основная команда /tpa инициирует запрос, отправляя игроку уведомление с просьбой принять перемещение. Игрок-получатель должен ответить командой /tpaaccept, чтобы выполнить перемещение, или /tpadeny, чтобы отклонить его. Отправитель запроса может отменить заявку в любой момент, используя команду /tpacancel . Также доступна команда /tpahere , которая работает в обратном направлении: она запрашивает перемещение самого отправителя к указанному игроку. Если в команду передан никнейм, действие направляется на конкретного пользователя; без аргумента команда работает с активным запросом.

Система прав доступа и особые разрешения

Все команды модификатора имеют встроенные права доступа по умолчанию, установленные в true. Базовое право blossom.tpa позволяет отправлять и принимать запросы, а специфические права blossom.tpa.command.* контролируют отдельные действия. Сервер может блокировать получение запросов для конкретных игроков, назначив им право blossom.tpa.disallowed. В этом случае отправитель получит предупреждение, а игрок-получатель ничего не увидит. Для автоматизации процессов предусмотрены специальные флаги: blossom.tpa.accept.always.tpa и blossom.tpa.accept.always.tpahere принудительно принимают все входящие запросы без отображения уведомлений. Флаги blossom.tpa.accept.force.tpa и blossom.tpa.accept.force.tpahere действуют на исходящие запросы, принудительно завершая их принятием, что имитирует поведение ванильной команды /tp, но сохраняет обязательную задержку на месте перед перемещением.

Настройка конфигурации

Параметры работы модификатора настраиваются через файл конфигурации config/BlossomMods/BlossomTPA.json, который генерируется после первого запуска сервера. Ключевой раздел teleportation содержит объект TeleportationConfig с несколькими важными параметрами. Параметр timeout определяет время жизни запроса в секундах; если игрок не ответит в течение этого срока, заявка автоматически отменится. Параметр standStill задаёт минимальное время в секундах, которое игрок должен простоять на месте после получения запроса, прежде чем телепортация начнётся. Параметр cooldown устанавливает время ожидания в секундах после успешного перемещения, в течение которого игрок не сможет инициировать новую телепортацию с помощью этого модификатора.

Локализация и ключи перевода

Мод предоставляет систему сообщений с ключами перевода, которые используются для обратной связи с игроками. В файле src/main/resources/data/blossom/lang/en_us.json хранятся ключи на английском языке. Сообщения делятся на две категории: ошибки (префикс fail.*) и информационные уведомления о ходе процесса (префикс to.*). Информационные сообщения содержат до шести аргументов, включая длительность таймаута, имена отправителя и получателя, а также ссылки на команды управления (/tpacancel, /tpaaccept, /tpadeny). Помимо английского, в проект добавлены переводы на китайский язык (упрощённый и традиционный) от разработчика @BackWheel.

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

• Mod Menu — похожий мод
• YetAnotherConfigLib (YACL) — похожий мод

Автор: CodedSakura · Лицензия: MIT