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
- 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]
- /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:
|maxbans.ban||Ban and unban commands|
|maxbans.mute||Mute and unmute commands|
|maxbans.ipban||IP ban command|
|maxbans.ipmute||IP mute 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 https://bstats.org/plugin/bukkit/MaxBansPlus - 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