sirens

Siren System

Each vehicle is assigned a siren preset through its config file. A preset defines a set of tones (typically 2–3) that the player can cycle through.

Starting & Stopping

Action	Default Key	Description
Toggle siren	NUMPAD 8	Start or stop the siren
Cycle tone up	NUMPAD +	Switch to the next tone
Cycle tone down	NUMPAD -	Switch to the previous tone

When the siren starts:

1. Blue lights turn on automatically if they aren't already active.

2. The sound plays from the vehicle entity, so it's positional — other players hear it from the correct direction and distance.

3. The siren state, tone type, and tone number are synced via StateBags to all nearby players.

When the siren stops:

• The dual siren also stops (if active).

• Sirene flashers deactivate (if configured).

• The UI updates for all occupants.

Siren Preset

The sirene property in your vehicle config determines which sound set is used:

sirene = 'hoog',        -- Police high-low siren with 3 tones
sirene = 'ambulance',   -- Ambulance siren with 3 tones
sirene = 'bw',          -- Fire department siren with 2 tones
sirene = 'geen',        -- No siren (disables the siren button)

See Siren Presets for the full list of 41+ available presets.

---

Horn

The horn is activated by holding the default GTA horn key (E by default, control ID 86). The script replaces the default emergency vehicle horn with custom audio from the HornHandler configuration.

Horn Behavior

The horn system has two main modes depending on the switchWithHornKey setting:

With switchWithHornKey = true (default)

This mode allows the horn key to double as a siren tone switch:

• Quick tap (< 100ms): Cycles the siren tone up (only when a siren is active)

• Long press (> 100ms): Plays the horn sound

This does not apply to fire department (bw*) siren types — for those, the horn key always plays the horn regardless of press duration. Use NUMPAD + / NUMPAD - for tone switching on fire vehicles.

With switchWithHornKey = false

The horn key always plays the horn. Tone switching is exclusively done with NUMPAD + / NUMPAD -.

Ambulance / MUG Exception

When switchAmbulanceWithoutHorn = true (default), ambulance, MUG, ASIMEX, and motorcycle siren types behave differently:

• The horn key always plays the horn (no quick-tap tone switching).

• A short delay (100ms) ensures the horn doesn't accidentally trigger when the intention was a quick tap.

This prevents the common issue of accidentally switching the ambulance siren when you just wanted to honk.

---

Mute Siren During Horn

New in V3 — Per-vehicle option to mute the siren while the horn is playing.

Some real-world emergency vehicles mute their main siren while the horn/air horn is sounding. You can enable this per vehicle:

muteSirenDuringHorn = 'true',

When enabled:

• Pressing the horn temporarily stops the siren sound

• Releasing the horn automatically restarts the siren at the same tone it was on

• The siren state remains "active" internally — it's just the audio that's muted

This creates a realistic effect where the horn cuts through clearly without competing with the siren.

---

Horn Animation

When the driver sounds the horn, a hand animation plays by default — the ped reaches toward the steering wheel horn area. This animation does not play for boats or helicopters (vehicle types 3 and 11).

---

Disabled Default Horn

The script disables the default GTA emergency vehicle horn sound (DisableControlAction for control 86) for all supported vehicles. Only the custom horn audio from the HornHandler is used.

---