ProxyTracer LogoProxyTracer
Skip to Content
DocumentationПлатформы и CMSMinecraft-серверы

Minecraft Серверы (Paper, Velocity и Bungee)

Блокируйте VPN и прокси-соединения до того, как они войдут в ваш игровой мир.

Официальный плагин обнаружения VPN, прокси, дата-центров и Tor для серверов Minecraft (поддерживает Spigot, Paper, Purpur, Velocity и BungeeCord / Waterfall). Предотвращает обход банов, защищает от ботнетов и бот-атак (включая L7-атаки) с субмиллисекундным временем выполнения проверок.

Предпросмотр

Экран блокировки в игреОповещение в консоли
Minecraft Kick ScreenConsole Warning Log

Почему ProxyTracer?

  • Обнаружение в реальном времени: Точные проверки по постоянно обновляемым базам резидентных и публичных VPN от ProxyTracer.
  • Поддержка разных платформ: Нативные интеграции для одиночных серверов (Paper/Spigot) и сетей (Velocity или BungeeCord/Waterfall).
  • Высокая производительность: Встроенное кэширование в оперативной памяти экономит кредиты API и гарантирует мгновенное подключение для возвращающихся игроков.
  • Умный вайтлист (Whitelist): Команды обхода проверок для доверенных никнеймов и IP-адресов сети.
  • Discord-оповещения: Логируйте заблокированные VPN-подключения прямо в каналы стаффа.
  • Брендированный экран блокировки (Kick Screen): Показывает игрокам профессиональное сообщение о блокировке со ссылкой на proxytracer.com.

Какой jar-файл установить?

Ваша архитектураУстановите этот jar-файлРасположениеДействие
Одиночный сервер Paper / Spigot / Purpurproxytracer-bukkit-1.4.0.jarplugins/ игрового сервера Скачать
Прокси-сеть Velocityproxytracer-velocity-1.4.0.jarplugins/ прокси-сервера (Не устанавливайте на Paper) Скачать
Сеть BungeeCord / Waterfallproxytracer-bungee-1.4.0.jarplugins/ прокси-сервера (Не устанавливайте на Paper) Скачать
Правило: Устанавливайте ProxyTracer там, где виден реальный IP клиента. Если вы используете прокси-сеть (Velocity или BungeeCord), установите плагин ТОЛЬКО на прокси-сервер.

Быстрая настройка (60 секунд)

  1. Получите бесплатный API-ключ: ProxyTracer.com/dashboard
  2. Скачайте нужный jar-файл для вашей сборки из раздела Releases.
  3. Поместите jar-файл в папку plugins/ вашего сервера и запустите его один раз.
  4. Установите ваш API-ключ прямо в игре или через консоль: 
    /proxytracer set your_api_key_here
    (Это действие автоматически сохранит ключ в конфигурационный файл и перезагрузит плагин)
  5. Проверьте соединение, выполнив: /proxytracer status

Главное о конфигурации

mode: "block"          # Действие при обнаружении прокси: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # Политика fail-open при отключении API: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # Отправлять цветные сообщения в игровом чате персоналу (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # Кэшировать результат проверки IP на 24 часа
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

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

Все команды начинаются с префикса /proxytracer:

  • /proxytracer notify <on|off|toggle> — Включить или выключить цветные уведомления в чате для персонала.
  • /proxytracer notify add|remove|list [player] — Добавить, удалить или просмотреть список персонала для уведомлений.
  • /proxytracer set <api_key> — Установить API-ключ напрямую с сохранением в config.yml.
  • /proxytracer status — Проверить статус конфигурации, учетные данные API и состояние кэша.
  • /proxytracer check <ip> — Вручную проверить IP-адрес.
  • /proxytracer cache clear — Очистить локальный кэш IP-адресов.
  • /proxytracer reload — Перезагрузить конфигурационный файл.
  • /proxytracer whitelist name add|remove|list [player] — Исключить игроков из проверок.
  • /proxytracer whitelist ip add|remove|list [ip] — Исключить IP-адреса сети из проверок.

Разрешения (Permissions):

  • proxytracer.admin — Доступ к командам перезагрузки, статуса и администрирования.
  • proxytracer.bypass — Игроки с этим правом обходят проверки при подключении (pre-login).
  • proxytracer.notify — Персонал получает игровые предупреждения, когда пользователь VPN логируется или получает предупреждение.

(Примечание: По умолчанию эти права назначаются только операторам сервера (OP). Чтобы выдать их другим игрокам или группам персонала, используйте плагин управления правами, такой как LuckPerms).

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

  • Версия Java: Java 17 или выше (полностью протестировано на Java 17, 21 и 22). Плагин скомпилирован под Java 17.
  • Поддерживаемые ядра: Paper / Spigot / Purpur (от 1.13 до 1.21.x), Velocity (3.x) и BungeeCord / Waterfall (современные билды).
  • Доступ к API: Бесплатный или платный API-ключ, зарегистрированный на proxytracer.com.

Решение проблем: Ошибки реального IP (127.0.0.1)

Если в логах видно, что все игроки подключаются с адреса 127.0.0.1, API ProxyTracer не сможет их проверить. Это означает, что сетевая архитектура вашего хостинга или фронт-энд прокси маскирует входящие IP игроков.

Как исправить:

  1. Для прокси-сетей (Velocity / Bungee): Развертывайте ProxyTracer только на шлюзовом прокси (Velocity/Bungee). Убедитесь, что пересылка информации об игроке активна (player-info-forwarding-mode = "modern" в velocity.toml или ip_forward: true в config.yml Bungee), чтобы внутренние игровые узлы получали реальный IP.
  2. Для виртуального хостинга (например, прокси панелей TickHosting): Если ваш хостинг пересылает заголовки подключения через Proxy Protocol, включите его в конфигурации Paper (proxies.proxy-protocol: true в config/paper-global.yml) и перезапустите. Внимание: Не включайте это, если ваш хостинг не поддерживает данный протокол напрямую; неправильная настройка заблокирует вход для всех игроков.

Тарифы и квоты API

Minecraft-плагины ProxyTracer на 100% бесплатны. Однако для обнаружения требуется подключение к API ProxyTracer:

- Free (Бесплатно): 100 проверок в месяц для небольших SMP и разработки.
- Starter (€3/мес): Отлично подходит для растущих публичных серверов.
- Pro (€9/мес) / Scale (€39/мес): Предназначены для крупных сетей.

Создайте ключ и выберите тарифный план: ProxyTracer

Последнее обновление:
Flarum