Skip to main content

Whitelist

Whitelist is a security feature on a Minecraft server that restricts who can enter. Only players registered on the whitelist can join the server.

Reasons to Use a Whitelist​

  • Prevents unknown players from entering without permission.
  • Reduces the risk of griefing from unknown players.
  • Maintains server privacy, especially for small communities or private servers.

Enabling and Disabling the Whitelist​

Use the following commands in the server console or as an operator:

/whitelist on   # Enables the whitelist
/whitelist off  # Disables the whitelist

Adding a Player to the Whitelist​

/whitelist add <playerName>

Example:

/whitelist add member1

Removing a Player from the Whitelist​

/whitelist remove <playerName>

Viewing the Whitelist​

/whitelist list
  • whitelist.json
    This file stores the list of players allowed to enter.
    Example contents: 
    [
      {
        "uuid": "xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
        "name": "member1"
      }
    ]

Security Tips​

  • Use a whitelist for small community servers to make them more private.
  • Combine it with a permission plugin for more detailed control.
  • Check the whitelist periodically to ensure only allowed players can enter.