How to Enable Whitelist Mode

Introduction

Whitelist mode blocks everyone except players you've explicitly added. It's the simplest way to keep a private server private.

Enable the Whitelist

1. 1Open the panel → Console tab
2. 2Type whitelist on and press Enter
3. 3Console prints: Whitelist is now turned on

Strangers now get a "You are not whitelisted on this server" message.

Add Players

• Per player: whitelist add UsernameHere
• Check the list: whitelist list
• Remove someone: whitelist remove UsernameHere
• Force refresh: whitelist reload

Edit the File Directly

1. 1Open File Manager → whitelist.json
2. 2Add entries:

   [
     { "uuid": "uuid-1", "name": "PlayerOne" },
     { "uuid": "uuid-2", "name": "PlayerTwo" }
   ]

1. 1Save → run whitelist reload in console

Tip: Combine whitelist with a custom MOTD that says "Private server, request access in Discord."

Turn It Off

• Run whitelist off in console
• Or remove white-list=true from server.properties

Warning: Whitelist is bypassed by anyone with OP. Don't OP people you don't fully trust.

Need More Help?

Whitelist not blocking joins? Make sure enforce-whitelist=true is also set. Help on Discord.