Whitelist Background

How to use Whitelists

If you're hosting a private server for friends, whitelisting is your most important tool for keeping griefers and unwanted guests out of your world.

A whitelist is a list of usernames that are allowed to join your server. Everyone else is automatically blocked by the server, even if they have your IP address.

1 Enabling the Whitelist

Open your server.properties file (located in your File Manager) and find the following line:

white-list=true

After saving, restart your server to apply the changes.

Properties Visual

2 Managing Players from the Console

You don't need to manually edit the whitelist.json file. It's much safer and faster to use the Web Console in your Deduck dashboard.

  • whitelist add [Player] Add someone to your private server.
  • whitelist remove [Player] Remove someone from the server.

Note: Player names are not case-sensitive. If you add "Steve", "steve" will also be able to join.

3 Whitelisting Operations (OPs)

If a player is an Op (Operator), they can usually join even if they aren't on the whitelist. However, we highly recommend adding yourself to the whitelist anyway to prevent any "Permission Denied" errors when you're testing your settings.

4 What if something goes wrong?

If you're on the whitelist but still can't join, it's often a UUID mismatch. This usually happens if you've recently changed your Minecraft username or if you're running in online-mode=false (offline mode). The quickest fix is to remove and re-add yourself using the console.

Keeping your server private is the first step toward a grief-free community.

Read more about Server Security