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.
Punishing
Section titled “Punishing”| 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 CheatingDurations
Section titled “Durations”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.
Templates
Section titled “Templates”/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.
Replacing a punishment
Section titled “Replacing a punishment”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 havexbans.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.
IP bans and mutes
Section titled “IP bans and mutes”/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.
Looking things up
Section titled “Looking things up”| 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 |
Staff limits
Section titled “Staff limits”| 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 trueWho’s told
Section titled “Who’s told”| 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 |