> ## Documentation Index
> Fetch the complete documentation index at: https://help.freakhosting.com/llms.txt
> Use this file to discover all available pages before exploring further.

# How to Set Up a Minecraft Server Whitelist

> Secure your Minecraft community from unauthorized access. Learn how to enable and manage an exclusive player whitelist using console commands.

## 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.

<CardGroup cols={2}>
  <Card title="Difficulty" icon="gauge-low">
    Beginner
  </Card>

  <Card title="Time" icon="clock">
    4 Minutes
  </Card>
</CardGroup>

***

## Technical Activation Workflow

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

<Steps>
  <Step title="Access the Console">
    Log in to the [Game Panel](https://games.freakhosting.com) and navigate to the **Console** tab.
  </Step>

  <Step title="Initialize Enforcement">
    Execute the following command to activate the security logic:

    ```bash theme={null}
    whitelist on
    ```
  </Step>

  <Step title="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.
  </Step>
</Steps>

***

## Managing the Authorized Registry

You can manipulate your access list in real-time without requiring a server restart.

| Administrative Action    | Command Syntax                                                          |
| :----------------------- | :---------------------------------------------------------------------- |
| **Authorize Player**     | `whitelist add <PlayerName>`                                            |
| **Revoke Authorization** | `whitelist remove <PlayerName>`                                         |
| **Audit Registry**       | `whitelist list`                                                        |
| **Synchronize Files**    | `whitelist reload` (use if manually editing the `whitelist.json` file). |

***

## Technical Considerations

<AccordionGroup>
  <Accordion title="UUID Persistence & Name Changes">
    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.
  </Accordion>

  <Accordion title="Handling Offline Mode (Cracked) Servers">
    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.
  </Accordion>
</AccordionGroup>

<Warning>
  ### 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.
</Warning>

***

<Note>
  ### Need Extra Help?

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

  * **Live Chat:** Quick assistance via our website.
  * **Support Ticket:** [Open a Ticket](https://freakhosting.com/clientarea/submitticket.php)
  * **Discord:** [Join our Community](https://discord.gg/freakhosting)
  * **Email:** [support@freakhosting.com](mailto:support@freakhosting.com)
</Note>

<Tip>
  ### Save on Your Hosting

  Ready to get a new server? Use code **KB20** at checkout for **20% off** your first month!
</Tip>

***

<div align="center">
  **Last Updated:** January 2026 | **Minecraft:** Access controlled.
</div>