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
Adds a player to the blacklist.

Arguments

 * Name of the player to be added to the blacklist. Must be a player name or a target selector. Does not have to be online or even real.
 * Entities other than players are not allowed.


 * Message to display to the banned player, to other operators, and in the server logs. May include spaces as well as target selectors.

Result
Fails if any target selectors in either argument fail to resolve to at least one online player.

On success, the player(s) is added to the server blacklist, which prevents anyone with that name from connecting to the server.

ban-ip
Adds an IP address to the blacklist.

Arguments

 * An IP address or name of an online player.


 * A message to display to the banned player, to other operators, and in the server logs. May include spaces as well as target selectors.

Result
Fails if either the IP address or player name is invalid, or if any target selectors in  fail to resolve to at least one online player.

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.

banlist
Displays the server's blacklist.

Result
Always succeeds. Displays banned IP addresses or banned players.

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

The Classic equivalent of.