Commands/ban

These commands control a server's banlist, or blacklist. A blacklist is a list of players or IP addresses that are not allowed to connect to the server. Bans supersede any whitelisting in place.

ban

ban

Restrictions	Multiplayer Operator No command blocks

Adds a player to the blacklist.

Syntax

ban <targets> [<reason>]

Arguments

<targets>: game_profile

Must be a collection of game profiles (player profiles), which can be a player name (must be a real one if the server is in online mode), or a player-type target selector.

Specifies the player profile(s) to be added to the blacklist.

<reason>: message

Must be a plain text. Can include spaces as well as target selectors. The game replaces entity selectors in the message with the list of selected entities' names, which is formatted as "name1 and name2" for two entities, or "name1, name2, ... and namen" for n entities.

Message to display to the banned player, to other operators, and in the server logs. If unspecified, defaults to Banned by an operator.

Result

Command	Trigger	Java Edition
any	the arguments are not specified correctly	Unparseable
	if the target selector fails to resolve to one or more online players	Failed
	does not add any new player profile to blacklist
	On success	the player profile(s) is added to the server blacklist, which prevents anyone from connecting to the server with uuids of these profiles.

Output

Command	Edition	Situation	Success Count	/execute store success ...	/execute store result ...
any	Java Edition	On fail	N/A	0	0
		On success	N/A	1	the number of new player names added to blacklist.

ban-ip

ban-ip

Restrictions	Multiplayer Operator No command blocks

Adds an IP address to the blacklist.

Syntax

ban-ip <target> [<reason>]

Arguments

<targets>: string

Must be a string. And it must be in a single word (no spaces).

Specifies the IP address to be added to the blacklist. Can also be a name of a online player, which represents the IP of that player.

<reason>: message

Must be a plain text. Can include spaces as well as target selectors. The game replaces entity selectors in the message with the list of selected entities' names, which is formatted as "name1 and name2" for two entities, or "name1, name2, ... and namen" for n entities.

Message to display to the banned player, to other operators, and in the server logs. If unspecified, defaults to Banned by an operator.

Result

Command	Trigger	Java Edition
any	the arguments are not specified correctly	Unparseable
	does not add any new IP address to blacklist	Failed
	On success	the narrowly-specified address or that of the named, online player is added to the server blacklist, preventing anyone from connecting to the server from that address.

Output

Command	Edition	Situation	Success Count	/execute store success ...	/execute store result ...
any	Java Edition	On fail	N/A	0	0
		On success	N/A	1	the number of online players that connecting with the specified IP.

banlist

banlist

Restrictions	Multiplayer Operator No command blocks

Displays the server's blacklist.

Syntax

banlist [ips|players]

Result

Always succeeds. Displays banned IP addresses or banned players.

Output

Command	Edition	Situation	Success Count	/execute store success ...	/execute store result ...
any	Java Edition	On success	N/A	1	the number of entries in the specified list.

banip

banip

Restrictions	Operator

Bans a player by IP number. Cannot be undone in-game; banned-ip.txt must manually be changed.

The Classic equivalent of /ban-ip.

Syntax

banip (<address>|<name>) [<reason>]

History

Java Edition Classic
0.0.15a (Multiplayer Test 3)					Added /ban and /banip.
Java Edition Indev
0.31					Removed all commands.
Java Edition Alpha
v1.0.16					Re-added /ban.
					Added /ban-ip and /banlist.

See also

• Commands/whitelist

Commands

View at: Template:Commands/content [edit]