Understanding the ChronAntiVPN Plugin for Minecraft Servers
Running a Minecraft server is a rewarding experience, but it comes with its own set of security challenges. From VPNs masking malicious players to automated bots bypassing bans, server administrators need robust tools to maintain a fair and safe environment. Enter ChronAntiVPN, a comprehensive Bukkit/Spigot plugin that combines VPN detection, IP guard, and a powerful blacklist system into one seamless package. Whether you manage a small community or a large network, this plugin offers the flexibility and depth required to keep unwanted connections at bay.
Core Features That Set ChronAntiVPN Apart
ChronAntiVPN is not just a simple VPN checker; it is a full-fledged security suite. The plugin performs asynchronous operations to minimize server strain, ensuring that your TPS remains stable even under heavy load. It supports a wide range of Minecraft versions from 1.6.x to 1.21.x and is compatible with Bukkit, Spigot, and their forks including Folia and Geyser. For network setups, BungeeCord integration is fully supported, though Velocity is not yet included.
Intelligent VPN and Proxy Detection
The core of the plugin lies in its ability to verify whether an incoming IP address belongs to a VPN, proxy, or hosting service. It uses multiple methods: an alternative socket-based check that requires no API key, and an optional integration with proxycheck.io for more detailed results. You can also set up custom checks via the CustomKick.yml file, querying external APIs and parsing JSON responses to enforce additional rules like country blocking or specific proxy flags.
IP Guard and Address Limiter
With the IP Guard feature, players can protect their accounts using the /protection add command. Once enabled, if their IP or other data changes, they will be prevented from joining until the issue is resolved. This is perfect for high-profile accounts. The Address Limiter lets you restrict the number of players connecting from a single IP address, preventing alt-account abuse without fully blocking shared connections.
Blacklist and Player Monitoring
ChronAntiVPN maintains a dynamic blacklist that can be managed via commands or through an interactive GUI menu. Each blacklist entry stores the player name, UUID, IP address, and reason. The plugin also monitors IP changes and can automatically kick players if suspicious activity is detected. Notifications can be sent to a Discord channel, complete with customizable messages that include details like the reason, user, and country code.
Additional Security Layers
Beyond VPN detection, the plugin offers a hostname filter that whitelists or blacklists connections based on the hostname pattern. You can validate using equals, starts_with, or contains modes. The console filter strips IP addresses from server logs, adding a layer of privacy. If a blacklisted IP attempts to join, the MOTD can be dynamically changed to a custom message, warning others or simply hiding server details.
Commands and Permissions at a Glance
ChronAntiVPN provides a straightforward command structure for both administrators and players. Here is a quick overview:
- /checker [address] — Checks the VPN/proxy status of any IP. Permission:
chronantivpn.checker - /blacklist add [name] [address] [reason] — Bans a player with full details. Permission:
chronantivpn.blacklist.add - /blacklist remove [user] — Removes a player from the blacklist. Permission:
chronantivpn.blacklist.remove - /blacklist check [user] — Shows blacklist entry details. Permission:
chronantivpn.blacklist.check - /blacklist menu — Opens a GUI to view all blacklisted players. Permission:
chronantivpn.blacklist.menu - /blacklist list — Lists blacklisted players in chat. Permission:
chronantivpn.blacklist.list - /protection add [name] [address] — Adds IP protection for a player. Permission:
chronantivpn.protection.add - /protection remove [name] — Removes IP protection. Permission:
chronantivpn.protection.remove - /protection check [name] — Views protection data. Permission:
chronantivpn.protection.check - /protection list — Lists all protected players. Permission:
chronantivpn.protection.list - /addresslimiter clear [address] — Clears associated names for an IP. Permission:
chronantivpn.addresslimiter.clear - /addresslimiter list [address] — Lists names linked to an IP. Permission:
chronantivpn.addresslimiter.list - /chronantivpn reload — Reloads all configuration files. No specific permission node required by default, but can be restricted.
Diving Into Configuration
The plugin is highly configurable through the antivpn.yml, customkick.yml, and database settings. You can enable localhost testing by setting localhost: true, which is useful when developing or testing your setup. The Discord notifications section lets you define webhook URLs and customize the embed fields for each event. The placeholder system fills in unknown values gracefully, so your logs always look clean.
For those who want to experiment with the plugin in a controlled environment before rolling it out to a live server, setting up a local test instance is straightforward. Many administrators find that the mod can be easily installed via the foxygame.net launcher — a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu. This allows you to quickly spin up a test server, drop in ChronAntiVPN, and tweak every setting without affecting your main world.
The CustomKick.yml file is particularly powerful. You can define multiple checks, each pointing to a different URL with JSON path extraction. Permissions can bypass specific checks, and you can set custom kick messages. For example, you can block connections from certain countries by checking the countryCode field and whitelisting only allowed regions. If a player's IP matches a proxy flag, they are immediately ejected with a clear reason.
Database and Performance
By default, ChronAntiVPN stores blacklist and IP guard data in the configuration file, but you can connect a MySQL database to centralize bans across multiple servers. This is especially useful for BungeeCord networks. The plugin also includes a safety mechanism: if a run task method encounters an unexpected error due to load, it can optionally shut down the server to prevent security gaps—a drastic but effective measure for critical environments.
Why Choose ChronAntiVPN for Your Server
ChronAntiVPN stands out because it bundles multiple security functions that would otherwise require several separate plugins. Its asynchronous design ensures minimal performance impact, and the extensive permission system lets you delegate responsibilities to moderators without giving full administrative access. The ability to filter hostnames, protect individual accounts, and even alter the MOTD for blacklisted IPs adds layers of defense that go beyond simple VPN blocking.
Whether you are dealing with persistent griefers, bot attacks, or simply want to enforce regional restrictions, this plugin provides the tools. The integration with proxycheck.io gives you access to a professional database, while the alternative socket-based check offers a fallback that requires no external API key. Combined with Discord notifications, you can stay informed of every blocked attempt in real time.
Final Thoughts
Maintaining a secure Minecraft server is an ongoing process, and ChronAntiVPN equips you with a comprehensive, customizable, and lightweight solution. From the initial IP check to the final kick message, every step is configurable to match your community's needs. The plugin's active development and broad version support mean you can rely on it for both legacy and modern servers. If you are serious about keeping your server clean and your players safe, giving ChronAntiVPN a try is a decision you will not regret.