Commands
BanManager contains a number of commands each with a subset of permissions. All commands have aliases prefixed with bm
, e.g. /bmban, /bmtempban etc.
Command | Description | Flags | Permission |
---|---|---|---|
/ban <player> <reason> | Permanently ban a player | -s | bm.command.ban |
/tempban <player> <timeDiff> <reason> | Temporarily ban a player | -s | bm.command.tempban |
/unban <player> [reason] | Unban a player | -d | bm.command.unban |
/mute <player> <reason> | Permanently mute a player | -s, -soft | bm.command.mute |
/tempmute <player> <timeDiff> <reason> | Temporarily mute a player | -s, -soft | bm.command.tempmute |
/unmute <player> [reason] | Unmute a player | bm.command.unmute | |
/banip <player || ip> <reason> | Permanently ban an ip address or ip of a player | -s | bm.command.banip |
/tempbanip <player || ip> <timeDiff> <reason> | Temporarily ban an ip address or ip of a player | -s | bm.command.tempbanip |
/unbanip <ip> [reason] | Unban an ip address | -d | bm.command.unbanip |
/muteip <player || ip> <reason> | Permanently mute an ip address or ip of a player | -s | bm.command.muteip |
/tempmuteip <player || ip> <timeDiff> <reason> | Temporarily mute an ip address or ip of a player | -s | bm.command.tempmuteip |
/unmuteip <ip> [reason] | Unmute an ip address | 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.*.* | -s | bm.command.baniprange |
/tempbaniprange <cidr || wildcard> <timeDiff> <reason> | Temporarily ban a cidr or wildcard ip range | -s | bm.command.tempbaniprange |
/unbaniprange <cidr || wildcard || player> | Unban an ip range | bm.command.unbaniprange | |
/warn <player> <reason> | Warn a player | -s -p | bm.command.warn |
/tempwarn <player> <timeDiff> <reason> | Temporarily warn a player | -s -p | bm.command.tempwarn |
/dwarn <player> | Delete the last warning a player received | -s | bm.command.dwarn |
/addnote <player> <message> | Add a note against a player | -s | bm.command.addnote |
/notes [player] | View notes of all online players or a particular player | bm.command.notes, bm.command.notes.online | |
/kick <player> <reason> | Kick a player from the server | -s | bm.command.kick |
/nlkick <player> <reason> | Kick a player from the server without logging the kick if kick logging enabled | -s | bm.command.nlkick |
/bminfo [player] | Look up information of a player | -bans, -kicks, -ips, -mutes, -notes, -time, -warnings | bm.command.bminfo |
/bmimport | Check the migration guides for more information | bm.command.import | |
/bmexport <players || ips> | Export bans to vanilla format | bm.command.export | |
/bmreload | Reload plugin configuration and messages (excludes database connection info) | bm.command.reload | |
/banlist [players || ipranges || ips] | List all bans stored in memory | bm.command.banlist | |
/bmsync <local || external> | Force the server to syncronise with the database | bm.command.sync | |
/bmclear <player> [banrecords || baniprecords || kicks || muterecords || notes || warnings] | Clear all records of a player or specify a type | bm.command.clear | |
/bmdelete <banrecords || kicks || muterecords || notes || warnings> <ids> | Delete specific records for a player based on ids from /bminfo | bm.command.delete | |
/bmactivity <timeDiff> [player] | View recent activity of staff, or a particular player | bm.command.bmactivity | |
/alts <player || ip> | List players which have the same ip address | bm.command.alts | |
/report <player> <reason> | Report a player for rule breaking, logs their location and the actors location, as well as other data | bm.command.report | |
/reports | Report management, executes list by default | bm.command.reports | |
/reports assign <ids> [player] | Assign a report to a player, if none given assigns to self | bm.command.reports.assign | |
/reports close <ids> [/command || comment] | Marks a report as closed, with an optional comment or command | bm.command.reports.close | |
/reports list [page] [state] | Lists reports | bm.command.reports.list | |
/reports tp <id> | Teleports you to where the report was created | bm.command.reports.tp | |
/reports unassign <ids> | Unassigns reports from a player | bm.command.reports.unassign | |
/bmrollback <player> <timeDiff> [types] | Allows rolling back malicious actions by a staff member | bm.command.bmrollback | |
/banname <name> <reason> | Ban any players with the name specified | -s | bm.command.banname |
/tempbanname <name> <timeDiff> <reason> | Temporarily ban a name | -s | bm.command.tempbanname |
/unbanname <name> [reason] | Unban a name | bm.command.unbanname | |
/bmutils <duplicates||missingplayers> | Utility commands to aid with resolving issues | bm.command.bmutils | |
/bmutils duplicates [UUID] [newName] | Finds duplicate player names and allows manual updating of a player name | bm.command.bmutils.duplicates | |
/bmutils missingplayers | Finds missing player records associated to punishments and creates them | bm.command.bmutils.missingplayers |
Command 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
Flag | Alias | Description | Permission | Example |
---|---|---|---|---|
-silent | -s | Perform the command silently without a broadcast | bm.command.<command>.silent e.g. bm.command.tempban.silent | /ban -s confuser Test |
-bans | -b | List the past bans of a player via /bminfo | bm.command.bminfo.history.bans | /bminfo confuser -b |
-bans | -b | List the past bans of an IP via /bminfo | bm.command.bminfo.history.ipbans | /bminfo 127.0.0.1 -b |
-ips | -i | List join leave history of a player via /bminfo | bm.command.bminfo.history.ips | /bminfo confuser -i |
-kicks | -k | List kick records of a player via /bminfo | bm.command.bminfo.history.kicks | /bminfo confuser -k |
-mutes | -m | List the past mutes of a player via /bminfo | bm.command.bminfo.history.mutes | /bminfo confuser -m |
-mutes | -m | List the past mutes of an IP via /bminfo | bm.command.bminfo.history.ipmutes | /bminfo 127.0.0.1 -m |
-notes | -n | List all notes associated with a player via /bminfo | bm.command.bminfo.history.notes | /bminfo confuser -n |
-warnings | -w | List all warnings of a player via /bminfo | bm.command.bminfo.history.warnings | /bminfo confuser -w |
-time | -t | Limit data by a date using timeDiff formatting | /bminfo confuser -t 23w | |
-soft | -st | Soft/shadow muting | bm.command.<command>.soft | /tempmute confuser -st 1d Testing |
-points | -p | Specify severity of a warning | bm.command.warn.points | /warn confuser -p 4 Testing |
-ips | -i | Display join/leave times of a player along with their ip address | bm.command.bminfo.history.ips | /bminfo confuser -i |
-delete | -d | Deletes a ban without creating a record | bm.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 1m2w3d Test
Global Commands
These commands are only available if the global database option within your config is enabled. They are only for syncing bans across multiple servers, and do not have as granulated permissions.
The time it takes for each action to take affect depends on the interval your global scheduler is set to within schedules.yml
. Default is 2 minutes.
Command | Description | Permission |
---|---|---|
/banall <player> <reason> | Permanently ban a player across multiple servers | bm.command.banall |
/tempbanall <player> <timeDiff> <reason> | Temporarily ban a player across multiple servers | bm.command.tempbanall |
/unbanall <player> | Unban a player across multiple servers | bm.command.unbanall |
/muteall <player> <reason> | Permanently mute a player across multiple servers | bm.command.muteall |
/tempmuteall <player> <timeDiff> | Temporarily mute a player across multiple servers | bm.command.tempmuteall |
/unmuteall <player> <timeDiff> | Unmute a player across multiple servers | bm.command.unmuteall |
/banipall <player || ip> <reason> | Permanently ban an ip across multiple servers | bm.command.banipall |
/tempbanipall <player || ip> <timeDiff> <reason> | Temporarily ban an ip across multiple servers | bm.command.tempbanipall |
/unbanipall <ip> | Unban an ip across multiple servers | bm.command.unbanipall |
/addnoteall <player> <message> | Add a note across multiple servers | bm.command.addnoteall |