Usage

What a driver does with a vehicle somebody has already configured. To change what the keys do, see the Editor.

Commands

Diagnostics

ACE-restricted (command.<name>), printing to console rather than chat.

tels_calibnow is an internal LED-colour calibration tool. It needs screencapture and is not for a live server.

Keybinds

Rebind any of these in Keybinds → FiveM.

Lights

Stage cycling runs Off → 1 → … → Max → Off. Max is the highest of stage_1 / stage_2 / stage_3 the vehicle's triggers use.

Siren

R:

Keys 1–8:

Tones flagged triggerOnly are skipped by both, but trigger actions can still start them.

Modes

Arges spotlight

Other

Vehicle radio

Q cycles stages, so GTA's radio wheel — also Q — is suppressed. These replace it, work from any seat, and are unbound until you assign them. The Quick tab of /tels needs no key.

Vehicles set to No User Controls keep GTA's own radio wheel, horn and cinematic camera.

Client settings (/tels)

Most changes apply live. Four tabs — Quick, Display, Appearance, Sounds — plus Vehicle when you own a tELS vehicle or are an admin sitting in one. A server default applies only where you have never chosen.

Quick

Display

Render quality

These are the two settings that decide what tELS costs you, and both ship on Smart.

Environmental Lighting — the expensive one, and the first to reach for.

High applies to one vehicle only — the one you are in, or own. Every other vehicle is capped at Medium within 60 m and Low beyond, whatever you set. Medium's grouping tests exact colour equality, so a bar running one red groups into very few lights while a bar alternating red and blue cannot group those at all.

Lighting Quality — how many flat layers make up one lit LED.

The cheapest and most expensive LED differ by a factor of two, so Environmental Lighting buys more.

Clawing back frame rate

In the order worth trying. Smart on both suits most players.

Nothing limits tELS to the closest few vehicles: twenty lit tELS vehicles in range and on screen are twenty vehicles drawn. A configured vehicle sitting dark costs nothing, nothing is drawn past 500 m, and ambient AI traffic is never tracked at all.

Appearance

Day/Night Mode sits at the top.

• Combined uses one set of slider values
• Day & Night splits each into a ☀ Day and a ☾ Night value, blended across dawn and dusk — except Bloom Skew Angle, which has one angle for both

The sliders follow in three sections — Flare, LED core, Light cast on the world — all stepping in 5s.

The two Env sliders scale what Environmental Lighting produces without changing how many lights it casts. At Env Brightness 0 the lights are still drawn and contribute nothing; a lower Env Range covers fewer pixels and so costs less at the same tier.

Under Reset and calibration: Reset to Defaults, which touches your sliders only, and Auto Calibrate when screencapture is started. Admins also get server-wide Enable/Disable Auto-Calibration, likewise gated on screencapture.

Sounds

Server-sided Sirens uses server-bundled audio when a tone has a serverSound. Off forces vanilla GTA siren audio.

Admins also get Server-wide mappings, assigning an installed file to each HUD event — Lights On, Lights Off, Tone Change, Airhorn, Chirp.

• Only an installed file can be newly assigned. Install sounds from the editor's Marketplace
• A mapping to a missing file stays visible, marked (unavailable)
• These save immediately, for everyone

Vehicle

A vehicle is claimed by its driver, or by a front passenger when the driver seat is empty. The tab appears only to whoever holds the vehicle; the LED Editor is a sidebar entry and needs no ownership, only tlib.admin and a vehicle.

LED Editor, in the sidebar rather than on this tab, needs admin and a vehicle and launches /telsedit. Feedback, last in the sidebar, sends one message to TIMMYG Studios rather than to this server's staff.

Repositioning the HUD

Reposition HUD opens tLib's shared editor with the lightbar selected; /tlibhud opens it directly. Preview applies live, Save persists, Cancel restores.

The HUD must have been on screen once, so get in an emergency vehicle first. A widget cannot be dragged off screen.

Stages

Stages come entirely from triggers. No stage_1 / stage_2 / stage_3 condition anywhere means Q is a plain on/off toggle.

Activating lights suspends cruise, restoring it on deactivate, and suspends takedown and the traffic advisor while lightsSuspendTakedown / lightsSuspendTA are on.

Modes

Blackout

Blackout hides every emergency light — the LEDs, the scene lighting they cast, and the high beams and emergency-lights flag tELS drives — without switching any of it off.

• Stage, pattern, pattern position, cruise, takedown and the traffic advisor keep running behind it, so toggling back returns the vehicle mid-sequence
• It replicates: a vehicle running dark is dark for everyone

Bind it under ELS: Toggle Blackout in Keybinds → FiveM, or tick Blackout on the Quick tab. A blackout condition lets rules react to it.

Horn gestures

E emits three conditions. With hornProgrammable on, the default airhorn and horn sounds are suppressed and your triggers drive the audio alone.

Chirp

A chirp is a 75–125 ms siren burst that repeats every 4–6 seconds for as long as chirp is held on. It is usually wired to park_kill, so it starts when the driver exits with sirens running.

• Chirp is a latch, not a one-shot: park_chirp turns it on and leaves it on
• It stops when a rule turns it off, a chirp_overlay rule releases it, or a script calls SetChirp(vehicle, false)
• On the Sirens tab, Chirp Tone picks the slot, and Play Full Siren (chirpByCode) holds the tone for the whole chirp

PA mic

Hold the PA key to broadcast through the vehicle's public address system, via a bandpass filter. Needs pma-voice, the driver seat, a vehicle you own, and no active call.

The PA ships unbound — assign it in Settings → Key Bindings → FiveM, under "tELS: PA Mic (hold)". It had B until tELS 2026-10-17, and B is tRadio's push-to-talk default, so a player running both transmitted on the radio and the PA at once.

Siren behaviour

Elgato Stream Deck

Physical keys for the lightbar:

• Stages, patterns, main and aux sirens, tones, horn, traffic advisor, cruise, takedown, blackout, rumbler, chirp and PA, plus a Status key
• Three Stream Deck+ dial actions — Stage, Tone and Spotlight. The Stage dial can be set to walk the pattern list instead, so a Deck+ can carry four dials off three actions
• Every key shows live state
• Entirely local. Your server is never involved

Setup

Resting states

The Status key is the exception: it keeps showing the lightbar in read only. The four states look like this on it, in the order of the table above:

If a key says "Port in use"

The plugin listens on port 21400. Close whatever else has that port and restart the Stream Deck app.

What a deck key may do

Every key sends the same request your keybind does, through the same checks.

• The front passenger seat works, exactly as the keyboard does there
• A key is refused from a rear seat, on a vehicle you are not sitting in, and while the LED editor is open

Turning it off

Close or uninstall the plugin. There is no in-game setting: the plugin's presence is what turns the link on, so with nothing listening on the port tELS does nothing.