WadFusion — simple IWAD merge utility

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 just bought these games from GOG, or Steam, etc., and you aren't familiar with GZDoom and DOOM modding, see the Absolute Beginner's Guide section below.

Note: WadFusion requires GZDoom v4.14.1 or newer, it will not work with other engines.

Usage

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. A new file called doom_fusion.ipk3 will be created, with all the game content in it. It should be selectable in GZDoom as "DOOM Fusion".

Also included is a file called doom_fusion_widescreen_gfx.pk3, which adds super-ultra-widescreen assets courtesy of the Ultra-Widerpix854 project. DOOM Fusion will load it automatically if it's added to GZDoom's file directories. GZDoom's own widescreen assets are disabled in Fusion. (It's worth noting that the full Ultra-Widerpix854 project has some extra features not included with WadFusion, such as alternate versions for some graphics, sprite fixes, extended sky textures, and support for other DOOM-based games.)

Supported WADs

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. This includes any content from the 5th generation console ports. If you want to add your own content to a custom IPK3, either modify WadFusion's code yourself, or simply edit the IPK3 that WadFusion generates. Please try consulting the ZDoom Wiki first before asking for help. If you've created an addon for WadFusion, feel free to share it with the community on the Discussions section.

Here is the official list of WADs that WadFusion will recognize:

• DOOM (original registered version of doom.wad, containing only episodes 1-3)
• The Ultimate DOOM (retail version of doom.wad or doomu.wad, containing episodes 1-4)
• DOOM II (doom2.wad)
• Master Levels for DOOM II (the original 20 WAD files, or masterlevels.wad from the KEX-based re-release)
• Master Levels Rejects (see below for a full list of supported WADs)
• Final DOOM (tnt.wad and plutonia.wad)
• No Rest for the Living (nerve.wad)
• SIGIL (sigil.wad and its optional music addon sigil_shreds.wad)
• SIGIL II (sigil2.wad and optionally its MP3 soundtrack version sigil2_mp3.wad)
• Legacy of Rust (id1.wad, id1-res.wad, id24res.wad, and iddm1.wad from the KEX-based re-release)
• Xbox secret levels (sewers.wad and betray.wad from the original Xbox port of DOOM)
• Tech Gone Bad and Phobos Mission Control (e1m8b.wad and e1m4b.wad, John Romero's map remakes)
• Extras (extras.wad from the Unity or KEX-based re-releases)

WadFusion requires id1-res.wad and id24res.wad for Legacy of Rust.

If IWADs 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 the official widescreen assets from them. These versions can also be used as the main WADs for extraction, but do keep in mind that they are censored, and that WadFusion already comes with optional super-ultrawide assets.

The versions of nerve.wad in these re-releases include a unique intermission screen, but renaming them isn't necessary—WadFusion will recognize them, and they aren't censored the way the IWADs are.

If extras.wad from the re-releases is included, WadFusion will extract the official "secret revealed" sound, and some status bar icons that can be used by the custom alternate fullscreen HUD. 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 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 menu in GZDoom. The MP3 version of SIGIL II isn't supported on its own, the MIDI version must be included alongside it.

Tech Gone Bad and Phobos Mission Control are levels that were made as a warm-up exercise for John Romero's cancelled game, Blackroom. If they're included, enabling them in the WadFusion options menu in GZDoom will replace E1M8 or E1M4 in the Knee-Deep in the Dead episode.

Master Levels Rejects

For the Master Levels Rejects to be integrated, all of the following WADs must be included:

• Master Levels for DOOM II (the original 20 WAD files, or masterlevels.wad from the KEX-based re-release)
• DOOM II (doom2.wad)
• The Ultimate DOOM (doom.wad)
• The C.P.U. (cpu.wad)
• Device One (device_1.wad)
• The D.M.Z. (dmz.wad)
• The Fury (cdk_fury.wad)
• The Enemy Inside (e_inside.wad)
• The Hive (hive.wad)
• Doom2 Map14 Homage (twm01.wad)
• Mines of Titan (mines.wad)
• The Titan Anomaly (anomaly.wad)
• The Farside of Titan (farside.wad)
• Trouble on Titan (trouble.wad)
• Dante's Gate (dante25.wad)
• Crossing Acheron (achron22.wad)
• Caball (caball.wad)
• Ultimate Doom The Way id Did (udtwid.wad)

Note: Works of the Masters is not supported by WadFusion! Do not use the WADs included with it!

Absolute Beginner's Guide

1. Download WadFusion for Windows or macOS and GNU/Linux, and extract it to a folder.
2. Find the folder(s) where GOG / Steam installed your game(s).
   • For Steam on Windows, this will be something like
     C:\Program Files (x86)\Steam\steamapps\common\Ultimate Doom\base
3. Copy any files you find with a .WAD extension to the source_wads subfolder where you extracted WadFusion.
4. On Windows, launch wadfusion.exe. On macOS or GNU/Linux, run the wadfusion.py Python 3 script.
5. A terminal window will show which episodes can be extracted. Press Y and then Enter to proceed.
6. The terminal window will show progress as it generates the IPK3. When it finishes, press Enter to close the window. You should now have a file in the WadFusion folder called doom_fusion.ipk3.
7. Download doom_fusion_widescreen_gfx.pk3 to use widescreen assets with WadFusion.
8. Download GZDoom and extract it to a folder.
9. Copy the doom_fusion.ipk3 and doom_fusion_widescreen_gfx.pk3 files to GZDoom's folder.
10. Launch GZDoom and play!

Acknowledgements

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.