DoomDynMus - a dynamic music mod

cyber_cool · Post by **cyber_cool** » Sat May 08, 2021 3:01 pm

A simple yet sometimes astonishing mod that adds a dynamic music system to Doom.

Features:

Customizable fade-in and fade-out between tracks.
Tracks are grouped - each group contains an ambient track, a combat track and a death track.
A flexible lump format that groups music tracks together.
Load any kind of music pack others or you made, and even mix them.
Keybinds for changing currently playing track.
High-action combat music playing on specific, dangerous occasions.

Music pack format:

Spoiler:
Lumps that DoomDynMus uses to recognize and group music files are called DMUSCHNK (music chunks).
They look like simplified JSON files.
There are 3 basic objects in DMUSCHNK:
String - a sequence of characters. You can include whitespaces or special characters (",", "]", "}", etc.) in a string by surrounding it with quotes.
Code: Select all
string_example
"I am a string, too!"
Array - a sequence of objects separated by commas and surrounded with [square brackets].
Code: Select all
[an, array, "of items", [which, "can be", nested, [with, great], {what: depth, how_much: 100ft}], "for real"]
Dictionary - a sequence of pairs "key: value", surrounded with {curly brackets}.
Code: Select all
{ type: normal,
	sizes: [1, 2, 3, 10, chicken, -1],
	name: "a normal dictionary"
}
A simple music chunk file looks like this:
Code: Select all
[
	{
		folder: "music/",
		tracks:
		[
			{normal: ["1-08 UNATCO.mp3", "1-17 NYC Streets.mp3"], action: "1-10 UNATCO Action.mp3", death: "1-11 UNATCO Death.mp3", high_action: "04_Anna_Combat.ogg"},
			{normal: "2-01 Majestic 12 Labs.mp3", action: "2-03 Majestic 12 Action.mp3", death: "2-04 Majestic 12  Death.mp3"}
		],
		high_action: ["04_Gunther_CombatIntro.ogg", "05_Anna_Combat.ogg"]
	}
]
Here, you NEED to put everything between an opening and a closing square brackets - DoomDynMus expects every music chunk file to be an array at it's top level.
In this array, you put one or more dictionaries - music chunks - which group together music files, while also providing some configuration options.
The whole list of attributes a music chunk can have is listed below:

tracks - mandatory attribute which describes a list of track groups. Each track group is a dictionary, which in turn has 3 attributes:

normal (ambient music, no or low amount of enemies directly attacking the player - can be configured through CVars)

action

death

high_action (same as high_action in track options, but tied to a track group and preferred over the former)

Each of these attributes can either have a string or an array assigned to it. If it's an array of file names, then a random music file is picked when music type changes (between ambient/action/death/high action).
If any of these attributes is absent, the level music will be played on that occasion. Same goes if you specify "*" as a file name.
Also, you can specify "silent" as a file name (without extension, just "silent") to make track completely silent and not be announced. (Works with arrays, too, so you can mix silence and music files).

high_action - attribute which describes an array of music tracks which play when a player is fighting a boss or a large amount of monsters (amount of monsters is configurable through cvars). A track is selected randomly from this array, and it doesn't depend on tracks attribute.

folder - a string which is prepended to each track name in the music chunk. You can only define it once per chunk, though, but it's handy if you put your music into a separate folder or even multiple folders (create multiple chunks on that occasion).

Upon selecting a random track (whether by a keybind, map change, or on game launcing) DoomDynMus picks a random chunk first (from any music chunk file loaded), then it picks a random track inside this chunk, according to current state of the game (ambient/action/death/high action). Each chunk has an equal chance of getting picked, no matter how much tracks does it have.

Legacy music pack format (still supported, but not updated with more features):

