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.

See also: /whitelist

ban

ban

Restrictions	Multiplayer Operator No command blocks
First introduced	Java Edition Alpha v1.0.16

Adds a player to the blacklist.

Syntax

ban <name> [reason …]

Arguments

name

The name of the player to be banned. Does not need to be online, or even real.

reason (optional)

Text to be displayed with the ban, to other operators and in the server logs.

Result

Always succeeds. The player name is added to the server blacklist, which prevents anyone with that name from connecting to the server

banip

ban

Restrictions	Operator
First introduced	Java Edition Classic 0.0.15a (Multiplayer Test 3)
Removed	JE Indev 0.31

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 <name>

ban-ip

ban

Restrictions	Multiplayer Operator No command blocks
First introduced	Java Edition Alpha v1.0.16

Adds an IP address to the blacklist.

Syntax

ban-ip <address|name> [reason …]

Arguments

address|name

An IP address or the name of a player who is currently online

reason (optional)

Text to be displayed with the ban, to other operators and in the server logs.

Result

Fails if address|name is neither a valid IP address nor the name of an online player.

On success, the IP address (of the online player, or the address specified) is added to the server blacklist, which prevents anyone from connecting to the server from that address.

banlist

ban

Restrictions	Multiplayer Operator No command blocks
First introduced	Java Edition Alpha v1.0.16

Displays the server's blacklist.

Syntax

banlist ips

banlist players

Result

Always succeeds. Displays banned IP addresses or banned players.

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					Added /ban, /ban-ip and /banlist.