ServerSeekerBlocker

Плагин ServerSeekerBlocker для Minecraft — блокировка сканеров серверо

ServerSeekerBlocker — это плагин для серверных платформ Paper и Purpur, предназначенный для защиты приватных и полуприватных серверов от ботов-сканеров, таких как ServerSeeker. Плагин перехватывает попытки подключения на самом раннем этапе, не давая игроку полноценно присоединиться к серверу. Это обеспечивает полную тишину: в консоли и логах не появляются сообщения о попытках входа, а заблокированные IP-адреса не видят сервер в списке мультиплеера (ping hiding). Инструмент позволяет блокировать пользователей по имени, IP или UUID, перенаправлять их на другие серверы и фильтровать логи для удаления следов попыток подключения.

Угроза сканирования и решение

Серверы Minecraft, особенно приватные или закрытые, часто становятся мишенью для автоматизированных сканеров, таких как ServerSeeker. Эти инструменты массово проверяют интернет на наличие открытых серверов, вступают с ними в соединение, собирают данные о сервере и игроках, а затем покидают его. По умолчанию сервер записывает каждую такую попытку в логи, что может раскрыть информацию о закрытых проектах.

ServerSeekerBlocker решает эту проблему, перехватывая соединение до того, как игрок полностью присоединится к серверу. Блокировка происходит на уровне события AsyncPlayerPreLoginEvent. В результате:

• Не формируется сообщение «joined the game».
• В консоль и файлы логов ничего не пишется.
• Для заблокированных IP-адресов сервер выглядит полностью недоступным в списке мультиплеера.

🔇 Режимы работы и скрытность

Плагин предлагает несколько методов защиты, которые можно включать и выключать независимо друг от друга:

• Тихая блокировка (Silent blocking): Игроки получают отказ на стадии пред-логина. Никаких сообщений в чате, консоли или логах.
• Скрытие пинга (Ping hiding): Когда заблокированный IP пытается отправить запрос о статусе сервера из мультиплеера, ответ игнорируется. Сервер для этого клиента выглядит как оффлайн.
• Перенаправление (Transfer mode): Вместо отключения, заблокированный игрок мгновенно перенаправляется на другой сервер с помощью встроенного пакета Transfer Minecraft.
• Подавление логов (Log suppression): Фильтр Log4j2 перехватывает любые сообщения, содержащие заблокированные имена или IP, не давая им попасть в консоль или файл логов.

🛠️ Настройка конфигурации

Основная работа плагина настраивается через файл config.yml. Плагин автоматически извлекает языковые файлы в папку plugins/ServerSeekerBlocker/lang/ при первом запуске. В настройках можно управлять следующими параметрами:

• **Блокировка по имени (blocking.name):** Включает или выключает блокировку по списку имен игроков.
• **Блокировка по IP (blocking.ip):** Позволяет добавлять конкретные IP-адреса в черный список.
• **Блокировка по UUID (blocking.uuid):** Блокировка по уникальному идентификатору игрока.
• **Перенаправление (transfer):** При включении (enabled: true) вместо бана игрок перенаправляется на сервер, указанный в host и port.
• **Подавление логов (suppress-logs):** Фильтрует сообщения о попытках подключения из консоли.
• **Обновления (update-checker):** Периодически проверяет наличие новых версий на Modrinth и уведомляет администраторов.

Важно: список имен, IP и UUID хранится внутри конфигурационного файла, поэтому при перенастройке необходимо вручную редактировать config.yml или использовать команды для добавления/удаления записей.

Параметры конфигурации config.yml

📋 Управление командами

Для оперативного управления списком заблокированных пользователей и проверки состояния плагина доступны следующие команды (доступны пользователям с правом OP):

• /ssb info — Показывает текущую версию плагина, последнюю доступную версию на Modrinth и статус всех включенных функций.
• /ssb reload — Перезагружает конфигурацию без остановки сервера. Выводит цветовой дифф, показывающий, какие именно настройки изменились.
• /ssb ban — Добавляет игрока в список блокировки по имени и сохраняет изменения.
• /ssb pardon — Удаляет игрока из списка блокировки.
• /ssb ban-ip — Добавляет IP-адрес в черный список.
• /ssb pardon-ip — Удаляет IP-адрес из черного списка.
• /ssb ban-uuid — Автоматически находит UUID игрока по его текущему имени и добавляет его в список блокировки.
• /ssb pardon-uuid — Удаляет игрока из списка блокировки по UUID.

Команды с UUID удобны тем, что блокировка привязывается к уникальному идентификатору, а не к имени. Если игрок сменит никнейм, он останется заблокированным. На серверах в режиме оффлайн UUID вычисляется локально по имени.

Примеры команд для управления блокировкой

/ssb ban Steve
/ssb pardon Notch
/ssb ban-ip 192.168.1.1
/ssb ban-uuid Steve
/ssb pardon-uuid Steve

🌍 Поддержка языков

Плагин поддерживает многоязычные сообщения. При первом запуске файлы переводов автоматически распаковываются в папку plugins/ServerSeekerBlocker/lang/. В конфигурации можно выбрать язык, используя ключ language (по умолчанию en_US).

В комплекте поставляются:

• en_US — Английский язык.
• ko_KR — Корейский язык.

Для добавления поддержки нового языка необходимо создать файл lang/ваш_язык.yml с ключами, соответствующими структуре существующих файлов, и указать его имя в настройках config.yml.

⚙️ Принцип работы механизмов

Плагин функционирует на разных этапах жизненного цикла подключения:

1. Режим блокировки (Block mode): При transfer.enabled: false плагин перехватывает событие AsyncPlayerPreLoginEvent. Это происходит до того, как игрок полностью войдет в игру. Никаких сообщений о входе не формируется.
2. Режим перенаправления (Transfer mode): При transfer.enabled: true событие перехватывается на уровне PlayerJoinEvent. Сообщение о входе подавляется, а клиент получает пакет перенаправления на целевой сервер.
3. Скрытие пинга: Плагин проверяет только список IP-адресов на этапе отклика на пинг. Имена и UUID на этом этапе недоступны.
4. Фильтрация логов: Фильтр Log4j2 устанавливается при старте и перехватывает сообщения на корневом уровне логгера. Если в сообщении обнаруживаются заблокированные данные, оно не доходит до вывода.

Обратите внимание: при блокировке соединения сервер может выводить промежуточные сообщения о разрыве (например, Disconnecting Foo (/1.2.3.4)), которые не содержат UUID. Плагин отслеживает такие попытки в течение 30 секунд и также фильтрует их, если в них присутствуют имя или IP.

🔍 Обновления и уведомления

В плагин встроен автоматический проверщик обновлений (update-checker). Он запускается сразу после старта сервера и затем каждые 6 часов, запрашивая API Modrinth. Если новая версия плагина доступна, сообщение о ней выводится в консоль (один раз при каждом запуске) и показывается каждому администратору при входе в чат. Ссылка на скачивание в чате кликабельна и ведет на страницу проекта на Modrinth.

⚠️ Оговорки и ограничения

ServerSeekerBlocker — это компактный плагин, не требующий внешних зависимостей. Он разработан специально для платформ Paper и Purpur и не совместим с CraftBukkit или Spigot. Поддерживает версии игры начиная с 1.20.6.

Важные оговорки:

• Плагин работает только на стороне сервера.
• Для корректной работы требуется Java 21 или новее.
• Блокировка по имени и UUID не работает на этапе отклика на пинг, доступен только список IP.
• При использовании режима перенаправления необходимо корректно указать адрес и порт целевого сервера в конфигурации.