Integrations

How to configure tELS vehicles to work with third-party scripts.

Third-Party

ERS (night_ers)

night_ers gates pullover detection on GTA's native emergency-lights flag. Because tELS uses its own rendering pipeline, turning on a tELS stage does not automatically set that flag — you need to tell tELS to blip it via the ers_pullover trigger action.

How it works

The ers_pullover action fires on the rising edge of whichever conditions you attach it to. On that edge it briefly activates GTA's native emergency-lights flag — visually silent (audio muted by tELS) — for long enough that night_ers detects it and allows a pullover. The flag clears itself automatically after the blip window.

No night_ers dependency is created anywhere in tELS. The action works the same whether night_ers is installed or not — it just flips a GTA native flag.

Setup

Open the Triggers tab for your vehicle

Run /telsedit while seated in the vehicle, then navigate to Triggers.

Add a trigger

Click Add Trigger. Set the condition(s) that should allow a pullover — typically stage_2, siren, or a combination of both.

Add the ers_pullover action

With the trigger selected, click Add Action and choose ers_pullover.

Save

Press Enter (or the Save button) to write the config.

The most common setup is to fire on stage_2 — the stage players typically activate when approaching a traffic stop:

data.json (triggers entry for your vehicle)
{
  "id": "a1b2c3d4e5f6a7b8",
  "conditions": ["stage_2"],
  "negated": [false],
  "operator": "and",
  "enabled": true,
  "actions": [
    { "type": "ers_pullover" }
  ]
}

You can attach it to any condition or combination — siren, stage_3, main_siren_on, or a compound rule. Whatever reflects "I intend to stop this vehicle" on your server.

Blip duration

The blip window defaults to 300 ms and that is the recommended value — it reliably covers one full enforcement tick (which runs every 200 ms) and is confirmed to work with night_ers. You do not need to change it.

If you want to override it anyway:

{ "type": "ers_pullover", "durationMs": 500 }

Do not set durationMs below 300 ms. The enforcement loop that applies the GTA flag runs every 200 ms, so a shorter window may expire before the loop fires and night_ers will miss the detection.

Using a cross-vehicle reference

If you have multiple police vehicles that all need ERS support, configure the trigger once on your primary model (e.g., police4) and reference it from the others:

police5, police6 triggers[]
{ "$ref": "police4", "triggerId": "a1b2c3d4e5f6a7b8" }

See Configuration → Cross-vehicle references for details.

On this page

Need help?

Ask on Discord