# Installation

## Installation

{% hint style="danger" %}
This guide is **NOT** about how to set up your SCP:SL server. This guide is for people who know how servers work and have worked with other plugins before.

Things that are not strictly about this plugin - like granting admin roles and setting up your server - are not covered here. The official SCP:SL discord server provides technical support for things like this.
{% endhint %}

### #1 - Install the `SER.dll` file

You can find the latest releases here:

> <https://github.com/ScriptedEvents/ScriptedEventsReloaded/releases>

### #2 - Move to the correct folder

You can select one of 2 versions of SER:

#### `SER.dll`

This is the default version and will work on every server. It should be moved to either one of these locations:

```
LabAPI -> plugins -> [PORT NUMBER] -> SER.dll
```

```
LabAPI -> plugins -> global -> SER.dll
```

{% hint style="info" %}
`[PORT NUMBER]` is a number like `7777`, which corresponds to a port of your server. It's recommended to put use the `global` directory if you're unsure.
{% endhint %}

#### `SER-Exiled.dll`

This is the EXILED version and will work only on a server using EXILED. It should be moved to:

```
EXILED -> Plugins -> SER-Exiled.dll
```

### #3 - Restart the server

When the server finishes loading, you should see a message like this:

```
Thank you for using ### Scripted Events Reloaded ### by Elektryk_Andrzej!
```

This means that SER has loaded successfully.

{% hint style="warning" %}
If you don't see this, check if an error hasn't been thrown. Issues like that are usually caused by improperly configured servers.
{% endhint %}

### #4 - Verify

After a successful installation, you should see a folder like this:

```
LabAPI -> configs -> Scripted Events Reloaded
```

Every script must live in this folder in order to be found by SER.

## Generate example scripts!

We highly recommend you to take a look at some example scripts that SER comes with!

To generate them, use `serexamples` command in the **server console** - this will create a folder:

```
LabAPI -> configs -> Scripted Events Reloaded -> Example Scripts
```

Inside, there will be plenty of scripts, ranging from simple utilities, to full systems like custom roles, chaos coin, custom events and much more!

If you don't want a given script to be active on your server, prefix its name with `#` (e.g. `#chaosCoin.ser`) or just remove it.

## Download the VS Code extension!

If you are planning on writing scripts on your PC, we highly recommend that you download the [`Scripted Events Reloaded` extension](https://marketplace.visualstudio.com/items?itemName=ElektrykAndrzej.ser) for Visual Studio Code!

This extension adds:

* Theme support for SER scripts
* Basic documentation on hovering
* Custom .ser file extension icon
* and more features coming in the future

## Are you a programmer?

If you understand basic concepts like variables, functions, loops, if statements etc., you can go straight here:

#### [SER Syntax Specification](https://github.com/ScriptedEvents/ScriptedEventsReloaded/blob/main/language_specification.md)

This one file covers most of the stuff you need to understand about SER syntax.


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://scriptedeventsreloaded.gitbook.io/docs/tutorial/installation.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.