Minecraft Whitelist Setup

What is the Whitelist?

The whitelist is an access control system for your server. Only players on the list can join.

Enabling the Whitelist

In server.properties:

white-list=true
enforce-whitelist=true

Or via an in-game command:

/whitelist on

Adding Players

/whitelist add <PlayerName>

For Bedrock players (via Geyser):

/whitelist add .<BedrockName>

Managing the Whitelist

Command Description
/whitelist list Show all players
/whitelist add <name> Add a player
/whitelist remove <name> Remove a player
/whitelist reload Reload the list
/whitelist on/off Toggle whitelist

whitelist.json

The whitelist is stored in whitelist.json:

[
  {
    "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
    "name": "PlayerName"
  }
]

Tips

  • Enforce Whitelist: Enable enforce-whitelist=true so players are kicked if they are removed from the list
  • Ops: Server operators (OPs) can join even without being whitelisted when enforce-whitelist is off
  • Automation: Use plugins like EasyWhitelist for web-based management