-------------------------------------
- SDAL's Music Box 2 -
-(c) by Sir Drink a lot (04.10.2005)-
-------------------------------------

This plugin allows admins to play custom sounds to all players or to a single player.
Admins must have accesslevel 512 and accesslevel 64 to use this plugin.
The admin has several options how to play the sound. He can use commands in
console, per keyword in chat or by using the menu. The plugin allows 50 keywords and
200 sounds per default.

Another feature of the plugin is the Map.res Manager (beta!!):
If the administrator of the server is too lazy to build up mapname.res files for each map,
he can enable the Map.res Manager, which does automatically create it or adds missing
sounds to it. The Map.res Manager gives also a hint, if sound file does not exist on server
when you make a typo in playerlist.cfg.

* Commands:
--------------------
+ used in console:
- admin_play <number>: allows admins to play a sound to all players on server.
- admin_playto <number> <player>: allows admins to play sound to a player.
- admin_playlist <number>: displays the sound numbers in playerlist.
- admin_playmenu: opens menu with all keywords
- admin_res_manager: <0/1> enables the feature (Map.res Manager) that
plugin creates mapname.res files automatically. (OFF per default)
+ used in chat:
- say '.musicbox' opens menu with all keywords
- say 'keyword' '<[player]>' plays sound to all [or player]
- all players can use say '.stop' or '.play' to turn on/off customsounds for them

* Installation:
--------------------
- all sounds are set up in addons/adminmod/config/playlist.cfg
- sounds are played randomly enabled by keyword
- number of sounds is not restricted for one keyword
- keywords are marked with a # in front. Next line is for path/wav file
- keyword must be one word
- example:

#doh
sound/misc/doh.wav
sound/misc/doh3.wav
sound/misc/doh4.wav
sound/misc/doh5.wav
sound/misc/doh7.wav
sound/misc/doh2.wav
sound/misc/dohoo.wav

!!!IMPORTANT!!!
PLEASE USE / INSTEAD \ AND YOU NEED TO SET
THE FULL PATH STARTING WITH sound/
LAST LINE MUST BE EMPTY IN FILE!

- HL-Speech sound must be marked with "".

* Needed settings:
--------------------
+ in adminmod.cfg:
- amv_enable_beta "menu1", so admin can use the playmenu.
- file_access_read 1
- file_access_write 1, if plugin shall create/edit the mapname.res file
- allow_client_exec 1
+ for the sound:
- create mapname.res files or enable Map.res Manager, that clients can download the sounds.