ProtectCord - продвинутая защита IP и модерация

Блокирует VPN, прокси, ботов и подозрительные подключения в реальном времени. Встроенная модерация, AutoMod-фильтр чата, детект альтов и синхронизация между серверами через MySQL - всё в одном лёгком плагине.

ProtectCord проверяет каждого подключающегося игрока по базе угроз в реальном времени, ещё до того как он попадёт на сервер. В комплекте идёт полноценный набор инструментов для модерации - это единственное, что нужно для чистоты и безопасности вашего сервера.

Ключевые возможности

Защита IP

• Проверка IP в реальном времени - каждое подключение сверяется с базой угроз
• Блокировка VPN, прокси и Tor - остановите баноеврейдеров и альтов мгновенно
• Детект датацентров - блокировка IP хостинг-провайдеров, которые часто используют боты
• Блокировка по уровню риска - настраиваемые уровни: UNKNOWN → LOW → MEDIUM → HIGH → CRITICAL
• Геоблокировка - блокировка или вайтлист целых стран по ISO-кодам
• Лимит аккаунтов на один IP - ограничение одновременных подключений с одного адреса
• Умный вайтлист - обход защиты по имени игрока, UUID или IP

Модерация

• Прогрессивная система предупреждений - настраиваемая автоэскалация от предупреждения до кика или бана
• Временные баны и муты - наказания с читаемым форматом времени (1h, 7d, 30d)
• Система мутов - постоянные муты с причиной, указанием кто выдал и автоистечением
• Детект альтов - поиск альтов по общему IP (/pc alts <игрок>) - показываются только ники, никогда сырые IP
• История предупреждений - полный лог с временными метками для любого игрока (онлайн или оффлайн)
• Очистка предупреждений - удаление отдельных записей по индексу или всех сразу
• Журнал аудита - автоматическая запись всех действий модерации
• Поддержка оффлайн-игроков - предупреждение, бан, мут или проверка игроков не в сети

AutoMod (фильтр чата)

• Анти-ссылки - блокировка URL с возможностью вайтлиста доменов
• Анти-реклама - блокировка IP других серверов и приглашений Discord
• Анти-спам - ограничение частоты сообщений и детект дубликатов
• Анти-мат - чёрный список слов с поддержкой regex и исключений
• Анти-капс - настраиваемый порог заглавных букв в процентах
• Анти-флуд - блокировка повторяющихся символов
• Анти-юникод/Zalgo - блокировка невидимого текста и злоупотребления символами
• Действия на каждое правило - каждое правило независимо настраивается на: BLOCK, WARN, KICK, MUTE или TEMPMUTE

Хранилище и мультисервер

• YAML-файлы - без настройки, работает сразу
• MySQL - полноценная поддержка с пулом соединений HikariCP
• Синхронизация между серверами - одна база MySQL для всей сети; баны и муты действуют на всех серверах
• Миграция на лету - переключение между YAML и MySQL в любой момент командой /pc migrate
• Очистка данных - удаление старых предупреждений, банов, мутов, IP-логов, записей аудита и неактивных игроков через /pc purge

Инструменты для персонала

• Оповещения в игре - уведомления в реальном времени о киках, банах, предупреждениях, мутах, срабатываниях AutoMod и т.д.
• Маскировка IP - показ персоналу скрытых IP (192.168.1.*) до получения права protectcord.ip.full
• Репорты от игроков - игроки отправляют жалобы через /report; персонал получает уведомления в игре и через Discord
• Статистика API - проверка использования, лимитов и здоровья API через /pc stats
• Ручная проверка IP - /pc check <игрок|ip> для анализа угроз по запросу

Платформы и интеграция

• Поддержка 6 платформ - Paper, Spigot, Folia, BungeeCord, Velocity и Forge
• Discord Webhooks - богатые встраиваемые сообщения с флагом страны, городом, флагами VPN/прокси/Tor/уровнем риска; по-событийное управление, ограничение частоты и повторные попытки
• Webhook для событий модерации - отдельный канал для банов/варнов/мутов/киков
• Полностью асинхронно - все проверки IP не блокируют основной поток

Поддерживаемые платформы

