Toggle menu
Toggle preferences menu
Toggle personal menu
Not logged in
Your IP address will be publicly visible if you make any edits.

Minecraft:Commands/whitelist: Difference between revisions

From SAS Gaming Wiki
SyncBot (talk | contribs)
Fix template calls: add MC/ prefix
SyncBot (talk | contribs)
Sync: updated from Minecraft
Line 5: Line 5:
* 3 {{only|java|short=1}}
* 3 {{only|java|short=1}}
* 4 {{only|bedrock|short=1}}
* 4 {{only|bedrock|short=1}}
|others=Cheat only{{only|bedrock|short=1}}
|others=[[Minecraft:Cheat]] only{{only|bedrock|short=1}}
|serveronly=y
|serveronly=y
}}
}}


Used to manage server whitelists.
Used to manage server [[Minecraft:whitelist]]s.


{{MC/In|java}}, server operators can ''always'' connect when the whitelist is active, even if their profiles do not appear in the whitelist. {{MC/In|bedrock}}, players ''must'' be whitelisted regardless of operator status. The profiles of the whitelisted players are stored in the <code>whitelist.json</code> or <code>allowlist.json</code>{{only|bedrock}} configuration file.
{{IN|java}}, server operators can ''always'' connect when the whitelist is active, even if their profiles do not appear in the whitelist. {{IN|bedrock}}, players ''must'' be whitelisted regardless of operator status. The profiles of the whitelisted players are stored in the <code>[[Minecraft:whitelist.json]]</code> or <code>allowlist.json</code>{{only|bedrock}} configuration file.


== Syntax ==
== Syntax ==
:<code>whitelist add <targets></code> ({{MC/El|je}})
:<code>whitelist add <targets></code> ({{el|je}})
:<code>allowlist add <name: string></code> ({{MC/El|be}})
:<code>allowlist add <name: string></code> ({{el|be}})
:: Adds player profile(s) into the whitelist. The player does not need to be online.
:: Adds player profile(s) into the whitelist. The player does not need to be online.
:<code>whitelist list</code>
:<code>whitelist list</code>
::Displays all player profiles in the whitelist.
::Displays all player profiles in the whitelist.
:<code>whitelist off</code>
:<code>whitelist off</code>
::Disables the server's use of a whitelist. Not implemented {{MC/In|be}}.
::Disables the server's use of a whitelist. Not implemented {{in|be}}.
:<code>whitelist on</code>
:<code>whitelist on</code>
::Enables the server's use of a whitelist. Not implemented {{MC/In|be}}.
::Enables the server's use of a whitelist. Not implemented {{in|be}}.
:<code>whitelist reload</code>
:<code>whitelist reload</code>
::Reloads the list of player profiles in <code>whitelist.json</code> or <code>allowlist.json</code>{{only|bedrock}} from disk (used when <code>whitelist.json</code> has been modified outside of ''Minecraft'').
::Reloads the list of player profiles in <code>whitelist.json</code> or <code>allowlist.json</code>{{only|bedrock}} from disk (used when <code>whitelist.json</code> has been modified outside of ''Minecraft'').
:<code>whitelist remove <targets></code> ({{MC/El|je}})
:<code>whitelist remove <targets></code> ({{el|je}})
:<code>allowlist remove <name: string></code> ({{MC/El|be}})  
:<code>allowlist remove <name: string></code> ({{el|be}})  
::Removes player profile(s) from the whitelist. The player does not need to be online.
::Removes player profile(s) from the whitelist. The player does not need to be online.


== Arguments ==
== Arguments ==
{{MC/El|je|short=1}}: {{MC/Argument|targets|game_profile}}
{{el|je|short=1}}: {{argument|targets|game_profile}}
:Specifies the player profile(s) to be added into or removed from the whitelist.
:Specifies the player profile(s) to be added into or removed from the whitelist.
:{{MC/Arg desc|je=game_profile}}
:{{arg desc|je=game_profile}}


{{MC/El|be|short=1}}: {{MC/Argument|be=1|name: string|basic_string}}
{{el|be|short=1}}: {{argument|be=1|name: string|basic_string}}
:Specifies the player name(s) to be added into or removed from the whitelist.
:Specifies the player name(s) to be added into or removed from the whitelist.
:{{MC/Arg desc|be=string}}
:{{arg desc|be=string}}


== Result ==
== Result ==
Line 50: Line 50:


