Protectcord (Протекткорд)

Мод для Майнкрафт для сервера, который проверяет подключения по IP и помогает защититься от VPN, прокси, ботов и обхода банов. В него также входят инструменты модерации, фильтрация чата и синхронизация наказаний между серверами.

Возможности

• Проверяет IP игрока через базу угроз, распознаёт VPN, прокси, Tor, адреса дата-центров и некорректные диапазоны IP.
• Блокирует подключения по заданному уровню риска, странам, числу одновременных аккаунтов с одного IP или отметкам аккаунта.
• Поддерживает белый список по нику, UUID и IP; адреса в выводе для модераторов можно маскировать.
• Выдаёт предупреждения, кики, муты, временные муты, баны и временные баны, в том числе офлайн-игрокам. Для предупреждений настраивается автоматическая эскалация наказаний и срок действия.
• Команда /pc alts <игрок> ищет дополнительные аккаунты с общим IP и показывает только ники, без самих адресов.
• AutoMod фильтрует ссылки, рекламу серверов и приглашения Discord, спам, повторы сообщений и символов, капс, запрещённые слова, невидимые символы и текст Zalgo. Для каждого правила выбирается действие: BLOCK, WARN, KICK, MUTE или TEMPMUTE.
• Игроки могут отправлять жалобы через /report [игрок] <причина>, а персонал получает уведомления в игре и при необходимости через вебхук Discord.
• Данные можно хранить в YAML или MySQL. Общая база MySQL синхронизирует баны и муты между серверами сети.

Как пользоваться

В plugins/ProtectCord/config.yml укажите ключ в api-key, затем примените настройки командой /pc reload. На Velocity используется config.toml, а на Forge — config/protectcord-forge.toml.

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

• /pc check <игрок|ip> — проверить угрозы для игрока или IP.
• /pc whitelist add player <ник> — добавить игрока в белый список.
• /pc whitelist add uuid <uuid> и /pc whitelist add ip <адрес> — добавить UUID или IP в белый список.
• /pc warn <игрок> <причина>, /pc ban <игрок> <причина>, /pc mute <игрок> <причина> — выдать наказание.
• /pc tempban <игрок> <срок> <причина> и /pc tempmute <игрок> <срок> <причина> — временно забанить или замутить; сроки записываются в виде 1h, 7d, 30d.
• /pc warnings <игрок> — посмотреть историю предупреждений.
• /pc migrate <yaml|mysql> — перенести данные между YAML и MySQL.
• /pc purge <тип> <дни> — очистить старые записи; доступны warnings, bans, mutes, iplogs, auditlog, inactive и all.

Настройки

В разделе enable-ip-check включается проверка IP, а параметры block-vpn, block-proxy, block-tor, block-datacenter и block-bogon определяют, какие подключения блокировать. Для проверки по общему уровню угроз включите enable-risk-level-blocking и задайте blocked-risk-level.

Географическая фильтрация настраивается в geo-blocking: режим blacklist блокирует перечисленные страны, а whitelist пропускает только их. Ограничение аккаунтов с одного IP задаётся в account-per-ip-limit.

Для сети серверов укажите database.type: "MYSQL" и одинаковые параметры базы на всех серверах. Вебхуки Discord, сообщения игрокам, уведомления персоналу и правила AutoMod также настраиваются в конфиге.

Требования и совместимость

Работает на Paper, Spigot, Folia, BungeeCord, Velocity и Forge. Для проверки подключений нужен ключ API ProtectCord. В сети с прокси BungeeCord или Velocity мод следует ставить на прокси: тогда он защитит все подключённые серверы.

На Forge проверка выполняется после входа игрока. Проверки IP выполняются асинхронно и не задерживают основной поток сервера.