Skip to content
RetroBIOS

UZDoom

UZDoom emulates Doom, Heretic, Hexen and 2 more systems. It reads 43 files, none of them required: it starts games without them.

About this profile
Detail Value
Type standalone
Classification Game engine
Source https://github.com/UZDoom/UZDoom
Version 5.0.3
Revision UZDoom/UZDoom@7910df710203
Profiled 2026-10-20
Profile YAML, JSON
Cores uzdoom
Systems Doom, Heretic, Hexen, Strife, Chex Quest
Install this emulator's files

With RetroBat: the installer finds RetroBat and its BIOS folder, then downloads only the files UZDoom reads there and checks each one.

Open the Start menu. Type PowerShell and open it. Paste the line. Press Enter.

PowerShell
&([scriptblock]::Create((irm https://raw.githubusercontent.com/Abdess/retrobios/main/install.ps1))) --emulator uzdoom
Technical notes

Doom-engine source port continued from GZDoom under a new name. The engine resource archive is uzdoom.pk3, the default soundfont uzdoom.sf2 and the configuration uzdoom.ini. The IWAD definitions in iwadinfo.txt are the ones GZDoom carries, line for line.

Engine resources (built from wadsrc*/static/ via add_pk3): uzdoom.pk3 BASEWAD, searched by BaseFileSearch ref: src/version.h:85, src/d_main.cpp:4148-4151 game_support.pk3 OPTIONALWAD, filter/game assets per IWAD ref: src/version.h:87, src/d_main.cpp:4205 lights.pk3 dynamic light definitions brightmaps.pk3 brightmap textures game_widescreen_gfx.pk3 widescreen HUD/menu replacements The last three are skipped for shareware IWADs and with -noextras. ref: src/d_main.cpp:2392-2412

Game data is a user-supplied IWAD. The search directories are scanned for the file names of the iwadinfo.txt Names block and for any .iwad, .ipk3 or .ipk7 file. Each candidate is then identified by its lumps, not by its name. The Names block also lists doomu.wad, doom1.wad, bfgdoom.wad, bfgdoom2.wad, freedoomu.wad, freedoom.wad, hereticsr.wad, heretic1.wad, hexendemo.wad, hexdemo.wad, strife0.wad and strife.wad. ref: wadsrc_extra/static/iwadinfo.txt:650-703, src/d_iwad.cpp:518-546

Startup refuses to run if BASEWAD (uzdoom.pk3) is absent, and stops with "Cannot find a game IWAD" when no candidate is identified. ref: src/d_main.cpp:4148-4151, src/d_iwad.cpp:816

RetroBat starts uzdoom.exe with -iwad on the IWAD it finds in the ROM folder and writes that folder into the IWADSearch.Directories section of uzdoom_portable.ini.

Hashes of the engine resources are those of the files in the 5.0.3 Windows release archive (Windows-UZDoom-Release-x86_64.zip, sha256 3a41131845415bc4bb5474f8de301a77736bd858e2ab489926325a2675e8263f, built from this commit). They are rebuilt with every release.

Files

Section titled “Files”

43 files: 0 required, 43 optional. 8 more files come with the app.

By kind: 51 game data.

51 rows
File Required Hash
doom.wad no -
doom2.wad no -
doom2f.wad no -
doombfg.wad no -
doom2bfg.wad no -
doomunity.wad no -
doom2unity.wad no -
doomkex.wad no -
doom2kex.wad no -
doomxbox.wad no -
doom2xbox.wad no -
doom_complete.pk3 no -
plutonia.wad no -
plutoniaunity.wad no -
plutoniakex.wad no -
tnt.wad no -
tntunity.wad no -
tntkex.wad no -
nerve.wad no -
nerveunity.wad no -
extras.wad no -
soundtrack no -
id24res.wad no -
freedoom1.wad no -
freedoom2.wad no -
freedm.wad no -
heretic.wad no -
blasphem.wad no -
hexen.wad no -
hexdd.wad no -
strife1.wad no -
sve.wad no -
voices.wad no -
chex.wad no -
chex3.wad no -
hacx.wad no -
hacx2.wad no -
action2.wad no -
harm1.wad no -
square.pk3 no -
square1.pk3 no -
delaweare.wad no -
rotwb.wad no -
uzdoom.pk3 with the app MD5 fee855c33d28
game_support.pk3 with the app MD5 5bc45497dee7
lights.pk3 with the app MD5 faeb9de6a307
brightmaps.pk3 with the app MD5 3de91b4ea157
game_widescreen_gfx.pk3 with the app MD5 e7dee49bb28e
soundfonts/uzdoom.sf2 with the app MD5 f306ebc541a4
fm_banks/GENMIDI.GS.wopl with the app MD5 29570afc6cce
fm_banks/gs-by-papiezak-and-sneakernets.wopn with the app MD5 4978fd39a6d7

In this collection: 23 in repo and 20 missing.

Game data

Section titled “Game data”
43 files

doom.wad optional in repo game data

  • The Ultimate DOOM and DOOM Registered both use this name and are told apart by their lumps.

doom2.wad optional in repo game data

doom2f.wad optional in repo game data

doombfg.wad optional missing game data

doom2bfg.wad optional missing game data

doomunity.wad optional missing game data

doom2unity.wad optional missing game data

doomkex.wad optional missing game data

doom2kex.wad optional missing game data

doomxbox.wad optional missing game data

doom2xbox.wad optional missing game data

doom_complete.pk3 optional missing game data

plutonia.wad optional in repo game data

plutoniaunity.wad optional missing game data

plutoniakex.wad optional missing game data

tnt.wad optional in repo game data

tntunity.wad optional missing game data

tntkex.wad optional missing game data

nerve.wad optional missing game data

  • No Rest for the Living. Autoloaded by Doom 2 BFG and Xbox editions.

nerveunity.wad optional missing game data

  • Loaded from the IWAD directory by DOOM 2: Unity Edition.

extras.wad optional missing game data

  • Loaded from the IWAD directory by the KEX and Unity editions.

soundtrack optional missing game data

  • Loaded from the IWAD directory by the DOOM and DOOM 2 Unity editions.

id24res.wad optional missing game data

  • id24 resource WAD. SupportWAD of every id IWAD block, loaded when found and i_loadsupportwad is set.

freedoom1.wad optional in repo game data

freedoom2.wad optional in repo game data

freedm.wad optional in repo game data

heretic.wad optional in repo game data

  • System: Heretic
  • Both Heretic and Shadow of the Serpent Riders use this name and are told apart by the EXTENDED lump.

blasphem.wad optional in repo game data

  • System: Heretic
  • Aliases: blasphemer.wad

hexen.wad optional in repo game data

  • System: Hexen

hexdd.wad optional in repo game data

  • System: Hexen
  • Deathkings expansion. Requires hexen.wad (Required = Hexen: Beyond Heretic).

strife1.wad optional in repo game data

  • System: Strife

sve.wad optional missing game data

  • System: Strife
  • Veteran Edition. Required = Strife: Quest for the Sigil (loads voices.wad).

voices.wad optional in repo game data

  • System: Strife

chex.wad optional in repo game data

  • System: Chex Quest

chex3.wad optional in repo game data

  • System: Chex Quest

hacx.wad optional in repo game data

hacx2.wad optional in repo game data

  • Identified by the MAP01 map and the HACX-E lump, whatever the container: every candidate is opened by its magic, so a zip under this name is read as a pk3. The Hacx 2.0 repository builds that zip from src/, where hacx-e.txt is the HACX-E lump and maps/MAP01.wad the first map.

action2.wad optional in repo game data

harm1.wad optional in repo game data

square.pk3 optional missing game data

  • Absent from the Names block: picked up only when named with -iwad.

square1.pk3 optional in repo game data

delaweare.wad optional in repo game data

rotwb.wad optional in repo game data

Comes with the app

Section titled “Comes with the app”
8 files

uzdoom.pk3 comes with the app game data

  • Fonts, menus, zscript, textures. Fatal if absent. Shipped with the engine resources below in the Windows zip, the AppImage and RetroBat's uzdoom.7z.

game_support.pk3 comes with the app game data

  • Per-game filters under static/filter/ (doom.id, strife, hexen, heretic, chex...).

lights.pk3 comes with the app game data

brightmaps.pk3 comes with the app game data

game_widescreen_gfx.pk3 comes with the app game data

uzdoom.sf2 comes with the app game data

  • Path: soundfonts/uzdoom.sf2
  • Default soundfont, used when the soundfont directories hold none. Every file of those directories is taken by its content. fluid_patchset defaults to uzdoom, and when no soundfont carries that name the first SF2 found is used.

GENMIDI.GS.wopl comes with the app game data

  • Path: fm_banks/GENMIDI.GS.wopl
  • OPL3 bank copied next to the executable. fm_banks is one of the scanned soundfont directories.

gs-by-papiezak-and-sneakernets.wopn comes with the app game data

  • Path: fm_banks/gs-by-papiezak-and-sneakernets.wopn
  • OPN2 bank copied next to the executable.

Next steps

Section titled “Next steps”
.

Maintained by Abdess on GitHub. Report a problem.

Packs from release v2026.10.10, .

MIT for the tooling and metadata. BIOS and firmware files are third-party system software, preserved for personal backup, archival and interoperability.