Whitelist Bedrock players

Restrict a native Minecraft Bedrock Edition server to approved Xbox Gamertags.

Use the allowlist to restrict a native Minecraft Bedrock Edition server to approved Xbox Gamertags. An allowlist (also called a whitelist) is the list of players allowed to join; a player's Xbox Gamertag is their Xbox username. Minecraft Bedrock Edition uses the term allowlist, although it also accepts whitelist as a command alias.

Before you begin

• Log in to the NolimitHost Game Panel at https://panel.nolimithost.cc/ and select your Minecraft Bedrock server. Start the server and wait until it finishes loading.
• Use each player's exact Xbox Gamertag — the player's Xbox username — including spaces and capitalization.
• Put a Gamertag in quotation marks when it contains spaces, such as "Example Player".
• Confirm that this is a native Bedrock server. For Bedrock players joining through Geyser, use the Java server's allowlist or permission system.

Enable the allowlist

1. Add approved players — Log in to the NolimitHost Game Panel at https://panel.nolimithost.cc/ and select your Minecraft Bedrock server. Open its Console and add each player's exact Xbox Gamertag. Enter console commands without a leading /.

   allowlist add "Example Player"

2. Stop the server — Stop the server before editing server.properties so the running process does not overwrite your change.
3. Enable the allowlist — In the File Manager, edit server.properties — the main configuration file for the server — and set allow-list to true. Save the file.

   allow-list=true

4. Restart the server — Start the server and watch the console for startup errors. A restart is required so the server reads the updated server.properties.
5. Check the approved players — List the allowlisted players and confirm that the expected Gamertags appear.

   allowlist list

Manage the allowlist

Fix common problems

An approved player cannot connect

Run allowlist list and compare the Gamertag exactly. Add the player again if needed, then run allowlist reload.

The command is unknown

Confirm that the server is running native Minecraft Bedrock Edition. Enter commands without / in the game panel console and with / in Minecraft chat.

The player joins through Geyser

Geyser provides Bedrock-to-Java cross-play. Manage the player with the Java server's allowlist or plugin permission system instead of this native Bedrock procedure.