Commands & Permissions

All commands have aliases prefixed with bm, e.g. /bmban, /bmtempban etc.

Key [optional] <required> <option 1 || option 2 || option 3>

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

Global Commands

These commands are only available if the global database option within your config is enabled. These commands are simply for syncing bans across multiple servers, and do not have as granulated permissions as normal local commands as defined above.

The time it takes for each action to take affect depends on the interval your global scheduler is set to within your schedules.yml file is. Default is 5 minutes.

CommandDescriptionPermission
/banall <player> <reason>Permanently ban a player across multiple serversbm.command.banall
/tempbanall <player> <timeDiff> <reason>Temporarily ban a player across multiple serversbm.command.tempbanall
/unbanall <player>Unban a player across multiple serversbm.command.unbanall
/muteall <player> <reason>Permanently mute a player across multiple serversbm.command.muteall
/tempmuteall <player> <timeDiff>Temporarily mute a player across multiple serversbm.command.tempmuteall
/unmuteall <player> <timeDiff>Unmute a player across multiple serversbm.command.unmuteall
/banipall <player || ip> <reason>Permanently ban an ip across multiple serversbm.command.banipall
/tempbanipall <player || ip> <timeDiff> <reason>Temporarily ban an ip across multiple serversbm.command.tempbanipall
/unbanipall <ip>Unban an ip across multiple serversbm.command.unbanipall
/addnoteall <player> <message>Add a note across multiple serversbm.command.addnoteall

Flags

Some commands allow flags, see above for which commands can use what. Flags (singular or multiple) can be used anywhere after the command name, including the beginning, middle and even end.

/ban -s confuser test
/ban confuser -s test
/ban confuser test -s
/ban confuser this is the -s reason
FlagAliasDescriptionPermissionExample
-silent-sPerform the command silently without a broadcastbm.command.<command>.silent e.g. bm.command.tempban.silent/ban -s confuser Test
-bans-bList the past bans of a player via /bminfobm.command.bminfo.history.bans/bminfo confuser -b
-kicks-wList kick records of a player via /bminfobm.command.bminfo.history.kicks/bminfo confuser -k
-mutes-mList the past mutes of a player via /bminfobm.command.bminfo.history.mutes/bminfo confuser -m
-notes-nList all notes associated with a player via /bminfobm.command.bminfo.history.notes/bminfo confuser -n
-warnings-wList all warnings of a player via /bminfobm.command.bminfo.history.warnings/bminfo confuser -w
-time-tLimit data by a date using timeDiff formatting /bminfo confuser -t 23w
-soft-stSoft/shadow mutingbm.command.<command>.soft/tempmute confuser -st 1d Testing
-points-pSpecify severity of a warningbm.command.warn.points/warn confuser -p 4 Testing
-ips-iDisplay join/leave times of a player along with their ip addressbm.command.bminfo.history.ips/bminfo confuser -i
-delete-dDeletes a ban without creating a recordbm.command.unban.delete/unban confuser -d

Time Format

Any commands which denote a <timeDiff> argument can be used as follows:

10s = 10 seconds
10m = 10 minutes
10h = 10 hours
10d = 10 days
10mo = 10 months
10y = 10 years

Usage

/tempban confuser 1d Test
/tempban confuser 1w3d Test

Permissions

Please note that most commands have more permissions than listed above, and will be denoted here. BanManager has been designed to be as flexible as possible, hence the plethora of permissions.

