Servidores de Minecraft (Paper, Velocity e Bungee)

Bloqueie conexões de VPN e proxy antes que entrem no seu mundo de jogo.

Pré-visualização

Tela de Expulsão no Jogo	Alerta de Aviso no Console

Por que escolher o ProxyTracer?

• Detecção em Tempo Real: Verificações precisas contra os bancos de dados constantemente atualizados de VPNs residenciais e públicas do ProxyTracer.
• Nativo Multi-Plataforma: Integrações dedicadas para servidores individuais (Paper/Spigot) e redes multi-servidores (Velocity ou BungeeCord/Waterfall).
• Alto Desempenho: Cache em memória integrado que economiza créditos de API e garante que jogadores recorrentes conectem instantaneamente.
• Lista de Permissões Inteligente: Comandos de bypass da whitelist para nomes de jogadores confiáveis e IPs de rede.
• Alertas no Discord: Registre entradas bloqueadas de VPN diretamente nos canais da sua equipe.
• Tela de Expulsão Personalizada: Apresenta aos jogadores uma mensagem de bloqueio profissional citando proxytracer.com.

Qual arquivo .jar devo instalar?

Configuração Rápida (60 Segundos)

1. Obtenha uma chave de API gratuita em: ProxyTracer.com/dashboard
2. Baixe o arquivo .jar correto para a sua configuração na página de Releases.
3. Coloque o arquivo .jar no diretório plugins/ do seu servidor e inicie-o uma vez.
4. Defina sua chave de API diretamente dentro do jogo ou pelo console:

   /proxytracer set your_api_key_here

   (Isso grava automaticamente a chave no seu arquivo de configuração e recarrega o plugin).
5. Verifique a conexão executando: /proxytracer status

Destaque de Configuração

mode: "block"          # Ação quando proxy for detectado: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # Política fail-open se a API ficar offline: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # Envie mensagens coloridas no chat do jogo para a equipe (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # Armazene o resultado da checagem de IP em cache por 24 horas
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

Comandos e Permissões

Todos os comandos utilizam o prefixo /proxytracer:

• /proxytracer notify <on|off|toggle> — Ativa/desativa mensagens coloridas de chat dentro do jogo para a equipe.
• /proxytracer notify add|remove|list [player] — Adiciona/remove/lista nomes de usuários da equipe autorizados a receber notificações no jogo (salvo automaticamente no config.yml).
• /proxytracer set <api_key> — Define a chave de API diretamente, salvando-a no config.yml e recarregando.
• /proxytracer status — Verifica o status da configuração, credenciais da API e estado das notificações no jogo.
• /proxytracer check <ip> — Consulta um endereço IP manualmente.
• /proxytracer cache clear — Limpa o cache local de IPs.
• /proxytracer reload — Recarrega o arquivo de configuração.
• /proxytracer whitelist name add|remove|list [player] — Isenta jogadores das verificações.
• /proxytracer whitelist ip add|remove|list [ip] — Isenta IPs de rede das verificações.

Permissões:

• proxytracer.admin — Acesso aos comandos de recarga, status e administração.
• proxytracer.bypass — Jogadores com esta permissão ignoram as exigências de verificação durante o pré-login.
• proxytracer.notify — A equipe recebe avisos dentro do jogo quando um usuário de VPN é registrado ou advertido.

(Nota: Por padrão, essas permissões são atribuídas apenas aos Operadores do servidor (OPs). Para conceder essas permissões a outros jogadores ou grupos da equipe, use um plugin gerenciador de permissões como o LuckPerms).

Compatibilidade e Requisitos

• Versão do Java: Java 17 ou superior (totalmente testado no Java 17, 21 e 22). O plugin é compilado com alvo no Java 17.
• Suporte a Softwares de Servidor: Paper / Spigot / Purpur (1.13 a 1.21.x), Velocity (3.x) e BungeeCord / Waterfall (builds modernas).
• Acesso à API: Uma chave de API gratuita ou paga registrada em proxytracer.com.

Solução de Problemas: Erro de IP Real (127.0.0.1)

Se os seus logs mostrarem todos os jogadores conectando a partir de 127.0.0.1, a API do ProxyTracer não conseguirá analisá-los. Isso indica que a topologia de rede da sua hospedagem ou o proxy de frontend está mascarando os IPs recebidos dos jogadores.

Como Corrigir:

1. Para Redes de Proxies (Velocity / Bungee): Implante o ProxyTracer apenas no proxy de entrada (gateway) (Velocity/Bungee). Certifique-se de que o encaminhamento de informações do jogador esteja ativo (player-info-forwarding-mode = "modern" no velocity.toml ou ip_forward: true no config.yml do Bungee) para que os nós de jogo do backend recebam o IP real.
2. Para Hospedagens Compartilhadas (ex.: proxies de painel TickHosting): Se o seu provedor repassar cabeçalhos de conexão via Proxy Protocol, ative-o na sua configuração do Paper (proxies.proxy-protocol: true no config/paper-global.yml) e reinicie. Aviso: Não ative esta opção a menos que sua hospedagem a suporte explicitamente; configurá-la incorretamente impedirá a entrada de todos os jogadores.

Preços e Cotas de API

Os plugins do ProxyTracer para Minecraft são 100% gratuitos. A detecção requer uma conexão com a API do ProxyTracer:

- Plano Gratuito: 100 verificações/mês para pequenos SMPs e desenvolvimento.
- Starter (€3/mês): Perfeito para servidores públicos em crescimento.
- Pro (€9/mês) / Scale (€39/mês): Destinado a redes estabelecidas.

Crie sua chave e selecione um plano: ProxyTracer