How to Whitelist Players on Your Minecraft Bedrock Server

Set up and manage the allowlist on your Minecraft Bedrock Edition dedicated server to control who can join through the XGamingServer panel.

Here is how to enable and manage the allowlist (whitelist) on your Minecraft Bedrock server. When enabled, only players on the list can connect to your server.

📝 Note: The whitelist command was renamed to allowlist in newer Bedrock versions. Both terms refer to the same feature, but you should use the allowlist command on your server.

Enabling the Allowlist

Select Your Server

Open Server Properties

In the sidebar, go to Files and open server.properties.

Enable the Allowlist

Find the line allow-list=false and change it to:

allow-list=true

Save the file.

Restart Your Server

Restart your server for the change to take effect.

Adding Players to the Allowlist

Open the Console

In the sidebar, go to Console.

Add a Player

Type the following command and press Enter:

allowlist add "PlayerName"

📝 Note: Always use quotes around the player name. This is required for gamertags that contain spaces.

Removing Players from the Allowlist

To remove a player, use the following command in Console:

allowlist remove "PlayerName"

Viewing the Allowlist

To see all players currently on the allowlist, run this command in Console:

allowlist list

Editing the Allowlist File Directly

You can also manage the allowlist by editing the file directly.

Open the Allowlist File

In the sidebar, go to Files and open allowlist.json in the root directory.

Edit the File

Add or remove entries in the following format:

[
  {
    "ignoresPlayerLimit": false,
    "name": "PlayerName",
    "xuid": "1234567890"
  }
]

💡 Tip: The xuid field is the player's Xbox Live ID. If you leave it blank, the server will fill it in automatically the next time that player connects. The ignoresPlayerLimit field allows a player to join even when the server is full.

Save and Restart

Save the file and restart your server.

How to Whitelist Players on Your Minecraft Bedrock Server

On this page