Short answer

Run whitelist on in the server console, then add each Java username with whitelist add PlayerName. Run whitelist list to verify the result. On ChunkArc, the same actions are available as simple controls in the world settings.

What a Minecraft whitelist does

When the whitelist is enabled, only players recorded in whitelist.json can join. Knowing the server address is no longer enough. Paper recommends using the whitelist when you want to restrict access, and recommends managing it with the console command instead of editing the JSON file directly.

A whitelist controls who can join. It does not give a player operator permissions. Use op PlayerName only for people who should have administrator commands.

Whitelist commands for Minecraft Java

  1. Open the server console.
  2. Enter whitelist on.
  3. Enter whitelist add PlayerName for every invited player.
  4. Enter whitelist list and check every spelling.
  5. Ask one invited player to join before you announce the server.

To remove access, use whitelist remove PlayerName. To turn invite-only mode off, use whitelist off. Commands entered in a hosting console normally omit the leading slash; in game, an operator uses the slash.

Use the whitelist in ChunkArc

Open World settings in ChunkArc Manage, turn on invite-only access, add exact Java usernames, and save. The panel sends the supported server commands for you, so you do not need to edit whitelist.json.

If you are still preparing the group, follow the invite-friends checklist after the whitelist is ready. Share the custom hostname shown in the panel, not the node hostname.

Why a whitelisted player still cannot join

  • The username is misspelled. Copy the exact Java profile name, including capitalization.
  • The wrong edition is joining. A Java whitelist entry does not automatically describe a Bedrock identity.
  • The list was changed while the server was unavailable. Start the server, run whitelist reload, then verify with whitelist list.
  • The server has another connection problem. Work through the Minecraft connection checklist before changing the whitelist again.

A safe setup for a small private server

Enable the whitelist before posting the address, add only the friends who should join, and keep operator access separate. Take a backup before major plugin or world changes. Removing someone from the whitelist prevents a future join; it does not undo changes they already made in the world.

PaperMC: whitelistingPaperMC: whitelist.json reference

Create an invite-only world

Start a free Minecraft Java server, choose its address, then manage the whitelist from the beginner-friendly ChunkArc panel.

CREATE FREE SERVER