/ban

This article is about the command that kicks and bans players from a server. For the command that only kicks players, see Commands/kick.

"Blocked" redirects here. For the game mechanic that prevents an attack from taking effect, see Blocking.

This feature is exclusive to Java Edition.

 

These commands add a single or multiple players into the server's ban list (or blacklist) by their game profile or IP address. A ban list is a list of players or IP addresses that are not allowed to connect to the server; this list supersede any whitelisting in place.

To remove players from the ban list, operator may use /pardon or manually removing it from the banned-players.json.

{
    "title": "<code>/ban</code>",
    "rows": [
        {
            "field": "3",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "Dedicated server<br>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Adds the player profile(s) into the server blacklist, which prevents anyone from connecting to the server with uuids of these profiles.

ban <targets> [<reason>]

<targets>: game_profile

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

Specifies one or more game profiles (player profiles). Must be a player name (should be a real one if the server is in online mode) or a player-type target selector.

<reason>: message

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

It is a greedy phrase string argument (taking the rest of the command as the string argument). 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.

{
    "title": "<code>/ban-ip</code>",
    "rows": [
        {
            "field": "3",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "Dedicated server<br>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Adds an IP address to the blacklist. Adds the narrowly-specified address or address of the named online player into the server blacklist, preventing anyone from connecting to the server from that address.

ban-ip <target> [<reason>]

<targets>: string

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

Must be a string. And it must be in a single word (Allowed characters include: -, +, ., _, A-Z, a-z, and 0-9).

<reason>: message

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

It is a greedy phrase string argument (taking the rest of the command as the string argument). 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.

{
    "title": "<code>/banlist</code>",
    "rows": [
        {
            "field": "3",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "Dedicated server<br>",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

Displays the server's blacklist.

banlist [ips|players]

This section describes content that has been removed from the game.

 

This feature was present in earlier versions of Java Edition, but has since been removed.

{
    "title": "<code>/banip</code>",
    "rows": [
        {
            "field": "Unknown",
            "label": "(link to Permission level article, displayed as Permission level<br>required)"
        },
        {
            "field": "None",
            "label": "(link to Commands#Restrictions article, displayed as Restrictions)"
        }
    ],
    "invimages": [],
    "images": []
}

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

The Classic equivalent of /ban-ip.

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

• Commands/whitelist