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.2 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 are 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 appreciated 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 the wiki: Check out our forum: 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 offenses 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 NewtPvP NewtPvP Dec 01, 2014 at 23:06 UTC - 0 likes

    Does this plugin work on 1.8?

  • Avatar of CloudeLecaw CloudeLecaw Nov 24, 2014 at 00:29 UTC - 0 likes

    do i need to setup the thing with the MCban API Key on the MCbans site or can i simply use this tool for manging local bans?

  • Avatar of Firestarthe Firestarthe Nov 06, 2014 at 16:58 UTC - 0 likes

    @Varengard: Go

    Yes it will work fine on 1.7.10


  • Avatar of Varengard Varengard Nov 06, 2014 at 15:55 UTC - 0 likes

    I know this plugin is made for 1.7.9 CB/Spigot, and as I own a pretty heavy-modded server (about 50 and 65 plugins) based on a cauldron1.7.10 build forge12xx+, do you think it will work smoothly or is there any kind of risk? (I don't actually have a testing setup which can handle a copy of the server, and a fail on the live-one could be just... the end of my life >.<)
    Thanks for answer, I will wait for it:3
    Have a nice day!

    (PS: Hope I didn't burned your eyes, I'm not from an english country)

  • Avatar of abcedea abcedea Oct 02, 2014 at 12:49 UTC - 0 likes

    @Azekial07: Go

    You can broadcast ban and kick notifications to all players with these permissions:

    - mcbans.kick.view
    - mcbans.ban.view
    Last edited Oct 02, 2014 by abcedea: code tags on perms
  • Avatar of Konsider Konsider Sep 21, 2014 at 11:17 UTC - 1 like

    It would be really handy if there were the option in the config to set it so that /ban would automatically ban both the playername and the IP at the same time.

    My server IP:

  • Avatar of Sshadowkraft Sshadowkraft Sep 05, 2014 at 17:59 UTC - 0 likes

    When using command '/lookup' it doesn't seem to show local bans anymore. It did in the previous versions but not in the most recent one. I'm sure the server owner didn't mess with the perms, I'll check everything on my side again. If possible could you look into this or if already fixed or information I don't know about please tell me. Thanks for reading and thank you for any help.

  • Avatar of Laxer21117 Laxer21117 Aug 22, 2014 at 23:56 UTC - 0 likes

    I need help from somebody fast! Okay so I can't get on my favorite server because it says I have more alt accounts. I found out the names of the accounts and they are accounts I have never heard of! Somebody please help me!

    When life hands you lemons... eat them... :P

  • Avatar of BethePandaGames BethePandaGames Aug 17, 2014 at 08:12 UTC - 0 likes

    @lilacorn: Go

    Make sure when you are connecting it is when you are logged in.

  • Avatar of Dutch_Boy Dutch_Boy Jul 27, 2014 at 11:54 UTC - 0 likes


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



Optional dependency