MaxBans Plus

MaxBans Plus



Welcome to MaxBans Plus. This is a rewrite of the original MaxBans project, which is still available here.


If you've got questions or feel that I've missed anything, feel free to raise an issue through the GitHub Interface. If you're looking for documentation, check out the GitHub Wiki. it might be able to help you with:


Notice: This is not MaxBans, this is MaxBans Plus -- it is a rewrite of the original project. If you want the old project maintained by Fabio12, check it out  here.



Here's a brief overview of the usage of the plugin



The short version of installing the plugin is like so:

  • Download the JAR from here
  • Place the JAR in plugins/
  • Start your server
  • Optional:
    • Stop the server
    • Edit the config files in plugins/MaxBansPlus/


The configuration explanation can be found here.



These are the commands available to anyone with permission. The permission convention is maxbans.COMMAND_NAME. For example, to allow a user to unmute someone, it's maxbans.unmute.


Here's the most common commands you'll be using:

  • /ban [duration] [message]
  • /mute [duration] [message]
  • /ipban <user|address> [duration] [message]
  • /ipmute <user|address> [duration] [message]
  • /warn [message]
  • /unban <user|address>
  • /unmute <user|address>
  • /kick [message]
  • /iplookup
  • /lockdown <ALL|JOIN|NEW|OFF> [message]
  • /history [page] [user]

Note: Arguments inside <> are required, while ones outside [] are optional.



Some examples of the above commands:

  • /ban Merlin 5 hours Wizards are not allowed
  • /mute Harry Silencio!
  • /ipban Circe No witches, either!
  • /warn Witch You look like a witch!



Here's a comprehensive list of permissions:

Permission Description
maxbans.ban Ban and unban commands
maxbans.mute Mute and unmute commands
maxbans.ipban IP ban command
maxbans.ipmute IP mute command
maxbans.warn Warn command
maxbans.kick Kick command
maxbans.iplookup Lookup command
maxbans.broadcast See broadcast messages, eg. User was banned. This is given by default.
maxbans.mod See alerts when players try to join / chat but are denied because they're not allowed to
maxbans.silent See when players use silent maxbans commands.

View recent punishments dealt



MaxBans will notify you when things occur via chat. There are three types of permissions to control this:


Broadcast: maxbans.broadcast is the permission node required to see server-wide messages from MaxBans. For example, if a user was banned, everyone with this permission who is currently online will be told that the user was banned. Broadcasting can be disabled by using the -s (s for silent) flag in your command. This is given to players by default, but can be taken away through permission setup.


Silent: maxbans.silent is the permission node required to see hidden messages whenever a command with -s is run. Moderators usually want this.


Mod: maxbans.mod is the permission to alert moderators when activity occurs on the server. For example, it will notify moderators when a banned player tries to join, or when a muted player tries to chat. This does its best not to spam moderators, and discards similar messages which are generated frequently.


Privacy Notice: This plugin uses bStats to track plugin metrics over here at - The standard information is tracked (geography, mode, version, system specs) as well as activity (bans, mutes, warnings, kicks) and the locale used. This can be disabled by configuring plugins/bStats/config.yml


  • To post a comment, please or register a new account.
Posts Quoted:
Clear All Quotes

About This Project

  • Project ID
  • Created
    Mar 15, 2018
  • Last Released File
    Mar 3, 2020
  • Total Downloads
  • License



Recent Files