MasaApps360
English
RCONRCON

Minecraft whitelist command: what to type and why it sometimes does nothing

On a Java Edition server the whole job is six commands: whitelist on, whitelist off, whitelist add NAME, whitelist remove NAME, whitelist list and whitelist reload. Type them in the server console without a slash, or send them over RCON from the RCON app on your iPhone; the reply comes back as plain text.

3 min read · Updated

The commands and what each one prints

The server answers every command with one line, so you always know whether it worked. Player names are case-sensitive in the sense that they must be spelled like the real account.

Vanilla Java Edition whitelist commands
CommandWhat it doesReply
whitelist onStarts enforcing the listWhitelist is now turned on
whitelist offLets everyone join againWhitelist is now turned off
whitelist add SteveAdds the account SteveAdded Steve to the whitelist
whitelist remove SteveTakes Steve off the listRemoved Steve from the whitelist
whitelist listShows how many players are on it, with namesA count followed by the names
whitelist reloadRe-reads whitelist.json from diskReloaded the whitelist

Two other replies are worth recognising. Player is already whitelisted means the add did nothing because the name was already on the list. That player does not exist means the name does not match an account, usually a typo.

The two switches in server.properties

  • white-list=true keeps the whitelist on after every start. The default is false, so a fresh server lets everybody in.
  • enforce-whitelist=true also kicks players who are online but not on the list the moment the list is reloaded or switched on. The default is false, so people already inside stay inside.

Stop the server before you edit server.properties, then start it again. The whitelist on command takes effect immediately, without a restart.

Run them from your phone with the RCON app

RCON has to be enabled on the server first (enable-rcon, rcon.password, rcon.port); the Minecraft RCON guide on this site walks through that. Then:

  1. On the Servers screen tap the plus button to open Add Server.
  2. Fill in Server Name and Hostname or IP, set Server Type to Minecraft and check that Port shows 25575.
  3. Enter the value of rcon.password in RCON Password, tap Test Connection, then Save Server.
  4. Tap the server to open its console and type whitelist add Steve. Do not type the slash.
  5. Check the result with whitelist list. Command Suggestions completes the subcommands as you type.

On a server in your own house the first connection makes iOS ask for Local Network access. Allow it, or the app cannot reach a machine on your Wi-Fi.

Why the whitelist command does not work

  • The whitelist is off. whitelist add fills the list, but nothing is enforced until you run whitelist on or set white-list=true.
  • The name does not exist. You get That player does not exist. Check the spelling against the Minecraft account, including capital letters.
  • You edited whitelist.json by hand. The server only reads the file again after whitelist reload.
  • The server runs in offline mode (online-mode=false). UUIDs are then built from the typed name, so entries copied from an online server do not match and Steve differs from steve. Add the names again with the command on that server.
  • You typed it in game without operator rights. The reply is Unknown or incomplete command. The server console and RCON need no operator status.

What about Bedrock servers?

The Bedrock Dedicated Server has no RCON and calls its list the allowlist, so the RCON app cannot manage it. This page is about Java Edition.

Questions and answers

How do I whitelist someone on a Minecraft server?
Run whitelist add followed by their exact account name, then make sure the whitelist is on with whitelist on. The server replies Added NAME to the whitelist when it worked.
Do I need to restart the server after whitelist add?
No. add, remove and on act immediately. You only need whitelist reload after editing whitelist.json by hand, and a restart after editing server.properties.
Why does the whitelist command say unknown or incomplete command?
In game that reply usually means you lack operator rights. Run the command from the server console or from an RCON session, which do not depend on being an operator.
Can I whitelist a player who is offline?
Yes. The player does not have to be online. On an online-mode server the machine does need internet access so it can look the name up.

You might also like

More RCON guides