Using it

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#

FlagMeaning
-sSilent. Only staff with mcbans.notify see the broadcast.
-ipAlso punish the player's IP address. Needs mcbans.ip. Applies to bans and mutes only.
-pSend the ban to purgatory (bans only).
-npMake 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-reasons is 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.
  • /kick and /freeze need the player to be online. Bans, mutes and warnings work on offline players too.
  • Players with mcbans.exempt cannot 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.