# SirenManager

A RagePluginHook plugin for GTA V that automatically switches ELS siren tones based on your vehicle speed and provides a hotkey to evacuate nearby ELS vehicles.

## Features

- Automatically switches between ELS siren tones based on vehicle speed
  - Above 55 mph: Tone 1 (wail)
  - Below 35 mph: Tone 2 (yelp)
  - Below 5 mph: Tone 3 (hi-lo / intersection clearing)
- Tone 4 is manual-only and will not be auto-switched away from
- Auto-switches while a siren tone is active — stops when the siren is turned off or you exit the vehicle
- Press H (keyboard) or Left Thumb (controller) to toggle auto-switching on/off for manual siren control
- 1.5-second cooldown between tone changes to prevent rapid switching
- LShift+G despawns all occupied ELS vehicles within 1000m — useful for silencing sirens from glitched vehicles that won't stop on their own

## Requirements

- Grand Theft Auto V
- RagePluginHook (RPH)
- Emergency Lighting System (ELS)

## Configuration

Edit `SirenManager.ini` in your `plugins` folder:

[Keys]
ToggleKey=H
DespawnKey=G
DespawnModifier=LShiftKey

[Buttons]
ToggleButton=LeftThumb

## Installation

1. Copy `SirenManager.dll` and `SirenManager.ini` into your GTA V `plugins` folder (e.g. `Grand Theft Auto V\plugins\`).
2. Launch GTA V through RagePluginHook.

## Usage

Activate your siren with any tone key (1-4) while in an ELS vehicle. The plugin will automatically switch tones as your speed changes. Press **J** to turn off the siren and disable auto-switching. Press **LShift+G** to despawn all nearby occupied ELS vehicles.

## Author

Gamecock Tomahawk
