Skip to content

Commands

mahdixser edited this page Aug 23, 2026 · 2 revisions

Commands

All commands work against both online and offline players unless noted otherwise — you don't need someone connected to ban them.

Punishment commands

/ban <player> <reason>

Permanently bans a player. Kicks them immediately if they're online.

/ban Steve Duping items

/tempban <player> <time> <reason>

Same as /ban, but expires after the given duration. Alias: /tban.

/tempban Steve 3d Excessive griefing

/unban <player>

Removes an active ban. Alias: /pardon.

/kick <player> <reason>

Kicks a currently online player. Doesn't leave a "ban" record, but it does show up in /history as a kick entry. Only works on online players, for obvious reasons.

/mute <player> <reason> / /tempmute <player> <time> <reason>

Blocks chat for a player. Temp version expires automatically. Alias for tempmute: /tmute.

/unmute <player>

Removes an active mute.

/warn <player> <reason>

Issues a warning. Once a player hits the configured warning threshold, SXBans can automatically ban them (see auto-ban in Configuration).

IP commands

/ipban <player|IP> <reason>

You can target either a currently-connected player (which bans their IP) or type a raw IP address directly. Kicks everyone currently online from that IP.

/ipunban <IP>

Removes an IP ban. Takes the IP address, not a player name.

/ipmute <player|IP> <reason> / /ipunmute <IP>

Same idea, but for mutes — mutes everyone connecting from that IP.

Info commands

/check <player>

Shows a player's current status — active bans/mutes, IP, last seen, warning count, and detected alt accounts if any. Aliases: /info, /status.

/history <player> [page]

Shows a paginated log of everything that's ever happened to a player — every punishment, who issued it, and when. Defaults to page 1.

/history Steve
/history Steve 2

Time format

Anywhere a command takes a <time> argument:

Unit Meaning
s seconds
m minutes
h hours
d days
w weeks
M months (capital M — lowercase m is minutes)
y years

You can chain units together: 1d12h30m is a day, twelve hours, and thirty minutes.

Admin commands

/sxbans reload

Reloads config.yml, messages.yml, templates.yml, and web panel user data without restarting the server.

/sxbans stats

Prints a quick summary — total punishments, active bans/mutes, warning counts, web server status, database type.

/sxbans web

Shows the web panel's current status and address.

/sxbans backup

Writes a timestamped JSON snapshot of every punishment record into plugins/SXBans/backups/. Doesn't touch your live database — it's a standalone export.

/sxbans clear all

Starts the process of wiping every punishment record on the server. Requires confirmation — run /sxbans clear all first, then /sxbans clear confirm within 30 seconds. This is destructive and cannot be undone; there's no "are you really sure" beyond the confirmation window, so don't run it out of curiosity.

/sxbans clear player <name>

Wipes all punishment records for one specific player.

Alias for the whole command group: /sxban.

Clone this wiki locally