ChatSentinel

Продвинутая защита чата для Spigot, Paper, Folia-совместимых серверов, BungeeCord и Velocity.

ChatSentinel - это бесплатный плагин с открытым исходным кодом для модерации чата в Minecraft. Он создан для администраторов, которым нужна практичная защита без устаревших фильтров, сломанных regex-правил или хрупкого поведения на прокси.

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

Bukkit / Spigot / Paper / Folia-совместимый backend - BungeeCord - Velocity - Regex-фильтры - Discord вебхуки - Redis-синхронизация оповещений - SocialSpy

---

Что такое ChatSentinel?

ChatSentinel - это серьёзная система фильтрации чата для серверов и сетей Minecraft.

Большинство старых плагинов для фильтрации чата проверяют лишь несколько слов, ломаются при обходе или перестают обновляться. ChatSentinel построен на конфигурируемых модулях, regex-файлах с указанием источника, действиях для каждого модуля, видимости для персонала, поддержке прокси и безопасных настройках по умолчанию для реальных сообществ.

Он пригодится на SMP-серверах, практических серверах, PvP-сетях, выживальных проектах, прокси-сетях и любых серверах, где чат должен оставаться читаемым, безопасным и управляемым.

---

Основная защита чата

• Фильтрация по чёрному списку - блокировка нецензурной лексики, рекламы, спама от хак-клиентов, пользовательских правил и payload-атак.
• Модули фильтров на основе папок - стандартные правила разбиты на модули: security, advertisement, offense, client, user.
• Поддержка regex - сложные паттерны компилируются из YAML-файлов с отчётами о компиляции и оповещениями администрации.
• Белый список - разрешённые выражения и имена прокси-серверов, к которым фильтрация не применяется.
• Проверка команд - выбранные команды (например /msg, /reply, /tell, /broadcast, /global) проверяются как обычный чат.
• Защита синтаксиса - блокировка командного синтаксиса с namespace (например minecraft:me), если не в белом списке.
• Фильтрация разрешённых символов - замена или блокировка символов, не входящих в заданный regex.
• Очистка имён игроков - игнорирование никнеймов онлайн-игроков при модерации (по настройке).

---

Антиспам и контроль качества сообщений

• Модуль кулдауна - отдельные задержки для обычного чата, команд, повторяющихся сообщений и глобальный повтор.
• Модуль флуда - блокировка или сокращение повторяющихся символов, слишком длинных сообщений и спама из символов.
• Модуль похожести - обнаружение повторяющихся похожих сообщений через сравнение нормализованного текста.
• Модуль капитализации - исправление чрезмерного использования заглавных букв, опциональная капитализация начала предложений, игнорирование заданных слов (например VIP, USA).
• Модуль автокоррекции - исправление распространённых опечаток без превращения модерации в наказание.
• Модуль "No-Move-Chat" - защита для Bukkit, требующая, чтобы игрок двигался перед отправкой сообщения.

---

Система чёрного списка для удобного обслуживания

ChatSentinel не пытается впихнуть все правила в одну огромную строку конфига.

Правила (стандартные и пользовательские) хранятся в структурированных YAML-файлах внутри папок blacklist. Каждый файл компилируется в фильтр с указанием источника, поэтому в оповещениях персонала видно имя файла, модуль, совпавший текст и оригинальное сообщение.

Встроенные группы правил:

• Security - паттерны Log4Shell/JNDI и подобные payloads.
• Advertisement - домены, домены с пробелами, IPv4-адреса и спам с портами.
• Offense - нецензурная лексика на английском, испанском и Spanglish.
• Client - сигнатуры спама от хак-клиентов.
• User - ваши собственные правила.

У каждого модуля чёрного списка можно настроить состояние, отображаемое имя, поведение предупреждений, вебхуков, цензуры, режим fake-message, режим raw-block и команды наказания.

---

Видимость персонала и модерация в реальном времени

• Оповещения персонала - уведомления онлайн-администрации, когда игрок триггерит модуль.
• Spy-оповещения - опциональный канал для персонала с информацией о файле, модуле, совпавшем тексте и контексте сообщения.
• Discord вебхуки - отправка событий модерации в Discord с настраиваемым именем, аватаром, автором, полями, цветами, подвалом и миниатюрой.
• Redis-шина оповещений - публикация и получение оповещений между несколькими экземплярами плагина.
• Команда самопроверки - проверка вывода команд, сообщений игроков и доставки предупреждений прямо в игре.
• Отчёты о компиляции - некорректные regex-правила сообщаются, а не молча ломают защиту.

