Protect Your Minecraft Server with Connection Guard: VPN Detection and Geo-Blocking
Running a Minecraft server is a blast, but it also opens the door to unwanted visitors. From ban-evading players using VPNs to bot swarms from distant countries, the wrong connections can disrupt your community. That is where Connection Guard steps in — a powerful plugin for Spigot, BungeeCord, and Velocity that gives you total control over who can join. Whether you need to block VPN users, restrict access by country, or simply gather detailed connection data, this tool puts the power in your hands without slowing down your server.
Why You Need VPN and Geo-Blocking Protection
Many server owners underestimate how often VPNs and proxies are used to bypass bans or launch attacks. A banned player can simply switch on a VPN, grab a new IP address, and walk right back in. Similarly, automated bots from certain regions can flood your server with spam or attempt to crash it. Connection Guard tackles both problems head-on. It detects VPN and proxy connections using multiple free and premium detection providers, then lets you decide exactly what to do — kick the player, notify your staff, or trigger a custom command. On top of that, its geo-blocking feature lets you whitelist only the countries you trust or blacklist known trouble zones, effectively shutting the door on entire continents of unwanted traffic.
Key Features of Connection Guard
Smart VPN Detection and Automated Reactions
Connection Guard does not just flag a VPN — it reacts the way you want. You can choose from three main actions when a VPN user tries to connect:
- Kick: Instantly prevent VPN users from joining the server with a customizable kick message.
- Notify: Send an alert to admins or moderators in-game so they can monitor the situation without disrupting the player.
- Command: Execute any server command automatically, such as logging the attempt to a file, applying a temporary mute, or triggering a custom script.
This flexibility means you can tailor the response to your community's needs, from zero-tolerance to a more watchful approach.
Multiple Detection Providers for Maximum Accuracy
No single VPN detection API catches everything. Connection Guard supports several providers simultaneously, reducing false flags and increasing detection rates. The built-in options include:
- ProxyCheck: 100 queries per day free without an API key, or 1,000 per day with a free key.
- IP-Hub: 1,000 free queries per day with an API key.
- IP-API: 45 queries per minute free, no key required.
- VPN-API: 1,000 free queries per day with an API key.
- Custom Provider: Connect any REST API that returns VPN/proxy data, supporting both GET and POST requests. This lets you integrate your own detection service or a paid provider for unlimited checks.
You can mix and match these providers to balance cost, speed, and reliability. The plugin handles all the API communication behind the scenes, so you never have to worry about rate limits or downtime.
Geo-Blocking: Keep Bots and Unwanted Regions Out
Geo-blocking is a game-changer for servers that attract malicious traffic from specific countries. Connection Guard lets you operate in either whitelist or blacklist mode. Whitelist only the countries where your real player base lives, and everyone else gets blocked. Or blacklist a handful of problematic regions while keeping the rest of the world open. With over 200 countries supported, you have granular control. The plugin checks the country code before the player even fully joins, so your server resources stay protected.
Detailed Connection Information at Your Fingertips
Every time a player connects, Connection Guard can show you a full profile of their connection. This includes their IP address, whether it is flagged as a VPN or proxy, the country code, city name, and even the Internet Service Provider. Having this data available in-game or in logs helps you spot patterns, investigate suspicious activity, and make informed moderation decisions.
Supported Platforms and Detection Providers
Connection Guard works natively on Spigot, BungeeCord, and Velocity, so it fits into almost any server setup. Whether you run a single Paper server or a large proxy network, the plugin can be installed on the proxy layer to filter connections before they reach any backend server. This is especially effective because it stops unwanted traffic at the earliest possible point. The multi-provider system is fully configurable per platform, and you can even set different actions for different detection sources.
Installation and Setup
Getting started with Connection Guard is straightforward. Drop the plugin JAR into your server's plugins folder, restart, and a default configuration file will be generated. From there, you can enable the detection providers you want, enter any required API keys, and set your preferred actions. The configuration is well-documented, and the plugin comes with a detailed documentation link (available on the project's GitHub and Discord). If you are managing a network, install it on your BungeeCord or Velocity proxy to cover all connected servers at once. For those who prefer an even smoother experience, you can install Connection Guard directly through the foxygame.net launcher — a convenient and modern Minecraft launcher that lets you download and manage plugins right from its menu, saving you the hassle of manual file transfers.
Advanced Configuration and WebHook Integration
Beyond basic blocking, Connection Guard supports Discord WebHooks. You can configure it to send a message to a Discord channel whenever a geo-blocked or VPN user attempts to connect. The message can include the player's name, IP, country, ISP, and the detection source. This is perfect for keeping your staff team informed in real time, even when they are not in-game. The plugin also allows you to create custom commands that fire on detection, so you can integrate it with other plugins like anti-cheat or logging systems. For example, you could automatically add a note to a player's profile in a moderation plugin when they try to join with a VPN.
Conclusion
Connection Guard is a must-have for any server owner who takes security seriously. Its combination of flexible VPN detection, precise geo-blocking, and rich connection data gives you full visibility and control over every login attempt. The support for multiple detection providers means you are not reliant on a single service, and the ability to run on Spigot, BungeeCord, and Velocity makes it adaptable to any architecture. Whether you are fighting ban evasion, bot attacks, or just want to know more about who is connecting, this plugin delivers. Install it, fine-tune the settings to your community's needs, and enjoy a cleaner, safer Minecraft server.