Client Guard

Client Guard - серверный плагин для Майнкрафт, который ловит игроков с запрещёнными клиентскими модами и убирает их с сервера. Речь про читы вроде Wurst, Meteor Client, Freecam, Baritone, XRay Mod и PlayerESP. Главная фишка в том, что для проверки не нужен мод на клиенте игрока. Плагин работает только на стороне сервера и подходит для Paper 1.21+.

Если вы держите сервер Minecraft, то знаете, как быстро читеры портят онлайн. Один игрок с Freecam уже лезет туда, куда не должен. Другой с XRay видит руду сквозь камень. Третий с Baritone бегает по миру как бот. Обычно админы решают это ручными проверками, жалобами и банами по факту. Client Guard нужен как раз для того, чтобы не ждать, пока ущерб уже нанесён. Он пытается определить нежелательный мод ещё на входе или при повторном скане и сразу применить наказание.

Что делает Client Guard

Плагин проверяет игроков на наличие модов из чёрного списка. В комплекте уже есть готовые проверки для популярных чит-клиентов и утилит. Это удобно, потому что не нужно собирать список с нуля. При этом набор можно расширять через конфиг или командой /cg probe.

Смысл простой. Если на клиенте стоит один из отслеживаемых модов, сервер это замечает и выполняет заданное действие. Можно просто кикнуть. Можно выдать предупреждение. Можно запустить любую консольную команду, включая бан или tempban через другой плагин. Для сервера это куда полезнее, чем просто лог в консоль.

Как работает детект

У чит-клиентов есть свои уникальные ключи перевода для биндов. Например, что-то вроде key.wurst.zoom. Client Guard использует это поведение. Когда игрок заходит, плагин незаметно подсовывает скрытую табличку с такими ключами, на долю секунды открывает редактор таблички на клиенте и тут же закрывает его. Клиент отправляет табличку обратно на сервер. Если ключи превратились в читаемые подписи, значит мод на клиенте есть.

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

Но тут есть важный нюанс. Такой подход хорош именно как серверный фильтр. Он не превращает ваш сервер в идеальную античит-систему на все случаи жизни. Зато закрывает очень практичную задачу: быстро вычистить самые известные чит-клиенты и моды, которые админы обычно и хотят резать первыми.

Что уже умеет плагин

• Предупреждения перед наказанием - можно сначала warn, а уже потом кик или бан. Статус предупреждения переживает перезаход, так что релогом его не сбросить.
• Гибкие действия на детект - при срабатывании можно выполнить любую консольную команду. Это удобно для связки с плагинами наказаний.
• Отдельные настройки для каждой проверки - для конкретного probe можно задать своё действие или отдельно включить предупреждения.
• Автоматическое повторное сканирование - плагин умеет периодически проверять всех онлайн-игроков по таймеру.
• Скан при входе - проверка запускается при заходе, а задержку можно настроить под игроков с плохим пингом.
• Ручное сканирование - через /cg scan <player> или сразу по всем через /cg scan-all.
• Кулдаун на скан - чтобы персонал не спамил проверками по одному и тому же игроку.
• Уведомление о возможном обходе - если клиент не отвечает на проверку, персонал получает сигнал.
• Звуковое оповещение для staff - когда найден запрещённый мод, онлайн-персонал слышит алерт.
• Право на исключение - доверенных игроков, админов или строителей можно полностью исключить из проверки.
• История срабатываний - все результаты сохраняются и смотрятся через /cg history <player>.
• Живое управление конфигом - настройки и probe-список меняются прямо в игре без рестарта.
• Подавление во время скана - опционально можно выдать blindness и slowness на время проверки.
• Без зависимостей - плагин работает на любом Paper 1.21+ сервере из коробки.

По факту это не просто "кик за чит". Это маленькая система контроля доступа по клиентским модам. Для выживания, анархии, мини-игр или приватного сервера с друзьями такая штука очень к месту.

Команды Client Guard

Команда	Что делает
/cg scan <player>	Вручную проверить игрока
/cg scan-all	Проверить всех, кто сейчас онлайн
/cg history <player>	Посмотреть историю детектов игрока
/cg history clear <player>	Очистить историю игрока
/cg status	Показать текущий статус плагина и конфиг
/cg set <flag> <value>	Поменять флаг детекта на лету
/cg probe <list/add/remove/toggle>	Управлять проверками на моды
/cg reload	Перезагрузить config.yml

Кому реально нужен этот плагин

Если у вас публичный сервер Minecraft, Client Guard выглядит очень практично. Особенно там, где не хотят видеть Freecam, XRay, Baritone и прочие клиентские штуки, но нет желания заставлять игроков ставить отдельный мод ради проверки. Это частая боль. Игроки не любят лишние установки, а админам нужен быстрый фильтр.

Для ванильного сервера на Paper это тоже хороший вариант. Плагин не тянет зависимостей, не требует сложной связки и решает конкретную задачу. Поставил, настроил действия, добавил свои probe при необходимости и дальше просто следишь за историей.

Если вы собираете сервер для игры с друзьями или небольшой проект, такой плагин тоже имеет смысл. Особенно когда один "умник" с чит-клиентом может испортить экономику, рейды или PvP. И да, если планируете онлайн с друзьями, плагин должен нормально встать на BungeeHost (https://bungee.host), а для типичного Paper-сервера установка там обычно делается в 1 клик.

Важный нюанс

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

Ещё из практики: не ставьте сразу жёсткий бан на каждый детект без проверки. Лучше начать с warn или кика, посмотреть историю срабатываний, а уже потом включать более жёсткие меры. Так проще понять, нет ли ложных срабатываний именно на вашей сборке сервера и с вашим набором плагинов.

Что изменится на сервере после установки

Игроки с запрещёнными клиентскими модами начнут отсеиваться быстрее. Админу не придётся вручную вычислять каждый подозрительный вход. Можно настроить автоскан, периодический re-scan и историю, чтобы видеть, кто уже ловился раньше. Для персонала это экономит время. Для обычных игроков это честнее.

По сути Client Guard закрывает очень конкретный сценарий: сервер хочет резать известные чит-клиенты без клиентского мода и без лишней возни. Если вам нужен именно такой инструмент для Paper 1.21+, скачать Client Guard стоит хотя бы ради теста на своём проекте. Для серверов, где важны чистое выживание и контроль над читерами, это выглядит как вещь из разряда must-have.