---

Система SocialSpy

ChatSentinel включает настраиваемый набор модулей SocialSpy для контроля персонала.

Поддерживаемые модули SocialSpy:

• Личные сообщения - /msg, /tell, /w, /reply, /r, /dm и настраиваемые паттерны.
• Таблички - содержимое при установке/редактировании.
• Книги - заголовки и фрагменты содержимого.
• Наковальни - изменения названий предметов.
• Команды - общая видимость команд, конфиденциальные команды (например, с паролями) игнорируются по умолчанию.

SocialSpy поддерживает отдельные права для каждого модуля, состояние по умолчанию, обрезку содержимого, игнорируемые корни команд, контроль включения себя и меню /socialspy menu на Bukkit.

---

Инструменты снимка чата, очистки и удаления

ChatSentinel хранит недавний снимок видимого чата, чтобы персонал мог очищать чат не только пустыми строками.

• Очистка чата - отправка очищающего payload игрокам без права обхода.
• Очистка с учётом обхода - персонал с правом обхода сохраняет видимость.
• Список недавних сообщений - просмотр отслеженных сообщений.
• Удаление записи чата - пометка сообщения как удалённого и перерисовка видимого чата.
• Клик для удаления - на Bukkit персонал может получать кликабельный префикс удаления рядом со строками чата в реальном времени.

Это ускоряет модерацию во время рейдов, рекламного спама или инцидентов в публичном чате.

---

Серверный мут

Встроенная функция мута всего сервера.

• Включение/отключение мута через команду.
• Настройка права на обход.
• Сохранение состояния мута в конфиг.
• Настраиваемые сообщения о муте/размуте (с возможностью широковещательной рассылки).
• Алиасы: /servermute, /muteall, /muteserver (если поддерживается платформой).

---

Поддержка сетей и платформ

ChatSentinel поддерживает разные стили развёртывания:

• Bukkit-семейство (backend) - Spigot, Paper, Purpur, Folia-совместимые серверы.
• BungeeCord (прокси) - модерация чата на уровне сети.
• Velocity (прокси) - с настраиваемым поведением для signed-chat.
• Redis-синхронизация оповещений - для уведомлений персонала на нескольких экземплярах.
• Java 8 - широкая совместимость с хостингом.

Поведение signed-chat для Velocity настраивается. legacy-deny блокирует или изменяет чат, warn-only оставляет уведомления, вебхуки и spy-оповещения без изменения signed-chat сообщений.

---

Команды

Основная команда:

• /chatsentinel help - список доступных команд.
• /chatsentinel status - статус модулей и фильтров.
• /chatsentinel selftest - тест доставки сообщений и предупреждений.
• /chatsentinel reload - перезагрузка конфигов, сообщений, фильтров и кэша игроков.
• /chatsentinel clear [причина] - очистка видимого чата у игроков без права обхода.
• /chatsentinel notify - включение/отключение уведомлений модерации.
• /chatsentinel spy - включение/отключение spy-оповещений.
• /chatsentinel delete <id>|list [лимит] - удаление или просмотр недавних записей снимка чата.
• /chatsentinel module list|enable|disable|toggle <moduleId> - управление модулями на лету.
• /chatsentinel regex add <moduleId> common <текст...> - добавление сгенерированного common-правила.
• /chatsentinel regex add <moduleId> raw <regex...> - добавление raw-правила.
• /chatsentinel mutechat [on|off|toggle] [причина] - мут или размут сервера.
• /chatsentinel socialspy [module|status] - включение/отключение или просмотр модулей SocialSpy.
• /chatsentinel autocorrect [on|off|toggle] - включение/отключение личной автокоррекции.

Распространённые алиасы:

• /autocorrect, /correction
• /servermute, /muteall, /muteserver
• /socialspy, /sspy
• /deletechat <id>
• /recentchats [лимит]

Некоторые алиасы зависят от платформы (Bukkit, BungeeCord, Velocity).

---

Права доступа

Права персонала:

• chatsentinel.admin - доступ ко всем командам персонала.
• chatsentinel.help - использование справки/статуса.
• chatsentinel.reload - перезагрузка ChatSentinel.
• chatsentinel.clear - очистка чата.
• chatsentinel.notify - получение уведомлений модерации.
• chatsentinel.spy - включение/отключение spy-оповещений.
• chatsentinel.delete - использование инструментов удаления/просмотра снимков чата.
• chatsentinel.module - переключение модулей на лету.
• chatsentinel.regex.add - добавление пользовательских regex-правил.
• chatsentinel.mute - управление серверным мутом.

