How to Set Up a Whitelist on Your SCP: Secret Laboratory Server

With a whitelist, only players you have explicitly listed can join – ideal for private community servers or events. The whitelist consists of two parts: the enable_whitelist option in the config_gameplay.txt file and the player list in the UserIDWhitelist.txt file. You can find the basics of editing the configuration files in the Edit configuration files guide.

Set up the whitelist

1. Find out the game port
   Open the dashboard of your server and note the game port shown under Overview.

2. Stop the server
   Stop your server via the dashboard.

3. Connect via SFTP
   Connect to your server via SFTP.

4. Enable the whitelist
   Open the following file – replace <Port> with your game port:

   /.config/SCP Secret Laboratory/config/<Port>/config_gameplay.txt
   

   Find the enable_whitelist entry and change its value from false (default) to true:

   enable_whitelist: true
   

5. Add players to the whitelist
   In the same port folder, open the UserIDWhitelist.txt file:

   /.config/SCP Secret Laboratory/config/<Port>/UserIDWhitelist.txt
   

   Add each allowed ID on its own line. Steam players are added in the format SteamID64@steam, Discord users in the format DiscordID@discord. Lines starting with # are comments – handy for noting the names that belong to the IDs:

   # Max
   76561198000000001@steam
   # Moritz
   123456789012345678@discord
   

   You can find your SteamID64 using the linked guide. It is the same ID format you also use when assigning ranks.

6. Start the server
   Save both files and start your server via the dashboard.