AntiSpoof - защита от подделки клиентов на вашем сервере

AntiSpoof - это плагин для Minecraft (Spigot/Paper 1.20.4+), который помогает администраторам выявлять игроков, использующих модифицированные клиенты, но выдающих себя за ванильных. В мире Майнкрафта многие читеры используют хаки вроде Wurst, Meteor, Impact - они меняют бренд клиента и регистрируют служебные каналы, чтобы обмануть античиты. AntiSpoof ловит их на этом, анализируя, какие данные передаёт клиент при входе и в процессе игры.

Плагин не заменяет полноценный античит, но здорово дополняет его, закрывая дыру со спуфингом. Если вы хотите, чтобы на сервере играли только с ванильным клиентом или разрешёнными модами - AntiSpoof даёт для этого гибкие настройки.

---

Основные возможности

Анализ бренда клиента

• Блокировка или разрешение конкретных клиентов (Fabric, Forge, Lunar Client и т.д.)
• Регулярные выражения для поиска подозрительных паттернов в названии бренда
• Выявление Java-игроков, которые притворяются Bedrock-клиентами (Geyser)

Мониторинг каналов

• Проверка: если игрок пишет "vanilla", но при этом регистрирует плагин-каналы - это явный признак спуфинга
• Белый/чёрный список каналов с поддержкой regex
• Строгая проверка: для определённого клиента можно требовать наличие конкретных каналов

Работа с Bedrock-игроками

• Интеграция с Floodgate API
• Определение Bedrock-игроков по префиксу ника
• Настройка: можно игнорировать или освобождать таких игроков от проверок

Дополнительные инструменты

• Команды для проверки любого игрока в реальном времени
• Логирование в консоль при включённом режиме отладки
• Интеграция с Discord (вебхуки) - оповещения о нарушениях
• Поддержка PlaceholderAPI - можно выводить информацию о клиенте на табло, в чат и т.д.

Гибкое форматирование сообщений

Плагин использует движок MiniMessage, поэтому можно смешивать градиенты, жирный шрифт, курсив и старые цветовые коды &. Все сообщения настраиваются в конфиге.

---

Что умеет, а что нет

AntiSpoof может:

• Поймать 95% читеров, которые не умеют правильно подделывать бренд и каналы
• Заблокировать или разрешить конкретные клиенты через regex
• Выявить игроков, которые "ваннила", но имеют каналы
• Отсечь Java-игроков под видом Bedrock
• Создать гибкие политики безопасности под ваш сервер

AntiSpoof не может:

• Остановить опытного хакера с кастомным клиентом, который идеально подделывает бренд и каналы (но это редкость)
• Определять VPN или альт-аккаунты
• Заменить полноценный античит (не ловит киллауру, флайхаки и т.п.)
• Гарантировать 100% защиту - ни один античит этого не может

---

Установка

Требования:

• Java 21+
• Spigot, Paper или совместимая сборка (1.20.4+)
• Права на установку плагинов

Опционально:

• Floodgate (для лучшего определения Bedrock)
• PlaceholderAPI (для плейсхолдеров)
• ViaVersion / ViaBackwards (для совместимости версий)
• PacketEvents 2.7.1+ (только для Lite-версии)

AntiSpoof доступен в двух вариантах:

Full-версия (рекомендуется) - всё в одном JAR, PacketEvents уже встроен. Просто кидаете в plugins и перезапускаете сервер.

Lite-версия - для тех, у кого уже есть PacketEvents от других плагинов. Меньше размер, нет дублирования библиотек. Требуется отдельно установить PacketEvents 2.7.1+.

Функционально версии одинаковы. После установки сгенерируется plugins/AntiSpoof/config.yml. Настройте под себя и примените команду /antispoof reload.

---

Команды и разрешения

Команда	Описание	Право
/antispoof check [игрок]	Проверить игрока на спуфинг (без указания - всех онлайн)	antispoof.command
/antispoof runcheck [игрок]	Перезапустить проверку для игрока (полезно после смены конфига)	antispoof.admin
/antispoof channels <игрок>	Показать зарегистрированные каналы игрока	antispoof.command
/antispoof brand <игрок>	Показать бренд клиента игрока	antispoof.command
/antispoof reload	Перезагрузить конфиг	antispoof.admin
/antispoof blockedchannels	Показать текущий список заблокированных/разрешённых каналов	antispoof.admin
/antispoof blockedbrands	Показать текущий список заблокированных/разрешённых брендов	antispoof.admin
/antispoof help	Справка по всем командам	antispoof.command

Права:

• antispoof.command - базовые команды (по умолчанию op)
• antispoof.admin - админские команды (reload и т.д.)
• antispoof.alerts - получать оповещения в игре (op)
• antispoof.bypass - игнорировать все проверки (false)

