> For the complete documentation index, see [llms.txt](https://docs.imperialcad.app/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.imperialcad.app/api-and-integrations/fivem-installation/offered-plugins/ers-integration.md).

# ERS Integration

Emergency Response Simulator (ERS) is a paid, third-party script for FiveM developed by Nights Software. We provide our own integration directly tied into ERS within our ImperialCAD resource.

***

{% 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.

***

####  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.