Commands
The full command list. Anything in <angle brackets> is required, anything in [square brackets] is
optional.
Add -s to a punishment command for a silent version that is not announced publicly, for example
/ban -s Steve Hacking. There are also dedicated aliases. See
Silent Punishments.
Bans
| Command | What it does | Permission |
|---|---|---|
/ban <player> [duration] [reason] | Ban a player (alias /pban) | phantombans.ban |
/tempban <player> <duration> [reason] | Temporarily ban a player | phantombans.tempban |
/ipban <player|ip> [duration] [reason] | Ban an IP address | phantombans.ipban |
/unban <player|uuid> | Remove a ban | phantombans.unban |
/unipban <ip> | Remove an IP-ban | phantombans.unipban |
Mutes
| Command | What it does | Permission |
|---|---|---|
/mute <player> [duration] [reason] | Mute a player | phantombans.mute |
/tempmute <player> <duration> [reason] | Temporarily mute a player | phantombans.tempmute |
/ipmute <player|ip> [duration] [reason] | Mute an IP address | phantombans.ipmute |
/unmute <player> | Remove a mute | phantombans.unmute |
/muteall [reason] | Mute all non-staff chat | phantombans.muteall |
/unmuteall | Unlock global chat | phantombans.muteall |
Kicks and warns
| Command | What it does | Permission |
|---|---|---|
/kick <player> [reason] | Kick a player (alias /pkick) | phantombans.kick |
/warn <player> <reason> | Warn a player | phantombans.warn |
/unwarn <player> [id] | Remove a warning | phantombans.unwarn |
/warnings <player> | List a player’s warnings | phantombans.warnings |
Silent punishments
These are aliases of /ban -s, /mute -s, /warn -s, and their reverses. They need phantombans.silent.use.
| Command | What it does | Permission |
|---|---|---|
/silentban <player> [duration] [reason] | Silently ban a player (alias of /ban -s) | phantombans.silentban |
/unsilentban <player> | Silently remove a ban | phantombans.unsilentban |
/silentmute <player> [duration] [reason] | Silently mute a player (alias of /mute -s) | phantombans.silentmute |
/unsilentmute <player> | Silently remove a mute | phantombans.unsilentmute |
/silentwarn <player> <reason> | Silently warn a player (alias of /warn -s) | phantombans.silentwarn |
History and lookup
| Command | What it does | Permission |
|---|---|---|
/history <player> [page] | Show punishment history (alias /hist) | phantombans.history |
/iphistory <player|ip> [page] | Show IP-linked history | phantombans.iphistory |
/staffhistory <staff> [page] | Show punishments issued by a staff member | phantombans.staffhistory |
/lookup <player> | Look up a player | phantombans.lookup |
/alts <player> | Show alt accounts sharing IPs | phantombans.alts |
/checkban <player> | Check whether a player is banned | phantombans.checkban |
/checkmute <player> | Check whether a player is muted | phantombans.checkmute |
Punishment lists
Add all to include expired and removed (unbanned/unmuted) punishments, not just active ones. Each row is tagged ACTIVE, EXPIRED, or REMOVED. The all view is paginated 10 per page and returns up to the most recent 1000 of that type. It uses the same permission as the active list.
| Command | What it does | Permission |
|---|---|---|
/banlist [all] [page] | Show active bans (or all with all) | phantombans.banlist |
/mutelist [all] [page] | Show active mutes (or all with all) | phantombans.mutelist |
/warnlist [all] [page] | Show active warnings (or all with all) | phantombans.warnlist |
Reports, appeals, and notes
| Command | What it does | Permission |
|---|---|---|
/report <player> <reason> | Report a player | phantombans.report |
/reports | Open report management | phantombans.reports |
/appeal <punishment-id> <message> | Submit an appeal | phantombans.appeal |
/appeals | Open appeal management | phantombans.appeals |
/note <add|list|remove> <player> [note|id] | Manage staff notes (alias /notes) | phantombans.note |
/punish <player> | Open the punishment menu | phantombans.punish |
Management
| Command | What it does | Permission |
|---|---|---|
/staffrollback <staff> | Remove punishments issued by a staff member | phantombans.staffrollback |
/clearhistory <player> | Clear a player’s history | phantombans.clearhistory |
/phantombans <reload|export|info|version|auditlog|import|help> | Admin command (aliases /pb, /pbans) | phantombans.info |
The admin command
/phantombans (or /pb) groups the management tools:
| Subcommand | What it does |
|---|---|
reload | Reload the config files. |
export | Export punishment data. |
info | Show plugin info and active counts. |
version | Show the plugin version. |
auditlog | Show the audit log. |
import <source> [dry|confirm] | Import punishments from AdvancedBan, LiteBans, or LibertyBans (needs phantombans.import). New in 1.0.0-8. See Data Import. |
help | Show the in-game help menu. |
Full permission detail, including defaults, is on the Permissions page.