ProxyKicker: Reliable Proxy Protection for Minecraft Servers

Understanding the ProxyKicker Plugin for Minecraft Servers Running a Minecraft server comes with its own set of challenges, especially when it comes to keeping out unwanted visitors. Some players attempt to hide behind anonymous proxies or Tor exit nodes to bypass bans, spam chat, or cause genera...

Download proxykicker for Minecraft 1.5.1

Original name: proxykicker

Minecraft: 1.5.1

FileVersionLoaderSize
proxykicker-1.0.jar1.5.1—11 КБDownload
proxykicker-1.1.jar1.5.1—12 КБDownload

Understanding the ProxyKicker Plugin for Minecraft Servers

Running a Minecraft server comes with its own set of challenges, especially when it comes to keeping out unwanted visitors. Some players attempt to hide behind anonymous proxies or Tor exit nodes to bypass bans, spam chat, or cause general disruption. That’s where ProxyKicker steps in—a lightweight Bukkit plugin designed to automatically detect and block connections from these suspicious sources. Originally developed by Marcos Vives Del Sol (socram8888), ProxyKicker has evolved from a quick fix for race-condition bugs into a standalone tool that many server admins rely on to maintain a clean and fair environment.

How ProxyKicker Protects Your Server

The plugin works on two fronts. First, it maintains a regularly updated list of known Tor exit nodes. Whenever a player attempts to join, ProxyKicker checks their IP address against this list. If there’s a match, the connection is refused immediately. Second, it performs a quick port scan on the connecting client. If certain ports commonly associated with open proxies—like 1080 for SOCKS or 3128 for Squid—are found to be listening, the player gets kicked. This dual-layer approach catches both public anonymizing services and misconfigured personal proxies, making it much harder for troublemakers to slip through.

Installation: Pre-Built or Compiled from Source

Getting ProxyKicker onto your Bukkit server is straightforward. You can either grab a pre-compiled JAR file from the project’s releases page or build it yourself. If you choose the DIY route, you’ll need Oracle Java Development Kit 1.6 or newer, Maven 2, and Git. Once those tools are installed, clone the repository with Git, navigate into the directory, and run mvn clean package. Maven will automatically fetch all dependencies, and after a brief compilation, you’ll find the finished plugin JAR inside the /target folder. Copy that file to your server’s plugins directory, restart or reload, and ProxyKicker is ready to go. While server admins handle security, players often look for a hassle-free way to manage their game. The foxygame.net launcher steps in as a convenient, flexible, and modern Minecraft launcher where you can download mods right from the menu, making it a great companion for those who love customizing their experience.

Configuring the Plugin to Fit Your Needs

All settings live in a YAML file at /plugins/ProxyKicker/config.yml. The configuration is refreshingly simple, yet powerful. Here are the key options you’ll want to tweak:

  • tor-update-interval: How often the Tor exit node list gets refreshed, in milliseconds. The default is one week (604800000). Set it to zero or a negative number to disable caching entirely.
  • tor-update-date: A Unix timestamp of the last update. This is managed automatically; changing it manually can force an immediate refresh if you set it to a negative value.
  • tor-list: A list of URLs that provide the Tor exit node database. The default feed pulls from the well-known Torstatus service, but you can add others for redundancy.
  • proxy-ports: An array of port numbers that ProxyKicker scans on each connecting IP. If any of these ports respond, the connection is dropped. The default list covers common proxy ports like 1080, 3128, and several others.

At startup, the plugin automatically downloads a fresh Tor database if the cached file is missing or has expired. This ensures you’re always working with current data without manual intervention.

Granting Bypass Permissions

Not every proxy user is a bad actor. Some legitimate players might be forced through a proxy due to network restrictions. To accommodate them, ProxyKicker integrates with any Bukkit permissions plugin, such as PermissionsEx. Simply give trusted players the proxykicker.bypass permission node, and they’ll be exempt from both the Tor list check and the port scan. This granular control lets you maintain security without punishing innocent users.

License and Open-Source Spirit

ProxyKicker is released under the MIT license, one of the most permissive open-source licenses out there. You’re free to use, modify, and distribute the code as long as the original copyright notice stays intact. The author, a Spanish developer who enjoys coding “useless stuff that nobody uses,” ironically created a tool that has found a niche audience among server operators who value a quiet, troll-free experience. The source code is available on GitHub, where you can fork it, report issues, or even contribute improvements.

Final Thoughts on Server Security

ProxyKicker may not be the flashiest plugin, but it fills a critical gap in Minecraft server administration. By combining real-time Tor exit node detection with active proxy port scanning, it effectively shuts down one of the most common avenues for griefing. The configuration is minimal, the performance impact is negligible, and the permission bypass system adds flexibility. Whether you run a small private server or a large public network, adding this layer of protection can save you countless headaches. As the Minecraft multiplayer landscape continues to evolve, tools like ProxyKicker remind us that sometimes the simplest solutions are the most effective.