== Output ==
== Output ==
{{MC/Output table}}
{{Output table}}
{{MC/Output table|edition=je|On fail|N/A|0|0}}
{{Output table|edition=je|On fail|N/A|0|0}}
{{MC/Output table|cmd=/whitelist on<br>/whitelist off<br>/whitelist reload|On success|N/A|1|1}}
{{Output table|cmd=/whitelist on<br>/whitelist off<br>/whitelist reload|On success|N/A|1|1}}
{{MC/Output table|cmd=/whitelist list|On success|N/A|1|the number of player profiles in the list.}}
{{Output table|cmd=/whitelist list|On success|N/A|1|the number of player profiles in the list.}}
{{MC/Output table|cmd=/whitelist add <targets>|On success|N/A|1|the number of new player profiles added to the whitelist.}}
{{Output table|cmd=/whitelist add <targets>|On success|N/A|1|the number of new player profiles added to the whitelist.}}
{{MC/Output table|cmd=/whitelist remove <targets>|On success|N/A|1|the number of player profiles removed from the whitelist.}}
{{Output table|cmd=/whitelist remove <targets>|On success|N/A|1|the number of player profiles removed from the whitelist.}}
{{MC/Output table}}
{{Output table}}


== History ==
== History ==
=== ''Java Edition'' ===
=== ''Java Edition'' ===
{{HistoryTable
{{HistoryTable
|{{MC/HistoryLine|Java Beta}}
|{{HistoryLine|Java Beta}}
|{{HistoryLine||1.3|Added {{MC/Cmd|link=none|whitelist}}.}}
|{{HistoryLine||1.3|Added {{cmd|link=none|whitelist}}.}}
|{{HistoryLine|upcoming java}}
|{{HistoryLine||26.3|dev=snap2|Whitelist is now enabled by default.}}
}}
}}


=== ''Bedrock Edition'' ===
=== ''Bedrock Edition'' ===
{{HistoryTable
{{HistoryTable
|{{MC/HistoryLine|bedrock}}
|{{HistoryLine|bedrock}}
|{{HistoryLine||1.16.0|dev=release|Added {{MC/Cmd|whitelist|link=none}}.}}
|{{HistoryLine||1.16.0|dev=release|Added {{cmd|whitelist|link=none}}.}}
|{{HistoryLine||1.17.0|dev=beta 1.16.230.50|Renamed to {{MC/Cmd|allowlist|link=none}}.}}
|{{HistoryLine||1.17.0|dev=beta 1.16.230.50|Renamed to {{cmd|allowlist|link=none}}.}}
|{{HistoryLine|||dev=release|Reverted back to {{MC/Cmd|whitelist|link=none}}.}}  
|{{HistoryLine|||dev=release|Reverted back to {{cmd|whitelist|link=none}}.}}  
|{{HistoryLine||1.18.10|dev=release|Renamed to {{MC/Cmd|allowlist|link=none}}.}}
|{{HistoryLine||1.18.10|dev=release|Renamed to {{cmd|allowlist|link=none}}.}}
}}
}}


Line 78: Line 80:


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


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

Revision as of 11:07, 1 July 2026

Template:Infobox command

Used to manage server Minecraft:whitelists.

Template:IN, server operators can always connect when the whitelist is active, even if their profiles do not appear in the whitelist. Template:IN, players must be whitelisted regardless of operator status. The profiles of the whitelisted players are stored in the Minecraft:whitelist.json or allowlist.jsonTemplate:Only configuration file.

Syntax

whitelist add <targets> (Template:El)
allowlist add <name: string> (Template:El)
Adds player profile(s) into the whitelist. The player does not need to be online.
whitelist list
Displays all player profiles in the whitelist.
whitelist off
Disables the server's use of a whitelist. Not implemented Template:In.
whitelist on
Enables the server's use of a whitelist. Not implemented Template:In.
whitelist reload
Reloads the list of player profiles in whitelist.json or allowlist.jsonTemplate:Only from disk (used when whitelist.json has been modified outside of Minecraft).
whitelist remove <targets> (Template:El)
allowlist remove <name: string> (Template:El)
Removes player profile(s) from the whitelist. The player does not need to be online.

Arguments

Template:El: Template:Argument

Specifies the player profile(s) to be added into or removed from the whitelist.
Template:Arg desc

Template:El: Template:Argument

Specifies the player name(s) to be added into or removed from the whitelist.
Template:Arg desc

Result

Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table Template:Result table

Output

Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table Template:Output table

History

Java Edition

Template:HistoryTable

Bedrock Edition

Template:HistoryTable

External links

Navigation

Template:Navbox commands

Minecraft:de:Befehl/whitelist Minecraft:ja:コマンド/whitelist Minecraft:pt:Comandos/whitelist Minecraft:ru:Команды консоли/whitelist Minecraft:zh:命令/whitelist