Skip to content

Commands

The commands and flags are LiteBans’, so what your staff know already works. Every permission is given to operators by default except /warnings (everyone may see their own) and the limits below.

Command What it does Permission
/ban <player> [duration] [reason] Bans, permanently or for the duration. xbans.ban
/tempban <player> <duration> [reason] Bans for a while. The duration is required. xbans.tempban
/ipban <player|ip> [duration] [reason] (/banip, /ban-ip) Bans the player’s account and their last IP, or an IP. xbans.ipban
/tempipban <player|ip> <duration> [reason] (/tempbanip) An IP ban for a while. xbans.ipban
/mute <player> [duration] [reason] Mutes: no chat, no blocked commands, signs or books. xbans.mute
/tempmute <player> <duration> [reason] Mutes for a while. xbans.tempmute
/ipmute <player|ip> [duration] [reason] (/muteip) Mutes everyone on the player’s IP. xbans.ipmute
/tempipmute <player|ip> <duration> [reason] (/tempmuteip) An IP mute for a while. xbans.ipmute
/warn <player> [duration] [reason] Warns. A warning lasts 30 days unless given a duration (warnings.default-duration). xbans.warn
/kick <player> [reason] Kicks a player who’s online, and records it. xbans.kick
/unban <player|ip|#id> [reason] (/pardon, /unbanip, /pardon-ip) Lifts a ban. Without server:, every ban the player has, on any server. xbans.unban
/unmute <player|ip|#id> [reason] (/unmuteip) Lifts a mute. xbans.unmute
/unwarn <player|#id> [reason] Removes the player’s newest warning, or the one given. xbans.unwarn

A player can be named by name or uuid, online or not. A player who has never joined can be banned too, before they arrive.

#id is a punishment’s number, shown in /history and on the ban screen.

Flags can go anywhere after the player’s name. Everything after -- is the reason, even words that look like flags.

Flag Means Permission
-s Silent: only staff with xbans.notify.silent are told.
-S Extra silent: only the console is told. xbans.extrasilent
-p Public, when punishing.silent-by-default is on.
-g Every server: the same as server:*. xbans.scope
-I By IP as well, as /ipban and /ipmute do. xbans.ipban or xbans.ipmute
server:<name> Only on that server (see Networks). server:*, server:global or server:all for every server, server:local or server:this for this one. xbans.scope
/ban Bob -s 10d server:survival Cheating

A number and a unit, units added up in any order: 30m, 1d2h, 1.5h, 2w, 5 days.

Unit Means
s seconds
m minutes
h hours
d days
w weeks
mo months (30 days)
y years (365 days)

perm, permanent or forever is permanent. Without a duration, /ban and /mute are permanent.

/ban Steve hacking follows the hacking template: its reason, and a duration that climbs each time the same player gets it, 7 days, then 30, then permanent. A duration typed with a template (/ban Steve 3d hacking) is used instead of the ladder’s. Each template needs xbans.template.<name> (operators have it), and its durations are held to the sender’s staff limits. Templates are set in the configuration. Tab completion lists the ones you may use.

A new ban or mute on someone already banned or muted on the same server replaces the old one only if all three hold:

  • it reaches everyone the old one did (an IP ban reaches the account too; an account ban doesn’t reach the IP’s other accounts),
  • it ends no sooner (a permanent one counts as long as a permanent one), and
  • you could lift the old one yourself with /unban: you gave it, your weight is at least the weight of whoever did, or you have xbans.unban.override.

Otherwise, if the old one already reaches everyone for at least as long, the new one is refused; if not, both stay in force.

