How to add players to your whitelist on your Java Minecraft server
How to add players to your whitelist on your Java Minecraft server
Whitelisting is a feature that allows you to limit the players who can access your Minecraft server. When enabled, only whitelisted players can join your server. This is a good way to prevent unwanted players from joining and making changes to your server. This functionality is built into every Minecraft server out of the box.
Important Reminders:
You need to be an operator (OP) to be able to use these commands. You can set yourself as an operation by following this article: How to OP and DE-OP a player in Minecraft
All operators / OP players bypass the whitelist. These players do not need to be added to the whitelist to join the server.
ENABLING AND DISABLING WHITELIST
Enabling and disabling whitelist on your Minecraft server can be done through commands alone.
| COMMAND | DESCRIPTION |
|---|---|
| /whitelist on | This command enables whitelisting. Once enabled, only players on your whitelist can join. |
| /whitelist off | This command disables whitelist. All players can join the server like normal. |
You may do these commands both in-game or through your server console by removing the "/" symbol before the command.
ADDING AND REMOVING PLAYERS FROM THE WHITELIST
Once you've enabled whitelisting on you server, you need to add players which will allow them to join your server.
| COMMAND | DESCRIPTION |
|---|---|
| /whitelist add | This command adds a player to the whitelist. Example:** /whitelist add Steve** |
| /whitelist remove | This command removes a player from the whitelist. This will prevent them from joining your server when whitelist is enabled. Example: /whitelist remove Steve |
You may do these commands both in-game or through your server console by removing the "/" symbol before the command.
You may also and and remove players from your whitelist by directly edit your whitelist.json (Minecraft 1.7.6 up to the most recent versions) or white-list.txt (Minecraft 1.7.5 or earlier) files. However, doing this is not recommended as it's easy to make syntax errors which will lead to errors for your whitelist or server.
ADDITIONAL COMMANDS TO MANAGE WHITELIST
| COMMAND | DESCRIPTION |
|---|---|
| /whitelist list | This command lists all whitelisted players. |
| /whitelist reload | This command reloads the whitelist.json or white-list.txt file from your server directory. |
You may do these commands both in-game or through your server console by removing the "/" symbol before the command.
If you require any further assistance, please create a ticket here.
Created By: Steven C.
Updated on: 14/06/2024
Thank you!