How to Install dhewm3 and Get the Doom3 Game Data

Updated

dhewm3 is a source port of the original Doom3 (not Doom3 BFG), and installing it takes two separate pieces: the dhewm3 executables, which you download for free, and the Doom3 game data, which you must supply from a copy of the game you legally own. The dhewm3 project states plainly that while the Doom3 source code is released under the GPL, "you still need to legally own the game and provide dhewm3 the game data to play." So the install is really two tasks: get the engine, then point it at your own game files.

What dhewm3 is (and isn't)

dhewm3 is a source port of the original Doom3, not Doom3 BFG. If you want a BFG Edition port, the project points elsewhere (Chocolate DOOM-3-BFG). Compared with the original Doom3, dhewm3 adds many bugfixes, EAX-like sound effects on all operating systems and hardware via OpenAL Soft's EFX support, much better widescreen resolution support, 64-bit support, and a mod-independent Settings Menu.

One compatibility caveat matters before you start: dhewm3 "only supports old Mods if they either don't require their own game DLL or have been ported to dhewm3." If you plan to run a specific old mod, check the Mods page first.

Step 1: Get the dhewm3 executables

Download the engine from the project's GitHub releases. The current release noted on the site is dhewm3 1.5.5 (dated 2026-06-08), and the GitHub download includes builds for Windows and 64-bit Linux.

For macOS, use the signed and notarized build hosted at Mac Source Ports rather than the GitHub archive.

Platform summary:

Platform Where to get dhewm3
Windows GitHub release download
64-bit Linux GitHub release download
macOS Mac Source Ports (signed and notarized build)

The project is known to work on Windows, Linux, macOS, FreeBSD, OpenBSD, and AROS. More generally, it should work on — or be easily portable to — any system that supports OpenGL 1.4 with ARB shaders, SDL, and OpenAL. If your platform isn't in the known list, those three requirements are the things to check.

Step 2: Provide the Doom3 game data

dhewm3 does not ship the game. You need to legally own Doom3 and give dhewm3 the game data. The project's own "Getting the Doom3 Game Data" and "How to Install" sections cover the specifics of which files are needed and where they go; follow those rather than guessing at file layouts, since the exact required data files depend on your copy of the game.

The practical sequence:

  1. Install or locate your legally owned copy of Doom3.
  2. Collect the game data files from it as described in the project's install instructions.
  3. Place them where dhewm3 expects them.
  4. Launch dhewm3 and confirm it finds the data.

If dhewm3 starts but can't find the game data, the problem is almost always step 2 or 3 — the engine itself installed fine, but the data path or file set is wrong.

Optional extras worth knowing about

  • Widescreen GUIs: dhewm3 1.5.5 added support for widescreen GUIs, but it requires adjusting the .ui files. Arl created versions for the base game, Resurrection of Evil, and The Lost Mission, offered as an optional download (dhewm3-wide-guis-*.zip).
  • BC7-compressed textures: dhewm3 now supports BC7-compressed (BPTC) .dds textures, which offer better quality than the older S3TC/DXT/BC1-3 standard at the same size as DXT3-5. This is aimed at high-res retexturing packs; the first pack to use it is hidef2k by y2keeth.
  • Smoother framerate: 1.5.5 removed several sources of microstutter (including the old 60 vs 62.5fps problem), so the game should run smoother, especially with VSync.
  • Mod DLLs: dhewm3-mods provides DLLs for some newer mods, including ELDOOM, Grimm, HeXen: Edge Of Chaos Demo, and Real Gibs. Note that the Real Gibs page says it only works with the 32-bit version of dhewm3, but that refers to the realgibs.dll they ship — you can use their gamedata with the .dll/.so provided on dhewm3-mods, or build the library yourself. Blood Mod has been updated to v1.8 and now also supports Resurrection of Evil, and LibreCoop is now maintained as part of dhewm3-sdk.

Common sticking points

  • Expecting the download to include the game. It doesn't. The engine is free; the data is not.
  • Using the wrong macOS build. Grab the signed/notarized one from Mac Source Ports.
  • Assuming old mods just work. They only work if they don't need their own game DLL or have been ported to dhewm3.
  • Skipping the install docs. The "How to Install" section is the authoritative source for where the game data goes on your platform.