Installation: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
Crispy (talk | contribs)
Things that don't work in Linux section was out of date
 
(214 intermediate revisions by 19 users not shown)
Line 1: Line 1:
== Requirements ==
'''Intended article audience:''' players, general users


In order to install The Dark Mod, you need to have the 1.3.1 patch for Doom 3 installed. You can download the patch for Windows [http://208.49.149.118/TheDarkMod/Files/DOOM3-1.3.1.exe here].
__TOC__


It is recommended that the installation path for Doom 3 contains no blanks as it might cause problems with some of the tools. Additionally it is recommended to keep all the paths lower case. This is especially important as Doom 3 can also run on other platforms like Linux where pathnames are different depending on their case (i.e. /home/sparhawk/Doom3 is a different path than /home/sparhawk/doom3). Windows does not have such restrictions but it happened on some systems that there were still issues with paths, as Doom 3 has its own internal library of handling paths in a system independent way and therefore this might cause maps to break on some systems while they can work on others.
== Installation ==


Depending on the operating system additional requirements may apply. Doom 3 currently supports Windows, Linux and Mac platforms. Requirements for the various platforms will be added at a later point, when development has progressed to a state where it makes sense to ensure platform compatibillity.
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.


== Installing The Dark Mod ==
== Prerequisites ==


===Install on Windows===
==== Operating Systems supported ====
In order to install The Dark Mod, once the requirements have been satsified, you should download the package which is provided (insert link here). 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 it's blue window and can not be started. The downloaded archive must be extracted directly into the Doom 3 folder which will create a darkmod folder in there with all files neccessary to run the mod.
*Windows (Vista/Win7/Win8/Win10/Win11)
*Linux


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


You need the native version of Doom 3 installed and patched to v1.3.1. Download
* Note: Microsoft no longer supports Vista or Win7
[http://zerowing.idsoftware.com/linux/doom/ here].


On 64 bit systems, you also need the 32 bit compatibility libraries installed. On 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 dependecies. Otherwise, even the installer for Doom 3 will fail to run.
==== 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.


Instructions on how to install The Dark Mod on Linux will be added at a later point.
See the article [[Known System Configurations]] for a growing collection of system configurations and the corresponding user feedback.


== Running the Mod ==
==== 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.


(It is assumed that running a mod is consistent throughout the supported platforms. In case this turns out not to be true, we will add specific instructions for certain platforms later.)
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 )


===Loading the mod manually===
==== GPU Hardware ====


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. For later releases it is planned to create a total conversion, which means that we will provide menu screens for all the various settings to be done in a consistant style fitting to the The Dark Mod universe. Since this is still under development, TDM maps have to be loaded via console commands using "map <mapname>". For instructions on how to use the console please refer to the game manual or tutorials which can be found (insert link to general tutorial site).
* 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


===Using the command line or a shortcut (recommended)===
== 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 (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.


Alternatively The Dark Mod can be initialized directly from the command line (or via a shortcut from the desktop) by using the commandline
== Installing and Running Fan Missions ==
* '''Windows:''' "<path to Doom 3>/doom3.exe  set fs_game darkmod"
* '''Linux:''' "<path to Doom 3>/doom3  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.
Fan Missions can be downloaded from inside the TDM menu. Go to "New Mission" and click on "Get new missions".


== Things that don't work in Linux ==
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.


* The lightgem is not yet implemented. For now, you can get a (very) rough approximation by entering <tt>tdm_lg_weak 1</tt> in the console.
See the full article [[Installing and Running Fan Missions]] for a detailed explanation.


== Performance Tweaks ==
To make TDM run a little bit faster:


* Run it in fullscreen - about a 4fps increase.
== See also ==
* Turn down anisotropic filtering (in DoomConfig.cfg), cos it defaults to 8. - ~1-2fps increase.
* [[FAQ]] - Frequently Asked Questions and their answers.
* [[Hosting The Dark Mod]]


Here's to start. Of course there is the "Low/Medium/High/Ultra" settings, but those are obvious.  (Note: Do NOT use "Ultra" graphics setting, as this will result in not being able to see many textures)
{{installation}}
 
<div id="toc">
[[Main Page]] > [[Installation]]
</div>
 
[[Category:General]]

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