/whitelist

/whitelist
Aliases

/allowlist

Permission level
required
  • 3 ‌
  • 4 ‌
Restrictions

Dedicated server
Cheat only‌

Used to manage server whitelists.

In Java Edition, server operators can always connect when the whitelist is active, even if their profiles do not appear in the whitelist. In Bedrock Edition, players must be whitelisted regardless of operator status. The profiles of the whitelisted players are stored in the whitelist.json or allowlist.json‌ configuration file.

Syntax

whitelist add <targets> (Java Edition)
allowlist add <name: string> (Bedrock Edition)
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 in Bedrock Edition.
whitelist on
Enables the server's use of a whitelist. Not implemented in Bedrock Edition.
whitelist reload
Reloads the list of player profiles in whitelist.json or allowlist.json‌ from disk (used when whitelist.json has been modified outside of Minecraft).
whitelist remove <targets> (Java Edition)
allowlist remove <name: string> (Bedrock Edition)
Removes player profile(s) from the whitelist. The player does not need to be online.

Arguments

JE: <targets>: game_profile

Specifies the player profile(s) to be added into or removed from the whitelist.
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.

BE: name: string: basic_string

Specifies the player name(s) to be added into or removed from the whitelist.
Must be a string. And it must be a single word that has no space or a double-quoted string (When quoted, \ can be used to escape characters).

Result

CommandTriggerJava Edition
AnyThe command is incomplete, or any argument is not specified correctly. Unparseable
/whitelist onThe whitelist is already enabled. Failed
/whitelist offThe whitelist is already disabled.
The target selector fails to resolve to one or more online players.
/whitelist add <targets>There's no player profile newly added to the whitelist.
/whitelist remove <targets>All specified profiles are not in the whitelist.
AnyOtherwiseSuccessful

Output

CommandEditionSituationSuccess Count/execute store success .../execute store result ...
AnyJava EditionOn failN/A00
/whitelist on
/whitelist off
/whitelist reload
On successN/A11
/whitelist listOn successN/A1the number of player profiles in the list.
/whitelist add <targets>On successN/A1the number of new player profiles added to the whitelist.
/whitelist remove <targets>On successN/A1the number of player profiles removed from the whitelist.

History

Java Edition Beta
1.3Added /whitelist.
Bedrock Edition
1.16.0releaseAdded /whitelist.
1.17.0beta 1.16.230.50Renamed to /allowlist.
releaseReverted back to /
1.18.10releaseRenamed to /allowlist.

Navigation