Платформа	Версии	Примечания
Paper	1.13 - 1.21+	Рекомендуется для одиночных серверов
Spigot	1.8.8 - 1.21+	Полная поддержка старых версий
Folia	1.19+	Поддержка многопоточного планировщика
Velocity	3.0+	Рекомендуется для прокси-сетей
BungeeCord	1.8.8 - 1.21+	Совместим с Waterfall
Forge	1.20.1+	Только серверная сторона; проверка после входа

Совет по сети: устанавливайте только на прокси (Velocity/BungeeCord), чтобы защитить все бэкенд-серверы одним API-ключом.

Быстрая настройка

1. Получите бесплатный API-ключ (регистрация на сайте разработчика)
2. Скачайте JAR для вашей платформы и поместите в папку plugins/ (или mods/ для Forge)
3. Запустите сервер - конфиг создастся автоматически
4. Добавьте API-ключ в plugins/ProtectCord/config.yml
5. Выполните /protectcord reload или перезапустите сервер
6. Ваш сервер защищён

Команды и права

Алиасы: /pc, /protect

Основные команды

Команда	Описание
/pc reload	Перезагрузить конфиг, вайтлист и хранилище
/pc stats	Просмотр использования API и лимитов
/pc check <игрок|ip>	Анализ угроз IP по запросу
/pc version	Версия плагина и информация о платформе
/pc health	Проверка соединения с API
/pc alerts	Включить/выключить оповещения персонала в игре

Команды вайтлиста

Команда	Описание
/pc whitelist add player <имя>	Добавить игрока по нику
/pc whitelist add uuid <uuid>	Добавить по UUID
/pc whitelist add ip <адрес>	Добавить IP-адрес
/pc whitelist remove <тип> <значение>	Удалить запись из вайтлиста
/pc list	Список всех записей вайтлиста

Команды модерации

