Installation

Installing Thief's Den?

You can ignore this page. Instead, follow the instructions at this link: Thief's Den Installation.

Installing The Tears of Saint Lucia?

You can ignore this page. Instead, follow the instructions at this link: Saint Lucia Installation.

The instructions on this page are primarily intended for beta mappers and other new team members.

If you're installing either of our public mission releases, Thief's Den or The Tears of Saint Lucia, refer to the links given above.

Windows users

You'll need to install the Doom 3 patch 1.3.1 (mirror) and copy the DevIL.dll (shipped with Darkmod) library to your C:\Windows\system32 folder otherwise D3 will crash.

Requirements

In order to install The Dark Mod, you need to have the v1.3.1 patch for Doom 3 installed. See the download section below for links.

Make sure that the install path for Doom 3:

• does not contain any blanks (e.g. C:/doom3 is ok, C:/Program files/Doom3 is not)
• is in all lowercase (e.g. /usr/local/lib/doom3 is ok, /home/username/MyDoom is not)

The latter point is especially important for Linux.

Doom 3 currently supports Windows, Linux and Mac platforms, but The Dark Mod currently supports only Windows and Linux.

Space Requirements

This is only an estimation of the space requirements needed to play TDM missions. Keep in mind that development on TDM is going to continue over time and new stuff will be added all the time.

• For the D3 installation you roughly need 1.5 GB.
• For the base TDM 1.00 package you need another 1.6 GB.
• Plus a variable amount of space you need for downloaded FM packages.
• Plus a variable amount of space for screenshots, savegames, etc.

So the mininum can be estimated to be slightly above 3 GB.

It's difficult to give numbers about FM package size, as this depends on the amount of custom content the FM author is packing in. Usually FMs are very small, if they're using the stock TDM content (1 to 10 MB). Note: FMs are in PK4 (i.e. ZIP) format, so textures and mission files are shipped in compressed form.

Savegames are about 1.7 MB per save (there is a small 700 kB screenshot generated per savegame).

Screenshots depend on the screen resolution you're using (~2 MB per shot).

Installing The Dark Mod

Install on Windows

1. Download the DarkMod package, see below.
2. In the distribution is a DLL contained named DevIL.dll which is required for image handling. Since as the time of writing there is no installer, so the user must install this library himself. To do this the DLL must be copied in the windows/system32 directory. The DLL can also be put in any other directory where a path is pointing to (meaning that the directory is included in the PATH environment variable when Doom 3 is run). If the library is not found when the mod is loaded, Doom 3 will show its blue window and can not be started.
3. The downloaded archive must be extracted directly into the Doom 3 folder, which will create a darkmod folder in there, with all files necessary to run the mod.

Install on Linux

1. You need the native version of Doom 3 installed and patched to v1.3.1, see below for download links and install instructions.
2. Since there is no 64 bit version of either Doom 3 or The DarkMod, on 64 bit systems you also need the 32 bit compatibility libraries installed. On some distributions like SuSE, these are included in the default installation, but on Kubuntu/Ubuntu you need to install the package called ia32-lib and all its dependencies. Otherwise, even the installer for Doom 3 will fail to run.
3. The downloaded DarkMod archive must be extracted into your own user's Doom 3 folder, which is usually under /home/username/.doom3/ (substitute "username" with your own username, of course). This will create a darkmod folder in there, with all files necessary to run the mod.
4. If you get an error about GLIBCXX_3.4.9, delete or rename the files /usr/local/games/doom3/libstdc++.so.6 and /usr/local/games/doom3/libgcc_s.so.1.

Running the Mod

Changing the screen resolution

You can choose from the various screen resolutions in the main menu under "Settings". You'll have to restart the game for the changes to take effect.

Note to widescreen users: Doom 3 resolutions default to 4:3 screen aspect ratios. If you're running wide screens (e.g. 1280x800, 1440x900, 1680x1050) you'll need to set that ratio to 16:10 in the Video Settings.

Loading the mod manually

In order to run The Dark Mod, Doom 3 can be started normally. In the lower right corner you can see a button saying "MOD". Clicking on this button will cause a dialog to appear listing all the mods currently installed. You can select Darkmod by choosing the appropriate entry from the dialog and load it. This will cause Doom 3 to load the mod data and initialze the mod.

Using the command line or a shortcut (recommended)

Alternatively, The Dark Mod can be initialized directly from the command line (or via a shortcut from the desktop) by using the command line:

• Windows: "<path to Doom 3>/doom3.exe set fs_game darkmod"
• Linux: "<path to Doom 3>/doom3 +seta com_allowConsole 1 +set fs_game darkmod"

It is recommended to use this way of running The Dark Mod, as it appears that Doom 3 will handle paths more consistently then loading the mod manually.

Please see also the articles about Doom3 command line and Creating Desktop Shortcuts for Doom3.

Performance Tweaks

See also Performance Tweaks to make TDM run a little bit faster.

Weblinks

• Doom v1.3.1 patch for Windows (mirror)
• Doom v1.3.1 for Linux: FTP BitTorrent
• TODO: Insert download link to The Dark Mod