<p><strong>dhewm3</strong> is a source port of the original Doom3 (<strong>not</strong><em>Doom3 BFG</em>, for that you may want to try <ahref="https://github.com/RobertBeckebans/RBDOOM-3-BFG/">RBDoom3BFG</a>). It's known to work on Windows, Linux, macOS, <ahref="https://freebsd.org">FreeBSD</a>, <ahref="https://openbsd.org">OpenBSD</a> and <ahref="http://www.aros.org/">AROS</a>, but it should work on (or be easily portable to) any system that supports OpenGL 1.4 with <ahref="https://en.wikipedia.org/wiki/ARB_assembly_language">ARB shaders</a>, <ahref="http://libsdl.org">SDL</a> and <ahref="http://openal.org">OpenAL</a>.<br/>
Compared to the original version of Doom3, dhewm3 has many bugfixes, supports EAX-like sound effects on all operating systems and hardware (via <ahref="http://openal-soft.org/">OpenAL Softs</a> EFX support), has much better support for widescreen resolutions and has 64bit support.</p>
<p>It only supports <strong>old Mods</strong> if they <em>either</em> don't require their own game DLL <em>or</em> have been ported to dhewm3 - see the <ahref="./mods.html">Mods page</a> for more information.</p>
<p>Note that while the Doom3 source code has been released under GPL, you still need to legally own the game and provide dhewm3 the game data to play. See the <ahref="#how-to-install">How to Install</a> section for more information.</p>
<p>A first Release Candidate of the upcoming 1.5.1 release is available!</p>
<p>You can <strong><ahref="https://github.com/dhewm/dhewm3/releases/tag/1.5.1_RC1">download it at Github</a></strong> (incl. builds for Windows and 64bit Linux)</p>
<p><ahref="./dhewm3-edit.jpg"title="DOOMEdit running in dhewm3"><imgsrc="./medium-dhewm3-edit.jpg"style="max-width:90%;margin-left:auto;margin-right:auto;display:block"></a></p>
<p><strong>Changes since 1.5.0:</strong></p>
<ul>
<li>The (Windows-only) integrated <strong>editing tools</strong> of Doom3 are back!
<ul>
<li>They can only be built with non-Express versions of Visual Studio (tested Community Editions of VS2013 and VS2017) and can be disabled via CMake</li>
<li>Official dhewm3 Windows binaries are built with tools enabled, of course.</li>
<li>Only supports 32bit builds, because in contrast to the rest of dhewm3's code, the tool code is not 64bit compatible at all.</li>
<li>Based on Code from the dhewm3 branch of SteelStorm2, thanks to <em>Motorsep</em> for donating that code!</li>
<li>Has some bugfixes over the state in Doom3 1.3.1, like selecting a material in the Particle Editor doesn't break the viewport of the game any more.</li>
</ul></li>
<li>While prior dhewm3 releases for Windows have been built with Visual Studio 2010, this is built with Visual Studio 2017, so if it doesn't start on your system make sure you have <ahref="https://support.microsoft.com/en-us/help/2977003/the-latest-supported-visual-c-downloads">the Visual C++ 2017 Redistributable</a> installed - but chances are good you already have it.
<ul>
<li>Also updated some DLLs that are bundled with the Windows release:<br/>
<ahref="https://libsdl.org">SDL2 2.0.12</a>, <ahref="https://openal-soft.org/">OpenAL-soft 1.20.1</a> and <ahref="https://curl.haxx.se">curl 7.70.0</a></li>
</ul></li>
<li>dhewm3 now supports the <strong>Doom3 Demo</strong> gamedata
<ul>
<li>See <ahref="#using-the-doom3-demo-gamedata">below</a> for installation instructions</li>
<li>This is based on <em>Gabriel Cuvillier's</em> code for <ahref="http://www.continuation-labs.com/projects/d3wasm/">D3Wasm</a>, which ports dhewm3 to web browsers, thanks!</li>
</ul></li>
<li>Several sound-related bugfixes:
<ul>
<li>Lags in starting to play a sound which for example caused the machinegun or plasmagun sounds to stutter have been eliminated (<ahref="https://github.com/dhewm/dhewm3/issues/141">#141</a>)</li>
<li>Trying to reset disconnected OpenAL devices, this esp. helps with display audio on Intel GPUs on Windows, when switching to fullscreen (<ahref="https://github.com/dhewm/dhewm3/issues/209">#209</a>)</li>
<li>Looping .wav sounds with leadin now work (<ahref="https://github.com/dhewm/dhewm3/issues/291">#291</a>)</li>
<li>The game still works if no sound devices are available at all (<ahref="https://github.com/dhewm/dhewm3/issues/292">#292</a>)</li>
<li>Make "idSoundCache: error unloading data from OpenAL hardware buffer" a Warning instead of an Error so it doesn't terminate game (by <em>Corey O'Connor</em>, <ahref="https://github.com/dhewm/dhewm3/pull/235">#235</a>)</li>
</ul></li>
<li>Restore "Carmack's Reverse" Z-Fail stencil shadows; use <code>glStencilOpSeparate()</code> if available
<ul>
<li>That bloody patent finally expired last October: <ahref="https://patents.google.com/patent/US6384822B1/en"class="uri">https://patents.google.com/patent/US6384822B1/en</a></li>
<li>This neither seems to make a visual nor performance difference on any hardware I tried (including Raspberry Pi 4), so this is mostly out of principle</li>
<li>Based on Code by <ahref="https://github.com/ljbade/doom3.gpl/commit/d4de024341e79e0ac1dfb54fb528859f8ccea605"><em>Leith Bade</em></a> and <ahref="https://github.com/raynorpat/Doom3/blob/2933cb554587aea546c2df1fdf086204d4ca363d/neo/renderer/draw_stencilshadow.cpp#L147-L182"><em>Pat Raynor</em></a>.</li>
<li>The <code>r_useCarmacksReverse</code> and <code>r_useStencilOpSeparate</code> CVars allow switching both things on/off for comparison</li>
</ul></li>
<li>New CVar <code>g_hitEffect</code>: If set to <code>0</code>, the player camera damage effects (like double-vision and extreme tilt) when being hit are disabled (by <em>dobosken</em>, <ahref="https://github.com/dhewm/dhewm3/pull/279">#279</a>).</li>
<li>(On Windows) stdout.txt and stderr.txt are not saved next to the binary anymore, but in <code>My Documents/My Games/dhewm3/</code>, like save games, because the binary dir might not be writable and dhewm3 wouldn't start properly then</li>
<li>Registering multiplayer servers at id's master-server fixed, so they can be found in the multiplayer menu (by <em>Stradex</em>, <ahref="https://github.com/dhewm/dhewm3/pull/293">#293</a>)</li>
<li>Support for <ahref="https://en.wikipedia.org/wiki/Reproducible_builds">reproducible builds</a> by setting the CMake option <code>REPRODUCIBLE_BUILD</code>.</li>
<p><details><summary>Click to see the rest of this (outdated) newspost</summary><ahref="./dhewm3-edit.jpg"title="DOOMEdit running in dhewm3"><imgsrc="./medium-dhewm3-edit.jpg"style="max-width:90%;margin-left:auto;margin-right:auto;display:block"></a></p>
<li>The (Windows-only) integrated <strong>editing tools</strong> of Doom3 are back!
<ul>
<li>They can only be built with non-Express versions of Visual Studio (tested Community Editions of VS2013 and VS2017) and can be disabled via CMake</li>
<li>The <ahref="https://github.com/dhewm/dhewm3/releases/tag/1.5.1_PRE1">dhewm3_1.5.1pre1_win32.zip available on Github</a> has them enabled, of course
<ul>
<li>While prior dhewm3 releases have been built with Visual Studio 2010, this is built with Visual Studio 2013, so if it doesn't start on your system make sure you have <ahref="https://www.microsoft.com/en-us/download/details.aspx?id=40784">the Visual C++ 2013 Redistributable</a> installed - but chances are good you already have it.</li>
</ul></li>
<li>Only tested in 32bit builds, in contrast to the rest of dhewm3's code, the tool code might not be 64bit-clean</li>
<li>Based on Code from the dhewm3 branch of SteelStorm2, thanks to Motorsep for donating that code!</li>
<li>Has some bugfixes over the state in Doom3 1.3.1, like selecting a material in the Particle Editor doesn't break the viewport of the game any more.</li>
</ul></li>
<li>dhewm3 now supports the <strong>Doom3 Demo</strong> gamedata (<ahref="https://www.fileplanet.com/archive/p-15998/DOOM-3-Demo">D3Demo.exe</a> or <ahref="http://files.holarse-linuxgaming.de/native/Spiele/Doom%203/Demo/doom3-linux-1.1.1286-demo.x86.run">doom3-linux-1.1.1286-demo.x86.run</a>)
<ul>
<li>On Windows, just run D3Demo.exe to install the demo, on Linux (and probably others) you can extract the relevant file from the .run installer with <code>sh doom3-linux-1.1.1286-demo.x86.run --tar xf demo/</code></li>
<li>This is based on Gabriel Cuvillier's code for <ahref="http://www.continuation-labs.com/projects/d3wasm/">D3Wasm</a>, which ports dhewm3 to web browsers, thanks!</li>
<li>(On Windows) stdout.txt and stderr.txt are not saved next to the binary anymore, but in <code>My Documents/My Games/dhewm3/</code>, like save games, because the binary dir might not be writable and dhewm3 wouldn't start properly then </details></li>
<li>Support for <ahref="./mods.html">some Mods</a> via <ahref="https://github.com/dhewm/dhewm3-sdk">custom SDK</a>: Classic Doom3, Fitz Packerton, HardQore2, Denton's Enhanced Doom3 and Rivensin (formerly known as Ruiner).
<li><ahref="https://github.com/dhewm/dhewm3/releases/download/1.5.0/dhewm3_1.5.0_win32.zip">dhewm3-mods_1.5.0_win32.zip</a> contains prebuild Windows game DLLs for those Mods (except Rivensin) and a README that tells you where to get the game data</li>
<li>See <ahref="./mods.html">the Mods page</a> for more information.</li>
<li>This has also broken backwards compatibility with 1.4.x game DLLs, that's why this version will be 1.5.0 and not 1.4.2.</li>
</ul></li>
<li>Supports High DPI displays on Windows now</li>
<li>Scale menus, fullscreen videos and the PDA to 4:3 (with black bars left/right) on widescreen displays so they don't look stretched/distorted. Can be disabled with <code>r_scaleMenusTo43 0</code>.<br/>
No, this unfortunately can't be done for the HUD (except for the crosshair), because it also handles fullscreen effects (for example when receiving damage), and those would look bad with black/empty bars on left/right.</li>
<li>Commandline option to display some help on supported commandline arguments: <code>-h</code> or <code>--help</code> or <code>-help</code> or <code>/?</code></li>
<li><del>(Experimental) uncapped framerate, enable by entering <code>com_fixedTic -1</code> in the console (can be set back with <code>com_fixedTic 0</code>).</del> (<ahref="https://github.com/dhewm/dhewm3/issues/261">this turned out to be broken</a>)</li>
<li>Providing binaries for Linux amd64 (x86_64) now
<ul>
<li>Should work on any halfway-recent distro, needs <code>libSDL2-2.0.so.0</code>, <code>libopenal.so.1</code> and <code>libcurl.so.4</code> installed</li>
<li>Updated some libraries bundled in the Win32 build: <ahref="https://libsdl.org">SDL2 2.0.9</a>, <ahref="https://openal-soft.org/">OpenAL-soft 1.19.1</a> and <ahref="https://curl.haxx.se">curl 7.62.0</a></li>
<p>I guess it makes sense to be a bit less dependent on Github (especially as it has been bought by Microsoft, but also in general), so I decided to create this homepage with a domain I control.<br/>
Another advantage is that it has some screenshots and more user-centric documentation than the <ahref="https://github.com/dhewm/dhewm3/blob/master/README.md">README.md</a>.<br/>
We'll continue to use Github for hosting the code and issues (and indeed this page via github pages), but if we need to migrate to another hoster some day, <ahref="http://dhewm3.org">dhewm3.org</a> will still be reachable and will link to the new code repo and issue tracker instead.</p>
<li>Fixed some (kinda rare) crashes due to assertion errors, especially observed in the last boss fights of both doom3 and the Resurrection of Evil Addon.</li>
<li>Improved compatibility with AZERTY keyboards (the row of keys with 1...9, 0 is now usable)</li>
<li>Fixed a crash (at least on FreeBSD) when loading Resurrection of Evil's last level</li>
<li>Compatibility with Microsoft Visual Studio 2015</li>
<li>Video resolutions in menu now sorted, added 2880x1800</li>
<h3id="from-cddvd-patch">... from CD/DVD + Patch</h3>
<p>If you bought the game on CDs/DVD, base/pak000.pk4 - pak004.pk4 and d3xp/pak000.pk4 can be copied from the disks, the other files are from the patch.</p>
<p>On <strong>Linux</strong> (and probably other <strong>Unix-like</strong> systems and maybe even Windows with a mingw shell) you can extract the needed files from <ahref="https://files.holarse-linuxgaming.de/native/Spiele/Doom%203/doom3-linux-1.3.1.1304.x86.run">the official 1.3.1 patch for Linux</a> with:</p>
<p>On <strong>Windows</strong> you can just install the game and <ahref="https://archive.org/details/Doom_3_1.3.1">the official 1.3.1 patch for Windows</a> and then get the files from the installation directory (or copy dhewm3 in there).</p>
<h3id="from-steam">... from Steam</h3>
<p>First you need to buy <ahref="http://store.steampowered.com/app/9050/">Doom3</a> of course (and the <ahref="https://store.steampowered.com/app/9070/">Resurrection of Evil Addon</a>, if you want that too; Note that the Addon is not available in Germany).</p>
<p>Thankfully the game from Steam is already fully patched to 1.3.1.</p>
<p>On <strong>Windows</strong>, <em>just install</em> it and copy the game data from there (see above for what files are needed).</p>
<p>Same on <strong>Linux</strong>, thanks to Steam Play / Proton, though you might have to enable it:<br/>
In Steam in the <code>Steam</code> âž” <code>Settings</code> menu, under <code>Steam Play</code>, check both:</p>
<blockquote>
<p>☑ Enable Steam Play for supported titles<br/>
☑ Enable Steam Play for all other titles</p>
</blockquote>
<p>On <strong>macOS</strong> unfortunately you can't just install the game (unless you run Windows Steam in Wine), because it's Windows-only on Steam and Steam (currently?) doesn't use Proton on Mac.</p>
<p>However, you can still download it with <strong><ahref="https://developer.valvesoftware.com/wiki/SteamCMD">SteamCMD</a></strong>.<br/>
See <ahref="https://developer.valvesoftware.com/wiki/SteamCMD#macOS">this description for macOS</a> or <ahref="https://developer.valvesoftware.com/wiki/SteamCMD#Linux">here for Linux</a> on how to install SteamCMD on your system. You won't have to create a new user.</p>
<p>(replace <code><YOUR_STEAM_LOGIN_NAME></code> with your steam login name)<br/>
When it's done you should have the normal windows installation of doom3 in <code>./doom3/</code> and the needed files in <code>./doom3/base/</code><br/>
It should be possible to get the <em>Resurection of Evil</em> data in the same way, by replacing <code>9050</code> with <code>9070</code>; the files should be in <code>./doom3/d3xp/</code> then.</p>
<p>By the way, that number is the "AppID" of Doom3/RoE; if you wanna use this to get the data of other games you own, you can look up the AppID at <ahref="https://steamdb.info/">SteamDB</a>.</p>
<h3id="using-the-doom3-demo-gamedata">Using the Doom3 Demo gamedata</h3>
<p>First you need to download the Doom3 Demo, of course.</p>
<p>For <strong>Windows</strong>, you can get <ahref="https://www.fileplanet.com/archive/p-15998/DOOM-3-Demo">D3Demo.exe at Fileplanet</a> and just run the installer.</p>
<p>For <strong>Linux</strong> (and <strong>other operating systems</strong> that have a POSIX-compatible shell and <code>tar</code>) you can download <ahref="https://files.holarse-linuxgaming.de/native/Spiele/Doom%203/Demo/doom3-linux-1.1.1286-demo.x86.run">doom3-linux-1.1.1286-demo.x86.run from Holarse</a> or some other page that has that file.<br/>
Then you can extract the relevant file from the .run installer with</p>
<p>You'll need <code>demo/demo00.pk4</code> for playing, either in exactly that directory, or you can copy it into <code>base/</code>.<br/>
Note that you <strong>don't need the patches</strong> of the fullversion, adding their pk4s when using Demo gamedata breaks the game.</p>
<code>demo00.pk4</code> has a size of 462MB but for some reason there seem to be minimal differences between the one for Linux and Windows, so they have different md5sums:<br/>
<p>On <strong>Windows</strong> you can just download the Win32 binaries from the <ahref="https://github.com/dhewm/dhewm3/releases/latest">Download page</a>.<br/>
You can either extract them into your Doom3 installation directory, or into a fresh directory and copy the needed game data (<ahref="#getting-the-doom3-game-data">see above</a>) in there.<br/>
Similarly, you can find x86_64 (amd64) <strong>Linux</strong> binaries there.</p>
<p>On Linux and *BSD it might be that your package manager provides a dhewm3 package/port that you can install; please refer to that packages documentation on where to put the game data.<br/>
You could also try telling dhewm3 where to find the game data with:</p>
<p>If your package manager does not provide dhewm3 (or you're on macOS/OSX and there is none), or you want to use the very latest code, you'll have to compile it yourself. It's not super hard, see <ahref="https://github.com/dhewm/dhewm3/blob/master/README.md#compiling">the README</a> for details on compiling and <ahref="https://github.com/dhewm/dhewm3/wiki/FAQ#where-do-i-need-to-put-the-game-data-files">the FAQ</a> on where to put the game data.</p>
