Overview#
tELS identifies individual LEDs by internal UUID, but each LED can carry a name field that groups it semantically. These names drive HUD display, trigger conditions, and pattern targeting by name.
This page defines the naming standard all vehicle configs should follow.
[ZONE][FACE?][SIDE?][NUM]
| Part | Description |
|---|
ZONE | 2–4 letter zone code (see tables below) |
FACE | Optional face direction: F (forward) or R (rear) — only when the zone has multiple faces |
SIDE | Optional side: L (left) or R (right) — only for physically separate side-facing units |
NUM | Sequential number starting at 1 |
Rules#
- All uppercase, no spaces, no special characters.
- Forward/rearward-facing lights — use sequential numbers only. No L/R suffix. (
RD1, RD2, LBF1, LBF2)
- Side-facing lights — use an L/R suffix because they are physically separate units on opposite sides. Add a number after if there are multiple per side. (
MRL, MRR, SRL1, SRL2) Omit NUM when there is only one unit per side — LBAL not LBAL1, PIL not PIL1.
- Names describe physical location only. Functions like takedowns, traffic advisor, and alley lights are pattern behaviors, not LED names. The same physical LED can act as a takedown in one pattern and a standard flasher in another.
- Numbers count left to right from the perspective of an observer standing outside the vehicle, looking directly at that face. Numbering typically starts at
1, but starting at 0 is permitted — and encouraged — when a vehicle has more LEDs than the standard cross-vehicle range. For example, a rear lightbar with 8 LEDs should use LBR0–LBR7: the LBR1–LBR6 core remains the cross-vehicle compatible zone (what patterns and the HUD reliably target), while LBR0 and LBR7 are vehicle-specific extensions. Patterns written for the full range silently skip any names that don't exist on a given vehicle, so a pattern targeting LBR0–LBR7 degrades gracefully on a vehicle that only defines LBR2–LBR5. This means:
- Front-facing lights (
LBF#, FG#, FB#, DS#, FV#, etc.) — #1 is on the vehicle's right, because the observer facing the front sees the vehicle's right on their left.
- Rear-facing lights (
LBR#, RD#, RV#, etc.) — #1 is on the vehicle's left, because the observer facing the rear sees the vehicle's left on their left.
- Right-side lights (
SRR#, DOR#, etc.) — #1 is toward the vehicle's rear, because the observer facing the right side sees the rear on their left.
- Left-side lights (
SRL#, DOL#, etc.) — #1 is toward the vehicle's front, because the observer facing the left side sees the front on their left.
Zone Reference#
Roof#
| Code | Description | Example |
|---|
LBF# | Lightbar — front face | LBF1, LBF2, LBF3 |
LBR# | Lightbar — rear face | LBR1, LBR2, LBR3 |
LBAL | Lightbar — alley left (side-facing) | LBAL |
LBAR | Lightbar — alley right (side-facing) | LBAR |
MBF# | Mini bar — front face | MBF1, MBF2 |
MBR# | Mini bar — rear face | MBR1, MBR2 |
MBAL | Mini bar — alley left | MBAL |
MBAR | Mini bar — alley right | MBAR |
BK# | Beacon / rotator | BK1 |
Alley lights: LBAL / LBAR are the physically side-facing LED units built into the ends of the lightbar. Whether they illuminate as alley lights, scene lights, or anything else is determined by the pattern — not the name.
Front Exterior#
| Code | Description | Example |
|---|
FG# | Front grille | FG1, FG2 |
FB# | Front bumper / push bar (forward-facing) | FB1, FB2 |
FBL / FBR | Front bumper side end caps (side-facing) | FBL, FBR |
HD# | Hood lights | HD1, HD2 |
Front Interior (projects forward through windshield)#
| Code | Description | Example |
|---|
DS# | Dash lights (low mount) | DS1, DS2 |
FV# | Front visor lights (high mount) | FV1, FV2 |
Side#
| Code | Description | Example |
|---|
MRL / MRR | Mirror lights | MRL, MRR |
SRL# / SRR# | Side runner lights | SRL1, SRL2, SRR1 |
DOL# / DOR# | Door lights | DOL1, DOR1 |
PIL / PIR | Pillar light sticks (B/C-pillar directional sticks) | PIL, PIR |
Rear Interior (projects rearward through rear glass)#
| Code | Description | Example |
|---|
RD# | Rear deck — low mount | RD1, RD2, RD3 |
RV# | Rear visor — high mount | RV1, RV2 |
Rear Exterior#
| Code | Description | Example |
|---|
RB# | Rear bumper face (exterior, bumper-mounted) | RB1, RB2 |
RR# | Rear runner (body/rocker perimeter) | RR1, RR2 |
RSP# | Rear step pad lights | RSP1, RSP2 |
LPL / LPR | License plate lights | LPL, LPR |
Specialty#
| Code | Description | Example |
|---|
SPL / SPR | Spotlight (A-pillar or roof edge) | SPL, SPR |
SC# | Scene / work lights | SC1, SC2 |
CAB# | Cabin / interior dome lights | CAB1 |
HUD Default LEDs#
The tELS HUD displays a row of colored LED indicators. When no layout specifies which LED names to show, tELS automatically resolves the best available set from the vehicle config using this fallback chain:
| Priority | Names checked | Typical source |
|---|
| 1st | RD1 – RD6 | Rear deck lights |
| 2nd | RV1 – RV6 | Rear visor lights |
| 3rd | LBR1 – LBR6 | Lightbar rear face |
tELS uses whichever group has at least one matching LED on the vehicle. Only the LEDs that actually exist in the config are shown — if a vehicle only has RD1, RD2, and RD3, the HUD shows three indicators, not six.
If none of the above names exist on the vehicle, the HUD falls back to showing all LEDs.
Custom HUD layouts can override this entirely by declaring their own data-hud-led bindings.
Out of Scope#
Factory light circuits (headlight flashers, tail light flashers) are not part of this convention. These are native vehicle lights driven by the game engine, not placed LEDs in the tELS config. If tELS ever gains addressable control over factory circuits, they will be assigned their own convention at that time. Do not invent names like HLF or TLF — there is no placed LED to attach them to.
