[h1]Unit Voiceovers[/h1]
[B]Author:[/B] 654Wak654 & Gokmen
[B]Website/Repo:[/B] https://github.com/the0utsider/unit-voiceovers

[B]Short description:[/B] Dynamic, randomized 3D-positional sound samples for units
[B]Requirements:[/B] None 
[B]Version:[/B] v1.17
[B]Signed:[/B] Yes

[B]Description:[/B]
Using NWI's iconic game 'insurgency' sound samples, this add-on created to improve overall experience and bring dynamism to expressionless Arma3 models. I always imagined this to be something similar to st_hud but an aural one instead of visual. Each faction has their own sounds, with samples played on certain actions to increase situational awareness, to simulate better close quarters combat.

[B]Features:[/B]
[list]
	[*] Supports ACE M14 & M84 grenade types
	[*] Positional in-game audio for units, for each faction, randomized
	[*] Using 'say3D' and 'playsound3D' for realistic volume simulation
	[*]	Max. range distance of sounds are similar to ingame directChat
	[*] Loud shout of pain whenever a unit dies
	[*] Wounded unit will yell out sentences like "kill that son of a xitch!"
	[*] Friendly fire - you will hear warnings like "stop It you Fxxxing idiot!"
	[*] Target down at close (less than 100 meters): aggressive kill confirms (depends on randomized chance factor)
	[*] Target down (outside 100m range): calm kill confirms (depends on randomized chance factor)
	[*] Whenever a team member gets killed nearby, alive team members shout panic sentences (depends on randomized chance factor)
	[*] Unit using throwables: shouts for throwing frag grenade and smoke grenades
	[*] Unit will let the others around know that he has few magazines left on him
	[*] Unit will say that he just planted an explosive satchel or c4 charge
	[*] Unit will say similar sentences to "watchout while I reload" when current mag goes empty
	[*] Performance demand of this add-on is minimal as It uses no loops and nothing is added to Arma scheduler
	[*] Voiceovers randomized for each action, approx. 700 different sound samples
[/list]

[B]Customization:[/B]
[list]
	[*] Enable/disable VO for player/client
	[*] Sound sample pitch adjustment
	[*] Set volume level and travel distance to your liking
	[*] Ratio customization for certain sounds
	[*] CBA is required to enable add-on options
[/list]

[B]Included Files:[/B] 
gokmen.bikey
goko_uVO.pbo
goko_uVO.pbo.gokmen.bisign

Has to be loaded both on server and client in order to work on MP

[B]Thanks:[/B] [url=http://steamcommunity.com/id/654wak654]654wak654[/url] for original EventHandler code, this add-on could never exist without his support.
Ömür 'gebbet' & Hamza 'ElKappucino' for testing.
NWI for creating Insurgency, mikee and others for VO's

[B]License:[/B] Covered under [B]Arma Public License Share Alike[/B]
 [url=https://www.bohemia.net/community/licenses/arma-public-license-share-alike]APL-SA[/url]
	Feel free to use and modify this code, on the proviso that you post back changes and improvements so that everyone can benefit from them, and acknowledge the original authors in any derivative works.

[B]ChangeLog:[/B]
[SPOILER]
	V1.17 - 03-03-2018:
		- Fixed: some script errors, missing function name on WEST faction
		- Added 42 voiceover samples for ACE m14, m84 grenade types for factions
		- Added customization for samples' volume, max. range, pitch, enable/disable checkbox for player (CBA required to enable settings)
		- Code improvements and optimizations (nearestObjects), volume levels equialized in cfgSounds.hpp
		
	V1.14 - 01-25-2018:
		- Fixed: new reloaded eventhandler functions (now you shouldn't hear "reloading" or "low on ammo" with throwables or in arsenal)
		- Added magazine ID check to make sure waituntil loop doesn't stack
		- new code to detect last bullet in the chamber - better than needReload command
		- Added 9 missing independent faction sound samples

	V1.1 - 01-19-2018:
		- Changed add-on name to 'Unit Voiceovers'
		- removed particle effects, now that's a seperate add-on,
		- removed some obsolete sound samples,
		- Removed nullified radio sentences (games default voiceovers are back)

	V1.0 - 12-29-2017:
		- Addon Released on steam as 'goko soldier voiceovers'
[/SPOILER]