## **[![https://banmanagement.com/images/banmanager-icon.png](https://banmanagement.com/images/banmanager-icon.png)](https://ore.spongepowered.org/linkout?remoteurl=https%3a%2f%2fbanmanagement.com)** **BanManager** ##### **The defacto plugin for Minecraft to manage punishments and moderate more effectively** **[Website](https://banmanagement.com) | [Docs](https://banmanagement.com/docs/webui/install) | [Demo](https://demo.banmanagement.com)** [![https://github.com/BanManagement/BanManager-WebUI/blob/assets/welcome.png?raw=true](https://github.com/BanManagement/BanManager-WebUI/blob/assets/welcome.png?raw=true)](https://demo.banmanagement.com) ### **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](https://github.com/banmanagement/banmanager-webui) * **Flexible.** [Fully customisable](https://banmanagement.com/docs/banmanager/configuration) with [extensive player permissions](https://banmanagement.com/docs/banmanager/permissions) To learn more about configuration, usage and features of BanManager, take a look at [the website](https://banmanagement.com/docs/banmanager/configuration) or view [the website demo](https://demo.banmanagement.com). ### **Requirements** * Java 8+ * CraftBukkit/Spigot/Paper, BungeeCord or Sponge for Minecraft 1.7.2+ * Optionally [MySQL or MariaDB](https://banmanagement.com/docs/banmanager/install#setup-shared-database-optional) ### **Installation** * Copy jar to plugins (Bukkit/Spigot/Paper) folder * For further instructions on how to support multiple servers [click here](https://banmanagement.com/docs/banmanager/install-network) ### **Commands** View [full list here](https://banmanagement.com/docs/banmanager/commands) * /ban - Permanently ban a player, requires permission, requires permission bm.command.ban * /tempban - Temporarily ban a player, requires permission bm.command.tempban * /unban [reason] - Unban a player, requires permission bm.command.unban * /mute - Permanently mute a player, requires permission bm.command.mute * /tempmute - Temporarily mute a player, requires permission bm.command.tempmute * /unmute [reason] - Unmute a player, requires permission bm.command.unmute * /banip - Permanently ban an ip address or ip of a player, requires permission bm.command.banip * /tempbanip - Temporarily ban an ip address or ip of a player, requires permission bm.command.tempbanip * /unbanip [reason] - Unban an ip address, requires permission bm.command.unbanip * /muteip - Permanently mute an ip address or ip of a player, requires permission bm.command.muteip * /tempmuteip - Temporarily mute an ip address or ip of a player, requires permission bm.command.tempmuteip * /unmuteip [reason] - Unmute an ip address, requires permission bm.command.unmuteip * /baniprange - Permanently ban a cidr or wildcard ip range, e.g. 192.168.0.1/16 or 192.168.*.*, requires permission bm.command.baniprange * /tempbaniprange - Temporarily ban a cidr or wildcard ip range, requires permission bm.command.tempbaniprange * /unbaniprange - Unban an ip range, requires permission bm.command.unbaniprange * /warn - Warn a player, requires permission bm.command.warn * /tempwarn - Temporarily warn a player, requires permission bm.command.tempwarn * /dwarn - Delete the last warning a player received, requires permission bm.command.dwarn * /addnote - 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 - Kick a player from the server, requires permission bm.command.kick * /nlkick - 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](https://banmanagement.com/docs/banmanager/migrations) for more information, requires permission bm.command.import * /bmexport - Export bans to vanilla format, requires permission bm.command.export * /bmreload - Reload plugin configuration and messages (excludes database connection info), requires permission bm.command.reload * /banlist [players || ipranges || ips] - List all bans stored in memory, requires permission bm.command.banlist * /bmsync - Force the server to syncronise with the database, requires permission bm.command.sync * /bmclear [banrecords || baniprecords || kicks || muterecords || notes || warnings] - Clear all records of a player or specify a type, requires permission bm.command.clear * /bmdelete - Delete specific records for a player based on ids from /bminfo, requires permission bm.command.delete * /bmactivity [player] - View recent activity of staff, or a particular player, requires permission bm.command.bmactivity * /alts - List players which have the same ip address, requires permission bm.command.alts * /report - 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 [player] - Assign a report to a player, if none given assigns to self, requires permission bm.command.reports.assign * /reports close [/command || comment] - Marks a report as closed, with an optional comment or command, requires permission bm.command.reports.close * /reports list [page] [state] - Lists reports, requires permission bm.command.reports.list * /reports tp - Teleports you to where the report was created, requires permission bm.command.reports.tp * /reports unassign - Unassigns reports from a player, requires permission bm.command.reports.unassign * /bmrollback [types] - Allows rolling back malicious actions by a staff member, requires permission bm.command.bmrollback * /banname - Ban any players with the name specified, requires permission bm.command.banname * /tempbanname - Temporarily ban a name, requires permission bm.command.tempbanname * /unbanname [reason] - Unban a name, requires permission bm.command.unbanname * /bmutils - 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](https://banmanagement.com/docs/banmanager/permissions) ### **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](https://github.com/banmanagement/banmanager/issues/new) 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](https://github.com/banmanagement/banmanager/issues/new) or [join us on Discord](https://discord.gg/59bsgzb) to chat ### **License** Free to use under the [Creative Commons Attribution-NonCommercial-ShareAlike 2.0 UK: England & Wales](https://github.com/banmanagement/banmanager/blob/master/licence)

BanManager

7.10.0