VPNGuard
VPNGuard allows you to check if players are using a VPN or proxy and (optionally) block them if they are. Just drop the plugin in and it's ready.
Features
- Caching: Caches IP data to lower your API usage.
- UUID Whitelist: Whitelist players so that they can join with a VPN even while VPN blocking is enabled.
- Multiple API Providers: Supports IP-API.com, VPNAPI.io, and ProxyCheck.io.
- Queueing & Rate Limiting: Queues lookup tasks with a configurable delay to prevent API rate-limit lockouts.
- Player Sweeps: Run
/vpnkick on kickto manually check and disconnect online players using a VPN. - Custom Kick Messages: Configurable kick messages for when a player is kicked due to VPN usage.
Installation
- Download VPNGuard and put it in your server or proxy's
pluginsfolder. - Start the server or proxy.
- (Optional) If you want to use ProxyCheck.io or VPNAPI.io, add your API key(s) to the config.
- (Optional) Enable automatic VPN blocking by executing
/vpnkick onin-game orvpnkick onin the console.
Commands & Permissions
| Command | Description | Permission |
|---|---|---|
/vpnkick [on|off] |
Toggle connection checking on or off. | vpnguard.vpnkick |
/vpnkick status |
View checking status and active blocking settings. | vpnguard.vpnkick |
/vpnkick [on] kick |
Check all currently online players and kick VPN users. | vpnguard.vpnkick |
/vpncheck <player/IP> |
Look up an IP or player's VPN status. | vpnguard.vpncheck |
/vpncheckall |
Check all online players for VPN/Proxy usage. | vpnguard.vpncheck |
/vpnwhitelist add <player/IP/UUID> |
Whitelist a player, IP, or UUID. | vpnguard.vpnwhitelist |
/vpnwhitelist remove <player/IP/UUID> |
Remove a player, IP, or UUID from the whitelist. | vpnguard.vpnwhitelist |
/vpnwhitelist list |
Show all whitelisted players and IPs. | vpnguard.vpnwhitelist |
/vpnguard reload |
Reload the config. | vpnguard.admin |
/vpnguard help |
Show the admin help menu. | vpnguard.admin |
Support
DM depton on Discord for bug reports/support/suggestions (Please state your problem/suggestion in the first message)
