AntiVPN protects your Minecraft server from players connecting through VPNs, proxies, Tor exit nodes, and optionally hosting or datacenter networks.
Connections are checked asynchronously during pre-login, preventing risky players from fully joining without blocking the server thread. Results are cached to reduce API usage and improve performance.
Features
- Paper and Folia support
- Designed for Minecraft 1.21 through 26.1.2
- Asynchronous pre-login checks
- VPN, proxy, and Tor detection
- Optional hosting/datacenter blocking
- Configurable minimum risk score
- Country allowlists and blocklists
- ASN allowlists and blocklists
- Configurable lookup timeout and cache duration
- Optional fail-open or fail-closed behavior
- IP, UUID, and player-name whitelists
- Staff notifications with alert cooldowns
- Console logging
- Optional console command enforcement
- Optional post-join verification
- Configurable messages
Supported Providers
- IP-API — no API key required
- ProxyCheck.io — API key required
- IPQualityScore — API key required
Commands
- /antivpn reload
- /antivpn check <player|ip>
- /antivpn whitelist add <ip|uuid|name>
- /antivpn whitelist remove <ip|uuid|name>
- /antivpn whitelist list
- /antivpn cache clear
- /antivpn stats Aliases: /avpn, /vpnblock
Permissions
- antivpn.admin — access administrative commands
- antivpn.notify — receive blocked-connection alerts
- antivpn.bypass — bypass optional post-join verification
AntiVPN relies on third-party IP intelligence providers. Detection accuracy, rate limits, and available data depend on the selected provider.
