Sank Sounds (luke Sankey)

* v1.6.6b: (29.03.2009)
*    - fixed:
*        - runtime error
*        - if SND_JOIN or SND_JOIN was not at the beginning and more sounds were added afterwards, those new sounds overwrote previous sounds
*
* v1.6.6: (03.03.2009)
*    - fixed:
*        - last entry in configfile was not sorted
*        - runtime error with keywords without any sound
*        - exploit where SND_JOIN and SND_EXIT could be used as keywords
*    - changed:
*        - SND_JOIN and SND_JOIN do not have to be before any other keyword
*
* v1.6.5b: (22.01.2009)
*    - changed:
*        - removed warning for unsupported mp3s (they are supported)
*
* v1.6.5: (14.01.2009)
*    - fixed:
*        - wav detection for bad files
*
* v1.6.4: (21.12.2008)
*    - added:
*        - warning for unsupported mp3 files
*    - changed:
*        - mp3 detection code rewritten
*
* v1.6.3: (29.02.2008)
*    - fixed:
*        - runtime error if more sounds added than defined in MAX_KEYWORDS
*        - commenting SND_JOIN and SND_EXIT (adding # or // infront of them) made the following sounds to be added to these options
*    - changed:
*        - CVAR "mp_sank_sounds_obey_duration" is now a bitmask (see readme.txt)
*
* v1.6.2:
*    - fixed:
*        - removed debug message
*        - admins are not included in overlapping check anymore
*        - non admins could see sounds that are for admins only
*        - bug when adding and removing sounds ingame to list (wierd keywords and sounds)
*    - added:
*        - "PLAY_COUNT_KEY" and "PLAY_COUNT" to data structure to count how often a key and sound has been used
*        - messages for players when enabling/disabling sounds and if players have to wait cause of delay
*    - changed:
*        - sank sounds is now precaching sounds after plugin init (fakemeta modul needed)
*        - no more engine, but therefore fakemeta is needed
*        - minor code tweaks
*
* v1.6.0: (16.4.2007)
*    - fixed:
*        - speech sounds not being played
*        - join / exit sound duration was incorrect
*        - SND_WARN / SND_MAX error checking could display wrong error
*    - added:
*        - access can be defined for every sound and keyword seperately
*    - changed:
*        - partly rewritten
*        - way of saving data
*        - sounds when enabling and disabling Sank Sounds are not precached anymore ( hard coded )
*        - many code improvements
*
* v1.5.6:
*    - fixed:
*        - sounds located in <MODDIR>/sounds/ (no subfolder) not being played if dead and alive not being splitted
*        - long lines not being parsed correctly
*        - players could play one more sound than allowed
*
* v1.5.5:
*    - fixed:
*        - error in mp3 calculation ( once again :( )
*    - added:
*        - additional debug info for mp3's when compiled in DEGUB_MODE 1
*
* v1.5.4:
*    - fixed:
*        - error in mp3 calculation
*        - when using "mapnameonly" option, following options have been ignored
*    - added:
*        - minor detection for damaged/invalid files
*    - changed:
*        - both "SND-LIST.CFG" and "snd-list.cfg" will work now ( linux )
*        - code improvements
*        - faster config parsing/writing
*
* v1.5.3:
*    - fixed:
*        - admin being able to play sounds when "mp_sank_sounds_obey_duration" was on
*    - added:
*        - CVAR: "mp_sank_sounds_motd_address" to use a website to show all sounds ( empty cvar = no website will be used )
*
* v1.5.2:
*    - fixed:
*        - support for SND_DELAY was accidently removed
*        - some possible minor bugs
*    - added:
*        - SND_MAX_DUR: maximum of seconds a player can play sounds each map
*        - two new options for SND_MODE ( read help for more information )
*
* v1.5.1b:
*    - fixed:
*        - runtime error in mp3 calculation
*
* v1.5.1:
*    - fixed:
*        - calculation for MP3's encoded with MPEG 2
*    - added:
*        - saying "/soundlist" will now show sound list like "/sounds" does
*        - CVAR: "mp_sank_sounds_obey_duration" to determine if sounds may overlap or not ( default: 1 = do not overlap )
*
* v1.5.0b:
*    - fixed:
*        - rare runtime error
*
* v1.5.0: ( AmxModX 1.71 or better ONLY )
*    - fixed:
*        - sounds being not in a subfolder ( eg: sound/mysound.wav ) will now be played
*        - reconnecting to reset quota will not work anymore
*        - no more overlapping sounds ( Join and Exit sounds will still overlap other but others cannot overlap them )
*        - amx_sound_reset now accepts IDs too
*        - sound quota could be increased even if no sound was played
*    - added:
*        - sound duration is now calculated
*    - changed:
*        - SND_DELAY does not affect admins anymore
*        - SND_SPLIT has been replaced with more customizable SND_MODE
*        - removed support to disable MP3
*
* v1.4.7:
*    - fixed:
*        - keywords with admin and public sounds, could block normal players from playing normal sounds
*        - runtime error which could stop plugin to work
*        - message telling players to wait till next sound can be played is not displayed on every word anymore
*
* v1.4.5:
*    - fixed:
*        - ADMINS_ONLY was not working always
*        - players could only play less sound than specified in SND_MAX
*        - runtime error with amx_sound_reload
*    - added:
*        - sounds can now also be used in team chat
*        - amx_sound_unban to unban players
*    - changed:
*        - keyword check tweaked
*        - amx_sound_ban now do not expect additional parameter "on / off" or "1 / 0"
*
* v1.4.3:
*    - fixed:
*        - keywords without or with wrong files will not be added anymore
*        - possible errors fixed
*        - error with MOTD display fixed
*
* v1.4.2b:
*    - fixed:
*        - compile error when disabling mp3 support
*
* v1.4.2:
*    - fixed:
*        - players could be banned from sounds after reconnect
*    - added:
*        - option to include sounds from "half-life.gcf" and <current mod>.gcf
*
* v1.4.1:
*    - fixed:
*        - when setting DISPLAY_KEYWORDS to 0 chat was disabled
*
* v1.4.0:
*    - added:
*        - option to load packages of sounds, packages cycle with each map-change (packages must be numbered)
*        - ability to ban people from using sounds (only for current map) ( amx_sound_ban <player> <1/0 OR on/off> )
*    - changed:
*        - precache method changed
*        - all keywords are now stored into buffer, even of those sounds that are not precached
*        - code improvements
*
* v1.3.7:
*    - added:
*        - "DISPLAY_KEYWORDS" to config, it determinates if keywords are shown in chat or not
*        - option to load specific sounds only on specific maps
*    - changed:
*        - "SND_DELAY" is now a float
*
* v1.3.5:
*    - added:
*        - with "/soundson" and "/soundsoff" each player can activate/deactivate the ability to hear sounds
*
* v1.3.4:
*    - fixed:
*        - error where some players could not hear any sound
*    - changed:
*        - some log messages got better checks
*        - reimplemented check for bots
*
* v1.3.3:
*    - added:
*        - cvar "mp_sank_sounds_freezetime" to define when first connect/disconnect sounds are played after mapchange (in seconds)
*
* v1.3.2:
*    - fixed:
*        - mp3 support not working
*    - changed:
*        - mp3 now dont need to be in sound folder but anywhere you want (anywhere in your mod folder though)
*            just specify the correct path (eg: music/mymusic/my.mp3 or sound/testmp3/test.mp3 or mainfolder.mp3)
*        - amx_sound_debug can now also be used if debug mode is off (this function prints the sound matrix)
*
* v1.3:
*    - fixed:
*        - fixed prob where strings were copied into other strings with no size match
*        - removed bot detection (maybe this was causing some problems, playing sounds to bots does not do any harm)
*        - admin sounds could not be played (eg: hallo; misc/hi.wav;@misc/hi2.wav -> hi2.wav was not played, even by admins)
*    - added:
*        - type "/sounds" in chat to get a MOTD window with all sounds available (not all mods support MOTD window)
*        - ability for speech sounds (like the AmxModX's speechmenu)
*        - admin check to "amx_sound_debug" so in debugmode only admins can use it
*        - list is now sorted by name for more readable output (sort by Bailopan) (sort can be turned off by define)
*
* v1.2.5:
*    - added a cvar to enable or disable auto download (change will take place after restart/mapchange)
*
* v 1.2.4 :
*    - added mp3 support (they have to be in <Mod-Dir>/sound too) (engine module needed therefore) (+ hotfix: wavs not being played)
*    - changed the way of initializing each sound file (if bad file it wont be loaded and error msg will be printed)
*    - changed SND_KICK to SND_MAX
*    - increased default defines ( words: 40 - > 80 / each wavs: 10 -> 14  / file chars: 30 -> 60 )
*    - fixed bug for 32 players
*    - increased memory usage for variables to 64K (should fix probs)
*    - while parsing there is now a check if file exists (if not it wont be put in list)
*
* v1.1.3 :
*    - fixed bug with spaces between keywords and wavs
*    - multiple Join and Exit sounds can now be used
*    - fixed bug where connect and disconnect sound have not been played
*    - fixed bug where dead players could not hear sounds
*    - added bot check
*    - added option to only allow admins to play sounds
*
* v1.0.2 (original 4.1 but this is AmxModX) (port to Amx Mod X by White Panther):
*    - initial release for AmxModX
*    - renamed commands to fit with AmxModX
*    - Admin sounds cannot be seen by normal people when using amx_sound_help
*    - sounds are precached from file
*    - fix: check if soundfile exist before precache (that should solve some probs)
*    - fix: if chat message was longer than 29 chars the first wav in cfg was played