
Description (English)
AntiVPN is an advanced and lightweight plugin designed to protect your Minecraft server from unwanted connections via VPN, Proxy, and Tor nodes. Thanks to the dual API system with automatic fallback, it ensures real-time defense without impacting server performance.
🚀 Key Features
- Dual API with Fallback: Uses proxycheck.io as the main API and ip-api.com as automatic fallback in case of downtime.
- Accurate Detection: Uses an always-updated database to identify suspicious connections.
- Anti-Ban Evading: Automatically blocks second accounts (alts) of already sanctioned users, both by name and direct IP.
- Ban by Name or IP: Ban a player using their name or directly their IP — with automatic alt detection in both cases.
- Stealth Mode: Blocked players see a generic error instead of the AntiVPN message — they don't know the plugin exists.
- Smart Local Cache: Minimizes external API requests and eliminates entry latency.
- Full IP Lookup: Shows detailed information about an IP: country, city, ISP, ASN and VPN detection in a single command.
- Discord Notifications: Sends automatic Discord notifications for every block, ban and unban via separate configurable webhooks.
- Multilingual: Full support for Italian and English, switchable in real time with a command.
- Fail-safe Management: In case of API issues, you decide whether to let players join or block them for security.
đź’» Commands & Permissions
| Command | Permission | Description |
|---|---|---|
/antivpn reload |
antivpn.admin |
Reloads the plugin configuration. |
/antivpn lang <it|en> |
antivpn.admin |
Changes the plugin language. |
/antivpn whitelist |
antivpn.admin |
Manages the IP and UUID whitelist. |
/antivpn lookup <ip> |
antivpn.admin |
Full IP info + VPN check. |
/antivpn playercheck <name> |
antivpn.admin |
Shows IP history and alt accounts of a player. |
/avpnban <name|ip> [reason] |
antivpn.ban |
Bans a player by name or IP and all their linked alt accounts. |
/avpnunban <name|ip> |
antivpn.ban |
Unbans a player by name or IP and all their linked alt accounts. |
/avpnbanlist |
antivpn.ban |
Displays the list of all active bans. |
⚙️ Configuration
The config.yml file allows you to customize every aspect: API Keys for proxycheck.io and ip-api.com, custom kick and ban messages (with full Minecraft color code support), Stealth Mode, separate Discord webhooks for blocks, bans and unbans, request timeouts, and a custom appeal server link.
🔌 Compatibility
- Platforms: Paper and Purpur.
- Versions: Developed and tested specifically for 1.21.6, with full compatibility guaranteed for all versions from 1.21 to 1.21.11.
================================================================================
Descrizione (Italiano)
AntiVPN è un plugin avanzato e leggero progettato per proteggere il tuo server Minecraft da connessioni indesiderate tramite VPN, Proxy e nodi Tor. Grazie al sistema a doppia API con fallback automatico, garantisce una difesa in tempo reale senza influire sulle prestazioni del server.
🚀 Funzionalità Principali
- Doppia API con Fallback: Utilizza proxycheck.io come API principale e ip-api.com come riserva automatica in caso di down.
- Rilevamento Accurato: Database sempre aggiornato per identificare connessioni sospette.
- Anti-Ban Evading: Blocca automaticamente i secondi account (alt) degli utenti giĂ sanzionati, sia tramite nome che tramite IP diretto.
- Ban per Nome o IP: Banna un giocatore usando il suo nome o direttamente il suo IP — con rilevamento alt automatico in entrambi i casi.
- Modalità Stealth: Il giocatore bloccato vede un errore generico invece del messaggio AntiVPN — non sa che il plugin esiste.
- Cache Locale Intelligente: Riduce al minimo le richieste API esterne e azzera la latenza di ingresso.
- IP Lookup Completo: Mostra informazioni dettagliate su un IP: paese, cittĂ , ISP, ASN e rilevamento VPN in un unico comando.
- Notifiche Discord: Invia notifiche automatiche su Discord per ogni blocco, ban e unban tramite webhook separati e configurabili.
- Multilingua: Supporto completo a Italiano e Inglese, cambiabile in tempo reale con un comando.
- Gestione Fallimenti: In caso di problemi API, decidi tu se far passare o bloccare i giocatori per sicurezza.
đź’» Comandi e Permessi
| Comando | Permesso | Descrizione |
|---|---|---|
/antivpn reload |
antivpn.admin |
Ricarica la configurazione del plugin. |
/antivpn lang <it|en> |
antivpn.admin |
Cambia la lingua del plugin. |
/antivpn whitelist |
antivpn.admin |
Gestisce la whitelist di IP e UUID. |
/antivpn lookup <ip> |
antivpn.admin |
Info complete sull'IP + check VPN. |
/antivpn playercheck <nome> |
antivpn.admin |
Mostra IP e account alt di un giocatore. |
/avpnban <nome|ip> [motivo] |
antivpn.ban |
Banna un giocatore per nome o IP e tutti i suoi account alt. |
/avpnunban <nome|ip> |
antivpn.ban |
Sbanna un giocatore per nome o IP e tutti i suoi account alt. |
/avpnbanlist |
antivpn.ban |
Mostra la lista di tutti i ban attivi. |
⚙️ Configurazione
Il file config.yml permette di personalizzare ogni singolo aspetto: API Key per proxycheck.io e ip-api.com, messaggi di kick e ban (con pieno supporto ai codici colori di Minecraft), modalitĂ Stealth, webhook Discord separati per blocchi, ban e unban, timeout delle richieste e link personalizzato per i ricorsi.
🔌 CompatibilitĂ
- Piattaforme: Paper e Purpur.
- Versioni: Sviluppato e testato specificamente su 1.21.6, con piena compatibilitĂ garantita per tutte le versioni da 1.21 fino a 1.21.11.

