Installation: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
 
(188 intermediate revisions by 17 users not shown)
Line 1: Line 1:
{{important|headline=Installing ''Thief's Den''?|text=You can ignore this page. Instead, follow the instructions at this link: [[Thief%27s_Den#Installation|Thief's Den Installation]].}}
'''Intended article audience:''' players, general users
 
{{important|headline=Installing ''The Tears of Saint Lucia''?|text=You can ignore this page. Instead, follow the instructions at this link: [[Saint_Lucia|Saint Lucia Installation]].}}


__TOC__
__TOC__


{{important|headline=The instructions on this page are primarily intended for beta mappers and other new team members.|text=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.}}
== Installation ==
 
{{important|headline=Windows users|text=You'll need to install the [http://72.8.59.188/TheDarkMod/Files/DOOM3-1.3.1.exe Doom 3 patch 1.3.1] ([http://www.dramthethief.com/darkmod/files/DOOM3-1.3.1.exe mirror]) and copy the DevIL.dll (shipped with Darkmod) library to your C:\Windows\system32 folder otherwise D3 will crash.}}
 
== Requirements ==
You'll need a machine which is capable of running the Doom 3 game. Although the team is recommending adding more RAM and a bit more CPU to the basic requirements to be able to run the larger maps which can be quite demanding.
 
In order to install The Dark Mod, you need to have the v1.3.1 patch for Doom 3 installed. See the [[#Weblinks|download section below]] for links.
 
Make sure that the install path for Doom 3:
 
* does not contain any blanks (e.g. <code>C:/doom3</code> is ok, <code>C:/Program files/Doom3</code> is not)
* is in all lowercase (e.g. <code>/usr/local/lib/doom3</code> is ok, <code>/home/username/MyDoom</code> 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).
 
=== References ===
See the article [[Known System Configurations]] for a (hopefully growing) collection of system configurations and the corresponding user feedback.


== Installing The Dark Mod ==
The only official way to freshly install TDM is described on the [http://www.thedarkmod.com/downloads/ downloads page on website].<br>
In short:<br>
* Download the TDM Installer for your operating system from the [http://www.thedarkmod.com/downloads/ downloads page on website], unpack it in a folder and run the installer.<br>
* And if you want to update an existing TDM installation, see [[Update|the Update article]].<br>
<br>
If you are using Windows and find those instructions difficult, try using the Freyk's Unofficial Installer (download from the download page).<br>
<br>
And a large list of Official and ''unofficial & unsupported'' installation methods is provided in article [[Installer and Manual Installation]].
<br>
If you want help after trying reading the documentation above, please ask for it on "Tech Support" subforum.


===Install on Windows===
== Prerequisites ==
# This information is subject to change - we are currently writing an installation app.


===Install on Linux===
==== Operating Systems supported ====
*Windows (Vista/Win7/Win8/Win10/Win11)
*Linux


# You need the native version of Doom 3 installed and patched to v1.3.1, [[#Weblinks|see below]] for download links and install instructions.
Running TDM on Mac OS is unsupported, but possible in Wine.
# 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 <code>ia32-lib</code> and all its dependencies. Otherwise, even the installer for Doom 3 will fail to run.
# The downloaded DarkMod archive must be extracted into your own user's Doom 3 folder, which is usually under <code>/home/username/.doom3/</code> (substitute "username" with your own username, of course). This will create a <code>darkmod</code> folder in there, with all files necessary to run the mod.
# If you get an error about GLIBCXX_3.4.9, delete or rename the files <tt>/usr/local/games/doom3/libstdc++.so.6</tt> and <tt>/usr/local/games/doom3/libgcc_s.so.1</tt>.


== Running the Mod ==
* Note: Microsoft no longer supports Vista or Win7


=== Changing the screen resolution ===
==== General ====
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.
At a minimum, you'll need a machine which is capable of running the Doom 3 game on comfortably high settings. The team recommends adding more RAM and a bit more CPU to the basic requirements, however, otherwise running the larger maps will be difficult.


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.
See the article [[Known System Configurations]] for a growing collection of system configurations and the corresponding user feedback.


===Loading the mod manually===
==== Hard Disk Space ====
A rough estimate of how much disk space required is '''4-6 GB'''. As TDM is under continual development this is likely to increase slowly over time.


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.
Breakdown of the estimate:
* Base TDM package takes around 3.5 GB of space.
* Size of one Fan Mission varies from 10 MB to 400 MB (depending on amount of custom content). <br/> Total size of all fan missions ever released over 15 GB, but you don't have to download them all at once =)
* You also need some space for screenshots, savegames, etc --- negligible compared to the first two points.
* Windows 10 and newer have incredibly high Disk IO consumption. We advise that you use an SSD rather than HDD if you are on Windows 10+ <br>( or use RAID, a Hybrid HDD, Ramdisk software, Optane Memory, or a Flash Drive caching solution such as Primocache )


===Using the command line or a shortcut (recommended)===
==== GPU Hardware ====


Alternatively, The Dark Mod can be initialized directly from the command line (or via a shortcut from the desktop) by using the command line:
* As of TDM 2.09, only OpenGL 3.3 and newer hardware are supported
* As a general proviso, we recommend at least 512MB of Video RAM


* '''Windows:''' "<path to Doom 3>/doom3.exe  set fs_game darkmod"
== First Startup ==
* '''Linux:''' "<path to Doom 3>/doom3 +seta com_allowConsole 1 +set fs_game darkmod"
* Please take your time to read through [[The Dark Mod Gameplay]] article to get familiar with the game.
* TDM ships with a [[Training Mission (OM)|Training Mission]] which is designed to introduce you to the various gameplay elements TDM has to offer. It is recommended to play through this mission first, even if you've played other stealth games before.
* Adjust the settings in the menus if needed (like screen resolution and gameplay settings).
* See also the [[Performance Tweaks]] article to make TDM run a little bit faster if you're on a lower end machine.
* If the game doesn't start the first time, the game create logs. The following article provides more information: "[[Debugging_TDM_systemerrors|Debugging TDM Systemerrors]]"  
* In case of any problems, please read the [[Reporting Problem]] article.
* If you encounter a problem, please check the [[FAQ]]. If you can't find an answer there, you can leave a post in the TDM Support forum.


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.
== Installing and Running Fan Missions ==


Please see also the articles about [[Doom3 command line]] and [[Creating Desktop Shortcuts for Doom3]].
Fan Missions can be downloaded from inside the TDM menu. Go to "New Mission" and click on "Get new missions".


== Performance Tweaks ==
Alternatively, you can go to [http://www.thedarkmod.com/missions/ www.thedarkmod.com] to get hold of mission packages available for The Dark Mod. Each FM is contained in a PK4 file, which contains all the files necessary to run the mission. Sometimes missions also have an optional _l10n.pk4 file; these contain the content for all other languages than English.


See also [[Performance Tweaks]] to make TDM run a little bit faster.
See the full article [[Installing and Running Fan Missions]] for a detailed explanation.


== Weblinks ==


* Doom [http://72.8.59.188/TheDarkMod/Files/DOOM3-1.3.1.exe v1.3.1 patch for Windows] ([http://www.dramthethief.com/darkmod/files/DOOM3-1.3.1.exe mirror])
== See also ==
* Doom v1.3.1 for Linux: [ftp://ftp.idsoftware.com/idstuff/doom3/ FTP] [http://zerowing.idsoftware.com:6969/ BitTorrent]
* [[FAQ]] - Frequently Asked Questions and their answers.
* '''TODO:''' Insert download link to The Dark Mod
* [[Hosting The Dark Mod]]


{{installation}}
{{installation}}

Latest revision as of 02:02, 11 June 2024

Intended article audience: players, general users

Installation

The only official way to freshly install TDM is described on the downloads page on website.
In short:


If you are using Windows and find those instructions difficult, try using the Freyk's Unofficial Installer (download from the download page).

And a large list of Official and unofficial & unsupported installation methods is provided in article Installer and Manual Installation.
If you want help after trying reading the documentation above, please ask for it on "Tech Support" subforum.

Prerequisites

Operating Systems supported

  • Windows (Vista/Win7/Win8/Win10/Win11)
  • Linux

Running TDM on Mac OS is unsupported, but possible in Wine.

  • Note: Microsoft no longer supports Vista or Win7

General

At a minimum, you'll need a machine which is capable of running the Doom 3 game on comfortably high settings. The team recommends adding more RAM and a bit more CPU to the basic requirements, however, otherwise running the larger maps will be difficult.

See the article Known System Configurations for a growing collection of system configurations and the corresponding user feedback.

Hard Disk Space

A rough estimate of how much disk space required is 4-6 GB. As TDM is under continual development this is likely to increase slowly over time.

Breakdown of the estimate:

  • Base TDM package takes around 3.5 GB of space.
  • Size of one Fan Mission varies from 10 MB to 400 MB (depending on amount of custom content).
    Total size of all fan missions ever released over 15 GB, but you don't have to download them all at once =)
  • You also need some space for screenshots, savegames, etc --- negligible compared to the first two points.
  • Windows 10 and newer have incredibly high Disk IO consumption. We advise that you use an SSD rather than HDD if you are on Windows 10+
    ( or use RAID, a Hybrid HDD, Ramdisk software, Optane Memory, or a Flash Drive caching solution such as Primocache )

GPU Hardware

  • As of TDM 2.09, only OpenGL 3.3 and newer hardware are supported
  • As a general proviso, we recommend at least 512MB of Video RAM

First Startup

  • Please take your time to read through The Dark Mod Gameplay article to get familiar with the game.
  • TDM ships with a Training Mission which is designed to introduce you to the various gameplay elements TDM has to offer. It is recommended to play through this mission first, even if you've played other stealth games before.
  • Adjust the settings in the menus if needed (like screen resolution and gameplay settings).
  • See also the Performance Tweaks article to make TDM run a little bit faster if you're on a lower end machine.
  • If the game doesn't start the first time, the game create logs. The following article provides more information: "Debugging TDM Systemerrors"
  • In case of any problems, please read the Reporting Problem article.
  • If you encounter a problem, please check the FAQ. If you can't find an answer there, you can leave a post in the TDM Support forum.

Installing and Running Fan Missions

Fan Missions can be downloaded from inside the TDM menu. Go to "New Mission" and click on "Get new missions".

Alternatively, you can go to www.thedarkmod.com to get hold of mission packages available for The Dark Mod. Each FM is contained in a PK4 file, which contains all the files necessary to run the mission. Sometimes missions also have an optional _l10n.pk4 file; these contain the content for all other languages than English.

See the full article Installing and Running Fan Missions for a detailed explanation.


See also