?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
VPNGuard

VPNGuard

VPNGuard allows you to check if players are using a VPN or proxy and (optionally) block them if they are.

52downloads
1follower
52downloads
1follower

Compatibility

Minecraft: Java Edition

1.21.x
1.20.x
1.19.x
1.18.x
1.17.x
1.16.x
1.15.x
1.14.x
1.13.x
1.12.x
1.11.x
1.10.x
1.9.x
1.8.x

Platforms

Links

Join Discord server

Tags

Creators

Details

Licensed ARR
Published last month
Updated last month

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)