Anti-VPN

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> <value>
• /antivpn whitelist remove <ip|uuid|name> <value>
• /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.