There are upcoming maintenance events which may impact our services. Learn more

How To Set Up A Whitelist / Make Your Server Private Print

  • 1

A white list is your primary means of preventing unauthorized entry into your server. Any official Minecraft user names that you put in this list will be allowed to enter your server, while anyone not on it will be denied access.

In order to activate/deactivate the white list, you must first login to your AleForge game panel. Once in, click on "Files", then navigate through "Config" to "Server Settings".  In there, you can enable or disable the whitelist. Make sure to restart your server after saving the settings on that page.
Alternatively, with some versions of Minecraft, you can also run these commands from the console to control white listing:
whitelist on
whitelist off

ADDING USERS TO THE WHITE LIST (File: whitelist.json)
You can edit the white list file (white-list.txt or whitelist.json) by either editing it in the File Manager or editing through FTP. Each username must be on a new line. You will have to restart the server for changes to take effect using this method. Note: As of Minecraft 1.7.9, this step is no longer relevant. You must use the console commands as below to add/remove users from the list or have knowledge of the proper formatting (shown below) to edit the .json file.

IMPORTANT: Before you can add a user to the whitelist, make sure to first allow that user to join your server with the whitelist off so that the server "knows" their UUID/username. Once that is done, you will then be able to re-enable whitelisting and add them as described below.

You can also add a user via console or in the game itself. To edit via console, you will need to click on "console" in the game panel under the navigation menu. You can add users to the white list by typing into the console the following: whitelist add username
To add the user in-game, you would follow the same format: /whitelist add username
This method does not require a restart.


    "uuid": "uuid-goes-here",
    "name": "notch"
    "uuid": "uuid-goes-here",
    "name": "user1"
  },  {
    "uuid": "uuid-goes-here",
    "name": "player1"

* UUIDs can be found by using various websites that allow you to search for them via player name.

Was this answer helpful?

« Back
Login Sign Up