infoServer ErrorsAffects: All versions
How to Fix Whitelist Not Working
Fix Whitelist Not Working by adding the player with the correct username and reloading the whitelist.
Quick Fix
Run /whitelist add <playername> and /whitelist reload on the server console.
Error Message
You are not white-listed on this server!How to Fix
1
Use /whitelist add <exact username> from the server console
2
Run /whitelist reload after editing whitelist.json manually
3
For offline-mode servers, ensure UUID matches in whitelist.json
4
Check username spelling and capitalization
Common Causes
- Player not added to whitelist
- Username case mismatch
- Using online-mode=false without configuring offline UUIDs
- Whitelist not reloaded after changes
Diagnostic Steps
- Check if whitelist is enabled: enforce-whitelist=true in server.properties
- Add the player: /whitelist add <name>
- Reload: /whitelist reload
- Have the player try connecting again
FAQ
How do I add a Bedrock player to the whitelist?
For Geyser/Floodgate servers, use the player's Bedrock gamertag prefixed with a dot: /whitelist add .BedrockPlayer