Команда	Описание
/pc kick <игрок> [причина]	Кикнуть игрока с информацией об IP
/pc warn <игрок> <причина>	Выдать предупреждение (автоэскалация)
/pc warnings <игрок>	Просмотр истории предупреждений
/pc clear warning <игрок>	Очистить все предупреждения
/pc clear ban <игрок>	Очистить запись бана
/pc remove warning <игрок> [#]	Удалить конкретное предупреждение по индексу
/pc ban <игрок> <причина>	Забанить навсегда
/pc tempban <игрок> <длительность> <причина>	Временный бан (1h, 7d, 30d)
/pc unban <игрок>	Разбанить
/pc mute <игрок> <причина>	Замутить навсегда
/pc tempmute <игрок> <длительность> <причина>	Временный мут
/pc unmute <игрок>	Снять мут
/pc alts <игрок>	Найти альты по общему IP

Команды хранилища

Команда	Описание
/pc migrate <yaml|mysql>	Мигрировать данные между хранилищами
/pc purge <тип> <дни>	Удалить данные старше X дней

Типы очистки: warnings, bans, mutes, iplogs, auditlog, inactive, all

Команды игроков

Команда	Описание
/report [игрок] <причина>	Пожаловаться на игрока (или анонимно)

Права (permissions)

Право	Описание	По умолчанию
protectcord.admin	Все команды /pc	OP
protectcord.bypass	Обход проверок IP при входе	false
protectcord.alerts	Получение оповещений персонала в игре	OP
protectcord.ip.full	Видеть полные IP в выводе команд	OP
protectcord.automod.bypass.*	Обход всех проверок AutoMod	false

Прогрессивная система предупреждений

Автоматическая эскалация наказаний по количеству предупреждений. Два режима:

Простой режим (по умолчанию)

Предупреждение	Действие
1-е	Сообщение в чате
2-е	Кик с "последним предупреждением"
3-е	Перманентный бан

Режим уровней эскалации (настраиваемый)

Полностью кастомная эскалация - любая комбинация WARN → TEMPMUTE → TEMPBAN → BAN:

1 предупреждение → сообщение
2 предупреждения → временный мут (1 час)
3 предупреждения → временный бан (1 день)
4 предупреждения → временный бан (7 дней)
5 предупреждений → перманентный бан

Предупреждения могут автоматически истекать через заданное время (7d, 30d и т.д.), чтобы прошлые нарушения не висели вечно.

AutoMod - автоматическая фильтрация чата

Защитите чат без лишних действий. Каждое правило AutoMod работает независимо и может быть настроено на BLOCK, WARN, KICK, MUTE или TEMPMUTE.

Правило	Что ловит
Anti-Link	URL-адреса с возможностью вайтлиста доменов
Anti-Advertising	IP других серверов, приглашения Discord
Anti-Spam	Частота сообщений и дубликаты
Anti-Swear	Пользовательский список слов с regex и исключениями
Anti-Caps	Чрезмерное использование заглавных букв (в процентах)
Anti-Flood	Повторяющиеся символы
Anti-Unicode	Zalgo-текст и невидимые символы

Детект альтов

Находите игроков, которые обходят баны или используют несколько аккаунтов, одной командой:

/pc alts Notch
→ [ProtectCord] Альты для Notch:
  - Notch2 (общих IP: 2)
  - AltAccount99 (общих IP: 1)

IP-адреса никогда не показываются в выводе - персонал видит только ники, что защищает приватность.

MySQL и мультисерверная синхронизация

Храните все данные (предупреждения, баны, муты, историю IP, журнал аудита) в MySQL вместо локальных YAML-файлов.

• Все серверы используют одну базу - бан на Factions действует и на Survival
• Пул соединений HikariCP - высокая производительность и потокобезопасность
• Автосоздание таблиц при первом запуске
• Каждая запись помечается server_id - откуда пришло действие
• Миграция на лету: /pc migrate mysql

Очистка данных

/pc purge warnings  90   - удалить предупреждения старше 90 дней
/pc purge bans      30   - удалить истёкшие баны старше 30 дней
/pc purge mutes     30   - удалить истёкшие муты старше 30 дней
/pc purge iplogs   365   - удалить историю IP старше года
/pc purge auditlog  90   - обрезать журнал аудита
/pc purge inactive 180   - удалить записи игроков неактивных 6 месяцев
/pc purge all       90   - выполнить всё вышеперечисленное

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

Webhook подключений

Получайте богатые Discord-встраивания каждый раз, когда игрок заблокирован, принят или пропущен по вайтлисту:

• Страна с флагом, город, флаги VPN/прокси/Tor/датацентр/bogon, уровень риска, провайдер
• По-событийное управление: какие события отправлять и какие поля показывать
• Ограничение частоты запросов и повторные попытки при ошибках
• Настраиваемый внешний вид каждого типа встраивания (цвет, заголовок, эмодзи)

Webhook событий модерации

Отдельный канал для уведомлений персонала о банах/варнах/мутах/киках.

Конфигурация (основные моменты)

Файл конфигурации создаётся автоматически при первом запуске в plugins/ProtectCord/config.yml. Для Velocity используется config.toml, для Forge - config/protectcord-forge.toml.

Основные разделы:

• API Settings - ключ API, таймауты, повторные попытки при ошибках
• Server Identity - имя сервера, IP, порт, тип платформы
• Player Tracking - отслеживание игроков через API ProtectCord; блокировка помеченных или неактивных аккаунтов
• IP Protection - включение/выключение проверки IP; какие типы блокировать (VPN, прокси, Tor, датацентры, bogon); блокировка по уровню риска
• Geo-Blocking - чёрный или белый список стран по ISO-кодам
• Accounts Per IP - лимит одновременных подключений с одного IP; действие при превышении (блокировать нового или кикнуть старого)
• Discord Webhook - настройка вебхуков для событий подключения и модерации; ретраи, ограничение частоты, поля данных, кастомизация встраиваний
• Staff Alerts - оповещения персонала в игре и через Discord; какие события вызывают оповещение
• Warning System - автоэскалация; кик при определённом количестве; срок действия предупреждений; уровни эскалации (WARN → TEMPMUTE → TEMPBAN → BAN)
• AutoMod - включение/выключение; действия для каждого правила; длительность TEMPMUTE; списки разрешённых доменов и слов
• Player Reports - кулдаун между репортами; вебхук для Discord; уведомление персонала; предопределённые причины
• Database Storage - выбор YAML или MySQL; настройки подключения к MySQL (хост, порт, база, пользователь, пароль); пул HikariCP
• IP Masking - маскировка IP в выводе команд для персонала без права protectcord.ip.full
• Custom Messages - все сообщения с поддержкой цветовых кодов &; плейсхолдеры для причины, уровня риска, лимитов и т.д.

ProtectCord - это не просто анти-VPN плагин, а полноценная система защиты и модерации для Minecraft-серверов. Он решает проблему баноеврейдеров, альтов и спама в чате, позволяя администраторам сосредоточиться на развитии сервера, а не на ручной модеризации.