PLAYLIST

Stored in the playlist.ddf file, or in the DDFPLAY data lump.

Playlist.ddf is used to define music entries in EDGE. Each entry begins with a unique reference number, in square brackets, and represents a piece of music that can be played at some point in the game. Either during a level, or as one of the intermission or title pieces of music. These entries are then referred to from the other ddf files, such as levels.ddf or game.ddf.

NOTE: When using filenames, directories must be separated by / instead of the \ character which is normally used under Windows. The reason is because the \ character has a special meaning in DDF: it is the escape character, and "\n" is used to put newlines into DDF strings.

Format

Entries in playlist.ddf have the following format:


[ENTRY NUMBER] MUSICINFO=[TYPE]:[FORMAT]:[SONG NAME];
 

Where each command is as follows:

COMMANDDESCRIPTION
[ENTRY_NUMBER] A two digit number, used to reference this entry in games.ddf and level.ddf.
[TYPE] This can be MIDI, MUS, MP3, OGG, FLAC, XMP, GME, SID, VGM, IMF280, IMF560 or IMF700 and should refer to the type of music source that is being used.
[FORMAT] If the music is in a wadfile, this must be LUMP.
If the music is a file on the hard drive this must be FILE.
[SONG NAME] Name of the actual file in the wadfile or on the hard drive. Entries with an underscore "_" in require quotes around the name (e.g. "D_DEAD").
 

Examples

The following are examples of different playlist entries:

[10] MUSICINFO=MUS:LUMP:"D_DEAD";   // NOTE: names with "_" in them require quotes

[23] MUSICINFO=OGG:FILE:"music/QOTSA/A_Song_for_the_dead.ogg";   

back to top

DDF docs written by Andy Baker and Ziggy Gnarly, with updates by Andrew Apted, Andy Brewood and Luke Brennan.
Problems with the docs, errors and comments should be directed to the EDGE team.

© EDGE Team 1998 - 2022.