NetworkJoinMessages - сообщения входа, выхода и переходов для прокси

NetworkJoinMessages - плагин для прокси-сетей Майнкрафт, который берёт на себя все сообщения о входе, выходе и переходах между серверами. Раньше он жил только на GitHub и SpigotMC, теперь спокойно лежит и на Modrinth. По сути это современное продолжение BungeeJoinMessages: тот же подход, но с поддержкой Velocity и куда более гибкой настройкой.

Если вы держите сеть из нескольких серверов (хаб, выживание, мини-игры), то ванильные сообщения вида "Player joined the game" тут вообще ничего не решают. Нужно показать, кто на какой сервер ушёл, сколько там народу, с префиксом из LuckPerms и в аккуратном форматировании. Вот этим плагин и занимается. Причём по метаданным Modrinth это управленческий и социальный инструмент - не хоррор, не PvP, просто рабочий инструмент админа.

Сразу оговорюсь по версиям, потому что это первое, что спрашивают: плагин работает с Minecraft Java начиная с 1.8.x и вплоть до 1.21.x и новее, актуальный релиз - 3.6.2. Ставится на прокси-сервер, а не на бэкенды.

Зачем это нужно на сервере

Представьте: 30 человек в хабе, часть уходит на выживание, часть в мини-игры. Без нормальных сообщений никто не понимает, что вообще происходит. NetworkJoinMessages даёт каждому игроку живую ленту событий: кто зашёл в сеть, кто на какой сервер перескочил, сколько народу в онлайне. Мелочь? Как посмотреть. Но именно из таких мелочей складывается ощущение живого, обжитого сервера, а не пустой коробки.

Возможности

• Гибкие уведомления о входе, выходе и переходах между серверами
• Поддержка BungeeCord и Velocity - то есть обеих популярных прокси-платформ
• Плейсхолдеры: LuckPerms (префикс и суффикс), PAPIProxyBridge, MiniPlaceholders
• Форматирование в legacy-стиле и через MiniMessage
• Совместимость с SayanVanish, PremiumVanish и LimboAPI
• Discord-сообщения в отдельном конфиге

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

Установка

1. Скачайте последний релиз
2. Положите JAR в папку plugins прокси-сервера
3. Перезапустите прокси, чтобы сгенерировался конфиг по умолчанию
4. Отредактируйте config.yml в папке плагина под себя
5. Примените изменения командой /njoinreload

При желании настройте сообщения для Discord в файле discord.yml - он тоже подхватывается через /njoinreload.

Важный нюанс: чтобы убрать ванильные сообщения о входе и выходе, используйте EssentialsX или отдельный простой плагин. Просто так NetworkJoinMessages их не перебивает - это стоит держать в голове, иначе получите дубли.

Плейсхолдеры

Общие для всех трёх типов сообщений:

• %player% - ник игрока
• %displayname% - кастомное имя игрока на прокси
• %player_prefix% - префикс игрока (нужен LuckPerms на прокси)
• %player_suffix% - суффикс игрока (нужен LuckPerms на прокси)

Для сообщения о смене сервера:

• %to% - сервер, куда идёт игрок
• %to_clean% - то же, но без цветовых кодов
• %from% - сервер, откуда идёт
• %from_clean% - то же, но без цветовых кодов
• %playercount_to% - сколько игроков на сервере назначения
• %playercount_from% - сколько игроков на сервере отправления
• %playercount_network% - сколько игроков во всей сети

Для входа и выхода из сети:

• %server_name% - сервер, куда зашли или на котором были в последний раз
• %server_name_clean% - то же, но без цветовых кодов
• %playercount_server% - сколько игроков на этом сервере
• %playercount_network% - сколько игроков в сети

Права

Право	Описание
networkjoinmessages.silent	Не показывает сообщения о входе, выходе и переходе для владельца права. Пригодится тем, кто часто заходит в ванише.
networkjoinmessages.spoof	Разрешает команду /njoinspoof.
networkjoinmessages.reload	Разрешает перезагрузку конфига через /njoinreload.
networkjoinmessages.toggle	Разрешает /njointoggle - игрок сам выбирает, какие уведомления получать.
networkjoinmessages.toggle.others	Применять /njointoggle к другим игрокам.
networkjoinmessages.import	Импорт из usercache.json бэкенд-серверов через /njoinimport.

Команды

Обязательные аргументы в угловых скобках (<this>), опциональные в квадратных ([this]), многоточие значит, что аргумент можно повторять через пробел.

Команда	Описание
/njoinspoof <join | leave | swap | toggle> [<from> <to>]	Показывает фейковое сообщение от имени отправителя.
/njoinreload	Перезагружает конфигурацию.
/njointoggle <all | join | leave | swap> <on | off> [player]	Включает или выключает получение сообщений отправителем или для указанного игрока. Параметр [player] обязателен при запуске из консоли.
/njoinimport <pathtousercache.json> [pathtousercache.json...]	Импортирует пользователей из usercache бэкендов, чтобы они не триггерили первое сообщение о входе. Полезно на уже работающей сети, когда вы только ставите плагин.

Последняя команда - скрытый гем для тех, кто добавляет плагин на живой проект. Иначе после установки весь онлайновый состав будет ошибочно считаться новичками, и полетят ложные "first join".

Особенности и советы из практики

Про Discord. В версии 3.6.2 как раз чинили обработку Discord-сообщений: теперь leave-сообщения кэшируются, чтобы плейсхолдеры отображались корректно, а Minecraft-форматирование вычищается перед отправкой. Если раньше в канале проскакивали странные §-коды, то обновитесь.

Про ваниш. Плагин умеет скрывать уведомления о перемещениях для игроков с правами ваниша - это работает с SayanVanish и PremiumVanish. На серверах с активной модерацией это прямо обязательно, иначе модеры палятся в чате при каждом выходе из ваниша.

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

Про производительность. Плагин легковесный, на TPS не влияет - вся работа это шлёны сообщений в чат. На слабом железе прокси никакого прироста нагрузок не почувствуете.

Про установку на хостинг. Если берёте сервер у BungeeHost, NetworkJoinMessages ставится в папку plugins в один клик, как и остальные плагины для прокси. Заодно можно поиграть с друзьями онлайн: сеть из хаба и пары серверов собирается без сложных настроек, а все переходы будут красиво отображаться в чате.

Совместимость и связки

Официально предусмотрена интеграция с LuckPerms, PAPIProxyBridge, MiniPlaceholders, SayanVanish, PremiumVanish и LimboAPI. Для скрытия стандартных join/leave-сообщений нужен EssentialsX или аналогичный плагин. С другими чат-плагинами уживается нормально, потому что работает на уровне прокси, а не на бэкендах.

Лицензия

Распространяется под zlib License от автора Tirco. Можно использовать, изменять и распространять, если сохранить указание авторства.

Скачайте NetworkJoinMessages и наведите порядок в уведомлениях своей прокси-сети - мелочь, которая сильно меняет восприятие сервера игроками.