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 RiriHD RiriHD May 17, 2016 at 17:34 UTC - 0 likes

    Hello, I have a problem. In the configuration I set the maximum time a ban was 1 week, but when I ban one hour I have this error message

    The Problem -> The Config ->

  • Avatar of TeoGamer123 TeoGamer123 May 08, 2016 at 19:22 UTC - 0 likes

    @Synthhero1: Go

    there's no version for 1.9 out yet for this plugin, just wait for the developer to update it.

  • Avatar of Synthhero1 Synthhero1 Apr 16, 2016 at 02:59 UTC - 0 likes

    Another MAJOR bug. Herochat and maxbans wont work for 1.9.2 If you perform /mute to a player he can still chat after muting.

  • Avatar of VantuPlays VantuPlays Mar 22, 2016 at 10:12 UTC - 0 likes

    Hey, So Whenever I do /dupeip (IP) To check someone's other accounts, It keeps saying, "An internal error occurred while attempting to perform this command. Please help!

  • Avatar of Joey249 Joey249 Mar 15, 2016 at 04:46 UTC - 0 likes

    Max bans has a bug where you can only tempban for 10 Mins and 5 Secs. To fix this, download MaxBans version 2.3, this will also fix the /immune command.

    Everything seems to be working fine in 2.3, if you dont care about the /immune command then the tempban feature is also working perfectly in 2.4.

    2.3 Download:

    2.4 Download:

    To use the immune command, do /immune <player name> <true or false> First enable will say "success", if you try to enable it while it already is enabled, it will give you an error message, to confirm that it's still working you could disable it with false, which should then say "success", then re-enable it which will once again give you a "success" message since it was disabled. When other players tries to ban you, the ban message still comes up in chat, but you do not get banned. Not sure what node you need to use this, im guessing maxbans.immune , I enabled it while in OP mode, you can also enable it for others if the permission node is incorrect/not working.

    Last edited Mar 15, 2016 by Joey249
  • Avatar of Babostylez Babostylez Mar 13, 2016 at 14:39 UTC - 0 likes

    Maxtempban time = 10 Mins. and 5 Secs.

  • Avatar of Kian101 Kian101 Mar 05, 2016 at 22:30 UTC - 0 likes

    I cant tempban for any longer then 10mins and 5 seconds... also can anyone help me with "/unmute" i need the permission node?

  • Avatar of Paxination Paxination Mar 01, 2016 at 03:48 UTC - 0 likes

    @NoScripts: Go

    Really? Its been mentioned a 1000 times, the latest versions of this plugin sucks.

    Just use that one.

    Also, it doesnt work on 1.9, but it is possible to update your selves *IF* you goto spigots site and and read the release info about spigot 1.9 They tell you how to fix plugins that MIGHT be using old API methods.

  • Avatar of NoScripts NoScripts Feb 19, 2016 at 04:37 UTC - 0 likes

    Hey, I love this plugin, but when I try to tempban someone, it wont let me do it longer than 10 min 5 seconds

  • Avatar of lor54 lor54 Feb 09, 2016 at 11:35 UTC - 0 likes

    @netherfoam Hi, I have a problem. When I start this plugin, I get this error:

    Last edited Feb 09, 2016 by lor54

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