Minecraft

How do I set up and manage a whitelist?

A whitelist limits your server to a specific list of approved players — perfect for private survival worlds and friend groups. You manage it entirely from the Console.

Turning on and managing the whitelist

In the Console:

  1. whitelist on — enable the whitelist.
  2. whitelist add PlayerName — do this for each allowed player.
  3. whitelist reload — apply your changes.

To manage it later:

  • whitelist remove PlayerName — revoke access.
  • whitelist off — disable the whitelist entirely.

Names are stored in whitelist.json, which you can view in the Files tab.

Tip: Add yourself to the whitelist before turning it on, so you don't accidentally lock yourself out.

Frequently asked questions

I locked myself out — now what? Use the Console (which isn't affected by the whitelist for commands) to whitelist add your name, then reconnect.

Do I need to restart after changes? No — whitelist reload applies changes immediately without a restart.

Where are whitelisted players stored? In whitelist.json in your server root. You can inspect or edit it via the Files tab if needed.