MineBans: The Fair Global Banning System for Minecraft Servers
Running a Minecraft server comes with the constant challenge of dealing with griefers, cheaters, and toxic players. While local bans keep troublemakers off your own world, they do nothing to warn other server owners. MineBans changes that by offering a transparent, evidence-based global banning system that helps server admins make informed decisions about who joins their community. Unlike older solutions that relied on subjective reports or centralized control, MineBans focuses on verifiable data and gives you full configuration power.
How MineBans Works
At its core, MineBans allows server administrators to publish player bans to a shared database. When a player attempts to connect to any server running the plugin, a real-time lookup is performed against minebans.com. The system then runs through a series of fully configurable checks before granting access. This means you can automatically filter out known offenders without manually reviewing each case.
The join verification process follows a logical sequence:
- First, the plugin checks if the player is on the local exception list. If they are, the connection is allowed immediately.
- Next, it verifies whether the player is banned from this specific server (globally, locally, or temporarily). If a ban exists, the connection is blocked.
- It then looks for bans issued by other servers owned by the same administrator and blocks accordingly.
- Public proxy connections are detected and prevented, reducing the risk of ban evasion.
- The system checks if the Minecraft account is flagged as compromised, stopping hijacked accounts from causing damage.
- Finally, it evaluates the total number of bans a player has accumulated across the network. If the count exceeds your configured threshold, the connection is denied.
Each of these layers can be adjusted or disabled entirely, giving you granular control over how strict your server's entry requirements should be.
What Sets MineBans Apart
Many server owners are familiar with older tools like MCBans, MCBlockIt, or Glizer. MineBans takes a fundamentally different approach that prioritizes fairness and transparency. The most significant distinction lies in how bans are documented. Instead of a single-word reason like "xray," MineBans uses fixed ban reasons paired with automatically collected supporting evidence. When a player is banned for cheating, the plugin gathers statistics and calculations that back up the claim. At the time of writing, over 80% of bans in the database include this hard data, making the records far more trustworthy.
Privacy is another key difference. MineBans does not track players beyond the necessary information. There is no log of who logged into which server or for how long. This minimal data collection reduces the potential for abuse. Moreover, there is no concept of a system-wide global ban that a central team can impose on a player across all servers. With some past systems, the plugin could even be remotely configured to broadcast arbitrary messages when a player joined—something that was once used for political statements unrelated to Minecraft. MineBans contains no such backdoor. The only way a player might be incorrectly banned is through the compromised account feature, and you are free to disable that if you distrust the data source.
Getting Started with MineBans
Setting up the plugin is straightforward, though it does require every moderator to have an account on minebans.com. This step might feel like an extra hurdle, but it ensures accountability. If a staff member abuses the system, they can be held responsible without having to wipe all of your server's bans from the database. The sign-up process also ties each account to a valid Minecraft account, which discourages misuse.
The basic installation steps are:
- Sign up for an account on the MineBans website.
- Download the plugin JAR from the files page and place it into your server's plugins folder.
- Run the server once to generate the configuration file, then shut it down.
- Open config.yml and set the api-key option to match the value found on the My Servers page of the website.
- Assign the necessary permissions to your admins and moderators.
For those who prefer a more streamlined approach, the plugin 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 saves you from manually moving JAR files and keeps your server setup organized.
Commands and Permissions
Once installed, MineBans integrates smoothly with your existing moderation workflow. All commands display usage information when run without arguments, making them easy to learn. Here are the core commands:
- /ban – Bans a player from the server. Requires the minebans.admin.ban permission.
- /unban – Removes any active bans for a player. Requires minebans.admin.ban.
- /kick – Disconnects a player immediately. Requires minebans.admin.kick.
- /exempt – Manages the exemption list, allowing specified players to bypass all join checks even if they exceed limits. Requires minebans.admin.exempt.
- /minebans – Provides various system-related subcommands for administration and lookups.
The in-game lookup feature displays a player's ban history with color-coded severity indicators. You can configure separate limits for each ban reason and severity level, tailoring the automatic blocking to your community's standards.
For Developers and Contributors
MineBans offers a dedicated API that other plugins can leverage. Detailed documentation is available on the GitHub wiki, covering everything from event hooks to custom ban reason integration. The project is open source, and contributions are welcome. If you have a feature idea and a clean implementation, you can fork the repository and submit a pull request. The maintainers ask that you avoid altering the pom.xml structure, add JavaDoc comments for any new API methods, and follow the existing code style. All dependencies are accessible from a public Maven repository, so you won't need to build multiple side projects just to test a small change.
Development builds can be obtained from the continuous integration server, though these are not officially approved by BukkitDev and should be used at your own risk. The source code is hosted on GitHub for full transparency.
Conclusion
MineBans rethinks global banning by putting evidence and configurability at the center. Instead of relying on a black-box reputation score or a central authority, it gives server owners the tools to decide who enters their world based on concrete data. The fixed ban reasons, automatic evidence collection, and layered join checks create a system that is both powerful and difficult to abuse. Whether you run a small survival server or a large network, MineBans helps you protect your community while respecting player privacy. By combining easy installation, a clear permission structure, and an open API, it fits neatly into any server setup and grows with your needs.