Skip to main content

​
Securing Your Digital Community

A whitelist represents your server’s primary technical defense against unauthorized intrusion, griefing, and automated bot attacks. Unlike a standard “Blacklist” or “Banlist” which targets specific known offenders, a whitelist implement a “Default Deny” security posture: every player is restricted from joining by default, and access is exclusively granted to those you have manually verified. This is an essential protocol for private survival groups, Roleplay (RP) communities, and high-security technical projects.

Difficulty

Beginner

Time

4 Minutes

​
Technical Activation Workflow

Follow these steps to authorize the whitelist enforcement on your FREAKHOSTING instance.
1

Access the Console

Log in to the Game Panel and navigate to the Console tab.
2

Initialize Enforcement

Execute the following command to activate the security logic:
whitelist on
3

Verify Activation

The console will return: Whitelist is now turned on. Any player not currently in your registry will be instantly disconnected if they attempt to join.

​
Managing the Authorized Registry

You can manipulate your access list in real-time without requiring a server restart.
Administrative ActionCommand Syntax
Authorize Playerwhitelist add <PlayerName>
Revoke Authorizationwhitelist remove <PlayerName>
Audit Registrywhitelist list
Synchronize Fileswhitelist reload (use if manually editing the whitelist.json file).

​
Technical Considerations

Modern Minecraft versions identify players via their Universally Unique Identifier (UUID) rather than just their username. This ensures that if an authorized community member changes their name through the official launcher, they will retain their whitelist status smoothly without administrative intervention.
If your server has online-mode=false active, the engine cannot verify UUIDs through official Mojang servers. In this scenario, we highly recommend using a secondary authentication plugin (e.g., AuthMeReloaded) in conjunction with the whitelist to prevent impersonation attacks.

​
Administrative Access

Always ensure that you have added your own username to the whitelist before activating the whitelist on command. If you enable the whitelist while you are not on the list, you will be unable to join your own server via the game client.

​
Need Extra Help?

If you encounter any issues, our support team is ready to assist:

​
Save on Your Hosting

Ready to get a new server? Use code KB20 at checkout for 20% off your first month!
Last Updated: January 2026 | Minecraft: Access controlled.