hChat (Эйччат)

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

Возможности

• Личные сообщения с ответом в один клик, режимом слежения за перепиской для модераторов, чёрным списком игроков и режимом «не беспокоить».
• Упоминания через @, включая @everyone и @here; для них настраиваются звук, цвет выделения и задержка между массовыми упоминаниями.
• Каналы с отдельными форматами, правами на чтение и отправку, псевдонимами, задержкой между сообщениями и радиусом видимости. Можно сделать локальный, глобальный, торговый, служебный канал или чат отдельного мира.
• Оффлайн-почта: сообщение игроку, который не в сети, сохраняется до прочтения или очистки.
• Автоматическое определение AFK и ручная установка статуса с сообщением.
• Объявления вручную и по расписанию, очистка чата, замедленный режим и полная блокировка чата.
• Фильтры слов, капса, невидимых символов, рекламы и повторяющихся сообщений. Нарушающее сообщение можно заблокировать, замаскировать, привести к нижнему регистру или отметить для модераторов.
• Ежедневные логи чата с настраиваемым сроком хранения.
• Интерактивные строки чата с подсказками и действиями по нажатию, цветовые коды & и шестнадцатеричные цвета &#RRGGBB.
• В форматы можно вставлять [ping], [item], [coords], [world] и [afk]: они показывают задержку, предмет в руке с подсказкой, координаты, мир и статус AFK.

Команды

• /message <игрок> <сообщение> — личное сообщение; псевдонимы: /msg, /tell, /w, /m, /whisper.
• /reply <сообщение> или /r — ответ последнему собеседнику.
• /ignore <игрок> — добавить или убрать игрока из игнора; /ignore list — показать список.
• /dnd [on|off] — включить или выключить запрет входящих личных сообщений.
• /channel [канал] или /ch — посмотреть каналы либо переключиться между ними.
• /broadcast <сообщение> или /bc — объявление для всего сервера.
• /clear — очистить чат игрокам.
• /slowmode <секунды|off|status> — задать задержку между сообщениями.
• /chatlock <on|off|status> — заблокировать или разблокировать общий чат.
• /sc <сообщение> — написать в чат персонала.
• /ping [игрок] — показать задержку соединения.
• /seen <игрок> — узнать, когда игрок последний раз писал вам.
• /afk [сообщение] — сменить статус AFK.
• /hchat mail read — прочитать оффлайн-почту; /hchat mail clear — очистить её; /hchat mail send <игрок> <сообщение> — отправить письмо.
• /hchat replay [игрок] — вывести недавние сообщения; /hchat replay clear-buffer — очистить буфер.
• /hchat reload — перечитать config.yml и языковые файлы.
• /hchat lang <язык> — выбрать язык сообщений для себя.
• /hchat help — открыть справку.

Права

Основные права игроков: hchat.message, hchat.reply, hchat.ignore, hchat.channel, hchat.dnd, hchat.ping, hchat.seen, hchat.afk, hchat.help и hchat.lang.

Для администрации используются hchat.broadcast, hchat.clear, hchat.slowmode, hchat.chatlock, hchat.sc, hchat.spy, hchat.reload и hchat.monitor.filter. Право hchat.* даёт доступ ко всем возможностям плагина.

Отдельные права позволяют обходить ограничения: hchat.slowmode.bypass, hchat.chatlock.bypass, hchat.bypass.dnd, hchat.spy.all, hchat.ping.others, hchat.broadcast.color, hchat.mention.everyone и hchat.mention.here.

Настройка

Главный файл находится по пути plugins/hChat/config.yml, а языковые файлы — в plugins/hChat/lang/. Через конфиг настраиваются форматы чата, звуки, приветствия и сообщения о выходе, личные сообщения, каналы, фильтры, AFK, логи, объявления и сообщения о смерти.

Формат канала, его радиус, задержка, псевдоним и права задаются в channels.<id>.*. Для локального чата используется range, для чата в пределах одного мира — per-world: true, а права на отправку и просмотр указываются ключами speak-permission и see-permission.

Поддерживаются плейсхолдеры {player}, {sender}, {receiver}, {target} и {message}. При наличии PlaceholderAPI доступны также плейсхолдеры вида %hchat_spy_enabled%, %hchat_ignored%, %hchat_dnd_enabled%, %hchat_last_sender% и %hchat_last_seen%.

Требования

Для работы нужны Paper и PlaceholderAPI. LuckPerms рекомендуется для управления правами и префиксами, Vault может использоваться для интеграции с экономикой и форматированием чата.

На сети с Velocity или BungeeCord плагин устанавливается на серверы Paper, а не на прокси. Личные сообщения, почта, игнор и режим «не беспокоить» хранятся отдельно на каждом сервере сети.