PacketTrigger (Пакеттриггер)

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

Возможности

• Перехватывает системные сообщения плагинов, чат игроков или оба источника.
• Извлекает значения из сообщения и подставляет их в действия: например, количество опыта или название задания.
• Выполняет команды от консоли и игрока, отправляет сообщения, строки над хотбаром и заголовки, воспроизводит звуки и создаёт частицы.
• Поддерживает рассылку, задержку действий, повтор с интервалом, случайный выбор действия, условия и отдельную задержку срабатывания для каждого триггера.
• Передаёт пойманные значения в другие плагины через PlaceholderAPI, например %pt_triggerName_1%.

Команды

Все команды требуют право packettrigger.admin.

• /pt reload — перезагрузить config.yml.
• /pt list — показать загруженные триггеры и их состояние.
• /pt test <trigger> <player> [data...] — вручную проверить триггер.
• /pt debug [player] — включить или выключить журнал пакетов для игрока.
• /pt stats и /pt resetstats — посмотреть и сбросить счётчики срабатываний.
• /pt toggle <setting> — переключить log-to-console или log-packet-content.
• /pt clearcooldowns [player] — очистить задержки срабатывания у игрока или всех игроков.

Права

• packettrigger.admin — доступ к командам управления; операторы получают его по умолчанию.
• В параметре permission у триггера можно указать право, необходимое игроку для его срабатывания.

Настройка

Триггеры задаются в config.yml. Для каждого можно указать начало перехватываемого сообщения в placeholder, разделитель значений в delimiter, источник в packet-source, задержку в cooldown, условия в conditions и список actions.

В действиях доступны значения {1}, {2} и далее, имя игрока %player%, его UUID %player_uuid%, мир %player_world%, здоровье %player_health%, уровень %player_level%, а также вычисления вида {math:expression}. В conditions поддерживаются операторы ==, !=, >, <, >=, <=, contains, startswith и endswith.

Требования

Нужен сервер Paper или Purpur и PacketEvents. PlaceholderAPI необязателен, но нужен для использования его плейсхолдеров и передачи данных триггеров другим плагинам.