Bans, mutes, warnings and kicks
The commands share one format: the player first, then an optional length, then flags, then the reason. Flags can appear anywhere after the player name.
/ban <player> [length] [-s] [-ip] [-p|-np] [reason]
/tempban <player> <length> [flags] [reason]
/mute <player> [length] [-s] [-ip] [reason]
/warn <player> [-s] [reason]
/kick <player> [-s] [reason]Lengths#
Use units of s, m, h, d, w, mo (30 days) and y (365 days), and combine them: 45s, 2h30m, 7d, 1w2d. Use permanent (also perm, forever or p) for no end. /ban and /mute without a length are permanent. /tempban and /tempmute require a real length.
Flags#
| Flag | Meaning |
|---|---|
-s | Silent. Only staff with mcbans.notify see the broadcast. |
-ip | Also punish the player's IP address. Needs mcbans.ip. Applies to bans and mutes only. |
-p | Send the ban to purgatory (bans only). |
-np | Make it a normal hard ban, even if purgatory is the default (bans only). |
Good to know#
- If you give no reason, the default from
punishments.default-reasonsis used. - A player has one active ban, one active mute and one active freeze. A new ban or mute replaces the old one and the old record is closed as reversed with a pointer to the new one. A second freeze is refused.
/kickand/freezeneed the player to be online. Bans, mutes and warnings work on offline players too.- Players with
mcbans.exemptcannot be banned, muted, kicked or frozen by other staff while they are online. Warnings still work. - A hard-banned player sees a multi-line ban screen at login with the reason, staff member, length, time left and your appeal link. It is editable in
lang.yml. - Muted players cannot chat, and cannot use the commands in
punishments.muted-blocked-commands. - Reason and length suggestions in tab completion come from the GUI presets in
config.yml.
Removing punishments#
/unban <player> [-s] [reason] (alias /pardon)
/unmute <player> [-s] [reason]
/unwarn <player> [id] [-s] [reason]
/unfreeze <player> [-s] [reason]/unwarn without an id removes the newest active warning. /unban also releases a player from purgatory.
History#
/history <player> [page] (aliases /hist, /punishments) shows a player's record in chat, 8 entries per page. Hover a line for every detail. The same record is available in the panel.