<h1 align="center">EXILED - EXtended In-runtime Library for External Development</h1> <div align="center">

<img src="https://img.shields.io/github/actions/workflow/status/Exiled-Team/EXILED/main.yml?style=for-the-badge&logo=githubactions&label=build" alt="CI"/> <a href="https://github.com/Exiled-Team/EXILED/releases"><img src="https://img.shields.io/github/v/release/Exiled-Team/EXILED?display_name=tag&style=for-the-badge&logo=gitbook&label=Release" href="https://github.com/Exiled-Team/EXILED/releases" alt="GitHub Releases"></a> <img src="https://img.shields.io/github/downloads/Exiled-Team/EXILED/total?style=for-the-badge&logo=github" alt="Downloads"> <a href="[https://discord.gg/835XQcCCVv](https://discord.gg/PyUkWTg)"> <img src="https://img.shields.io/discord/1261714360854646905?style=for-the-badge&logo=discord" alt="Chat on Discord"> </a>

</div>

EXILED is a high-level plugin framework for SCP: Secret Laboratory servers. It offers an event system for developers to hook into in order to manipulate or change game code or implement their own functions. All EXILED events are coded with Harmony, meaning they require no direct editing of server assemblies to function, which allows for two unique benefits.

• Firstly, the entirety of the framework’s code can be freely published and shared, allowing developers to better understand how it works and offer suggestions for adding to or changing its features.
• Secondly, since all the code related to the framework is done outside of the server assembly, things like small game updates will have little, if any, effect on the framework. Making it most likely to be compatible with future game updates, as well as making it easier to update when it is necessary to do so.

Localized READMEs

• Русский
• 中文
• Español
• Polski
• Português-BR
• Italiano
• Čeština
• Dansk
• Türkçe
• German
• Français
• 한국어
• ไทย

Installation

Installation of EXILED is quite simple. It loads itself through Northwood’s Plugin API. That's why there are two folders inside the Exiled.tar.gz in release files. SCP Secret Laboratory contains the necessary files to load EXILED features in EXILED folder. All you need to do is move these two folders into the appropriate path, which are explained below, and you are done!

If you choose to use the installer it will, if run correctly, take care of installing all EXILED features.

Windows

Automatic installation (more information)

Note: Make sure you're on the user that runs the server, or you have Admin privileges before running the Installer.

• Download the Exiled.Installer-Win.exe from here (click on Assets -> click the Installer)
• Place it on your server folder (download the dedicated server if you haven't)
• Double click the Exiled.Installer.exe or download this .bat and place it in the server folder to install the latest pre-release
• To get and install plugins, check the Installing plugins section down below. Note: If you are installing EXILED on a remote server, make sure you run the .exe as the same user that runs your SCP:SL servers (or one with Admin privileges)

Manual installation

• Download the Exiled.tar.gz from here
• Extract its contents with 7Zip or WinRar
• Move the EXILED folder to %appdata% Note: This folder needs to go in C:\Users\%UserName%\AppData\Roaming, and NOT C:\Users\%UserName%\AppData\Roaming\SCP Secret Laboratory, and IT MUST be in (...)\AppData\Roaming, not (...)\AppData!
• Move SCP Secret Laboratory to %appdata%.
  • Windows 10 & 11: Write %appdata% in Cortana / the search icon, or the Windows Explorer bar.
  • Any other Windows version: Press Win + R and type %appdata%

Installing plugins

That's it, EXILED should now be installed and active the next time you boot up your server. Note that EXILED by themselves will do almost nothing, so make sure to get new plugins from our Discord server

• To install a plugin, simply:
  • Download a plugin from their releases page (it MUST be a .dll!)
  • Move it to: C:\Users\%UserName%\AppData\Roaming\EXILED\Plugins (move here by pressing Win + R, then writing %appdata%)

Linux

Automatic installation (more information)

Note: If you are installing EXILED on a remote server, make sure you run the Installer as the same user that runs your SCP:SL servers (or root)

• Download the Exiled.Installer-Linux from here (click on Assets -> download the Installer)
• Install it by either typing ./Exiled.Installer-Linux --path /path/to/server or move it inside the server folder directly, move to it with the terminal (cd) and type: ./Exiled.Installer-Linux.
• If you want the latest pre-release, simply add --pre-releases. Example: ./Exiled.Installer-Linux /home/scp/server --pre-releases
• Another example, if you placed Exiled.Installer-Linux in your server folder: /home/scp/server/Exiled.Installer-Linux --pre-releases
• To get and install plugins, check the Installing plugins section down below.

Manual installation

• Ensure you are logged in on the user that runs the SCP servers.
• Download the Exiled.tar.gz from here (SSH: right click and to get the Exiled.tar.gz link, then type: wget (link_to_download))
• To extract it to your current folder, type tar -xzvf EXILED.tar.gz
• Move the EXILED folder to ~/.config. Note: This folder needs to go in ~/.config, and NOT ~/.config/SCP Secret Laboratory (SSH: mv EXILED ~/.config/)
• Move the SCP Secret Laboratory folder to ~/.config. Note: This folder needs to go in ~/.config, and NOT ~/.config/SCP Secret Laboratory (SSH: mv SCP Secret Laboratory ~/.config/)

Installing plugins

That's it, EXILED should now be installed and active the next time you boot up your server. Note that EXILED by themselves will do almost nothing, so make sure to get plugins from our Discord server

• To install a plugin, simply:
  • Download a plugin from their releases page (it MUST be a .dll!)
  • Move it to: ~/.config/EXILED/Plugins (if you use your SSH as root, then search for the correct .config which will be inside /home/(SCP Server User))

Config

EXILED by itself offers some config options. All of them are auto-generated at the server startup, they are located at ~/.config/EXILED/Configs/(ServerPortHere)-config.yml file (%AppData%\EXILED\Configs\(ServerPortHere)-config.yml on Windows).

Plugin configs will NOT be in the aforementioned config_gameplay.txt file, instead, plugin configs are set in the ~/.config/EXILED/Configs/(ServerPortHere)-config.yml file (%AppData%\EXILED\(ServerPortHere)-config.yml on Windows). However, some plugins might get their config settings from other locations on their own, this is simply the default EXILED location for them, so refer to the individual plugin if there are issues.

For Developers

If you wish to make a plugin for EXILED, it's quite simple to do so. If you would like more of a tutorial please visit our Getting Started Page..

For more comprehensive and actively updated tutorials, see the EXILED website.

But make sure to follow these rules when publishing your plugins:

• Your plugin must contain a class that inherits from Exiled.API.Features.Plugin<>, if it does not, EXILED will not load your plugin when the server starts.
• When a plugin is loaded, the code within the aforementioned class' OnEnabled() method is executed immediately, it does not wait for other plugins to be loaded. It does not wait for the server startup process to finish. It does not wait for anything. When setting up your OnEnabled() method, be sure you are not accessing things which may not be initialized by the server yet, such as ServerConsole.Port, or ``PlayerManager.loca