UUID support. Read changelog for more

MaxBans is a project I've been writing for my server, MaxGamer. I struggled to find a banning plugin that wasn't a joke, and the good plugins were all designed for Premium servers anyway. Nothing gave us the tools that SHOULD have been out there - Like temp mutes, temp IP bans, duplicate IP lookups, and good autocompletion!

It is thoroughly tested on an Offline-Mode server, so you can bet it's rock solid and feather light!

Databases ===

  • MySQL
  • SQLite (Flatfile)

Best Features ===

Here are the top ten features of MaxBans over other banning plugins:

  1. Full UUID support
  2. Ability to view players' previous username(s) - date of change
  3. Full server lockdown - Prevent anyone from joining with a custom message (Such as bot attacks)
  4. Offline player name auto completion
  5. Warnings system
  6. Duplicate IP detection
  7. DNSBL lookups to stop proxys!
  8. Multiline kick messages! No more running off the screen!
  9. Notifications when a banned player tries to join!
  10. All times are relative! (Eg. "You're banned for 4 minutes 6 seconds", not "You're banned til 5:43pm CST")
  11. Customize every colour!
  12. Block commands like /me when muted!


  • /unban <name, IP or UUID>
  • /ban <name, IP or UUID> <reason>
  • /ipban <name, IP or UUID> <reason>
  • /tempban <name, IP or UUID> <number> <minutes|hours|days|weeks|etc> <reason>
  • /tempipban <name, IP or UUID> <number> <minutes|hours|days|weeks|etc> <reason>
  • /mute <name or UUID>
  • /tempmute <name or UUID> <number> <minutes|hours|days|weeks|etc>
  • /kick <name, * for everyone or UUID>
  • /checkip <name or UUID>
  • /uuid
  • /togglechat
  • /dupeip <name, IP or UUID>
  • /checkban <name, IP or UUID>
  • /warn <name or UUID> <reason>
  • /clearwarnings <name or UUID> <reason>
  • /unwarn <name or UUID> - Removes a players most recent warning
  • /unmute <name or UUID>
  • /history [name] [number of records] - Displays a history of bans, kicks, mutes & more dealt
  • /mbreload - Reloads the plugin
  • /mbdebug - Outputs debug information for me if you're having issues!
  • /mbwhitelist <name or UUID> - Allows the given user to bypass IP bans (Not regular bans! Eg, use for players with siblings who need to be IP banned)
  • /ipreport - Basically, a mass /dupeip, on everyone who is online
  • /lockdown [reason]
  • /forcespawn - Teleports someone to the spawn (Twice, so /back won't work)
  • /mbreload - Reloads maxbans
  • /mbimport - Imports vanilla minecraft (And others) bans.
  • /mbexport - Export bans to vanilla, MySQL or SQLite databases. (Allows swapping SQLite <-> MySQL), and others ban plugins.
  • /rangeban <ip1-ip2> [reason] - Bans the IP range from ip1 to ip2 for the supplied reason.
  • /temprangeban <ip1-ip2> <time> <hours/min/sec> [reason] - Temporary variant of above
  • /unrangeban <ip> - Removes any RangeBan which overlaps with the given IP. Eg, if is banned, unbanning will lift the whole ban on

Almost any command may have -s added in it to prevent announcing it, for example:

/tempban NewGuy101 -s 1 hour MaxBans is Awesome!

- Nobody will see the announcement that NewGuy101 was temp banned, just the fact he "has left the game."

If you want an in-depth analysis of each command, try here:

Configuration Guide===

This is an in-depth guide on how to configure MaxBans :) If I've missed anything, ask in the comments!

Common Issues===

This is a list of common issues people have with MaxBans, such as plugin conflicts.

Features that will never implement===

  • Fines (Use your economy to do this!)
  • Jails
  • Regional bans
  • Ban weightings

Ban Listing Webpage===

