☰

Whitelist Error

A player is rejected with 'You are not whitelisted on this server'. The whitelist is on and that player's account is not on it, or it was added incorrectly.

O que significa este erro?
With white-list enabled, only listed players may join. The kick means the joining account is not present in whitelist.json, often due to a name change, a typo, or offline-mode UUID issues. 
You are not whitelisted
Causas mais comuns
  • The player was never added to the whitelist.
  • A username typo when adding them.
  • The player changed their Minecraft name (the stored entry is outdated).
  • The server runs in offline mode, so UUIDs do not match online ones.
  • whitelist.json edited by hand with bad formatting.
Como diagnosticar
  1. Run '/whitelist list' to see who is actually whitelisted.
  2. Confirm the exact current username of the player.
  3. Check whether online-mode is true or false in server.properties.
  4. Inspect whitelist.json for formatting errors if edited manually.
Correções recomendadas
  • Add the player correctly
    Use '/whitelist add <currentName>' so the server fetches the right UUID.
  • Re-add after a name change
    Remove the stale entry and add the player by their new username.
  • Fix offline-mode UUIDs
    On offline servers, whitelist by the offline UUID, or run online-mode for proper UUIDs.
  • Reload the whitelist
    Run '/whitelist reload' after manual edits to apply changes.
Analisar meu log
Perguntas frequentes

Use the command with the current name on online-mode servers, it stores the correct UUID automatically.

Online mode tracks UUIDs, but a stale name entry can still cause mismatches, re-add the player.

Yes, offline UUIDs differ from online ones, so whitelist entries must use the matching UUID.