Skip to main content

Minecraft | How to whitelist players on your server

The whitelist feature allows you to control who can access your Minecraft server. In this tutorial, we will guide you through the process of managing whitelists on your Minecraft server.

The terms white-list and enforce-whitelist refer to two different settings related to player access.

  • White-list - The white-list feature allows server administrators to control who can access the server. When the white-list is enabled, only players whose usernames are added to the white-list can join the server. It acts as a form of access control, ensuring that only approved players can connect. Other players attempting to join will be denied access.

  • Enforce-Whitelist - Enforce-whitelist is a more strict version of the white-list feature. When enforce-whitelist is enabled, the server strictly enforces the white-list and automatically kicks any player who is not on the white-list. Essentially, it ensures that only whitelisted players can join, and it actively removes any unauthorized players who manage to connect to the server.

Enabling the white-list is useful for controlling access to your Minecraft server, allowing you to play with a select group of friends or only allow trusted players. However, by enabling enforce-whitelist, you add an extra layer of security, preventing any unauthorized players from remaining on the server even if they somehow manage to join initially.

  1. Stop the server from the Game panel.
  2. Go to the configuration files and click on the Text Editor for server.properties.

  1. Look for the line enforce-whitelist=false and change it to enforce-whitelist=true.

  1. Start the server.
  1. Click on the Web Console button.
  2. Type whitelist on and press Enter to activate the whitelist.

  1. To add a player to the whitelist, run the command whitelist add playername in the console. For example, whitelist add PlayerName. After entering the command, you will see a message stating Player added to whitelist.
  2. To remove players from the whitelist, type whitelist remove playername in the console. For example, whitelist remove PlayerName. Once the command is entered, you will receive a message saying Player removed from whitelist.

Commands

note

These commands are entered directly into the console without the leading slash (/).

tip

If you want to use these commands in-game, remember to include the slash (/).

  • whitelist on - Activates the whitelist.
  • whitelist off - Disables the whitelist.
  • whitelist add PlayerName - Adds a player to the whitelist.
  • whitelist remove PlayerName - Removes a player from the whitelist.
  • whitelist list - Lists the players who have been added to the whitelist.

Take control of who can join your Minecraft server by managing the whitelist effectively using these steps and commands.