README for the AdminMod-Plugin 'plugin_bib_entrysound' v1.0
Author: Jochen Ruster aka Bibabuzemann
Clansite: http://www.btsclan.de/


_Description_

This plugin can be used to announce certain players with a
sound and some centersay-text users are recognized by their 
wonid i.e it is useless on a LAN-only server
I used the all famous sank-sounds-plugin as a 
tamplate for the general layout of a adminmod-plugin 
and the principles of configfile-parsing ;)


_Configuration_

1. the source
There are several important #DEFINEs and variables at the top of the source:
CfgFile[]         : contains the filename of the configfile
ACCESS_ENTRYSOUND : contains the accesslevel needed to use the 
                    adminmod-command admin_entrysound
MAX_ENTRYS        : contains the maximum amount of users in the 
                    usersounds.cfg 
DEBUG             : when set to 1 the plugin will log additional 
                    information into the servers logfile

2. The .cfg
The configfile (named 'usersounds.cfg' by default) contains a 
':'-seperated list like the following one:
wonid:path/tp/sound.wav:some cool text announcing the admin
empty lines, lines beginning with '#' or '//',
 and lines containing less than 2 ':' are ignored


_Installation_

1. The bundled .sma is in win-textformat so you have to 
   convert it if your server is running on Linux
2. compile
3. edit the usersounds.cfg
4. upload the userfiles.cfg
3. upload the .amx to your server 
   (into cstrike/dlls/ or cstrike/addons/adminmod/scripts or whatever 
    is the correct place on your server)
4. add the line 'dlls/plugin_bib_entrysound.amx' to your plugin.ini
5. restart your server


_Troubleshooting_

If a user is recognized (the centersay-text is displayed) 
but the sound is not played try setting the #DEFINE FILENAME_LENGTH 
to a higher number (default is 60)
