How To Setup an Allowlist for your Server

i18n:translate:helpHow to Set Up an Allowlist on Your Minecraft Bedrock Server

Sick of random people joining your Bedrock server? An allowlist limits who can join your game to only the players you specify. This guide shows you how to turn it on and how to add and remove players.

Before You Begin

• Your Bedrock server and access to its console
• The exact Minecraft username of every player you want to allow

Tip: Stop your server before changing settings, then start it again to apply them.

Setting Up an Allowlist

Using the Blacksmith’s Portal

Use these steps if your server is hosted with AleForge.

1. Open the Blacksmith’s Portal and select your server.

2. Stop your server.

3. Go to Startup.

4. Set Enable Allowlist to true.

   

5. Start your server.

6. Go to Console.

7. Add a player to the allowlist by typing this command into the console:

allowlist add "playername"

8. Remove a player by typing:

allowlist remove "playername"

Self-Hosting or Other Providers

Use these steps if you host the server yourself or with another provider.

1. Stop your server.
2. Open your server’s files.
3. Locate server.properties and open it.
4. Look for allow-list and set it to true:

allow-list=true

5. Start your server.
6. Add a player to the allowlist by typing this command into the console:

allowlist add "playername"

7. Remove a player by typing:

allowlist remove "playername"

Using Commands In-Game

As well as typing these commands into the console, you can run them in-game if you are set as an operator. In the in-game chat, start the command with a /:

/allowlist add "playername"

Enter Usernames Exactly

Enter the player’s username exactly as it appears in Minecraft, including capital letters and any spaces. Otherwise the command will not add the correct player.

Quick Reference

Action	Command
Add a player	allowlist add "playername"
Remove a player	allowlist remove "playername"

Troubleshooting

Problem	What to try
Players can still join without being on the list	Make sure the allowlist is turned on (Enable Allowlist or allow-list), then restart the server.
A player on the list can’t join	Check that their username was entered exactly as it appears in Minecraft. Remove the entry and add it again.
Command doesn’t work in-game	Make sure you are an operator and that the command starts with /.
Settings didn’t apply	Stop the server before changing settings, then start it again.