General notes on music in XDM

Console commands
----------------
These can be used to manually control the music player from the console.

bgm_play <file name> [loop mode (1/0)]
bgm_playpath <full path> [loop mode (1/0)]
bgm_pls_play <playlist file name> [loop 0/1]
bgm_pls_next
bgm_pls_prev
bgm_pls_list
bgm_pls_track <position #>

* If the specified file name or path contains spaces ("my file name.ogg")
you should enclose it into "quotes".
* Make sure you have 'bgmvolume' > 0 and 'mp3player' > 1.


Console variables
----------------
Most of these you'll never have to change.

"mp3player" must be "2" for external player
"bgm_playmaplist"
"bgm_playcustomlist"
"bgm_defplaylist"	"default.xpl"
"bgm_driver"
"bgm_quality"
"bgm_dir",		"music"
"bgm_volume"	0-255
"bgm_pausable"	0/1
"bgm_pls_loop"	0/1


Directory contents
----------------
/music/ directory may contain:
2.mp3 - 28.mp3 - standard music tracks
default.xpl - default playlist (referenced by bgm_defplaylist cvar).
<mapname>.xpl - playlists for maps.
<gameprefix>.xpl - default playlists for game rules ("CTF.xpl").

You can put here your own music files.

* It is recommended to include only file paths in XPL playlists,
but they can have .m3u tags too, which are currently ignored.


Other notes
----------------
In XDM terms, 'internal' music player is HL engine CDA/MP3 player,
which has almost no control over it, and 'external' player is the
detachable DLL player with support for seeking, GUI and lots
of file formats.


Internal music player commands
----------------
For Half-Life version 1.1.1.0 and newer:

MP3volume 0.0 - 1.0 - background music volume

cd on - activate the control of CD player
cd off - deactivate the control of CD player
cd reset
cd eject
cd close
cd info - information about inserted CD
cd play # - play track #
cd loop # - cyclic reproduction of the track #
cd remap # [#] - reorder sequence of playing
cd pause
cd resume
cd stop
cd mp3track # - play track # from an MP3 file
cd mp3info - info about MP3 file

It is necessary to place .mp3 files in Half-Life/valve/media directory.

List of acceptable filenames:

valve\media\Half-Life01 - 17.mp3
valve\media\Prospero01 - 05.mp3
valve\media\Suspense01 - 02,03,05,07.mp3