MCBans Logo

MCBans Logo

Welcome to MCBans

MCBans is a global banning solution for Minecraft, provided through the Bukkit plugin. The aim of the plugin is to provide server owners with a method of assisting in the prevention of griefers on their own and other's servers, using both local and global bans.

Currently, we're flying using the MCBans 4.21 plugin and CraftBukkit 1.7.4, and all is well!

MCBans Website:



Please remember the following things while using our plugin!

  • MCBans is maintained constantly by a team of staff, but we're not miracle workers! Like everyone, we need time to perform our tasks and can't do everything on demand.
  • MCBans isn't always 100% clear from invalid bans - but, we're well on our way. Your help is always thanked in removing invalid bans and we try our hardest to monitor everything.
  • MCBans has a small dedicated development team - We do only have a few dedicated developers, but they do have other commitments as well.
  • MCBans staff don't always have good memories! email. [email protected]

Global Ban?

A Global ban is a ban that effects a user on a permanent scale by reducing their reputation from 10 downwards with every ban, the deduction depends on the server's own reputation. For the reason that, when users reach 0 reputation they get banned from accessing any MCBans server, there are strict guidelines that regulate the usage of such bans.

These bans are meant for high severity offences in order to prevent griefers violating the same rules on other servers, and they are always monitored by the MCBans Staff so we can quickly remove any invalid bans.

So.. How does this all work then?

During the connect phase of logging into a server, the plugin asks the main server for information on the users (Reputation, No. of alt accounts etc.) which it then uses to determine if a user is eligible to access the server or not. If they are, then we don't do much else except inform the user if they have bans on record, any disputes and things like that. Otherwise, if they aren't eligible to login, then they get kicked with the ban reason that caused them to be disallowed access.

But, what if I want to let someone on who is banned?

You can always add players or reasons to an exception list located in your server control panel.

Help! Something wont work!

Hey, hey! Don't get all worked up, you only need to do one of the following to get help: Check out our forum at Or finally, check in for a chat via our IRC chatroom at irc://


Local Ban Variations

  • /ban <playername> <reason> - bans the player
  • /rban <playername> <reason> - rollback and ban
    • E.G. /ban Firestarthe breaking my sign *

Global Ban Variations

  • /ban <playername> g <reason> - global ban
  • /gban <playername> <reason> - global ban
  • /rban <playername> g <reason> - rollback and global ban
    • E.G. /ban g Firestarthe griefing *

Temporary Ban Variations

  • /ban <playername> t <int> <m/h/d> <reason> - temp bans a player
  • /tban <playername> <int> <m/h/d> <reason> - temp bans a player
  • /rban <playername> t <int> <m/h/d> <reason> - temp bans a player and rolls them back
    • E.G. /tban Firestarthe 15 m you are banned for 15 minutes *

IP Ban Variations

  • /banip <IP> [reason] - bans an IP address ( /unban <IP> to unban ip address)

Misc Commands

  • /lookup <playername> - checks players ban history (local/global bans)
  • /banlookup <banID> - checks ban details
  • /kick <playername> [reason] - kicks a player from the game
  • /unban <playername|IP> - unbans the player/IP from your server

Permission Nodes

  • mcbans.admin (default: op) - Admin privileges to mcbans
  • (default: op) - Allow global ban player
  • mcbans.ban.local (default: op) - Allow local ban player
  • mcbans.ban.temp (default: op) - Allow temp ban player
  • mcbans.ban.rollback (default: op) - Allow use rban command
  • mcbans.ban.ip (default: op) - Allow use banip command
  • mcbans.unban (default: op) - Allow unban player
  • mcbans.view.alts (default: op) - Show notification of a players alts on connect
  • mcbans.view.bans (default: op) - Show previous ban information on player connect
  • mcbans.view.staff (default: true) - Show notification of a mcbans staff on connect
  • mcbans.hideview (default: false) - Hide player view alts/previous bans on connect
  • mcbans.lookup.player (default: op) - Allow lookup player ban history
  • mcbans.lookup.ban (default: op) - Allow lookup ban details
  • mcbans.lookup.alt (default: op) - Allow lookup alt account
  • mcbans.kick (default: op) - Allow kick player
  • mcbans.kick.exempt (default: op) - Exempt from kicks


  1. Download the latest MCBans jar file and put on your plugins directory
  2. Run your server
  3. Go to
  4. Copy your API key
  5. On your server, open /plugins/MCBans/config.yml in a text editor
  6. Enter your apiKey: 342903849263048203874 (this number is an example of your APIkey)
  7. Change any configurations that you want
  8. Restart your server or type /mcbans reload

We'll always be able to help and will try to the best of our ability to resolve any questions or issues you may have!

MCBans Staff Debug Commands

The plugin contains commands which give descriptive data to help diagnose issues that your server may have. These commands are strictly readonly and provide only information. the commands include ones that send permissions debug data + mcbans variable sizes, a message sent to admins verifying that they are mcbans staff, as well as apikey info and minrep settings. This data is only probed when your server has requested support regarding issues with the mcbans plugin.

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

  • Avatar of Firestarthe Firestarthe Apr 15, 2014 at 12:16 UTC - 0 likes

    Update coming within this week to address UUID and a few other changes! MCBans 4.3 expected completion date 4/18/2014

    Last edited Apr 15, 2014 by Firestarthe


  • Avatar of lukerocks01 lukerocks01 Apr 15, 2014 at 08:19 UTC - 0 likes

    @OJR: Go

    If It Is Saying Incorrect Parameters Do /mcbans banning To Get The Info On How To Ban Correctly.

  • Avatar of lukerocks01 lukerocks01 Apr 15, 2014 at 08:17 UTC - 0 likes

    @Kahanamoku78: Go

    Dont Use Glizer instead, The Unban System Is Extremely Terrible, And If You Want To Remove Your Server From The Site They Wont Let You.

  • Avatar of Firestarthe Firestarthe Apr 12, 2014 at 04:05 UTC - 0 likes

    @SkeletonGamez: Go

    This works in 1.7.2 and 1.7.4+

  • Avatar of Firestarthe Firestarthe Apr 12, 2014 at 04:04 UTC - 0 likes

    @Kahanamoku78: Go

    Actually we are still running strong

  • Avatar of Kahanamoku78 Kahanamoku78 Mar 17, 2014 at 21:14 UTC - 0 likes

    Looks like this plugin is Abandonware..... I think I'll use Glizer instead.

    Last edited Mar 17, 2014 by Kahanamoku78
  • Avatar of SkeletonGamez SkeletonGamez Feb 22, 2014 at 02:07 UTC - 1 like

    Plz update to 1.7.2/1.7.4

  • Avatar of marubal21 marubal21 Feb 06, 2014 at 05:36 UTC - 0 likes

    I apologize if this has been answered before, or somewhere i might have missed it. But, how do you install this plugin when setting up a server using BungeeCord support for multiple servers?

  • Avatar of guntarzz guntarzz Feb 03, 2014 at 13:05 UTC - 0 likes

    Mmm good job .
    VERSION : 1.7.4

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

    @2insanepeople: Go

    I'm having the same issue. It's picking up my server's bans just fine, but it's not listing it as "online" nor "active," and it's losing rep every day.

    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


Date created
Aug 24, 2011
Last update
Jul 20, 2013
Development stage
GNU General Public License version 3 (GPLv3)
Curse link
Recent files



Optional dependency