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!


  • 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!


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 all. I am other dev and now i assuming the Project for bugfixes and possible improvements.
Netherfoam still busy but still online on comunity. I have a lot of time to code (i have a home work) and i can maintain this plugin (and my others) Always updated ;)
See ya o/

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

  • Avatar of Henaminator Henaminator Oct 25, 2016 at 00:28 UTC - 0 likes

    List of blocked commands when people are muted? Such as /tell, /m, etc.

  • Avatar of dutchy1001 dutchy1001 Oct 21, 2016 at 23:56 UTC - 0 likes

    @netherfoam: Go @CoolLord22: Go

    I have to agree with @PixelHacks: Go, I have checked the SQLite and MySQL db's and in either of them I can find the UUID listed to ban/warn or tempban a player. Somehow there should be a reference to the UUID in the MySQL-DB or it wont know it is banned
    I use v2.7 so updating to a newer version will not fix this.
    This might be a serious issue that needs to be addressed very quick with a fix.

    uSkyblock: Official Website
    uSkyblock: Issue report
    Latest Dev version download: Latest
    uSkyblock server:

    I'm associated with uSkyblock (v2.0.1 and upwards) but can't be held responsible for mistakes you make.

  • Avatar of PixelHacks PixelHacks Oct 21, 2016 at 22:59 UTC - 0 likes

    @CoolLord22: Go

    I have the version 2.6. But if I ban a player and he changed his name he can still join.

  • Avatar of CoolLord22 CoolLord22 Oct 21, 2016 at 20:53 UTC - 0 likes

    @PixelHacks: Go

    Which version are you using? It has UUID support lol xD

  • Avatar of PixelHacks PixelHacks Oct 21, 2016 at 11:47 UTC - 0 likes

    Ok Ok Ok. This is a very nice plugin BUT: If I ban a player for permanent he easily can change his name on and now the player can join because he's unbanned... Thats not nice. Please add a full UUID Support. A player will be banned for permanent and if he change his name he is still banned for permanent. Also i would add a /banlist or a /rollback. If a staff member do anything (banned all players) the owner or other player can do /rollback <NAME> and then all Bans, Warns, Mutes will be cleared from this player (like Litebans). Pls add this 3 features or i must to buy the plugin Litebans.. sry but Litebans is currently better as Maxbans.

  • Avatar of MerlinK11 MerlinK11 Oct 16, 2016 at 23:34 UTC - 0 likes

    I have a found Bug all commands with temp in name is buggy / Broken please Fix this

  • Avatar of CoolLord22 CoolLord22 Oct 13, 2016 at 23:10 UTC - 0 likes

    Sorry if this is dumb, but could you explain a little how to setup the webpage? Thank you!

  • Avatar of Jaxtrex Jaxtrex Oct 10, 2016 at 03:20 UTC - 0 likes

    Can you fix the spelling of "monthes" for the times, there is no "e" in months. I'm sorry, I know this is a small detail, but it really bugs me.

  • Avatar of GodlyNuk3s GodlyNuk3s Sep 26, 2016 at 15:55 UTC - 0 likes

    Can you make it so when a player gets warned a message shows on their screen like.

    - You resived a warning - Reason Spam

    and maybe add /tempipmute

    Last edited Sep 30, 2016 by GodlyNuk3s
  • Avatar of netherfoam netherfoam Sep 26, 2016 at 10:13 UTC - 0 likes

    @TheHadDad: Go

    One of your plugins is interfering with MaxBans. Ask them to fix their issue.

    @AntZaro: Go

    Pretty sure there's a permission node like maxbans.seebroadcast - Have a look at the configuration page. It's given to everyone by default, but if you negate the permissions from regular players without negating it for staff, you should be fine. permissions documented here:

    @xRoyalFeeds: Go

    Okay, so you can sort through 10,000 bans that you've handed out in the lifetime of your server? No.

    You most likely want the /history command

    @AtomMitte: Go

    Yes, if you configure Spigot and Bungee correctly with IP forwarding. Get started with

Do you use BungeeCord?

  1. Choice:

  1. Results
  2. 3 comments


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