lights

Blue Lights (blauw)

Blue lights are the primary emergency lighting on your vehicle. They are toggled with NUMPAD 7 by default.

How It Works

The blauw property in your vehicle config contains an array of extra IDs that should activate when blue lights are turned on. When you toggle blue lights:

1. All extras listed in blauw are toggled on/off simultaneously.

2. The state is synchronized to all nearby players.

3. The native GTA siren effect (SetVehicleSiren) is activated to trigger any built-in lighting.

Blue Lights as Master Switch

Blue lights act as a master switch for sound features:

• Turning off blue lights will automatically:

  • Stop the active siren

  • Stop the dual siren

• Starting a siren will automatically:

  • Turn on blue lights if they aren't already on

This prevents scenarios where a siren is playing without any visible lights.

Empty Blue Lights Config

If you set blauw = {} (an empty array), the control panel will still track the blue lights state internally. This is useful for vehicles that only use GTA's native siren lighting (the SetVehicleSiren native) without custom extras.

---

Steady Blue / Cruise Lights (steadyBlue)

Cruise lights are a low-profile lighting mode — typically used when driving to a call without full emergency response. Toggled with NUMPAD 9.

These are independent from blue lights and can be on simultaneously or separately.

steadyBlue = {10, 11},  -- Extras 10 and 11 activate for cruise mode

---

Steady White / Work Lights (steadyWhite)

Work lights (also called scene lights) illuminate the area around the vehicle. Toggled with NUMPAD 2.

steadyWhite = {12},  -- Extra 12 activates work lighting

Separate Left & Right Work Lights

New in V3 — You can now configure left and right work lights independently.

In addition to the combined steadyWhite, you can add:

steadyWhiteLeft = {13},   -- Extra 13 for left-side work light only
steadyWhiteRight = {14},  -- Extra 14 for right-side work light only

These appear as separate buttons in the UI and can be toggled independently. This is useful for vehicles where you want directional scene lighting (e.g., illuminating the road shoulder on one side).

Config Key	Default Key	Description
steadyWhite	NUMPAD 2	Combined work lights
steadyWhiteLeft	NUMPAD 1	Left-side work light
steadyWhiteRight	NUMPAD 3	Right-side work light

---

Exclude Siren Effect

Some light types should not trigger the native GTA siren effect (which adds a rotating light glow). Use the excludeSiren array in your config to prevent this:

excludeSiren = {'pitje', 'steadyBlue', 'steadyWhite'},

Any light type listed here will toggle its extras without activating the native siren state. Additionally there is a global exclude list that applies to all vehicles.

---