How to Install EXILED Plugins on Your SCP: Secret Laboratory Server

EXILED is a plugin framework for SCP: Secret Laboratory. With EXILED plugins you can extend your server, for example with custom roles, items or admin features.

Prerequisite: EXILED

EXILED must be installed on your server before you can use EXILED plugins. To learn how to install it, see the guide Install EXILED.

Where are the EXILED folders?

Install a plugin

1. Download the plugin
   Download the .dll file of the plugin you want, usually from the plugin developer's GitHub releases page. Also download all dependencies the plugin requires according to its description.

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

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

4. Upload the plugin
   Upload the plugin's .dll file to the following directory:

   /.config/EXILED/Plugins/
   

5. Upload the dependencies
   If the plugin requires additional libraries, upload them to the following directory:

   /.config/EXILED/Plugins/dependencies/
   

6. Start the server
   Start your server via the dashboard.

7. Check that it loaded
   Open the console in the dashboard. For every plugin that loaded successfully, EXILED prints a line like this during startup:

   Loaded plugin ExamplePlugin@1.0.0
   

   If the plugin is missing or an error appears, the guide Plugins not loading will help you.

Configure a plugin

After the first successful load, EXILED automatically creates a configuration file for each plugin. By default, every plugin gets its own file. Replace <Port> with your server's game port, which you can find in the dashboard under Overview:

/.config/EXILED/Configs/Plugins/<Plugin-Name>/<Port>.yml

A plugin's texts and translations are stored separately under:

/.config/EXILED/Configs/Translations/<Plugin-Name>/<Port>.yml

1. Stop the server
   Stop your server via the dashboard.

2. Adjust the configuration
   Open your plugin's configuration file via SFTP and adjust the values. Use is_enabled to turn the plugin on (true) or off (false).

3. Start the server
   Save the file and start your server to apply the changes.

Remove a plugin

1. Stop the server
   Stop your server via the dashboard.

2. Delete the plugin
   Delete the plugin's .dll file from /.config/EXILED/Plugins/ via SFTP.

3. Start the server
   Start your server via the dashboard.