Плагин для серверов Майнкрафт, который проверяет клиентские моды, объявившие себя серверу, и применяет правила: записывает нарушение, предупреждает или кикает игрока. Он подходит для контроля разрешённых мини-карт, модов на схемы, автоматизацию и других клиентских дополнений, но не заменяет античит: моды, не передающие серверу свои каналы, включая многие читы, обнаружить не получится.
Возможности
- Сверяет каналы модов, строку
minecraft:brandи рукопожатие загрузчика модов с записями вsignatures.yml. - Поддерживает профили
BLOCKLISTиALLOWLIST: запрет конкретных модов или допуск только перечисленных. - Выбирает профиль через право
clientpolicy.profile.<name>либо использует профиль изdefault-profile. - Повторно проверяет каналы, зарегистрированные вскоре после входа игрока, поэтому поздняя регистрация мода не обходит правило.
- Ведёт журнал обнаружений и действий в SQLite; его можно просмотреть и для офлайн-игроков из локального кэша сервера.
- Неизвестным каналам можно назначить отдельное действие. Это полезно для
ALLOWLIST, чтобы безобидные служебные каналы не приводили к кику.
Команды
/clientpolicy rules— разрешённые и запрещённые моды для своего профиля./clientpolicy check— что сервер видит у вашего клиента./clientpolicy inspect <player>— каналы, строка клиента, распознанные моды и состояние проверки./clientpolicy history <player> [limit]— журнал нарушений и действий./clientpolicy profile <player>— профиль игрока и причина его выбора./clientpolicy rescan <player>— немедленно повторить проверку./clientpolicy reload— перечитатьconfig.ymlиsignatures.yml.
Также доступен короткий вариант команды: /cp.
Права
clientpolicy.rules— команда/clientpolicy rules; выдано всем.clientpolicy.check— команда/clientpolicy check; выдано всем.clientpolicy.admin— проверка игроков, журнал, профили, повторная проверка и перезагрузка; выдано операторам.clientpolicy.bypass— не применять действия к игроку, но сохранять обнаружения и уведомлять персонал.clientpolicy.notify— получать сообщения о предупреждениях и киках.clientpolicy.profile.<name>— назначить профиль с именем<name>.
Игроку или группе следует выдавать только одно право профиля: при нескольких правах будет выбран первый найденный профиль.
Настройка
В signatures.yml для каждого мода указываются его идентификатор, шаблоны каналов, строка клиента и категория. Шаблоны поддерживают подстановки, например litematica:*.
Перед использованием ALLOWLIST проверьте сигнатуры на собственном клиенте: выполните /clientpolicy inspect <ваш_ник>, перенесите нераспознанные нужные каналы в signatures.yml и используйте /clientpolicy reload. Настройка профилей, задержки проверок, действий для неизвестных каналов, лестницы наказаний и сообщений находится в config.yml.
Сообщения поддерживают MiniMessage и плейсхолдеры <player>, <mod>, <mod_id>, <channels>, <category>, <profile>, <reason>, <action>, <count>.
Требования
Работает с ванильными клиентами, а также с Fabric, Forge и NeoForge; клиентский мод для игроков не нужен. Плагин рассчитан на Paper и требует Java 21. Для истории и счётчика нарушений между перезаходами используется драйвер SQLite: если сервер не может скачать его, проверка и наказания сохраняются, но журнал и счётчик между сессиями недоступны.
