Mod Detector Plugin - детектор клиентских модов для сервера

Mod Detector Plugin - плагин для серверов Paper, который показывает админу, с какими клиентскими модами заходят игроки. Работает он через отслеживание plugin message channels: многие моды при подключении к серверу регистрируют свои каналы для обмена данными, даже если на сервере нет отвечающего плагина. Mod Detector Plugin ловит эти регистрации и по ним определяет, что стоит у игрока на клиенте.

Зачем это вообще нужно? На любом сервере Minecraft рано или поздно встаёт вопрос честной игры. Кто-то заходит с миникартой, где видно пещеры и игроков, кто-то с Litematica строит по схемам, а кто-то вообще тащит реплей-мод и сливает ваши ивенты. Ванильный сервер сам по себе никак не узнает, что у игрока на клиенте - моды работают локально и никак себя не выдают. Этот плагин закрывает именно эту дыру: админ видит список обнаруженных модов у каждого игрока и может автоматически кикать тех, кто зашёл с запрещённым софтом. Скачать Mod Detector Plugin стоит в первую очередь владельцам анархий, гриферских и хардкорных серверов, где миникарта с радаром реально ломает баланс.

Возможности плагина

• Автоматическое определение модов - плагин сам ловит клиентские моды, которые регистрируют plugin message channels при входе
• Белый или чёрный список - гибкий режим фильтрации: либо разрешаете только конкретные моды, либо баните отдельные
• Настраиваемые действия - кик игрока, запись в лог или оба варианта сразу
• Готовая база модов - из коробки прописаны паттерны для популярных модов, ничего дописывать руками не нужно
• Свои паттерны - можно добавлять собственные каналы с поддержкой вайлдкардов (звёздочек)
• Уведомления админам - алерты в реальном времени, когда у игрока обнаружили мод
• Логирование в файл - все срабатывания пишутся в отдельный файл для разборов
• MiniMessage - кастомные сообщения при кике с форматированием и цветами

Какие моды определяет из коробки

В файле mods.yml уже прописаны самые ходовые клиентские моды. Вот что плагин узнаёт без дополнительной настройки:

ID	Мод	Что это
xaeros-worldmap	Xaero's World Map	Полноценная карта мира
xaeros-minimap	Xaero's Minimap	Миникарта
jade	Jade	Информация о блоках и мобах при наведении
journeymap	JourneyMap	Карта в реальном времени
litematica	Litematica	Строительство по схемам (через Servux)
minihud	MiniHUD	Оверлеи на HUD (через Servux)
servux	Servux	Серверный провайдер данных для модов masa
simple-voice-chat	Simple Voice Chat	Голосовой чат
noxesium	Noxesium	Мод на фичи и производительность
flashback	Flashback	Запись реплеев
appleskin	AppleSkin	Расширенный HUD еды и голода

Список легко расширить - добавляете свой ID и паттерн канала, и плагин начнёт ловить хоть редкий чит-клиент, хоть самописный мод.

Требования и установка

• Paper 1.21 или новее (по данным проекта заявлена поддержка и более старых версий вплоть до 1.8, но актуальные релизы ориентированы на 1.21.x)
• Java 21 или выше

Установка стандартная для любого плагина Майнкрафт:

1. Скачайте свежий JAR-файл релиза
2. Закиньте его в папку plugins/ вашего сервера
3. Перезапустите сервер
4. Откройте plugins/ModDetectorPlugin/config.yml и настройте под себя

Если ваш сервер крутится на BungeeHost (https://bungee.host), плагин установится в один клик прямо из панели - удобно, если не хочется возиться с FTP и ручной заливкой файлов.

Команды

Команда	Описание	Право
/moddetector	Показать справку	moddetector.admin
/moddetector reload	Перезагрузить конфиг	moddetector.admin
/moddetector status	Текущий статус плагина	moddetector.admin
/moddetector mods	Список известных определений модов	moddetector.admin
/moddetector debug	Отладочная информация	moddetector.admin

Есть короткий алиас - /md, чтобы не тянуться каждый раз за длинной командой.

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

Право	Описание	По умолчанию
moddetector.admin	Доступ к админ-командам	OP
moddetector.notify	Получение уведомлений о детектах	OP
moddetector.bypass	Обход проверки (игрока не кикнет)	false

Право moddetector.bypass удобно выдать админам и ютуберам сервера - чтобы их самих не кикало за реплей-мод или миникарту, пока обычных игроков плагин фильтрует.

Лог обнаружений

Если включить track-detections: true, все срабатывания пишутся в plugins/ModDetectorPlugin/detections.txt в таком формате:

[2025-01-15 14:30:22] uuid-here | PlayerName | Xaero's World Map, Jade

По этому логу удобно потом разбирать жалобы: кто и когда заходил с картой, кто пользовался схемами. В свежих версиях (начиная с 1.2.3) появился per-session tracking - плагин следит за модами в рамках каждой сессии игрока, а история сессий хранится с delta-compression, так что файл не раздувается до неприличных размеров даже на активном сервере.

Как это работает под капотом

Принцип простой, но рабочий. Когда клиент с модами подключается к серверу, моды регистрируют свои plugin message channels - каналы для общения с серверной частью. Например, Simple Voice Chat регистрирует канал для передачи голоса, а моды masa (Litematica, MiniHUD) стучатся к Servux. Даже если на сервере нет отвечающей стороны, сама регистрация канала уже происходит - и Mod Detector Plugin её видит. Дальше дело за конфигом: совпадение с чёрным списком - кик, совпадение с белым при строгом режиме - пускаем, всё остальное - по настройкам.

Важный нюанс. Этот метод ловит только те моды, которые регистрируют каналы. Полностью пассивные моды (например, Sodium, Iris или чисто визуальные твики) каналы не создают, и плагин их не увидит. Это не античит в полном смысле - от XRay-текстурпака или Kill Aura он не спасёт. Зато против миникарт, схем и реплеев работает отлично, а именно они чаще всего и ломают экономику и PvP-баланс серверов.

Совет из практики. Начните с режима "только лог" на пару дней, без киков. Посмотрите в detections.txt, чем реально пользуется ваша аудитория - часто оказывается, что половина сервера сидит с AppleSkin и голосовым чатом, и кикать их всех будет просто глупо. Потом уже включайте кик для действительно проблемных модов вроде карт с радаром. И обязательно пропишите нормальное сообщение кика через MiniMessage с пояснением, какой мод запрещён - иначе игроки не поймут, за что их выкинуло, и завалят вас вопросами.

Для владельцев серверов, которые хотят контролировать клиентский софт без установки тяжёлых античитов, Mod Detector Plugin - лёгкое и понятное решение. Скачайте плагин, настройте список модов под свой проект и больше не гадайте, кто там у вас бегает с миникартой.