MCBans intro

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.


Posts Quoted:
Clear All Quotes