MineBans

Logo

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

  1. Is the player on the local exception list, if they are let them join.
  2. Is the player banned from this server (global, local or temporary), if they are prevent the connection.
  3. Is the player banned from another server with the same owner, if they are prevent the connection.
  4. Is the player using a public proxy, if they are prevent the connection.
  5. Is the player using a Minecraft account that is known to be compromised, if they are prevent the connection.
  6. 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):

  1. 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)
  2. 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.
  3. 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

  1. Sign up for an account on our website
  2. Download the plugin from the files page and put the .jar in your plugins folder
  3. Run the server once for the config file to be created and then shut it down again
  4. 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
  5. 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

example

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

Available on GitHub

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/

Download Stats

View detailed stats

You must login to post a comment. Don't have an account? Register to get one!

  • Avatar of WilliamtheChad WilliamtheChad Feb 23, 2014 at 00:05 UTC - 0 likes

    Soooo...

    Are we going to see any more updates on Bloodmoon? or is that plugin dead?

  • Avatar of TheShadbusher TheShadbusher Jan 21, 2014 at 15:21 UTC - 0 likes

    Could you add support for LilyPad servers? I'm running LilyPad and I cannot use MineBans because of this.

    It's very similar to BungeeCord, but it's more secure.

    Last edited Jan 21, 2014 by TheShadbusher

    Don't let anyone look down on you because you are young, but set an example for the believers in speech, in life, in love, in faith, and in purity.

    1 Timothy 4:12

    http://minecraft-mp.com/regular-banner-36994-6.png

  • Avatar of PiratesDawn PiratesDawn Aug 17, 2013 at 21:47 UTC - 0 likes

    why do not you put your plugin to run on server pirate? I am Brazilian and I need that way = /

  • Avatar of wide_load wide_load Jul 06, 2013 at 19:43 UTC - 0 likes

    The website is down at the moment, it seems to be a network issue on the hosts side. Will update once I know more.

    EDIT: Back to normal :)

    Last edited Jul 06, 2013 by wide_load
  • Avatar of wide_load wide_load May 14, 2013 at 14:40 UTC - 0 likes

    @TheShadbusher: Go

    I guess I can add a second mode for the command syntax. I like the way the command is as short as possible though so the current way will stay. I'll put it on the todo list.

  • Avatar of TheShadbusher TheShadbusher May 13, 2013 at 23:12 UTC - 0 likes

    @wide_load: Go

    Could you please take a look at my last comment? Global banning and local banning are so similar with this plugin that I can't use it. I'd appreciate it if you made a stronger distinction between local and global banning.

  • Avatar of wide_load wide_load May 08, 2013 at 20:47 UTC - 0 likes

    @ChaseThis1: Go

    I believe I just replied, if you're not the same Chase_This then can you email again :)

  • Avatar of ChaseThis1 ChaseThis1 May 08, 2013 at 20:10 UTC - 0 likes

    I have a problem on MineBans Website. I have emailed [email protected] and not getting a response. I even went to support at www.minebans.com/support.html but no one was online. If you get the time, can you look at my problem. Thanks

    Chase_This

  • Avatar of wide_load wide_load May 05, 2013 at 18:50 UTC - 0 likes

    @Jnk1296: Go

    Where are you getting that information from ? I believe that changed a long time ago.

    EDIT: you now need to implement PlayerBansCallback. I'll update the docs now.

    Last edited May 05, 2013 by wide_load
  • Avatar of Jnk1296 Jnk1296 May 05, 2013 at 17:25 UTC - 0 likes

    Maybe you can help me. I keep trying to implement the lookupPlayer method in my plugin, and I'm having trouble.

     ...must be an instance of a class which implements the PluginAPIResponseCallback interface...
    

    But there is no interface defined with that name that I can find? Help please?

    BFAK:90730724,46adb931596c153048fb32097b78291f91311a1ce00feeb279e1d404f56ef938

Facts

Date created
Jul 12, 2012
Categories
Last update
Jan 11, 2014
Development stage
Release
License
GNU General Public License version 3 (GPLv3)
Curse link
MineBans
Downloads
8,623
Recent files
  • R: v0.17 for CB 1.7.2-R0.1 Jan 11, 2014
  • R: v0.16 for CB 1.5.1-R0.2 May 01, 2013
  • A: v0.16-SNAPSHOT-b24 for CB 1.5.1-R0.2 Apr 25, 2013
  • R: v0.15.2 for CB 1.4.6-R0.3 Jan 14, 2013
  • R: v0.14.4 for CB 1.4.2-R0.2 Nov 16, 2012

Authors