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 kick to 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

1. Download VPNGuard and put it in your server or proxy's plugins folder.
2. Start the server or proxy.
3. (Optional) If you want to use ProxyCheck.io or VPNAPI.io, add your API key(s) to the config.
4. (Optional) Enable automatic VPN blocking by executing /vpnkick on in-game or vpnkick on in 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)