# ERS Integration

***

{% hint style="warning" %}
This plugin requires an **Advanced ImperialCAD subscription or higher**.

View our [pricing](https://imperialcad.app/pricing) for more information.
{% endhint %}

> The script can be purchased from [**Nights Software**](https://store.nights-software.com/category/ers).

***

#### ⚙️ Installation & Setup Guide

**Step 1: Install the ImperialCAD Resource**

Download and install the [ImperialCAD FiveM Resource](https://github.com/Zippy01/ImperialCAD). Follow the included instructions to configure your server and connect it to your CAD account.

***

**Step 2: Enable ERS Support in the Config**

In your server’s `config.lua` file, set:

```lua
ERSsupport = true
```

***

**Step 3: Enable Advanced API Usage in the CAD**

1. Log into your CAD as an admin.
2. Navigate to **Admin Panel > Settings > Plugins**.
3. Enable the toggle labeled **Advanced API Usage**.

This step is required for ERS to push callouts and create CAD records.

***

**Step 4: Verify Your Account**

Your CAD account and all your users must be Discord-verified to use API features. Follow this guide:\
👉 [Verify Your Account](https://docs.imperialcad.app/getting-started/creating-your-imperialcad-account#step-3-optional-verify-your-discord)

***

#### Features of the Integration

* **Automatic Advanced Call Generation:** When an ERS callout starts in-game, a corresponding new CAD call appears in ImperialCAD while trying to auto assign the primary unit and attaching the information available from ERS.
* **Civilian and Vehicle Auto-Registration:** Interacting with an AI character or vehicle during a callout will automatically create a civilian or vehicle record in the CAD using events.
* **Unit Auto-Attach:** When a unit accepts an ERS callout, they are automatically attached to the dispatch call in CAD.

***

#### &#x20;Known Limitations

* **Custom ERS Versions:** This integration is designed for the default ERS package. If you use a custom or modified version, further manual integration may be required.

***

#### 🧪 Testing the Integration

To test your setup:

1. Launch an ERS callout in-game.
2. Accept the callout in-game.
3. Interact with a pedestrian or vehicle.
4. Check the CAD for:
   * A new call under your community.
   * A new civilian or vehicle record.
5. Confirm your unit is automatically attached to the call in the CAD.

***

#### 🚘 Troubleshooting

If the integration doesn’t appear to work:

* Confirm `ERSsupport = true` is set in `config.lua`.
* Verify that **Advanced API Usage** is enabled in the Admin Panel.
* Make sure your CAD account is Discord-verified.

***

#### 💬 Support

We offer standard support for our ERS integration but if you require help with ERS itself, please contact **Nights Software**, the original developer.


---

# 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://docs.imperialcad.app/api-and-integrations/fivem-installation/offered-plugins/ers-integration.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.
