Commands & Permissions

Common Flags

Most sanction commands accept these optional flags:

Flag	Description
`-s`	Silent mode — suppresses the public broadcast (only Warden / staff with notify permissions see it)
`-server <name>`	Cross-server execution — forwards the command to the named server
`@template_name`	Replaces `[time] [reason]` with a predefined template from `config.yml`

Player Commands

Command	Description	Permission
`/report <player> [reason]`	Report a player to staff (no reason opens a reason-picker GUI)	`xbans.report`

Ban Commands

Command	Description	Permission
`/ban [-s] <player> [time] [reason] [-server <name>]`	Ban a player (permanent if no time)	`xbans.ban`
`/unban [-s] <player> [-server <name>]`	Remove a player's ban	`xbans.unban`
`/ban-ip [-s] <player> [time] [reason] [-server <name>]`	Ban a player's IP	`xbans.banip`
`/unban-ip [-s] <player> [-server <name>]`	Remove a player's IP ban	`xbans.unbanip`
`/ban-ip-range [-s] <range> [reason] [-server <name>]`	Ban an IP range (wildcards: `192.168.1.*`)	`xbans.baniprange`
`/unban-all <player>`	Unban all bans matching the player	`xbans.unban-all`

Mute Commands

Command	Description	Permission
`/mute [-s] <player> [time] [reason] [-server <name>]`	Mute a player (permanent if no time)	`xbans.mute`
`/unmute [-s] <player> [-server <name>]`	Remove a player's mute	`xbans.unmute`
`/mute-ip [-s] <player> [time] [reason] [-server <name>]`	Mute a player's IP	`xbans.muteip`
`/unmute-ip [-s] <player> [-server <name>]`	Remove a player's IP mute	`xbans.unmuteip`
`/unmute-all <player>`	Unmute all mutes matching the player	`xbans.unmute-all`

Warn & Report Commands

Command	Description	Permission
`/warn [-s] <player> [reason] [-server <name>]`	Warn a player	`xbans.warn`
`/unwarn [-s] <player> [id]`	Remove a warning (specific ID or all)	`xbans.unwarn`
`/report <player> [reason]`	Report a player to staff (no reason opens a reason-picker GUI)	`xbans.report`
`/unreport <player> [id]`	Remove a report (specific ID or all)	`xbans.unreport`

Jail Commands

Command	Description	Permission
`/jail [-s] <player> [jail_name] [time] [reason] [-server <name>]`	Jail a player at a named jail location	`xbans.jail`
`/unjail [-s] <player>`	Release a player from jail	`xbans.unjail`
`/jail-create <name>`	Create a jail at your current position	`xbans.jail.manage`
`/jail-delete <name>`	Delete a jail location	`xbans.jail.manage`
`/jail-locations`	List configured jail locations	`xbans.jail`
`/sanctions jails`	Open the active jails GUI	`xbans.sanctions`

Moderation Tools

Command	Description	Permission
`/kick [-s] <player> [reason] [-server <name>]`	Kick a player	`xbans.kick`
`/freeze <player>`	Toggle freeze on a player	`xbans.freeze`
`/watchlist <add\|remove\|list> [player] [reason]`	Manage the watchlist	`xbans.watchlist`
`/note <add\|list\|delete> <player\|id> [note]`	Manage staff notes	`xbans.note`
`/warden`	Toggle warden notifications for yourself	`xbans.warden`

Lookup & GUI Commands

Command	Description	Permission
`/profil <player>`	Open the player profile GUI	`xbans.profil`
`/punish <player>`	Open the one-click sanction menu (with sub-menus)	`xbans.punish`
`/history <player>`	Show a player's sanction history (text)	`xbans.history`
`/whois <player\|ip>`	Lookup IP/player info	`xbans.whois`
`/sanctions <bans\|ipbans\|mutes\|ipmutes\|warns\|reports\|jails>`	Open one of the sanction list GUIs	`xbans.sanctions`
`/players`	All players GUI	`xbans.players`

Admin Commands

Command	Description	Permission
`/xbans reload`	Reload XBans configuration and lang	`xbans.admin`
`/xbans stats`	Show XBans statistics (active sanctions, totals)	`xbans.admin`
`/xbans export <bans\|mutes\|warns\|reports\|all>`	Export sanction data to JSON	`xbans.admin`
`/xbans import <file>`	Import sanction data from a JSON file	`xbans.admin`

Exports are written to plugins/XCore/addons/XBans/exports/. Imports look up files in the same folder.

Permissions Reference

Sanction commands

Permission	Description
`xbans.admin`	Full access to all XBans features (GUIs, lookup commands, admin commands, etc.)
`xbans.ban` / `xbans.unban`	Issue / lift bans
`xbans.banip` / `xbans.unbanip`	Issue / lift IP bans (and IP range bans)
`xbans.mute` / `xbans.unmute`	Issue / lift mutes
`xbans.muteip` / `xbans.unmuteip`	Issue / lift IP mutes
`xbans.warn` / `xbans.unwarn`	Issue / lift warnings
`xbans.report` / `xbans.unreport`	Submit / remove reports (`xbans.report` defaults to all players)
`xbans.jail` / `xbans.unjail`	Jail / release players
`xbans.kick`	Kick players

Lookups, GUIs & moderation tools

Permission	Description
`xbans.sanctions`	Access `/sanctions <bans\|ipbans\|mutes\|ipmutes\|warns\|reports\|jails>`
`xbans.players`	Open the players GUI (`/players`)
`xbans.profil`	Open the profile GUI (`/profil`)
`xbans.punish`	Open the punish menu (`/punish`)
`xbans.history`	Use the text-based history command (`/history`)
`xbans.whois`	Use `/whois`
`xbans.freeze`	Use `/freeze`
`xbans.watchlist`	Use `/watchlist`
`xbans.note`	Use `/note`
`xbans.jail.manage`	Create / delete jail locations

Notifications

Permission	Description
`xbans.warden`	Receive Warden notifications (reports, alerts, watchlist joins, AI flags...). Required for `/warden`.
`xbans.notify.warn`	See warn broadcasts (when configured to require this permission via `broadcast-permissions.warn`)
`xbans.notify.report`	See report broadcasts (when configured via `broadcast-permissions.report`)
`xbans.update`	Receive update notifications on join

Sanction exemptions & bypasses

Permission	Description
`xbans.exempt.ban`	Cannot be banned
`xbans.exempt.mute`	Cannot be muted
`xbans.exempt.kick`	Cannot be kicked
`xbans.exempt.warn`	Cannot be warned
`xbans.exempt.report`	Cannot be reported
`xbans.exempt.jail`	Cannot be jailed
`xbans.bypass.chatai`	Bypass AI chat moderation
`xbans.bypass.vpn`	Bypass VPN/proxy blocking
`xbans.bypass.hosting`	Bypass hosting/datacenter blocking
`xbans.bypass.mobile`	Bypass mobile network blocking

The xbans.admin permission is the umbrella for staff-only tools (lookup commands, GUIs, exports). For granular staff roles, hand out individual sanction permissions: a helper role might only have xbans.warn, xbans.unwarn, and xbans.warden.

Exempt and bypass permissions can be assigned to a permission group (e.g., donator with xbans.bypass.vpn) to handle exceptions cleanly without per-player tweaks.