Country Filter: Restrict Server Access by Country in Minecraft

Taking Control of Your Minecraft Server with Country Filter Running a public Minecraft server is a fantastic way to build a community, but it also comes with its own set of challenges. One moment you are welcoming friendly builders, and the next you might be dealing with latency issues or unwante...

Download Country Filter for Minecraft 1.9, 1.6.2

Original name: Country Filter

Minecraft: 1.6.2, 1.9

FileVersionLoaderSize
Country_Filter.zip1.6.2—118 КБDownload
CountryFilter.jar1.9—125 КБDownload

Taking Control of Your Minecraft Server with Country Filter

Running a public Minecraft server is a fantastic way to build a community, but it also comes with its own set of challenges. One moment you are welcoming friendly builders, and the next you might be dealing with latency issues or unwanted behavior from distant regions. If you have ever wished for a simple way to manage who can join based on their geographic location, the Country Filter plugin for Bukkit and Spigot servers is exactly what you need. It acts as a smart gatekeeper, letting you allow or block players by their home country with just a few configuration tweaks.

What Exactly Does Country Filter Do?

Country Filter is a lightweight plugin that integrates directly with your server’s existing permission and connection flow. Instead of manually banning individual IP addresses, it uses GeoIP data to determine a player’s country the moment they attempt to log in. You can then create either a whitelist of allowed nations or a blacklist of restricted ones. This means you can instantly open your server to a global audience while still keeping out regions that cause performance problems or where you notice a higher rate of rule-breaking.

The plugin works silently in the background. When a player connects, their IP is checked against a local database, and if their country code matches a blocked entry, they are denied access with a clean, configurable message. No complicated scripting, no messy firewall rules—just a straightforward filter that respects your server’s needs.

Core Features at a Glance

  • Whitelist and Blacklist Modes: Choose whether to allow only specific countries or block a list of unwanted ones.
  • Real-Time GeoIP Lookup: Uses IPv4 GeoIP data to identify the player’s country during the login process.
  • Minimal Performance Impact: The plugin is designed to be lean, adding virtually no overhead to your server.
  • Simple Command Interface: A single command gives you instant stats and version information.
  • Open Source under MIT License: You can inspect the code, suggest improvements, or even fork it on the developer’s GitHub page.

Installation Made Effortless

Getting Country Filter up and running takes less than a minute. First, download the compiled version from the releases section of the plugin’s repository. You will not find any external download links here, but you can easily locate the official page by searching for the project on GitHub. Once you have the JAR file, simply drop it into your server’s plugins folder and restart the server. That is all there is to it—no additional dependencies, no database setup. The plugin automatically generates a default configuration file where you can specify your country lists.

While Country Filter is a server-side plugin, if you are also exploring client-side mods to enhance your own gameplay, the foxygame.net launcher provides a convenient, flexible, and modern way to install them. This launcher lets you browse and download mods directly from its menu, saving you the hassle of manual file management. It is a perfect companion for players who love to customize every aspect of their Minecraft experience.

Using the Plugin Commands

Once installed, Country Filter offers a straightforward command to keep you informed. Typing /cfilter in the server console or as an operator in-game will display a few useful statistics, such as the number of blocked or allowed connections since the last restart, along with the current plugin version. This makes it easy to verify that the filter is active and working as expected without digging through logs.

Handling Known Limitations

No GeoIP system is perfect, and Country Filter is transparent about its limitations. Due to the nature of IPv4 GeoIP data, some players’ countries cannot be recognized. This often happens with certain VPNs, proxies, or outdated IP ranges. The plugin addresses this by using the special country code -- for unrecognized locations. If you notice legitimate players being blocked or allowed incorrectly, you can fine-tune your configuration by adding or removing -- from your lists. This small workaround ensures that you maintain full control even when the database falls short.

Contributing and Licensing

Country Filter is distributed under the MIT License, which means you are free to use, modify, and share it without restrictive terms. The source code is available on the developer’s GitHub page, where you can also report bugs or suggest new features. The project welcomes contributions, whether it is a simple bug report, a pull request, or a detailed suggestion. This open approach has helped the plugin stay reliable and up-to-date with the latest server versions.

Why Every Server Admin Should Consider Country Filter

Managing a Minecraft server is about creating the best possible environment for your players. By filtering connections based on country, you can reduce lag caused by high-latency regions, minimize language barrier issues, and cut down on moderation work. It is not about exclusion—it is about curating a space where your community can thrive. With its easy installation, single-command stats, and flexible list management, Country Filter puts that power right at your fingertips. Whether you are running a small survival world or a large minigame network, this plugin is a quiet but powerful ally in your server administration toolkit.