Proxy Messages

Единая система сообщений для вашей сети Velocity/Paper

Если у вас сеть серверов на Velocity, вы наверняка сталкивались с проблемой: сообщения о входе/выходе игрока, а тем более чат, не синхронизируются между серверами. Игроки на разных серверах не видят друг друга, а админам приходится ставить костыли. Proxy Messages решает эту проблему раз и навсегда.

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

Основные возможности

• Глобальные сообщения - игроки общаются между собой, даже находясь на разных серверах.
• Настраиваемые сообщения - легко меняйте текст приветствий, прощаний, смены сервера и самих сообщений. Подгоняйте под стиль вашей сети.
• Поддержка PlaceholderAPI - используйте плейсхолдеры с версии 4.0.0.
• Несколько вариантов сообщений - создавайте по несколько вариантов для каждого события, чтобы игроки не заскучали.
• Цвета и HEX - добавляйте свои цвета через HEX-коды, чтобы сообщения выглядели стильно.
• Kyori Adventure TextDecoration - форматирование текста: жирный, курсив, зачёркнутый, подчёркнутый, обфускация.
• Сетевые ресурспаки - возможность установить единый ресурспак на всю сеть.
• Интеграция с Discord - связывайте чат сервера с Discord-каналом.

Как это работает

Вся конфигурация хранится на стороне прокси. Вам не нужно синхронизировать настройки между бэкенд-серверами. Просто отредактируйте файл config.yml в папке plugins/proxymessages/ на прокси-сервере.

Плагин Paper

Для полной функциональности рекомендуется установить плагин ProxyMessages на все бэкенд-серверы (Paper). Он нужен для:

• Удаления стандартных сообщений о входе/выходе (vanilla join/leave messages).
• Форматирования чата на сервере, где находится игрок.
• Поддержки PlaceholderAPI (начиная с версии 4.0.0).

В версиях до 4.0.0 плагин Paper был опциональным, но с 4.0.0 он стал обязательным, если вы включаете enable-papi: true. Если PlaceholderAPI не нужен, просто поставьте enable-papi: false - тогда плагин Paper останется опциональным, но его всё равно рекомендуют ставить.

Таблица зависимости:

enable-papi	Плагин Paper?	Версия Paper Plugin
false	Опционально	>= 4.0.0
true	Обязательно	>= 4.0.0
N/A	Опционально	< 4.0.0

Важно: Все настройки по-прежнему задаются только в конфиге прокси. Плагин Paper не требует отдельной конфигурации - просто установите его.

Цвета и стили

В любом сообщении можно вставить HEX-код в скобках, например {#ff0066}. Весь текст после кода (кроме ника игрока) окрасится в этот цвет. Можно использовать несколько кодов для многоцветных сообщений. По умолчанию цвет - жёлтый.

Для стилизации текста используйте теги Kyori Adventure:

• {bold} - жирный
• {italic} - курсив
• {strike} - зачёркнутый
• {underline} - подчёркнутый
• {obfuscate} - обфусцированный (магический текст)

Теги работают парно: открывающий и закрывающий. Например, {bold}важный текст{/bold}. В оригинале используется одинаковый тег для открытия и закрытия, но в документации Kyori это обычно так. На практике можно просто ставить тег второй раз для закрытия.

Настройка сообщений

Основные опции в config.yml:

• enable-papi - включить поддержку PlaceholderAPI.
• default-player-color - цвет ника по умолчанию.
• choose-color - разрешить ли игрокам самим выбирать цвет ника.
• global-network-join - включить/выключить глобальное сообщение о входе.
• global-network-leave - то же для выхода.
• global-network-switch - то же для смены сервера.
• global-messages - включить глобальный чат.
• join-message-options - список вариантов сообщений о входе. Используйте {player} как плейсхолдер ника.
• leave-message-options - список вариантов сообщений о выходе.
• switch-message-options - список вариантов сообщений о смене сервера. Плейсхолдеры: {player}, {prev} (предыдущий сервер), {cur} (текущий сервер).
• global-message-prefix - префикс для глобальных сообщений с других серверов. Плейсхолдеры: {player}, {cur}.

Цвет ника игрока

Игроки могут сами установить цвет своего ника командой /set-color #xxxxxx. Администратор (или любой, если не настроено) может изменить цвет другого игрока: /set-color #xxxxxx ник. В будущем планируется сделать эту команду только для операторов.

Перезагрузка конфига

Конфигурация перезагружается на лету командами pmReload или reloadPM.

Глобальные сообщения

Если global-messages включён, игроки могут переключать режим чата между глобальным и локальным командами:

• toggleGM
• tGM
• pmToggle

Опция global-message-defaults определяет, будут ли сообщения по умолчанию глобальными (игрок всё равно может переключить).

Глобальные сообщения видны на всех серверах сети. Локальные - только на том сервере, где находится игрок.

PlaceholderAPI

Поддержка PlaceholderAPI доступна начиная с версии 4.0.0. Для её работы нужно:

• Включить enable-papi: true в конфиге прокси.
• Установить плагин Paper ProxyMessages на все бэкенд-серверы.
• Установить PlaceholderAPI на каждый бэкенд-сервер.

Плейсхолдеры ProxyMessages (в фигурных скобках) продолжают работать. PlaceholderAPI использует двойные проценты (%%). Пример: {player} joined {cur} with %rank%.

Важно: поскольку конфигурация одна для всей сети, плейсхолдеры PAPI должны быть доступны на всех бэкенд-серверах. Если на одном сервере есть плагин, дающий %power%, а на другом нет - сообщение не сработает. Если вам нужны сервер-специфичные плейсхолдеры, свяжитесь с разработчиком (но не через Discord, а через issues на GitHub, впрочем, это опционально).

Сетевые ресурспаки

В разделе network-resource-pack настройте:

• enabled - включить/выключить.
• url - ссылка на скачивание ресурспака.
• sha1-hash - SHA1-хеш (пока не работает, так что можно оставить пустым или указать что-то).
• prompt - текст, который увидят игроки при предложении скачать ресурспак.
• required - обязателен ли ресурспак для игры.
• except - список серверов, на которых ресурспак не будет отправляться.

Discord

Плагин умеет отправлять сообщения о событиях в Discord-канал. Настройки в разделе discord:

• enabled - включить.
• bot-token - токен бота.
• proxy-channel-id - ID канала для сообщений с прокси.
• server-channel-ids - список серверов и соответствующих каналов Discord.
• join-color, leave-color, switch-color - цвета HEX для встраиваемых сообщений (embeds).
• text-configuration - настройка текстов сообщений (поддерживается Markdown).
• online-message / offline-message - сообщения при запуске/остановке прокси.
• player-message-prefix - префикс для сообщений игроков в Discord.
• discord-role-color - использовать ли цвет роли отправителя в Discord.
• server-count - показывать ли список активных серверов при запуске.
• display-icon - показывать ли иконку (файл icon.jpg в папке плагина).

Итог

Proxy Messages - это must-have для любой сети серверов на Velocity. Он избавляет от головной боли с синхронизацией чата и сообщений, даёт гибкие настройки и поддержку современных фич вроде HEX и PlaceholderAPI. Установите плагин на прокси и настройте конфиг под себя - и ваша сеть заговорит в унисон.