Whitelist and operator levels explained
Minecraft has two simple tools for control, built into the game itself. The whitelist decides who can join. Operator status decides who can use admin commands. Both work without any plugins, on Paper, Fabric, Forge and vanilla alike.
The whitelist
With the whitelist on, only players on the list can join. Everyone else sees a message that they are not whitelisted. For a server among friends, turn it on before you share the address.
In the panel
- Open the Players tab.
- Add each friend's exact Minecraft username to the whitelist.
- Switch the whitelist on in the whitelist settings.
With commands
whitelist on
whitelist add Sam
whitelist remove Sam
whitelist listType these in the Console without a slash, or in the game with a slash if you are an operator.
Kick people who are no longer on the list
Removing someone from the whitelist does not throw them out while they are online. The setting enforce-whitelist=true in server.properties does: with it on, anyone not on the list is removed as soon as the whitelist is reloaded or turned on.
Operators
An operator, or op, can use admin commands. Add one in the Players tab under operators, or with op Sam in the console. deop Sam takes it away.
Operators are stored in ops.json, each with a level from 1 to 4. The level decides how far their power goes.
The four levels
| Level | What it allows | Give it to |
|---|---|---|
| 1 | Build inside the spawn protection area | Trusted builders |
| 2 | Cheat commands: gamemode, give, teleport, time, weather, and command blocks | Event hosts, builders on a creative server |
| 3 | Player management: kick, ban, op and deop others | Moderators you trust |
| 4 | Everything, including stopping the server and saving | Only yourself |
New ops get the level set by op-permission-level in server.properties, which is 4 unless you change it. To give someone a lower level, change their level in ops.json in the Files tab and restart, or lower op-permission-level before you op them.
Spawn protection
By default, players who are not ops cannot break or place blocks within 16 blocks of the world spawn. That protects the spawn on public servers but confuses friends on a private one. Set spawn-protection=0 in server.properties to switch it off.
When the built in tools are not enough
Op levels are coarse. A level 2 op can give themselves any item. If you want a helper who can mute and kick but not cheat, use a permissions plugin instead. Set up permissions with LuckPerms walks through it.
Bans are in the Players tab as well, or with ban Sam and pardon Sam. A ban by IP (ban-ip) also catches a second account on the same connection, but it can hit innocent people who share a home connection.
Questions
Does the whitelist work for Bedrock players on a crossplay server?
Yes, but add them with Floodgate's own command, fwhitelist add, followed by their Bedrock name. The normal whitelist command expects a Java account.
Is the username case sensitive?
No. Minecraft matches the account, not the capitals. The spelling does have to be right, including underscores and numbers.
A player changed their name. Are they still whitelisted?
Yes. The whitelist stores the account ID next to the name, so a name change does not remove them.
Checked against Minecraft Java 26.2, September 2026. Written by the Cheapest Minecraft Hosting team, updated .