============================================================
 Vehicle Audio Changer  -  ScriptHookVDotNet 3 mod
============================================================

Change any vehicle's engine sound in-game, live, from a menu -
including standalone / addon engine-sound mods. You can also
SAVE a sound to a make/model so every car of that model uses
your chosen sound whenever you find one.


------------------------------------------------------------
 REQUIREMENTS
------------------------------------------------------------
 - Grand Theft Auto V
 - ScriptHookV
 - ScriptHookVDotNet 3   (v3.7.0 or newer)
 - LemonUI (SHVDN3)      LemonUI.SHVDN3.dll must be present in
                         your "scripts" folder.
                         https://www.gta5-mods.com/tools/lemonui


------------------------------------------------------------
 INSTALL
------------------------------------------------------------
 Copy these three files into your GTA V "scripts" folder:

     VehicleAudioChanger.dll
     VehicleAudioChanger.ini
     VehicleAudioSounds.ini

 (Ensure LemonUI.SHVDN3.dll is also in "scripts".)


------------------------------------------------------------
 USAGE
------------------------------------------------------------
 Get in a vehicle and press  7  to open the menu:

   Enter custom name...    type ANY audio name and apply it live
   Reset to default        restore this car's own engine sound
   Save sound to this model remember the current sound for every
                           car of this make/model
   Forget this model       remove that saved sound
   Apply saved to traffic  (checkbox) also give passing AI cars
                           of a saved model their saved sound
   Reload list             re-read VehicleAudioSounds.ini
   [Category] submenus     pick a sound to apply to your car

 Press  8  for a quick reset to the car's default engine sound.

 Picking a sound applies it instantly to the car you are in and
 keeps the menu open, so you can audition sounds back-to-back.

 Saved model->sound assignments are written to
     scripts\VehicleAudioSaved.ini   (created automatically).
 A background watcher re-applies them to matching cars you find.


------------------------------------------------------------
 ADDING YOUR OWN SOUNDS
------------------------------------------------------------
 Open VehicleAudioSounds.ini. Each line is one audio name (the
 game-object name a sound registers - usually the addon's name).
 Put addon sounds under [Addon], or create your own [Category]
 headers; each header becomes a submenu in-game.
 Then use "Reload list" in the menu - no restart needed.


------------------------------------------------------------
 CONFIG  (VehicleAudioChanger.ini)
------------------------------------------------------------
 [Keys]
 MenuKey  = 7      ; number-row digit, F-key, or key name
 ResetKey = 8


------------------------------------------------------------
 EXAMPLE INI
------------------------------------------------------------

[Addon]
; >>> Add your standalone / addon engine-sound names here (one per line) <<<
; The name is whatever game-object name the audio pack registers, e.g. brabus_v8

demonv8
dlc2015mustsound
ea825
ea888
ecoboostv6
f136
ferrarif140fe
fordvoodoo
ftypesound
gt3flat6
k20a
kc98gmls6
lambov10

; ============================ VANILLA ENGINE SOUNDS ==========================
[Super]
adder
zentorno
t20
osiris
tyrus
fmj
nero
italigtb
italigtb2
vagner
xa21
sc1
gp1
prototipo
reaper
penetrator
entityxf
cheetah
turismor
...
..
.

------------------------------------------------------------
 NOTES / CREDITS
------------------------------------------------------------
 - Works on the vehicle you are currently in. Manual picks
   always override the auto-watcher for that car.
 - Uses the FORCE_USE_AUDIO_GAME_OBJECT game native.
 - In-game menu powered by LemonUI (by Guad).

