*built with original 12-22 assasins edition, no patches*
Documentation of Anathema's playlist mod

1. What is
2. Installation
3. Use

1. What is the m3u playlist mod
The m3u playlist mod is a tiny (~200 loc) modification in the src/engine/sound.cpp file that enables sauer to load an m3u playlist placed in the packages/ folder that have relative file paths. The m3u playlist standard is essentialy a list of music files + metadata, originaly created by the winamp peoples.

for an example of what one looks like, see packages/default.m3u

2. Installation

On linux, extract this zip file into your sauerbraten directory.
it will overwrite the binary and default_map_settings.cfg, and add the folder m3u_src to sauers dir.

On windows, mac, copy the src files and build your own binary ;P

3. Using the m3u playlist mod

command: playlist
accepts: string, interger
loads playlist file string, which should be an m3u playlist with relative links placed in the /packages folder. the interger can be 0, 1, or 2. if no arguments are provieded, assumes 0. 0 creates a new playlist from file string, 1 appends to the current playlist, and 2 only creates the playlist if there is no current playlist (used in modified defualt_map_settings.cfg)

command: nextsong
accepts: interger
with no arguments, this just plays the nextsong. if interger is passed, it will play the song specified.

command: deletesong
accepts: interger, interger (optional)
deletes song of number first interger. if a second interger is
passed, it will delete that many songs beginning at the first interger.

command: randomlist
accepts: interger (optional)
by default this command flips the random setting of the playlist.
passed a one it will force the playlist random, passed a 0 it will
force the playlist straight-through play.

command: printlist
accepts: (none)
prints every song on the playlist + it's order number, and then
prints total # of songs.