PermissionDescription
bm.command.banAllows a player to permanently ban someone
bm.command.ban.offlineRequired to permanently ban an offline player
bm.command.ban.overrideAllows overriding an existing ban
bm.command.tempbanAllows a player to tempban someone
bm.command.tempban.offlineRequired to temporary ban an offline player
bm.command.tempban.overrideAllows overriding of an existing ban
bm.command.unbanAllows a player to unban someone
bm.command.unban.ownAllows a player to only unban a player they banned
bm.command.unban.deleteAllows using -d flag to delete a ban without creating a ban record
bm.command.warnAllows you to warn a player
bm.command.warn.offlineAllows you to warn an offline player who will be shown the message when they next join
bm.command.tempwarnAllows you to temporarily warn a player
bm.command.tempwarn.offlineAllows you to temporarily warn an offline player who will be shown the message when they next join
bm.command.syncAllows you to forcefully sync database changes
bm.command.baniprangeAllows you to permanently ban an ip range
bm.command.tempbaniprangeAllows you to temporary ban an ip range
bm.command.unbaniprangeAllows you to unban an ip range
bm.command.banlistAllows you to see active punishments stored in memory
bm.command.banlist.playersAllows you to see active player bans stored in memory
bm.command.banlist.ipsAllows you to see active ip bans stored in memory
bm.command.banlist.iprangesAllows you to see active ip range bans stored in memory
bm.command.bmactivityAllows you to see recent punishment activity
bm.command.clearAllows clearing of a players records
bm.command.clear.banrecordsAllows clearing of a player's ban records
bm.command.clear.baniprecordsAllows clearing of a player's ip ban records
bm.command.clear.kicksAllows clearing of a player's kick records
bm.command.clear.muterecordsAllows clearing of a player's mute records
bm.command.clear.notesAllows clearing of a player's notes
bm.command.clear.reportsAllows clearing of a player's reports
bm.command.clear.warningsAllows clearing of a player's warnings
bm.command.deleteAllows deleting a players record
bm.command.delete.banrecordsAllows deleting a player's ban record
bm.command.delete.kicksAllows deleting a player's kick record
bm.command.delete.muterecordsAllows deleting a player's mute record
bm.command.delete.notesAllows deleting a player's note
bm.command.delete.reportsAllows deleting a player's report
bm.command.delete.warningsAllows deleting a player's warning
bm.command.addnoteAllows adding a note to a player
bm.command.notesAllows viewing all notes of a player
bm.command.notes.onlineAllows viewing all notes of players currently online
bm.command.bminfoAllows use of /bminfo which shows your current ban info
bm.command.bminfo.playerstatsAllows seeing player statistics, amount of bans, mutes etc
bm.command.bminfo.connectionAllows seeing player's logged ip address
bm.command.bminfo.ipstatsAllows seeing ip statistics such as amount of bans
bm.command.bminfo.altsAllows seeing possible alts, same output as /alts
bm.command.bminfo.websiteDisplays link to players ban page, requires configuring within messages.yml
bm.command.bminfo.othersAllows viewing other players information
bm.command.banipAllows you to ban an ip
bm.command.banip.overrideAllows overriding an existing ip ban
bm.command.tempbanipAllows you to tempban an ip
bm.command.tempbanip.overrideAllows overriding an existing ip ban
bm.command.unbanipAllows you to unban an ip
bm.command.importAllows importing of banned players and ips from banned-players.json and banned-ips.json files
bm.command.kickAllows you to kick another player
bm.command.nlkickAllows you to kick another player without logging it
bm.command.muteAllows you to mute a player
bm.command.mute.offlineRequired to permanently mute an offline player
bm.command.mute.overrideAllows you to override an existing mute
bm.command.tempmuteAllows you to temp mute a player
bm.command.tempmute.offlineRequired to temporary mute an offline player
bm.command.tempmute.overrideAllows you to override an existing mute
bm.command.unmuteAllows you to unmute a player
bm.command.unmute.ownAllows a player to only unmute a player they muted
bm.command.reloadAllows you to reload from the config
bm.command.rollbackAllows rolling back staff actions
bm.command.bannameAllows banning a name
bm.command.banname.overrideAllows overriding an existing name ban
bm.command.tempbannameAllows temporarily banning a name
bm.command.tempbanname.overrideAllows overriding an existing name ban
bm.command.unbannameAllows unbanning a name
bm.exempt.kickOnline players with this permission cannot be kicked, highly recommended for admins
bm.exempt.banOnline players with this permission cannot be banned, highly recommended for admins
bm.exempt.ban.overrideAllows a player to ban an exempt player
bm.exempt.tempbanOnline players with this permission cannot be temporarily banned,highly recommended for admins
bm.exempt.tempban.overrideAllows a player to tempban an exempt player
bm.exempt.muteOnline players with this permission cannot be muted, highly recommended for admins
bm.exempt.mute.overrideAllows a player to mute an exempt player
bm.exempt.tempmuteOnline players with this permission cannot be temporarily muted, highly recommended for admins
bm.exempt.tempmute.overrideAllows a player to tempmute an exempt player
bm.exempt.banipOnline players with this permission cannot be ip banned, highly recommended for admins
bm.exempt.banip.overrideAllows a player to ip ban an exempt player
bm.exempt.tempbanipOnline players with this permission cannot be temporarily banned, highly recommended for admins
bm.exempt.warnOnline players with this permission cannot be warned
bm.exempt.tempwarnOnline players with this permission cannot be temporarily warned
bm.notify.banNotified when a player is permanently banned
bm.notify.tempbanNotified when a player is temporarily banned
bm.notify.unbanNotified when a player is unbanned
bm.notify.banipNotified when an ip is permanently banned
bm.notify.tempbanipNotified when an ip is temporarily banned
bm.notify.unipbanNotified when an ip is unbanned
bm.notify.muteNotified when a player is permanently muted
bm.notify.mutedShows attempted messages from muted players
bm.notify.tempmuteNotified when a player is temporarily muted
bm.notify.unmuteNotified when a player is unmuted
bm.notify.muteipNotified when an ip is permanently muted
bm.notify.mutedipShows attempted messages from muted ips
bm.notify.tempmuteipNotified when an ip is temporarily muted
bm.notify.unmuteipNotified when an ip is unmuted
bm.notify.baniprangeNotified when an ip range is permanently banned
bm.notify.tempbaniprangeNotified when an ip range is temporarily banned
bm.notify.unbaniprangeNotified when an ip range is unbanned
bm.notify.kickNotified when a player is kicked
bm.notify.reportsNotified when a player is reported
bm.notify.reports.openDisplays open reports on server join
bm.notify.reports.assignedDisplays assigned reports on server join
bm.notify.warnNotified when a player is warned
bm.notify.tempwarnNotified when a player is temporarily warned
bm.notify.duplicateipsNotified when a player with the same ip address of a banned player joins
bm.notify.notesNotified when a note is created for a player
bm.notify.notes.joinDisplays all notes associated with a player who joined the server
bm.notify.denied.playerNotified when a banned player attempts to join
bm.notify.denied.ipNotified when a player attempts to join from a banned ip address
bm.notify.bannameNotified when a name is permanently banned
bm.notify.tempbannameNotified when a name is temporarily banned
bm.notify.unbannameNotified when a name is unbanned
bm.timelimit.playerBans.bypassAllows a player to bypass any group limitations on temporary ban lengths
bm.timelimit.playerMutes.bypassAllows a player to bypass any group limitations on temporary mute lengths
bm.timelimit.ipBans.bypassAllows a player to bypass any group limitations on temporary ban lengths
bm.timelimit.ipMutes.bypassAllows a player to bypass any group limitations on temporary mute lengths
bm.timelimit.rollbacks.bypassAllows a player to bypass any group limitations on rollback lengths
bm.timelimit.nameBans.bypassAllows a player to bypass any group limitations on temporary name lengths
bm.command.reportAllows reporting a player
bm.command.reportsAllows access to report management
bm.command.report.offlineAllows reporting an offline player
bm.command.reports.assignAssign a report to yourself
bm.command.reports.assign.otherAssign a report to another player
bm.command.reports.closeClose a report
bm.command.reports.listList assigned reports
bm.command.reports.list.othersList all reports
bm.command.reports.teleportTeleport to a player report location
bm.command.reports.unassignUnassign a report
bm.command.bmutilsAllows access utility commands
bm.command.bmutils.missingplayersAllows access to missingplayers subcommand
bm.command.bmutils.duplicatesAllows access to duplicates subcommand