BanManager

The defacto plugin for Minecraft to manage punishments and moderate more effectively

Overview

• Free. Open source and free to use
• Robust. Used and battle tested by some of the largest Minecraft servers
• Maintained. Actively developed since 2012, 10+ years
• Cross platform. Supports Bukkit, Spigot, Bungeecord & Sponge
• Feature rich. An advanced punishment system, reports, appeals, network friendly and website compatible
• Flexible. Fully customisable with extensive player permissions

To learn more about configuration, usage and features of BanManager, take a look at the website or view the website demo.

Requirements

• Java 21+
• CraftBukkit/Spigot/Paper, BungeeCord, Fabric or Sponge for Minecraft 1.7.2+
• Optionally MySQL or MariaDB

Installation

• Copy jar to mods (Fabric) folder
• For further instructions on how to support multiple servers click here

Commands

View full list here

• /ban <player> <reason> - Permanently ban a player, requires permission, requires permission bm.command.ban
• /tempban <player> <timeDiff> <reason> - Temporarily ban a player, requires permission bm.command.tempban
• /unban <player> [reason] - Unban a player, requires permission bm.command.unban
• /mute <player> <reason> - Permanently mute a player, requires permission bm.command.mute
• /tempmute <player> <timeDiff> <reason> - Temporarily mute a player, requires permission bm.command.tempmute
• /unmute <player> [reason] - Unmute a player, requires permission bm.command.unmute
• /banip <player ip> <reason>- Permanently ban an ip address or ip of a player, requires permissionbm.command.banip-/tempbanip <player ip> <timeDiff> <reason> - Temporarily ban an ip address or ip of a player, requires permission bm.command.tempbanip
• /unbanip <ip> [reason] - Unban an ip address, requires permission bm.command.unbanip
• /muteip <player ip> <reason>- Permanently mute an ip address or ip of a player, requires permissionbm.command.muteip-/tempmuteip <player ip> <timeDiff> <reason> - Temporarily mute an ip address or ip of a player, requires permission bm.command.tempmuteip
• /unmuteip <ip> [reason] - Unmute an ip address, requires permission bm.command.unmuteip
• /baniprange <cidr wildcard> <reason>- Permanently ban a cidr or wildcard ip range, e.g. 192.168.0.1/16 or 192.168.*.*, requires permissionbm.command.baniprange-/tempbaniprange <cidr wildcard> <timeDiff> <reason> - Temporarily ban a cidr or wildcard ip range, requires permission bm.command.tempbaniprange
• /unbaniprange <cidr wildcard player> - Unban an ip range, requires permission bm.command.unbaniprange
• /warn <player> <reason> - Warn a player, requires permission bm.command.warn
• /tempwarn <player> <timeDiff> <reason> - Temporarily warn a player, requires permission bm.command.tempwarn
• /dwarn <player> - Delete the last warning a player received, requires permission bm.command.dwarn
• /addnote <player> <message> - Add a note against a player, requires permission bm.command.addnote
• /notes [player] - View notes of all online players or a particular player, requires permission bm.command.notes
• /kick <player> <reason> - Kick a player from the server, requires permission bm.command.kick
• /nlkick <player> <reason> - Kick a player from the server without logging the kick if kick logging enabled, requires permission bm.command.nlkick
• /bminfo [player] - Look up information of a player, requires permission bm.command.bminfo
• /bmimport, Check the migration guides for more information, requires permission bm.command.import
• /bmexport <players ips>- Export bans to vanilla format, requires permissionbm.command.export-/bmreload- Reload plugin configuration and messages (excludes database connection info), requires permissionbm.command.reload-/banlist [players ipranges ips]- List all bans stored in memory, requires permissionbm.command.banlist-/bmsync <local external> - Force the server to syncronise with the database, requires permission bm.command.sync
• /bmclear <player> [banrecords baniprecords kicks muterecords notes warnings]- Clear all records of a player or specify a type, requires permissionbm.command.clear-/bmdelete <banrecords kicks muterecords notes warnings> <ids>- Delete specific records for a player based on ids from /bminfo, requires permissionbm.command.delete-/bmactivity <timeDiff> [player]- View recent activity of staff, or a particular player, requires permissionbm.command.bmactivity-/alts <player ip> - List players which have the same ip address, requires permission bm.command.alts
• /report <player> <reason> - Report a player for rule breaking, logs their location and the actors location, as well as other data, requires permission bm.command.report
• /reports - Report management, executes list by default, requires permission bm.command.reports
• /reports assign <ids> [player] - Assign a report to a player, if none given assigns to self, requires permission bm.command.reports.assign
• /reports close <ids> [/command comment]- Marks a report as closed, with an optional comment or command, requires permissionbm.command.reports.close-/reports list [page] [state]- Lists reports, requires permissionbm.command.reports.list-/reports tp <id>- Teleports you to where the report was created, requires permissionbm.command.reports.tp-/reports unassign <ids>- Unassigns reports from a player, requires permissionbm.command.reports.unassign-/bmrollback <player> <timeDiff> [types]- Allows rolling back malicious actions by a staff member, requires permissionbm.command.bmrollback-/banname <name> <reason>- Ban any players with the name specified, requires permissionbm.command.banname-/tempbanname <name> <timeDiff> <reason>- Temporarily ban a name, requires permissionbm.command.tempbanname-/unbanname <name> [reason]- Unban a name, requires permissionbm.command.unbanname-/bmutils <duplicates missingplayers> - Utility commands to aid with resolving issues, requires permission bm.command.bmutils
• /bmutils duplicates [UUID] [newName] - Finds duplicate player names and allows manual updating of a player name, requires permission bm.command.bmutils.duplicates
• /bmutils missingplayers - Finds missing player records associated to punishments and creates them, requires permission bm.command.bmutils.missingplayers

Permissions

View full list here

Development

git clone [email protected]:BanManagement/BanManager.git

Contributing

If you'd like to contribute, please fork the repository and use a feature branch. Pull requests are warmly welcome.

Help / Bug / Feature Request

If you have found a bug please open an issue with as much detail as possible, including relevant logs and screenshots where applicable

Have an idea for a new feature? Feel free to open an issue or join us on Discord to chat

License

Free to use under the Creative Commons Attribution-NonCommercial-ShareAlike 2.0 UK: England & Wales