Commands/ban
< Commands
 |
This feature is exclusive to Java Edition. |
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[edit]
ban
| Restrictions | |
|---|---|
| First introduced |
Adds a player to the blacklist.
- Syntax
ban <name> [<reason>]
- Arguments
<name>- Name of the player to be added to the blacklist. Does not have to be online or even real
[<reason>](optional)- Message to display to the banned player, 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[edit]
banip
| Restrictions | |
|---|---|
| First introduced | |
| Removed |
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>]
ban-ip[edit]
ban-ip
| Restrictions | |
|---|---|
| First introduced |
Adds an IP address to the blacklist.
- Syntax
ban-ip (<address>|<name>) [<reason>]
- Arguments
(<address>|<name>)- An IP address or name of an online player
[<reason>] (optional)- A message to display to the banned player, to other operators, and in the server logs
- Result
- On success, the narrowly-specified address or that of of the named, online player is added to the server blacklist, preventing anyone from connecting to the server from that address.
- Fails if either the IP address or player name is invalid
banlist[edit]
banlist
| Restrictions | |
|---|---|
| First introduced |
Displays the server's blacklist.
- Syntax
banlist (ips|players)
- Result
- Always succeeds. Displays banned IP addresses or banned players.
History[edit]
| 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[edit]
