Server Minecraft (Paper, Velocity e Bungee)

I plugin ufficiali ad alte prestazioni anti-VPN e di rilevamento proxy per server Minecraft Paper, Spigot, Purpur, Velocity e BungeeCord.

Anteprima

Schermata di Kick In-Game	Avviso in Console

Perché ProxyTracer?

• Rilevamento in Tempo Reale: Controlli accurati rispetto ai database di VPN residenziali e pubbliche di ProxyTracer costantemente aggiornati.
• Nativo Multi-Piattaforma: Integrazioni dedicate per server singoli (Paper/Spigot) e reti multi-server (Velocity o BungeeCord/Waterfall).
• Alte Prestazioni: Il caching in memoria integrato risparmia crediti API e garantisce che i giocatori di ritorno si connettano istantaneamente.
• Whitelist Intelligente: Comandi di bypass in whitelist per nomi di giocatori e indirizzi IP di rete attendibili.
• Avvisi Discord: Registra gli accessi bloccati da VPN direttamente nei canali del tuo staff.
• Schermata di Kick Personalizzata: Mostra ai giocatori un messaggio di blocco professionale con riferimento a proxytracer.com.

Quale file jar devo installare?

Configurazione Rapida (60 Secondi)

1. Ottieni una chiave API gratuita su: ProxyTracer.com/dashboard
2. Scarica il file jar corretto per la tua configurazione da Releases.
3. Posiziona il file jar nella directory plugins/ del tuo server e avvialo una volta.
4. Imposta la tua chiave API direttamente in gioco o tramite la console:

   /proxytracer set your_api_key_here

   (Questo comando scrive automaticamente la chiave nel tuo file di configurazione e ricarica il plugin).
5. Verifica la connessione eseguendo: /proxytracer status

Dettagli di Configurazione

mode: "block"          # Azione quando viene rilevato un proxy: block | warn | log
 
api:
  base-url: "https://api.proxytracer.com/v1"
  key: "proxy_your_key_here"
  on-error: "allow"    # Politica fail-open se l'API va offline: allow | block | warn
  timeout-ms: 2000
 
notifications:
  in-game: false       # Invia messaggi di chat colorati in gioco allo staff (proxytracer.notify)
 
cache:
  enabled: true
  ttl-minutes: 1440    # Memorizza nella cache il risultato del controllo IP per 24 ore
  max-entries: 10000
 
discord:
  enabled: false
  webhook-url: ""
  notify-blocked: true

Comandi e Permessi

Tutti i comandi hanno come prefisso /proxytracer:

• /proxytracer notify <on|off|toggle> — Attiva/disattiva i messaggi di chat colorati in gioco per lo staff.
• /proxytracer notify add|remove|list [player] — Aggiungi/rimuovi/elenca gli username dello staff autorizzati a ricevere notifiche in gioco (salvato automaticamente in config.yml).
• /proxytracer set <api_key> — Imposta la chiave API direttamente, salvandola in config.yml e ricaricando.
• /proxytracer status — Controlla lo stato della configurazione, le credenziali API e lo stato delle notifiche in gioco.
• /proxytracer check <ip> — Interroga manualmente un indirizzo IP.
• /proxytracer cache clear — Svuota la cache IP locale.
• /proxytracer reload — Ricarica il file di configurazione.
• /proxytracer whitelist name add|remove|list [player] — Esenta giocatori dai controlli.
• /proxytracer whitelist ip add|remove|list [ip] — Esenta indirizzi IP di rete dai controlli.

Permessi:

• proxytracer.admin — Accesso ai comandi di ricarica, stato e amministrazione.
• proxytracer.bypass — I giocatori con questo permesso bypassano i requisiti di controllo durante il pre-login.
• proxytracer.notify — Lo staff riceve avvisi in gioco quando un utente VPN viene registrato nei log o avvisato.

(Nota: per impostazione predefinita, questi permessi sono assegnati solo agli Operatori del server (OP). Per concedere questi permessi ad altri giocatori o gruppi di staff, utilizza un plugin di gestione dei permessi come LuckPerms).

Compatibilità e Requisiti

• Versione Java: Java 17 o superiore (completamente testato su Java 17, 21 e 22). Il plugin è compilato con target Java 17.
• Supporto Software Server: Paper / Spigot / Purpur (da 1.13 a 1.21.x), Velocity (3.x) e BungeeCord / Waterfall (build moderne).
• Accesso API: Una chiave API gratuita o a pagamento registrata su proxytracer.com.

Risoluzione Problemi: Problemi con l'IP Reale (127.0.0.1)

Se i tuoi log mostrano che ogni giocatore che entra si connette da 127.0.0.1, l'API ProxyTracer non può scansionarli. Ciò indica che la configurazione di rete del tuo hosting o il proxy front-end sta mascherando gli IP in ingresso dei giocatori.

Come Risolvere:

1. Per Reti Proxy (Velocity / Bungee): Distribuisci ProxyTracer solo sul gateway proxy (Velocity/Bungee). Assicurati che l'inoltro delle informazioni del giocatore sia attivo (player-info-forwarding-mode = "modern" in velocity.toml o ip_forward: true nel config.yml di Bungee) in modo che i nodi di gioco backend ricevano l'IP reale.
2. Per Hosting Condivisi (es. proxy del pannello TickHosting): Se il tuo host inoltra gli header di connessione tramite Proxy Protocol, abilitalo all'interno della tua configurazione di Paper (proxies.proxy-protocol: true in config/paper-global.yml) e riavvia. Attenzione: non attivare questa opzione a meno che il tuo host non la supporti esplicitamente; una configurazione errata impedirà a tutti i giocatori di connettersi.

Prezzi e Quote API

I plugin Minecraft di ProxyTracer sono gratuiti al 100%. Il rilevamento richiede una connessione all'API di ProxyTracer:

- Piano Gratuito: 100 controlli/mese per piccoli server SMP e sviluppo.
- Starter (€3/mese): Perfetto per server pubblici in crescita.
- Pro (€9/mese) / Scale (€39/mese): Pensati per reti consolidate.

Crea la tua chiave e seleziona un piano: ProxyTracer