Check out this guy's work for an amazing webpage setup to view MaxBans while using MySQL. Link: I haven't personally set it up, but the page looks quite sleek and well done!

Metrics ===

This plugin uses Hidendra's plugin metrics system ( which tracks server information including:

  • A unique ID
  • Java version
  • Online/Offline mode
  • Plugin & Server version
  • OS name, version, architecture
  • Number of CPU cores
  • Players online
  • Metrics version

These stats can be disabled using the PluginMetrics config file (BukkitServer/plugins/PluginMetrics/config.yml).

GeoIP Lookup===

MaxBans will download a GeoIP.csv file, which allows it to look up the country of origin for IP addresses. The file is approx. 1.7MB and is downloaded from automatically on the first run. The file is only downloaded once (Unless it is renamed/removed).

Hello there. I have currently taken over this project as Netherfoam is busy with school and other real life stuff/projects.
I am planning on keeping this plugin updated, and hopefully with all the required features for a 1.8 plugin now a-days.
Plugin is mainly coded by JOEHOT200, while I am still just learning! :)
I will try as well as I can to respond to every question/suggestion!

Hi, I'm an 19 year old University student studying Software Engineering. I spend my time writing code that I receive practically no reward for other than people asking questions I've answered a hundred times before. I know server Admin's and Owners aren't the richest of people - But if you're feeling particularly generous, I always appreciate any amount for the time and patience I put into coding Bukkit plugins.

all donations still goes to Netherfoam

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

  • Avatar of mohamadm0 mohamadm0 Aug 27, 2016 at 18:45 UTC - 0 likes

    I have a problem

    When i ban a people he can join the server with not unban

    i think it is the essentials,but i dont know how to fix it

    help plz :(

  • Avatar of YaBoyHere YaBoyHere Aug 17, 2016 at 10:23 UTC - 0 likes

    @MrVault: Go

    I have the same problem

  • Avatar of MrVault MrVault Aug 15, 2016 at 01:52 UTC - 1 like

    Hey, how can I fix it where you press tab on someones name and it doesn't put capitals on their name? like I want it to do /ban Name not /ban name without the capital?

  • Avatar of creepergalaxydfdvvge creepergalaxydfdvvge Aug 14, 2016 at 08:29 UTC - 0 likes

    Can you add so we can customize the mute messages?

  • Avatar of ElGoMer ElGoMer Aug 08, 2016 at 17:38 UTC - 2 likes

    the tempban have a bug! !!!!

    just ban for 10 minutes and 5 seconds!!!

    can you fixed??? 7u7

  • Avatar of XxDawnsusxX XxDawnsusxX Aug 05, 2016 at 07:28 UTC - 0 likes

    Max time for tempban cant be longer then 10 minutes....

  • Avatar of YaBoyHere YaBoyHere Jul 20, 2016 at 11:51 UTC - 0 likes

    Hey can someone tell me how to make prefix and suffix appear in the ban screen and on the chat message. Thank you

  • Avatar of Icabash Icabash Jul 19, 2016 at 05:48 UTC - 0 likes

    @iversen0: Go

    How soon is soon? MB Hasn't been updated in over a year and it's really becoming difficult to use with so many issues.


  • Avatar of FireMario2111 FireMario2111 Jul 04, 2016 at 15:42 UTC - 0 likes

    @girly5: Go

    Get essentials and you can do /seen

  • Avatar of girly5 girly5 Jul 02, 2016 at 00:46 UTC - 0 likes


    I love your plugin however, I feel one of the most important commands doesn't work. It's the command used to check all online players for multiple accounts. This doesn't work and tells me the command doesn't exist, I would love if you could tell me why this is or fix it!:) The command is /ipreport Thanks for creating the plugin!


Do you use BungeeCord?

  1. Choice:

  1. Results
  2. 3 comments


Date created
Dec 26, 2012
Last update
Apr 17, 2015
Development stage
  • enUS
GNU General Public License version 3 (GPLv3)
Curse link
Recent files