How to fix the "Player Banned" message on a Bedrock server¶

If a player sees a message that looks like "player banned" even though they have not been banned, the most common cause is usually not a real ban, but an allowlist, account name, or authentication/version mismatch issue.

1. Check the client and server versions¶

• Make sure the Bedrock client version matches the server version.
• If you see Outdated Server or Outdated Client, sync the versions first.

2. Check the allowlist¶

If allow-list=true, only players listed in allowlist.json can join.

• Add a player with the command:

/allowlist add PlayerName

• Or disable the allowlist if you are not using it:

allow-list=false

3. Check online mode¶

By default, a Bedrock dedicated server uses online-mode=true. For an internet-facing server, this is the setting recommended by the official documentation.

online-mode=true

4. Restart the server after changes¶

After editing server.properties or allowlist.json, restart the server or reload the allowlist if needed.

5. Check the console¶

Watch the error lines when a player tries to join. The cause is usually one of the following:

• the player is not on the allowlist
• the client version does not match
• the player name is wrong
• the server is unstable or not fully online

If there really is a ban¶

Check the ban file or commands used on the server or any extra proxy you may be running outside the standard Bedrock dedicated server.

Cheers, Team NexusCloud