MCBans Logo

MCBans Logo

Welcome to MCBans

MCBans is a 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 global bans. Local ban is a servers private ban on a player, and is not shared.

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

MCBans Website:

Latest MCBans:



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]

Need Support?

Check out our forum at Or check in for a chat via our IRC chatroom at irc://

MCBans Just a Global Banning Plugin?

Absolutely not, but that is our main focus. We have a way that lets you customize what you share, what servers share bans with you, and what servers you want to be grouped with ( meaning their bans are your bans ), ignore all bans for a player, disregard bans based on a string of your own choosing, even "grief" can be ignored. Reputation is calculated on each server for every player to give server owners the most control.

MCBans is a banning plugin that also has an ability for servers to ban to the point where a player can no longer join a MCBans protected server due to the number of bans. The bans can be appealed within 60 days of being issued, and a server is required to provide proof for Global bans only. Local bans are generally hidden from view and do not cause a player to lose access to MCBans protected servers.

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.

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.


Local Ban Variations

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

Global Ban Variations

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

Temporary Ban Variations

  • /ban <playername|uuid> t <int> <m/h/d> <reason> - temp bans a player
  • /tban <playername|uuid> <int> <m/h/d> <reason> - temp bans a player
  • /rban <playername|uuid> 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|uuid> - checks players ban history (local/global bans)
  • /banlookup <banID> - checks ban details
  • /kick <playername|uuid> [reason] - kicks a player from the game
  • /unban <playername|IP|uuid> - 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
  • mcbans.ban.exempt (default: op) - Exempt from bans


  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 23, 2014 at 10:42 UTC - 0 likes

    @xK3ks: Go

    We are working to get a bungee cord version out.


  • Avatar of Firestarthe Firestarthe Apr 23, 2014 at 10:40 UTC - 0 likes

    @DerekZil: Go

    You can also use MCBans for more than just global bans, but as a way to store your local bans, and have a managed system. You can have your server networked, meaning only servers that you add will have their bans recognized. You can also setup a group for your servers which you can share bans between, be that global local or temp bans.

    So if you have 3 servers, you can setup a group OR a network and share your bans between them easily, without having to worry about syncing.

  • Avatar of xK3ks xK3ks Apr 21, 2014 at 22:25 UTC - 0 likes

    Can I use it with Bungee Cord?

  • Avatar of Searchndstroy Searchndstroy Apr 21, 2014 at 06:13 UTC - 0 likes

    @DerekZil: Go

    :# There's a dispute ban button for a reason... If the server doesn't supply proof, the global ban is removed. Localbans do nothing, if a server will ban you based on locals, don't play there....

    Last edited Apr 21, 2014 by Searchndstroy
  • Avatar of DerekZil DerekZil Apr 21, 2014 at 00:39 UTC - 1 like

    Little kids that have this plugin ban players for no reason.

    This plugin is awful the way it is set up.

    Insanity Realms Website

  • Avatar of JozefSK JozefSK Apr 20, 2014 at 18:24 UTC - 0 likes

    Hello, please add function SwearCensor - automatic BAN

    Last edited Apr 20, 2014 by JozefSK
  • 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+


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



Optional dependency