Skip to Content
PhantomBans is a premium plugin. Get it from the store or join the Discord.
ReferenceCommands

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

CommandWhat it doesPermission
/ban <player> [duration] [reason]Ban a player (alias /pban)phantombans.ban
/tempban <player> <duration> [reason]Temporarily ban a playerphantombans.tempban
/ipban <player|ip> [duration] [reason]Ban an IP addressphantombans.ipban
/unban <player|uuid>Remove a banphantombans.unban
/unipban <ip>Remove an IP-banphantombans.unipban

Mutes

CommandWhat it doesPermission
/mute <player> [duration] [reason]Mute a playerphantombans.mute
/tempmute <player> <duration> [reason]Temporarily mute a playerphantombans.tempmute
/ipmute <player|ip> [duration] [reason]Mute an IP addressphantombans.ipmute
/unmute <player>Remove a mutephantombans.unmute
/muteall [reason]Mute all non-staff chatphantombans.muteall
/unmuteallUnlock global chatphantombans.muteall

Kicks and warns

CommandWhat it doesPermission
/kick <player> [reason]Kick a player (alias /pkick)phantombans.kick
/warn <player> <reason>Warn a playerphantombans.warn
/unwarn <player> [id]Remove a warningphantombans.unwarn
/warnings <player>List a player’s warningsphantombans.warnings

Silent punishments

These are aliases of /ban -s, /mute -s, /warn -s, and their reverses. They need phantombans.silent.use.

CommandWhat it doesPermission
/silentban <player> [duration] [reason]Silently ban a player (alias of /ban -s)phantombans.silentban
/unsilentban <player>Silently remove a banphantombans.unsilentban
/silentmute <player> [duration] [reason]Silently mute a player (alias of /mute -s)phantombans.silentmute
/unsilentmute <player>Silently remove a mutephantombans.unsilentmute
/silentwarn <player> <reason>Silently warn a player (alias of /warn -s)phantombans.silentwarn

History and lookup

CommandWhat it doesPermission
/history <player> [page]Show punishment history (alias /hist)phantombans.history
/iphistory <player|ip> [page]Show IP-linked historyphantombans.iphistory
/staffhistory <staff> [page]Show punishments issued by a staff memberphantombans.staffhistory
/lookup <player>Look up a playerphantombans.lookup
/alts <player>Show alt accounts sharing IPsphantombans.alts
/checkban <player>Check whether a player is bannedphantombans.checkban
/checkmute <player>Check whether a player is mutedphantombans.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.

CommandWhat it doesPermission
/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

CommandWhat it doesPermission
/report <player> <reason>Report a playerphantombans.report
/reportsOpen report managementphantombans.reports
/appeal <punishment-id> <message>Submit an appealphantombans.appeal
/appealsOpen appeal managementphantombans.appeals
/note <add|list|remove> <player> [note|id]Manage staff notes (alias /notes)phantombans.note
/punish <player>Open the punishment menuphantombans.punish

Management

CommandWhat it doesPermission
/staffrollback <staff>Remove punishments issued by a staff memberphantombans.staffrollback
/clearhistory <player>Clear a player’s historyphantombans.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:

SubcommandWhat it does
reloadReload the config files.
exportExport punishment data.
infoShow plugin info and active counts.
versionShow the plugin version.
auditlogShow 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.
helpShow the in-game help menu.
The in-game help menu

Full permission detail, including defaults, is on the Permissions page.

Last updated on