This mod lets you set custom sounds to your designs.
Might be useful for SP video makers or just for fun.
Designed to work on Windows. Not tested on Linux or Mac.

This mod was built with Unity 2018. If you see some compatibility warnings in mods tab after activating the mod just ignore them.

Also there are 3 integrated .NET assemblies :
System.Buffers,
System.Memory,
System.Runtime.CompilerServices.Unsafe
These are loading correctly and working fine on Windows, but not tested on Linux or Mac.

---

Functionality

Player aircraft sounds will be updated automatically if matching configuration file found. AI aircraft sounds must be updated manually through console.

---

Part Support

This mod can be used to change sounds of this part types:

Guns
Rockets
Rocket Pods
Missiles
Engines
Helicopter Rotors

---

Console Commands

g_dbg_snd_reload - Automatically update player aircraft sounds from matching "ltx" file.
g_dbg_snd_reload_ai - Same as above, but for selected AI target.
g_dbg_snd_override - Update player aircraft sounds from specified "ltx" file name ( without file extension ).
g_dbg_snd_override_ai - Same as above, but for selected AI target.
g_dbg_snd_select - Selects single part from player aircraft for sound testing ( part id ).
g_dbg_snd_test - Overrides selected part sound from specified "ogg" file name ( without file extension ).
g_dbg_snd_unpack - Unpacks integrated audio package.
g_dbg_snd_restart - Must be called from editor/main menu. Empties buffers / releases memory.

---

Key Mappings

When you select part by g_dbg_snd_select, you can cycle through all sounds:
Keypad / - Previous sound
Keypad * - Next sound

---

Audio Files Support

This mod supports ONLY Ogg Vorbis audio files and has limit of 256Kb per file.
"Mono" files preferred, "Stereo" files may cause some noise with loud audio.
Files must be located in "Sounds" folder inside of main SP local user folder.
On Windows this should be AppData/LocalLow/Jundroo/SimplePlanes/Sounds/
If you cant find AppData folder, try: Right Click - New - Shortcut - %AppData%
Or this: Start - Run ( Win + R ) - %AppData%

---

Builtin Audio Package

This mod contains an integrated audio package.
It consists of 75 example sounds:
10 Gun sounds ( Gun_* )
10 Cannon sounds ( Cannon_* )
20 Propeller engine sounds ( Prop_* )
10 Turboprop engine sounds ( Turbo_* )
10 Jet Engine Sounds ( Jet_* )
10 Helicopter sounds ( Rotor_* )
2 Missile sounds ( Missile_* )
2 Rocket Pod/Rocket launch sounds ( Launch_* )
1 Car sound ( Car_* )

If "Sounds" folder does not exists, it will be created and all sounds will be extracted automatically. Also sounds can be extracted manually at any time through console.
Example sounds named like that only for better organization, you can name your sounds whatever you like, just keep the ogg extension.

SOUND WARNING : Cannon sounds can be very loud.

---

Making Audio Files

When making/converting sounds you may need to adjust volume since some sounds will become too quiet / loud in SP. Also sounds for some parts needs to be slowed down to play correctly.

In your audio editor find something like "Effects - Change Speed" and set to:

Propeller Engines / Tail Rotor : 0.37 ( 0.35 - 0.375 )
Jet Engines : 0.68 ( 0.67 - 0.7 )
Helicopter Rotor : 0.5
Car Engine : 0.6 ( 0.58 - 0.7 )
Missiles : 0.5?
Rockets, Rocket Pods, Guns, Cannons, Old Engines : No Change

Gun sounds preferred to be multi-shot.
Cannon sounds must be single-shot.
Engine sounds must be properly looped.

---

Aircraft Configuration files

These are files with "ltx" extension and name equal to some aircraft.
They store data required to override design sounds and located in
AppData/LocalLow/Jundroo/SimplePlanes/SoundOverride/
Use text editor ( such as notepad / notepad++ / wordpad etc ) with ASCII encoding to create/edit these files.

To be automatically identified, "ltx" file must have name of aircraft it's associated with.
Example:
For Wasp this would be Wasp.ltx
For Bush Plane this would be Bush Plane.ltx

Files consists of "key=value" pairs:
"Sound file name without extension = part ids separated by comma"
You can get id of any part from Overload - id field.
No comma needed if there only one value.
Each line must contain only 1 key-value pair.

Example:
prop_3 = 10, 22, 51
Means sound "prop_3.ogg" will be assigned to parts 10, 22 and 51.

There also support of comments ( semicolon )
Example:
jet_2 = 10 ;here starts comment

---

Overriding AI Plane Sounds

There are no automatic sound override for AI planes, you need to do it manually:
1. Spawn AI Plane
2. Enter Air-to-Air mode and select that plane
3. In Console type g_dbg_snd_reset_ai to load matching config for that plane
Or use g_dbg_snd_override_ai to load config from file specified. Example:
g_dbg_snd_override_ai aircraft123

---

Testing Audio

If you want to quickly test different sounds on your design you can try this:
1. Get part id ( for example, 25 )
2. In Console type g_dbg_snd_select 25
3. "Activate" the part ( increase throttle, fire guns etc )
4. For next/previous sound use Keypad * and Keypad /
Or use g_dbg_snd_test to load sound from file specified. Example:
g_dbg_snd_test prop_20

---

File Names with Spaces

In Console you need to encapsulate file name with quotes if it contains spaces.

---

File Paths (Windows)

Sounds - AppData/LocalLow/Jundroo/SimplePlanes/Sounds/
Aircraft Configs - AppData/LocalLow/Jundroo/SimplePlanes/SoundOverride/