Spoiler:
Lump format is called DMUSDESC (exactly that file name, or with an extension).
It's basic structure is described as follows:
Code: Select all
"/music/ambient1.mp3" "/music/combat1.mp3" *0
"/music/ambient2.mp3" "/music/combat2.mp3" "/music/death2.mp3"
Each group has 3 tracks, one following other. They are separated by any kind of white space - spacebars, new lines, tabulations, etc. If a name of a track contains spaces, it can be encapsulated in quotes (but not necessary).
To avoid unnecessary duplication, you can use *N to duplicate a track from the same group from other category (i.e. *0 to duplicate ambient track and *1 to duplicate action track). You can't duplicate tracks before providing their names.
You can also keep the level music for any track category by typing ** .
There is also a separate category - "high-action" combat music. It is placed in a separate lump called DMUSHIGH. It doesn't support duplication, just file names. The amount of music tracks is not limited and not tied to DMUSDESC lump (they are chosen randomly instead being tied to a track group). If no such lump is present, normal combat music will play instead:
Code: Select all
"music/boss1.mp3"
"music/boss2.mp3"

Spaceman333 · Post by **Spaceman333** » Sun May 09, 2021 6:31 pm

Tried it with the Deux Ex pack, works amazing!

Only caveat is that there is a short freeze that happen once when the music first changes from peace>combat per each level, but after that its completely seamless for the rest of the map.

Thank you for making this!

marco.nadal.75 · Post by **marco.nadal.75** » Sun May 16, 2021 4:50 am

This is an excellent addition, I tested it with this loadout:

name=DooM EXP
portname=GZDoom latest build (actually 4.5.0)
iwad=doom2.wad
pwads=..\WADS\TC\LithiumHeat\1COMPEND.wad,
doors-stay-open.pk3,
offi_xp_v2.4.2.pk3,
livereverb.pk3,
..\WADS\music\Dynamic OST\DMus_SSTFE.zip,
..\WADS\music\Dynamic OST\DoomDynMus-master.zip

Thank You CyberCool!

slyrboi · Post by **slyrboi** » Wed Jun 02, 2021 2:50 am

So you load a music pack, then load this mod. That's how to use it?

marco.nadal.75 · Post by **marco.nadal.75** » Sun Jun 06, 2021 2:49 am

Yes, and it is super easy to make your own.

Using SLADE, I exported two sets of music lumps from MusicDarkAmbient.pk3 and STRAIN.WAD, Used bulkrenameutility.exe to rename them from D_<lumpname>.mus / .ogg to STRAIN_<lumpname>.mus / Dark_Ambient_<lumpname>.ogg, then wrote a DMUSDESC to tie them together. Zipped up the DMUSDESC and \music\ folder with the renamed .mus and .ogg files into DMus_STRAIN.zip and now I'm playing through STRAIN with dynamic music, livereverb.pk3 and LitDoom early alpha.

Well trying to play through. LitDoom is super hard survival mod, but I love it so far. It's easier to learn to play than Hideous Destructor, that's for sure.

Will try to make a DynMus pack for Invasion mode using instrumental tracks by Utsu-P.

My load order for LitSTRAIN:

name=LitDoom
portname=GZDoom 4.6.0
iwad=doom2.wad
pwads=
..\WADS\megawads\STRAIN.WAD
doors-stay-open.pk3
nashgore.pk3
livereverb.pk3
..\WADS\TC\LiTDOOM\LiTDOOM 0.51 Beta.pk3
..\WADS\music\Dynamic OST\DMus_STRAIN.zip
..\WADS\music\Dynamic OST\DoomDynMus-master.zip

Prodigal Providence · Post by **Prodigal Providence** » Mon Jun 07, 2021 6:59 am

Took this for a spin and I'll be honest - I love this one. I'm having a bit too much fun making musicpacks. Reminds me of the NOMBAT mod for GMod that's basically the same thing in concept.

MP3s work well with it too although the resulting large filesize is a bit of a bother.

