Minecraft:Commands/ban - Revision history

SyncBot: Fix template calls: add MC/ prefix

2026-04-09T20:08:21Z

Fix template calls: add MC/ prefix

← Older revision		Revision as of 20:08, 9 April 2026
Line 1:		Line 1:
	{{About\|the command that kicks and bans players from a server\|the command that only kicks players\|Commands/kick}}		{{About\|the command that kicks and bans players from a server\|the command that only kicks players\|Commands/kick}}
	{{Redirect\|Blocked\|the game mechanic that prevents an attack from taking effect\|Blocking}}		{{MC/Redirect\|Blocked\|the game mechanic that prevents an attack from taking effect\|Blocking}}
	{{Exclusive\|java}}		{{MC/Exclusive\|java}}

	These commands control a [[Minecraft:Server\|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.		These commands control a [[Minecraft:Server\|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.
Line 18:		Line 18:

	=== Arguments ===		=== Arguments ===
	{{~~argument~~\|targets\|game_profile}}		{{MC/Argument\|targets\|game_profile}}
	: Specifies the player profile(s) to be added to the blacklist.		: Specifies the player profile(s) to be added to the blacklist.
	: {{~~arg~~ desc\|je=game_profile}}		: {{MC/Arg desc\|je=game_profile}}

	{{~~argument~~\|reason\|message}}		{{MC/Argument\|reason\|message}}
	: Message to display to the banned player, to other operators, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>		: Message to display to the banned player, to other operators, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>
	: {{~~arg~~ desc\|je=message}}		: {{MC/Arg desc\|je=message}}

	=== Result ===		=== Result ===
Line 35:		Line 35:

	=== Output ===		=== Output ===
	{{Output table}}		{{MC/Output table}}
	{{Output table\|edition=je\|On fail\|N/A\|0\|0}}		{{MC/Output table\|edition=je\|On fail\|N/A\|0\|0}}
	{{Output table\|On success\|N/A\|1\|the number of new player names added to blacklist.}}		{{MC/Output table\|On success\|N/A\|1\|the number of new player names added to blacklist.}}
	{{Output table}}		{{MC/Output table}}

	== ban-ip ==		== ban-ip ==
Line 53:		Line 53:

	=== Arguments ===		=== Arguments ===
	{{~~argument~~\|targets\|string}}		{{MC/Argument\|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.		: 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.
	: {{~~arg~~ desc\|je=string\|type=word}}		: {{MC/Arg desc\|je=string\|type=word}}

	{{~~argument~~\|reason\|message}}		{{MC/Argument\|reason\|message}}
	: Message to display to the banned player, to other operators, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>		: Message to display to the banned player, to other operators, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>
	: {{~~arg~~ desc\|je=message}}		: {{MC/Arg desc\|je=message}}

	=== Result ===		=== Result ===
Line 70:		Line 70:

	=== Output ===		=== Output ===
	{{Output table}}		{{MC/Output table}}
	{{Output table\|edition=je\|On fail\|N/A\|0\|0}}		{{MC/Output table\|edition=je\|On fail\|N/A\|0\|0}}
	{{Output table\|On success\|N/A\|1\|the number of online players that connecting with the specified IP}}		{{MC/Output table\|On success\|N/A\|1\|the number of online players that connecting with the specified IP}}
	{{Output table}}		{{MC/Output table}}

	== banlist ==		== banlist ==
Line 94:		Line 94:

	=== Output ===		=== Output ===
	{{Output table}}		{{MC/Output table}}
	{{Output table\|edition=je\|On success\|N/A\|1\|the number of entries in the specified list.}}		{{MC/Output table\|edition=je\|On success\|N/A\|1\|the number of entries in the specified list.}}
	{{Output table}}		{{MC/Output table}}

	== banip ==		== banip ==
Line 104:		Line 104:
	}}		}}

	Bans a player by IP number. Cannot be undone in-game; {{cd\|banned-ip.txt}} must manually be changed.		Bans a player by IP number. Cannot be undone in-game; {{MC/Cd\|banned-ip.txt}} must manually be changed.

	The Classic equivalent of {{~~cmd~~\|ban-ip}}.		The Classic equivalent of {{MC/Cmd\|ban-ip}}.

	=== Syntax ===		=== Syntax ===
Line 113:		Line 113:
	== History ==		== History ==
	{{HistoryTable		{{HistoryTable
	\|{{HistoryLine\|java classic}}		\|{{MC/HistoryLine\|java classic}}
	\|{{HistoryLine\|\|rowspawn=2\|0.0.16a\|Added {{~~cmd~~\|ban\|link=none}} and {{~~cmd~~\|banip\|link=none}}.}}		\|{{HistoryLine\|\|rowspawn=2\|0.0.16a\|Added {{MC/Cmd\|ban\|link=none}} and {{MC/Cmd\|banip\|link=none}}.}}
	\|{{HistoryLine\|java indev}}		\|{{MC/HistoryLine\|java indev}}
	\|{{HistoryLine\|\|0.31\|Due to Indev's lack of support for servers, commands are no longer usable.}}		\|{{MC/HistoryLine\|\|0.31\|Due to Indev's lack of support for servers, commands are no longer usable.}}
	\|{{HistoryLine\|java alpha}}		\|{{MC/HistoryLine\|java alpha}}
	\|{{HistoryLine\|\|v1.0.16\|{{~~cmd~~\|banip\|link=none}} has been renamed to {{~~cmd~~\|ban-ip\|link=none}}.		\|{{HistoryLine\|\|v1.0.16\|{{MC/Cmd\|banip\|link=none}} has been renamed to {{MC/Cmd\|ban-ip\|link=none}}.
	\|{{~~cmd~~\|ban\|link=none}} and {{~~cmd~~\|ban-ip\|link=none}} are now usable again.		\|{{MC/Cmd\|ban\|link=none}} and {{MC/Cmd\|ban-ip\|link=none}} are now usable again.
	\|Added {{~~cmd~~\|banlist\|link=none}}.}}		\|Added {{MC/Cmd\|banlist\|link=none}}.}}
	}}		}}

Line 127:		Line 127:

	== Navigation ==		== Navigation ==
	{{Navbox commands}}		{{MC/Navbox commands}}

	de:Befehl/ban		de:Befehl/ban

SyncBot: Remove broken links to missing pages

2026-04-09T15:43:22Z

Remove broken links to missing pages

← Older revision		Revision as of 15:43, 9 April 2026
Line 23:		Line 23:

	{{argument\|reason\|message}}		{{argument\|reason\|message}}
	: Message to display to the banned player, to other ~~[[Minecraft:operator]]s~~, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>		: Message to display to the banned player, to other operators, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>
	: {{arg desc\|je=message}}		: {{arg desc\|je=message}}

Line 58:		Line 58:

	{{argument\|reason\|message}}		{{argument\|reason\|message}}
	: Message to display to the banned player, to other ~~[[Minecraft:operator]]s~~, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>		: Message to display to the banned player, to other operators, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>
	: {{arg desc\|je=message}}		: {{arg desc\|je=message}}

Line 129:		Line 129:
	{{Navbox commands}}		{{Navbox commands}}

	~~[[Minecraft:~~de:Befehl/ban]]		de:Befehl/ban
	~~[[Minecraft:~~es:Comandos/ban]]		es:Comandos/ban
	~~[[Minecraft:~~ja:コマンド/ban]]		ja:コマンド/ban
	~~[[Minecraft:~~pt:Comandos/ban]]		pt:Comandos/ban
	~~[[Minecraft:~~ru:Команды консоли/ban]]		ru:Команды консоли/ban
	~~[[Minecraft:~~uk:Команди консолі/ban]]		uk:Команди консолі/ban
	~~[[Minecraft:~~zh:命令/ban]]		zh:命令/ban

imported>CrafterShapeless at 04:43, 6 December 2025

2025-12-06T04:43:58Z

New page

{{About|the command that kicks and bans players from a server|the command that only kicks players|Commands/kick}}
{{Redirect|Blocked|the game mechanic that prevents an attack from taking effect|Blocking}}
{{Exclusive|java}}

These commands control a [[Minecraft:Server|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 ==
{{Infobox command
|name=ban
|oplevel=3
|serveronly=y
}}

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

=== Syntax ===
:<code>ban <targets> [<reason>]</code>

=== Arguments ===
{{argument|targets|game_profile}}
: Specifies the player profile(s) to be added to the blacklist.
: {{arg desc|je=game_profile}}

{{argument|reason|message}}
: Message to display to the banned player, to other [[Minecraft:operator]]s, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>
: {{arg desc|je=message}}

=== Result ===
{{Result table|onlyje=1}}
{{Result table|The command is incomplete, or any argument is not specified correctly.|unparseable}}
{{Result table|The target selector fails to resolve to one or more online players.|fail}}
{{Result table|Does not add any new player profile to blacklist.}}
{{Result table|succeed}}
{{Result table}}

=== Output ===
{{Output table}}
{{Output table|edition=je|On fail|N/A|0|0}}
{{Output table|On success|N/A|1|the number of new player names added to blacklist.}}
{{Output table}}

== ban-ip ==
{{Infobox command
|name=ban-ip
|oplevel=3
|serveronly=y
}}

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.

=== Syntax ===
:<code>ban-ip <target> [<reason>]</code>

=== Arguments ===
{{argument|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.
: {{arg desc|je=string|type=word}}

{{argument|reason|message}}
: Message to display to the banned player, to other [[Minecraft:operator]]s, and in the server logs. If unspecified, defaults to <code>Banned by an operator.</code>
: {{arg desc|je=message}}

=== Result ===
{{Result table|onlyje=1}}
{{Result table|The command is incomplete, or any argument is not specified correctly.|unparseable}}
{{Result table|<code>targets</code> is not a valid IP, nor a name of an online player.|fail}}
{{Result table|Does not add any new IP address to blacklist.}}
{{Result table|succeed}}
{{Result table}}

=== Output ===
{{Output table}}
{{Output table|edition=je|On fail|N/A|0|0}}
{{Output table|On success|N/A|1|the number of online players that connecting with the specified IP}}
{{Output table}}

== banlist ==
{{Infobox command
|name=banlist
|oplevel=3
|serveronly=y
}}

Displays the server's blacklist.

=== Syntax ===
: <code>banlist [ips|players]</code>

=== Result ===
{{Result table|onlyje=1}}
{{Result table|The command is incomplete.|unparseable}}
{{Result table|succeed}}
{{Result table}}

=== Output ===
{{Output table}}
{{Output table|edition=je|On success|N/A|1|the number of entries in the specified list.}}
{{Output table}}

== banip ==
{{Outdated feature|section=1|edition=java}}
{{Infobox command
|name=banip
}}

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

The Classic equivalent of {{cmd|ban-ip}}.

=== Syntax ===
: <code>banip (<address>|<name>) [<reason>]</code>

== History ==
{{HistoryTable
|{{HistoryLine|java classic}}
|{{HistoryLine||rowspawn=2|0.0.16a|Added {{cmd|ban|link=none}} and {{cmd|banip|link=none}}.}}
|{{HistoryLine|java indev}}
|{{HistoryLine||0.31|Due to Indev's lack of support for servers, commands are no longer usable.}}
|{{HistoryLine|java alpha}}
|{{HistoryLine||v1.0.16|{{cmd|banip|link=none}} has been renamed to {{cmd|ban-ip|link=none}}.
|{{cmd|ban|link=none}} and {{cmd|ban-ip|link=none}} are now usable again.
|Added {{cmd|banlist|link=none}}.}}
}}

== See also ==
* [[Minecraft:Commands/whitelist]]

== Navigation ==
{{Navbox commands}}

[[Minecraft:de:Befehl/ban]]
[[Minecraft:es:Comandos/ban]]
[[Minecraft:ja:コマンド/ban]]
[[Minecraft:pt:Comandos/ban]]
[[Minecraft:ru:Команды консоли/ban]]
[[Minecraft:uk:Команди консолі/ban]]
[[Minecraft:zh:命令/ban]]