Права на обход:

• chatsentinel.bypass - глобальный обход модерации (кроме исключённых UX-модулей).
• chatsentinel.bypass.capitalization - обход исправления капитализации.
• chatsentinel.bypass.correction - обход автокоррекции.
• chatsentinel.clear.bypass - обход визуальной очистки/удаления чата.
• chatsentinel.mute.bypass - возможность писать при активном серверном муте.

Права SocialSpy:

• chatsentinel.socialspy - использование SocialSpy.
• chatsentinel.socialspy.messages - получение spy-оповещений о личных сообщениях.
• chatsentinel.socialspy.signs - получение spy-оповещений о табличках.
• chatsentinel.socialspy.books - получение spy-оповещений о книгах.
• chatsentinel.socialspy.anvils - получение spy-оповещений о наковальнях.
• chatsentinel.socialspy.commands - получение spy-оповещений о командах.

---

Философия конфигурации

Всё важное настраивается.

• Состояния модулей (вкл/выкл).
• Папки фильтров и regex-файлы.
• Отображаемые имена модулей.
• Предупреждения и их пороги.
• Команды наказания.
• Цензура, режим fake-message, скрытие и raw-block.
• Тайминги кулдаунов.
• Regex для флуда.
• Правила нормализации для похожести.
• Поведение капитализации и токены белого списка.
• Замены в автокоррекции и игнорируемые слова.
• Состояние серверного мута и обход.
• Дистанция для No-Move-Chat.
• Модули SocialSpy, форматы, права, обрезка и игнорируемые команды.
• История снимков чата, количество строк очистки, префикс удаления с кликом, ховер и команда.
• Стиль Discord вебхуков.
• Канал Redis, URI, ID экземпляра, публикация и получение.
• Мультиязычные сообщения.

---

Почему стоит выбрать ChatSentinel?

• Не просто фильтр мата - обрабатывает спам, флуд, капс, похожесть, синтаксис, рекламу, опасные payloads и командные сообщения.
• Создан для видимости персонала - уведомления, spy-оповещения, Discord вебхуки, SocialSpy и инструменты снимков чата.
• Создан для реальных сетей - режим Bukkit backend, BungeeCord, Velocity и опциональная Redis-синхронизация.
• Создан для удобства обслуживания - YAML-файлы фильтров с указанием источника вместо одного неуправляемого чёрного списка.
• Создан для контроля - действия для каждого модуля, переключение на лету, добавление regex, обходы, права и перезагрузка.
• Создан для продакшена - отчёты о компиляции, безопасные настройки по умолчанию, Folia-совместимое планирование и политики signed-chat для Velocity.

---

Установка

1. Остановите сервер или прокси.
2. Скачайте ChatSentinel .jar.
3. Поместите его в папку plugins.
4. Запустите сервер или прокси один раз для генерации файлов.
5. Отредактируйте config.yml, messages.yml, whitelist.yml и файлы фильтров в папках blacklist.
6. Выполните /chatsentinel reload после изменения конфигурации.

Для прокси-сетей установите ChatSentinel там, где хотите запустить модерацию чата. Используйте режим Bukkit backend, если нужны функции только для Bukkit: no-move-chat, слушатели табличек/книг/наковален или кликабельное удаление чата.

---

Важно знать

Для каких серверов подходит?

SMP, выживание, PvP, практика, фракции (lite), прокси-сети и любые серверы, где нужна настраиваемая модерация чата.

Поддерживает ли прокси?

Да. ChatSentinel включает поддержку BungeeCord и Velocity.

Поддерживает ли Bukkit-серверы?

Да. Есть поддержка Bukkit-семейства, включая Folia.

Можно ли добавить свои слова и regex-правила?

Да. Добавляйте правила в YAML-файлы blacklist или используйте /chatsentinel regex add для добавления на лету.

Может ли персонал увидеть, что именно сработало?

Да. В оповещениях указываются файл источника, модуль, совпавший текст, сообщение, игрок и контекст сервера.

Настраиваются ли наказания?

Да. Настраиваются команды для каждого модуля. Работает с внешними плагинами наказаний (LiteBans, AdvancedBan и подобными).

Обязателен ли Discord или Redis?

Нет. Discord вебхуки и Redis-синхронизация опциональны.

Могут ли игроки отключить автокоррекцию?

Да. Игроки могут использовать /autocorrect off, если модуль включён.

---

Скачайте ChatSentinel и настройте модерацию чата на вашем сервере Minecraft. Администраторы получат реальный контроль, а игроки - чистый и безопасный чат.