WadFusion merges your provided DOOM, DOOM II, Master Levels, Final DOOM, No Rest for the Living, SIGIL, SIGIL II, and Legacy of Rust data into a single IPK3 file that can be played in GZDoom, with each game as its own entry in the episode list. This makes it very convenient to play all of classic DOOM's official releases without re-launching the game with different settings.
It's fine if you don't have all of the DOOM games, e.g. you have DOOM II but not Final DOOM — WadFusion will package up everything it can find.
If you're not a DOOM expert and just bought these games from GOG, or Steam, etc., see the Absolute Beginner's Guide section below.
Simply copy all of your WADs into the source_wads subfolder, then run WadFusion. A log will appear showing progress and any errors that arise.
If you're on Windows, run wadfusion.exe.
If you're on macOS or GNU/Linux, run the wadfusion.py Python script — Python 2 and 3 are both supported now.
WadFusion will create a new file called doom_complete.pk3, with all the game content in it. GZDoom will recognize the doom_complete.pk3 file as a valid IPK3 without any name change needed.
In rare cases, you may need to uncheck the source_wads folder's read-only status.
WadFusion is not a general-purpose tool for merging DOOM WADs; it is for merging official content only — it was created out of a desire for a "complete" version of retail DOOM and DOOM II. Please do not ask if WadFusion will support any specific WAD. If you want to add your own content to a custom IWAD, please either modify WadFusion's source code yourself, or simply edit the doom_complete.pk3 file that WadFusion generated. Please do not ask us for support when doing either, try consulting the ZDoom Wiki instead.
Here is the official list of WADs that WadFusion will recognize:
doom.wad, containing only episodes 1-3)doom.wad, containing episodes 1-4)doom2.wad)masterlevels.wad from the KEX-based re-release)tnt.wad and plutonia.wad)nerve.wad)sigil.wad and its optional music addon sigil_shreds.wad)sigil2.wad and optionally its MP3 soundtrack version sigil2_mp3.wad)id1.wad, id1-res.wad, id24res.wad, and iddm1.wad from the KEX-based re-release)sewers.wad and betray.wad (the two secret levels from the original Xbox port of DOOM)extras.wad (from the Unity or KEX-based re-releases)WadFusion requires id1-res.wad and id24res.wad for Legacy of Rust.
If WADs from the Unity or KEX-based re-releases are also included (must be named doomunity.wad, doom2unity.wad, tntunity.wad, plutoniaunity.wad or doomkex.wad, doom2kex.wad, tntkex.wad, plutoniakex.wad), WadFusion will extract widescreen assets from them. The versions of nerve.wad in these releases include a unique intermission screen. These versions can also be used as the main WADs for extraction, but do keep in mind that they are censored.
If extras.wad from the Unity or KEX-based re-releases is included, WadFusion will extract the official "secret revealed" sound, and some status bar icons that can be used by custom HUDs. If the version from the KEX-based re-release is used, WadFusion will also extract Andrew Hulshult's "IDKFA" covers of the DOOM and DOOM II soundtracks, which can be toggled from the WadFusion options mod menu in GZDoom.
None of the "official add-on" content from the Unity or KEX-based re-releases of DOOM and DOOM II is supported.
For SIGIL and SIGIL II, all the filenames for different releases of those WADs are also recognized; you shouldn't have to rename your original files. If sigil_shreds.wad is included, or if both versions of SIGIL II are included, WadFusion will extract both soundtracks, which can be toggled from the WadFusion options mod menu in GZDoom.
For the Master Levels Rejects to be integrated, all of the following WADs must be included:
masterlevels.wad from the KEX-based re-release)doom2.wad)doom.wad)cpu.wad)device_1.wad)dmz.wad)cdk_fury.wad)e_inside.wad)hive.wad)twm01.wad)mines.wad)anomaly.wad)farside.wad)trouble.wad)dante25.wad)achron22.wad)caball.wad)udtwid.wad)C:\Program Files (x86)\Steam\steamapps\common\Ultimate Doom\base..WAD extension to the source_wads subfolder where you extracted WadFusion.wadfusion.exe. A terminal window will pop up, showing which WAD files were found, and which episodes can be extracted. Press Y and then Enter to proceed. The terminal window will show progress as it generates the IPK3.doom_complete.pk3.doom_complete.pk3 file to GZDoom's folder.WadSmoosh was originally created by JP LeBreton. WadFusion is based on its source code. WadFusion uses the Omgifol Python library by Fredrik Johansson and Devin Acker.