MineBans
MineBans - The Fair Global Banning System
Put simply, MineBans is a global banning system for Minecraft servers. We offer a way for server admins to publish the player bans they make on their servers to our database. The owners of other servers can then use this information to decide if a player that just joined their server should be allowed to stay.
How Does it Work ?
When a player joins the server a summary of any previous bans they may have is downloaded from minebans.com and the following checks are done on the user
- Is the player on the local exception list, if they are let them join.
- Is the player banned from this server (global, local or temporary), if they are prevent the connection.
- Is the player banned from another server with the same owner, if they are prevent the connection.
- Is the player using a public proxy, if they are prevent the connection.
- Is the player using a Minecraft account that is known to be compromised, if they are prevent the connection.
- Does the player have too many bans from other servers, if they have prevent the connection. Each of these checks is fully configurable.
What About MCBans, MCBlockIt, Glizer, etc
The way I see it MineBans is nothing like the other systems available for a few reasons (feel free to judge for yourself though):
- Our ban reasons are fixed. This means that the plugin can collect supporting evidence for each ban. Ultimately this means instead of a single word, "xray" as the ban reason we can provide a full page of statistics and calculations. As the bans are backed up by data we believe they are much more trustworthy. (At the time of writing over 80% of our bans have supporting evidence)
- We don't track players, we only collect the necessary information from the server. There is no log of who logged in to a specific server or how long they were online.
- Less potential for abuse. Did you know the MCBans team could globally ban a player from all servers for no good reason, with MineBans there is no concepts of a system wide ban like this. Did you also know that the MCBans team can configure their plugin (without your consent) to broadcast a message of their choice when a player joins, this has previously been used for political messages unrelated to Minecraft. There is no such feature with MineBans. The compromised account feature is the only way that a player could be banned incorrectly and you are free to disable that feature if you do not trust the origin of the data.
Some Things you Should Know
- All moderators of the server will need an account at minebans.com. This might seem like an unnecessary pain but it allows us to hold a certain player responsible if the system is abused without having to take a drastic step like removing all of the servers bans from the database. It also will help to prevent abuse of the system as a valid Minecraft account is needed to sign up.
Installation
This is a summary of the information that can be found on the wiki
- Sign up for an account on our website
- Download the plugin from the files page and put the .jar in your plugins folder
- Run the server once for the config file to be created and then shut it down again
- Open the config.yml file and edit the api-key option so that it matches the value from the My Servers page on the website
- Give your admins and moderators the necessary permissions
Usage
The basic commands are listed here, for more information please see the commands page on the wiki. All commands can be used with no arguments to show usage information.
- /ban - Bans a player from the server. Requires the minebans.admin.ban permission.
- /unban - Removes any bans that a player currently has. Requires the minebans.admin.ban permission.
- /kick - Disconnects a player from the server. Requires the minebans.admin.kick.
- /exempt - Used to manage the exempt list. The exempt lists acts as a list of players that will be made exempt from the join checks meaning they can join even if they are over the servers limits. Requires the minebans.admin.exempt permission.
- /minebans - Provides various commands relating to the system.
Since the page needs some colour here is an example of an in-game lookup
The colours next to each reason denote that ban's severity. Limits can be configured for each ban reason and each severity.
For Developers
The plugin provides it's own API for other plugins to use, the features provided by this are documented in detail on the GitHub wiki page.
Contributing
Contributions to the project are very much welcome, if you have a feature that you want implemented and know a nice way to do it then consider forking the repo and submitting a pull request. These will be accepted as long as the following simple guidelines are followed.
- Do not edit the structure of the pom.xml file, feel free to add a dependency if you need it but the formatting and structure should not be changed.
- If you are exposing a new API method, add a JavaDoc comment to it, but don't over-comment internal code.
- Follow the existing code style, don't antagonise over every space though !
All dependencies that are used are now available from a public Maven repo, so you don't have to worry about building several other projects just to add a simple change any more.
Source Code
Dev Builds
Changes Since Last Release
Download
Development builds of this project can be acquired at the provided continuous integration server. These builds have not been approved by the BukkitDev staff. Use them at your own risk.
http://bukkit.jacekk.co.uk:8000/job/MineBans/
@wide_load
The latest version, v0.15.2. I am also using Spigot 1.5.1 (#735) and the latest version of each rollback plugin.
@abcedea
Air is never meant to show up :P Which version of the plugin are you using ?
Ban data on griefing seems to be a bit messy when both CoreProtect and LogBlock are installed.
Bans will often only come up as low severity because the data would only be air blocks or one of every item broken, even when the total damage is significant.
Can anybody else verify this bug or is it just my setup?
@greyedge
You can only use one reason, go with the most serious.
If an individual conducts more than one infraction that is listed, how do you ban them for more than one reason?
@squeezer2k
Looks like I need to update for changes to CoreProtect, will work on that now. You can safely ignore that error for now.
got following problem:
http://pastebin.com/Pnv7E6sz
coreprotect issue?
edit: using coreprotect 2.02
@wide_load
I sent an email containing a video of me showing proof.
@SlenderCraft
That means that your username was found on a public list of account names with a valid password. If you email [email protected] with proof of ownership of the account it can be removed from the list.
On the website it says this when I use my minecraft name (SlenderCraft) to sign up on your website it says "You cannot register using a Minecraft account that is known to be compromised." what is that supposed to mean? It has never been compromised...
@SkyRanger
I won't be adding an mcbans lookup, this is a separate system and I do not believe their data is reliable.
If a player is being globally banned then it has to be for one of the listed reasons, if what they did does not fit into one of these then it should be a local only ban. If you tell me the rule that is being broken I can tell you if it would fit into one of the categories we have.
@wide_load
Thy for the response.
The import-thing i tryed out, but it just does local bans. so i deleted the file with local bans and putted them in per console each ban.
I allready want to do bans "online" so that other Serverowner know "oh, thid guy is a bad boy"... u know.
just for this, i could stay at mcbans. for this, its a good thing. But the point, why i want to switch to minebans is the request from ur database, when a player joins. AND the kind of how i can configure, what i want to do with the joined player. so if anyone has a ban for griefing, i wont let him play on my server.
and this is the mainpoint, why would like to switch to minebans. but infact of the small database of minebans, i need mcbans just for lookups.
but if i have mcbans on the server, i would use it to write a ban into their database, too.
if it would b possible, to lookup mcbans database without mcbans-plugin, so that u could integrate this lookup into ur plugin, so i wont use mcbans anymore for bans.
I dont like their company policy.
well, then tell me, in which kind of bantype should i do bans, which are breaking serverrules ?
ic ould do them into chat spamming or griefing, but its not fair, if i do it.
@SkyRanger
The reason it should not be a global reason is that is is not specific, all of the other reasons could come under the "general rule breaking" rule. If a lot of servers have a common rule that specific thing can be added to the list of reasons.
You should be able to import the bans you made using McBans using their website and the /minebans import command. It would be a bit odd to use both plugins at once.
@wide_load
Ok, i dont understand, why this should not be a global reason, bcoz of the large number of pples, which wont read serverrules and then askin, what and how to do. but i have to accept it.
local bans doesnt help other Serveradmins. but this ist just my opinion.
thanks for the answer :-)
i still want to help to grow up ur database :-) but i have to use MCbans for now, til i found a way to use them both.
i am not a programmer, so i have to figure out, how to change the ban command from one of the both plugins.
@SkyRanger
Anything that does not fit into one of the specific reasons should be a local ban, I'm open to adding reasons but not general ones like that.
I think its important, to add the following Ban-reason:
Banned for breaking / not following Serverrules.
Its the most typed bans near griefing.
@NoMansLand_MFGC
:P glad to be of service :)
@wide_load
You sir, have saved my life from being killed by several angry Mods & Senior staff..
@NoMansLand_MFGC
Have you added them as moderators to the server ? You can do that from the My Servers page.
Several of my staff have registered to minebans.com and fully validated with their Minecraft names etc. but when they log onto our server it says they're not authorised Moderator's
How can I fix this?