ZDoom

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"

Load order:
Load any music packs before the mod.

Download the mod:
The latest version: https://github.com/cyberc001/DoomDynMus ... master.zip
GitHub repository: https://github.com/cyberc001/DoomDynMus

Download music packs:
These music packs should either contain free soundtracks, or provide instructions to buying and downloading them.
cyber_cool:
Deus Ex music pack: https://www.dropbox.com/s/50kvgbiadum7e ... X.zip?dl=0 (Contains the latest music chunk format, if you want to take a look)
Deus Ex Revision music pack: https://www.dropbox.com/s/iduweu0hv9kx3 ... v.zip?dl=0
Serious Sam The First Encounter music pack: https://www.dropbox.com/s/zwej1fqjrx2ui ... E.zip?dl=0
Red Alert 2 + Yuri's Revenge: https://www.dropbox.com/s/cuwdty9y439l0 ... R.zip?dl=0
ZikShadow:
Desert storm 1/2 music pack: https://www.mediafire.com/file/px7me88z ... 2.zip/file
Dark Forces Remastered: https://www.mediafire.com/file/a3g0caz5 ... d.zip/file
TheoDrHashiriya:
Payday music pack: https://github.com/TheoDrHashiriya/DMus_Payday
sonoda:
Persona 5 music pack: https://drive.google.com/file/d/1aTGVdp ... sp=sharing
Karl515:
Megaman Battle Network: https://github.com/KarlsRepo/DMus_MMBN (gzdoom has issues recognizing lumps inside folders inside archives, so unpack before using, if you downloaded as ZIP)
RastaManGames:
Manhunt 1: https://drive.google.com/file/d/1bg3Czp ... sp=sharing
Manhunt 2: https://drive.google.com/file/d/1oJSq43 ... sp=sharing
S.T.A.L.K.E.R.: Clear Sky: https://drive.google.com/file/d/1FqzkER ... sp=sharing
S.T.A.L.K.E.R.: Call Of Pripyat: https://drive.google.com/file/d/12PVu9i ... sp=sharing
S.T.A.L.K.E.R.: Shadow Of Chernobyl + FireStarter: https://drive.google.com/file/d/16T1L4- ... sp=sharing
Quake 1 + Quake 2: https://drive.google.com/file/d/1DCC96w ... sp=sharing
The Elder Scrolls III: Morrowind: https://drive.google.com/file/d/1ma4n16 ... sp=sharing
The Elder Scrolls IV: Oblivion: https://drive.google.com/file/d/1gpxIH4 ... sp=sharing
The Elder Scrolls V: Skyrim: https://drive.google.com/file/d/1vuWnO- ... sp=sharing
Fallout 3: https://drive.google.com/file/d/1JwsNwe ... sp=sharing
Fallout: New Vegas: https://drive.google.com/file/d/1CA0Iiv ... sp=sharing
Warframe: https://drive.google.com/file/d/1OY7R3j ... sp=sharing
Killing Floor: https://drive.google.com/file/d/1bgWvHA ... sp=sharing
Deus Ex Human Revolution: https://drive.google.com/file/d/1sM8NYu ... sp=sharing
Deep Rock Galactic: https://drive.google.com/file/d/1EE0XyP ... sp=sharing
Postal Redux: https://drive.google.com/file/d/1dG0xB7 ... sp=sharing
Borderlands: https://drive.google.com/file/d/103bc-C ... sp=sharing
Borderlands 2: https://drive.google.com/file/d/16Pr7A1 ... sp=sharing
Borederlands: The Pre-Sequel: https://drive.google.com/file/d/1CEZON5 ... sp=sharing
Dr_Cosmobyte:
Disrputor: https://drive.google.com/file/d/15dSBmG ... share_link
Death_Ripper666:
Doom 2016: https://www.mediafire.com/file/eb444xie ... 6.zip/file
Painkiller: https://www.mediafire.com/file/1gcjyayc ... T.zip/file
Dusk: https://www.mediafire.com/file/kygfqgyv ... 2.zip/file
Painkiller: Black Edition: https://www.mediafire.com/file/djtnqsoi ... T.zip/file
Painkiller: Overdose: https://www.mediafire.com/file/pw27tx68 ... 2.zip/file
Painkiller Resurrection: https://www.mediafire.com/file/is8x7b7s ... T.zip/file
Disruptor: https://www.mediafire.com/file/q9i4h387 ... 2.zip/file (For some reason some tracks seem to be unused)
Return to Castle Wolfenstein: https://www.mediafire.com/file/nnycnmpp ... 2.zip/file
Resident Evil 1 remake: https://www.mediafire.com/file/j5s50yci ... e.zip/file
Resident Evil 2: https://www.mediafire.com/file/rfxit9rw ... 2.zip/file
Resident Evil 3: https://www.mediafire.com/file/uldb3el4 ... 3.zip/file
Resident Evil 4: https://www.mediafire.com/file/mk4rj2ju ... 4.zip/file
Shellshock 2: https://www.mediafire.com/file/ih617x1q ... 2.zip/file
Doom Eternal Ancient Gods: https://www.mediafire.com/file/q1nrrqsq ... G.zip/file
Conflict: Vietnam: https://www.mediafire.com/file/zi26yswd ... V.zip/file
Resident Evil Remake (Remastered): https://www.mediafire.com/file/fd9cfaun ... d.zip/file
Aliens Colonial Marines: https://www.mediafire.com/file/nyss66z ... M.zip/file
Splinter Cell: https://www.mediafire.com/file/diy4vlec ... l.zip/file
Syphon Filter: https://www.mediafire.com/file/lfedxth7 ... r.zip/file
Syphon Filter 2: https://www.mediafire.com/file/avba88sx ... 2.zip/file
Syphon Filter 3: https://www.mediafire.com/file/bf0ee5pl ... 3.zip/file
X2 Wolverine Revenge: https://www.mediafire.com/file/qakbfm9w ... e.zip/file
Goldeneye 007 (N64): https://www.mediafire.com/file/9qpr5s4r ... 7.zip/file
Resident Evil Code Veronica X: https://www.mediafire.com/file/cebgeo12 ... V.zip/file
Syphon Filter The Omega Strain: https://www.mediafire.com/file/r16zhxqu ... n.zip/file
Dino Crisis: https://www.mediafire.com/file/si24j8cy ... s.zip/file
Dino Crisis 2: https://www.mediafire.com/file/49ddzd24 ... 2.zip/file
Resident Evil 2 Remake: https://www.mediafire.com/file/xtmhv5zt ... e.zip/file
Manhunt: https://www.mediafire.com/file/cxfa92b8 ... t.zip/file
Mortal Kombat Shaolin Monks: https://www.mediafire.com/file/x3ord25d ... M.zip/file
Spec Ops: The Line: https://www.mediafire.com/file/p44spsao ... e.zip/file
Gungrave: https://www.mediafire.com/file/2sjk0o96 ... 2.zip/file
Eggs:
Company of Heroes 1: https://drive.google.com/file/d/1IAqW7R ... sp=sharing
Alien vs Predator 2010: https://www.mediafire.com/file/zjd9iyea ... 0.zip/file
Ltmajordude:
Hotline Miami 1: https://www.dropbox.com/sh/jvi5hcsmpcxo ... _puxa?dl=0 (Make sure to extract and run gzdoom with DMus_HM1.zip)
D3athStalker:
Devil May Cry (first 3 games): https://mega.nz/file/M8YHXAbS#YSBE8ILWS ... NwS7UC_Nhg
Kominate:
Punisher: https://drive.google.com/file/d/1E14M6o ... sp=sharing
Max Payne 1 & 2: https://drive.google.com/file/d/1c0sqm0 ... share_link
The Jangler:
Homestuck: https://www.mediafire.com/file/i4fxzr077b4nshw

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!

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!

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

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

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.

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?

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.

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

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)

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

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.

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)

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?)

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