Train Horn for Any Vehicle  v1.0
A ScriptHookVDotNet v3 script for GTA V on PC.

What it does
------------
While you are in a vehicle, hold a configurable key (default: H) to play a
loud, looping, multi-chime train horn. Release the key, step out of the
vehicle, or open the pause menu to stop it. The ordinary vehicle horn on E
is left untouched.

Three royalty-free, fully synthesized horn variants are included (a deep
two-chime, a classic three-chime, and a five-chime K5LA-style chord). Pick
one in the ini file.

Requirements
------------
- Grand Theft Auto V for PC
- ScriptHookV (Alexander Blade)
- ScriptHookVDotNet v3 (the ScriptHookVDotNet.asi + ScriptHookVDotNet3.dll
  package). Nightly builds are fine as long as they include the v3 API.

This mod ships as a plain C# source file. SHVDN compiles it at runtime; you
do not need Visual Studio or a compiled .dll.

The script file is named TrainHornAnyVehicle.3.cs on purpose. ScriptHookVDotNet
runs unsuffixed .cs files against the older v2 API. The ".3" before the
extension selects the v3 API, which this script is written for.

Install
-------
1. Install ScriptHookV and ScriptHookVDotNet v3 if you have not already.
   Confirm that a "scripts" folder exists in your GTA V directory
   (the folder that contains GTA5.exe).
2. Copy the contents of this archive into that GTA V directory, so that:
     scripts/TrainHornAnyVehicle.3.cs
     scripts/TrainHornAnyVehicle.ini
     scripts/TrainHorn/TwoChime.wav
     scripts/TrainHorn/ThreeChime.wav
     scripts/TrainHorn/FiveChime.wav
   land in those exact paths. Merge folders if Windows asks; do not nest
   a second "scripts" folder inside "scripts".
3. Start the game. A short subtitle should read:
     Train Horn for Any Vehicle loaded  (key H, variant 2)
   If a WAV is missing, the subtitle will show the path it looked for.

Controls
--------
H            Hold, while in a vehicle, to blast the train horn (default).
E            Still the normal vehicle horn; this mod does not bind it.

Edit scripts/TrainHornAnyVehicle.ini to change the key or the horn:

  [Controls]
  HornKey=H          ; any System.Windows.Forms.Keys name (J, Y, NumPad0, ...)

  [Audio]
  HornVariant=2      ; 1 = TwoChime, 2 = ThreeChime, 3 = FiveChime

There is no in-script volume slider (SoundPlayer does not expose one).
The WAV files are already normalized. Use the Windows volume mixer if you
need the horn quieter or louder. The in-game SFX slider does not apply,
because the sound is played through the default Windows audio device.

The included horns
------------------
All three files are 44.1 kHz, 16-bit, mono, seamless 4-second loops,
synthesized by the author (no recorded samples, no third-party banks):

  1  TwoChime.wav     D3 + A3, a deep two-note blast
  2  ThreeChime.wav   D4, F#4, A4, a classic major-triad 3-chime
  3  FiveChime.wav    D#4, F#4, G#4, B4, D#5, a Nathan K5LA-like 5-chime

Changelog
---------
1.0  Initial release.
     - Hold-to-play train horn on any vehicle, default key H.
     - Three synthesized horn variants, selected in the ini.
     - Stops on key release, on leaving the vehicle, on pause, and on death.

Credits
-------
Script and horn samples by the author. Sounds are synthesized from scratch
and may be used with this mod.