Just a note for users: If you play mods that has abrupt in-game music cut-off mechanics (like Insanity's Brutality FATALITY! executions), they would momentarily stop your musicpack from playing. Just hit the random set play button to change back to it.

Ferretmanjcdenton · Post by **Ferretmanjcdenton** » Wed Jun 09, 2021 1:46 am

Prodigal Providence wrote:Took this for a spin and I'll be honest - I love this one. I'm having a bit too much fun making musicpacks. Reminds me of the NOMBAT mod for GMod that's basically the same thing in concept.

MP3s work well with it too although the resulting large filesize is a bit of a bother.

Just a note for users: If you play mods that has abrupt in-game music cut-off mechanics (like Insanity's Brutality FATALITY! executions), they would momentarily stop your musicpack from playing. Just hit the random set play button to change back to it.

Awesome...would you consider making a doom eternal version. ?
With the awesome original tracks ...or d2016?

Prodigal Providence · Post by **Prodigal Providence** » Wed Jun 09, 2021 5:11 am

Awesome...would you consider making a doom eternal version. ?
With the awesome original tracks ...or d2016?

I haven't really given the 2016 and Eternal soundtrack a listen yet besides The Only Thing They Fear Is You, but it's rather doable.

Not sure if I can post it and the other packs I made here though.

Linz · Post by **Linz** » Wed Jun 16, 2021 6:41 am

Man,I really would love to see a Painkiller music pack

ARScplrd420 · Post by **ARScplrd420** » Thu Jun 24, 2021 6:25 am

I haven't really given the 2016 and Eternal soundtrack a listen yet besides The Only Thing They Fear Is You, but it's rather doable.

Don't mind if do!, i have made the doom eternal soundtrack into the doomdynmus mod!, soundtrack is way off when encountering epic fights such when super gore nest was playing but the epic guitar riff was way too long to happen.

maybe a random script on skipping the best part of the song
try editing the soundtrack to get the best results

Download Link below:
https://mediafire.xyz/0HZHWwwUOi8Og1W
(dunno why other download links doesn't require file hosting websites)

Eggs · Post by **Eggs** » Sat Jun 26, 2021 11:34 pm

Decided to try and make one myself based on Company of Heroes 1. Tried to match the music best i could, and used cut scene audio on some of the intermission title and text screen stuff.
https://drive.google.com/file/d/1IAqW7R ... sp=sharing
edit01 found a quick typo in one of the track lists, fixed
edit02 fix hopefully for real this time

Death_Ripper666 · Post by **Death_Ripper666** » Thu Jul 15, 2021 3:04 am

I've downloaded DoomDynMus and got some music packs as well and it works like charm, haven't ran into problem yet.
This actually inspired me to make a Painkiller OST music pack for DoomDynMus. I made it a bit accurate as possible in the best of my ability. I made it into four different Painkiller music pack files from four games (if you count Battle Out Of Hell Expansion pack). Some of the music were from Hell & Damnation as well as scrapped music from level that didn't make it to the finished product. So Here's all three of Painkiller's music pack for your enjoyment

:

Painkiller: Black Edition OST: https://www.mediafire.com/file/djtnqsoi ... T.zip/file

Painkiller: Overdose: https://www.mediafire.com/file/g9m3wa0g ... T.zip/file

Painkiller Resurrection: https://www.mediafire.com/file/is8x7b7s ... T.zip/file

Left a video here to demonstrate the DoomDynMus:

edit: edited the error on PainkillerOST. Reuploaded.

Craneo · Post by **Craneo** » Sat Jul 17, 2021 12:18 am

Idea: what if someone does a pack where the action/combat music is Doom 1 and 2 metal/rock/techno covers and the ambience music is Doom 64/PSX Doom music? so it's more Doom-themed in general (without having to explicitly rely on Doom 2016 or Eternal's music, since IIRC those have to be bought)

mamaluigisbagel · Post by **mamaluigisbagel** » Sat Jul 17, 2021 6:34 pm

Question: Is it possible to add JUST one category of music? (ie right now I don't want to start creating my own music packs yet but have some amusing ideas for death songs/sounds. Could I just add a bunch of death sounds and leave the music alone? (possibly being replaced by whatever music the MegaWAD is playing?)

TheoDrHashiriya · Post by **TheoDrHashiriya** » Sun Jul 18, 2021 8:22 am

Made a PAYDAY music pack for this less than a month ago: https://github.com/TheoDrHashiriya/DMus_Payday

ZDoom

DoomDynMus - a dynamic music mod

DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod

Re: DoomDynMus - a dynamic music mod