Case Example What happens
Same length /ban Steve x, then /ban Steve y Replaced: the new reason stands.
Longer /tempban Steve 1d, then /ban Steve Replaced.
Shorter /ban Steve, then /tempban Steve 1d Refused, so a helper can’t turn a permanent ban into a day. Unban first to shorten one.
IP over account /tempban Steve 1d, then /ipban Steve Replaced: the IP ban reaches Steve too.
Account over IP /ipban Steve, then /ban Steve Never replaced, which would let the IP’s other accounts back in. Refused if the IP ban lasts as long; otherwise both stay.
A senior’s, by a junior The console bans Steve; a helper bans him again Never replaced, so a helper can’t swap it for their own and unban that. Refused if it’s as long or shorter (“given by someone who outranks you”); if it’s longer, both stay, and the helper’s /unban lifts only their own.
Mute and ban /ban Steve, then /mute Steve They never meet: both stay.

Mutes follow the same rule among themselves. A replaced ban or mute is kept in the history as revoked (“Replaced by a newer one”), and still counts toward its template’s ladder.

/ipban Steve bans the IP Steve last joined from, and every account on it. /ipban 203.0.113.9 bans that address. An IPv6 address is banned on its own (a /128), not its network. The broadcast and ban lists show only the first half of the address (203.0.x.x), or the start of its hash.

Staff limits apply to everyone on the IP: if any account seen on it, or online on it now, is exempt or has a weight as high as yours, the IP ban is refused.

Command What it does Permission
/history <player> [bans|mutes|warnings|kicks] [page] (/hist) Everything a player was given, newest first. Click the footer for more. xbans.history
/staffhistory <staff|console> [type] [page] (/staffhist) Everything a staff member gave. xbans.staffhistory
/checkban <player|ip|#id> Whether they’re banned, why, by whom and until when. xbans.checkban
/checkmute <player|ip|#id> The same for mutes. xbans.checkmute
/warnings [player] [page] Active warnings: your own, or with xbans.warnings.others, anyone’s. xbans.warnings (everyone)
/banlist [page] Everyone banned on this server. xbans.banlist
/mutelist [page] Everyone muted on this server. xbans.mutelist
/alts <player|ip> [page] (/dupeip, /checkalts) Accounts that joined from the same IPs, and whether each is banned, muted or online. xbans.alts
/iphistory <player> [page] The IPs a player joined from, with when. xbans.iphistory
/prunehistory <player> [duration] [confirm] Deletes a player’s punishments that are no longer in force. With a duration, only those made within it. Shows how many first; add confirm to delete. xbans.prunehistory
Command What it does Permission
/xbans import <vanilla|essentials|litebans> [confirm] Counts what a source holds, then imports it with confirm. See Switching. xbans.admin
/xbans reload, /xbans info Reload the config, or show the version and settings. xbans.admin
Permission What it does Default
xbans.weight.<n> A rank’s weight. A player with a weight can only be punished by someone with a higher one. Players without one can be punished by any staff. nobody
xbans.exempt Can’t be punished by staff at all (the console still can). nobody
xbans.limit.<group> The group’s longest ban and mute, from staff-limits.groups. Template durations count too. nobody
xbans.limit.bypass-templates A template’s own durations may go past the group’s limit. nobody
xbans.template.<name> May use that template. op
xbans.unban.override May lift any punishment, whoever gave it (see below). op

Operators don’t get the first four by default, so an operator isn’t held to a helper’s limit, and isn’t exempt. A player’s weight and exemption are recorded when they join, so they count while they’re offline too.

Lifting punishments. The weight of whoever gives a punishment is recorded with it. With staff-limits.weights on, /unban, /unmute and /unwarn lift only punishments you gave yourself, or that were given by someone whose weight was no higher than yours, like LiteBans’ litebans.unban.own but by weight. The console’s weight is the highest, so a ban from the console (or from a plugin, or from a warnings action) needs xbans.unban.override. Imported punishments have no weight, so anyone with the command can lift them.

/lp group helper permission set xbans.weight.10 true
/lp group helper permission set xbans.limit.helper true
/lp group moderator permission set xbans.weight.50 true
Permission Sees Default
xbans.notify.broadcast Public punishments. everyone
xbans.notify.silent Silent (-s) punishments, with [Silent] in front. op
xbans.notify.banned-join A banned player trying to join. op
xbans.notify.alts A player joining who shares an IP with a banned account. op
xbans.scope May choose the server with server: or -g. op