---

Интеграция с PlaceholderAPI

Плагин регистрирует плейсхолдеры автоматически. Можно использовать в любых плагинах, поддерживающих PlaceholderAPI.

Плейсхолдер	Описание	Пример вывода
%antispoof_brand%	Бренд клиента игрока	vanilla, fabric, lunarclient:v1.8.9-10b0
%antispoof_channels%	Список каналов через запятую	minecraft:brand, fabric:registry/sync
%antispoof_channels_count%	Количество каналов	5
%antispoof_is_spoofing%	Обнаружен ли спуфинг	true или false
%antispoof_is_bedrock%	Игрок с Bedrock?	true или false

Пример использования в чате:

[%antispoof_brand%] %player_name%: %message%

---

Конфигурация: что важно знать

Файл config.yml содержит подробные комментарии на английском, но мы переведём ключевые моменты.

Основные настройки:

• delay-in-seconds - задержка перед проверкой после входа (по умолчанию 1 секунда). Ставьте 0, если проверка нужна сразу, но может быть ненадёжно.
• debug: false - включите, чтобы в консоль выводились все бренды и каналы при подключении игроков. Помогает при настройке.

Проверка на ванильный спуфинг (vanillaspoof-check):

• Если игрок говорит "vanilla", но у него есть плагин-каналы - он ловится.
• Можно настроить наказание (кик, бан) или просто оповещение.
• Discord-оповещения включаются отдельно.

Супер-строгий режим (non-vanilla-check):

• Не рекомендуется, так как блокирует всех, у кого не "vanilla" или есть каналы. Может задеть легитимные моды.
• По умолчанию выключен.

Фильтрация каналов и брендов - через регулярные выражения. Можно заблокировать, например, все каналы Fabric, а Lunar Client разрешить.

Система брендов клиентов (client-brands):

• Позволяет задать для каждого клиента свои правила: флаг, оповещение, наказание, обязательные каналы.
• Например, для Lunar Client можно указать, что он считается легитимным, но если у него нет каналов Lunar - это спуфинг.

Discord-интеграция:

• Укажите URL вебхука и формат сообщения. Можно отправлять оповещения о нарушениях.

Пример настройки для Lunar Client:

lunar:
  enabled: true
  values:
    - "^lunarclient:v\\d+\\.\\d+\\.\\d+-\\d{4}$"
  flag: false
  alert: true
  discord-alert: false
  alert-message: "&8[&eAntiSpoof&8] &7%player% использует &9Lunar Client &7версия: &b%brand%"
  punish: false
  punishments: []
  required-channels:
    - "lunar.*"
  required-channels-punish: false
  required-channels-punishments:
    - "kick %player% &cОбнаружен спуфинг Lunar Client"

Подобные настройки можно создать для любого клиента.

---

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

1. Когда игрок заходит на сервер, он отправляет пакет с брендом клиента (например, "vanilla", "fabric"). AntiSpoof перехватывает его и сравнивает с вашими правилами.
2. Модифицированные клиенты регистрируют плагин-каналы - это способ общения мода с сервером. У ванильного клиента каналов нет. Если игрок пишет "vanilla", но каналы есть - он явно врёт.
3. Через регулярные выражения плагин определяет конкретный тип клиента или блокирует подозрительные паттерны.
4. Для Geyser/Floodgate проверяется, действительно ли игрок с Bedrock, или это Java-читер маскируется.
5. Проверки не ограничиваются моментом входа - AntiSpoof продолжает следить за регистрацией новых каналов в течение сессии.

---

Важно знать

• Full или Lite? Если у вас нет других плагинов с PacketEvents - берите Full. Если есть (например, другие античиты) - Lite, чтобы не было конфликтов библиотек.
• Что такое "ванильный клиент"? Это оригинальный лаунчер Mojang без модов. Он отправляет бренд "vanilla" и не имеет ни одного плагин-канала.
• Совместимость с ViaVersion - полная. AntiSpoof даже может использовать данные ViaVersion для улучшения обнаружения.
• Производительность - плагин очень лёгкий. Проверки происходят только при входе и при регистрации каналов, что бывает нечасто.
• Обход - опытный программист с кастомным клиентом может подделать всё идеально. Но таких единицы. Для 99% читеров AntiSpoof - непреодолимая преграда.

Если вы администратор и хотите отсеять массовых читеров, которые не заморачиваются со спуфингом - этот плагин станет отличным дополнением к вашему античиту. Скачайте AntiSpoof и настройте под свой сервер - игроки с хаками быстро уйдут искать другой сервер.