Installation: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
No edit summary
 
(93 intermediate revisions by 9 users not shown)
Line 1: Line 1:
'''Intended article audience:''' players, general users


=== Install on Windows ===
__TOC__
 
Install TDM on Windows
 
1.  Create a folder anywhere you like named "darkmod" (saved games will not load properly if you call it anything else).
 
2. Download the [http://www.bloodgate.com/mirrors/tdm/pub/pk4/tdm_update_win.zip TDM Updater]
 
3. Extract the '''tdm_update.exe''' from the downloaded ZIP and copy it into your '''darkmod''' directory.
 
4. Run tdm_update.exe. The installer will connect to one of our download mirrors and start the download process.
 
5. Be patient and wait. The download weighs > 2 GB and will probably take a while.
 
6. After installation, you’ll find an executable TheDarkMod.exe in your darkmod folder. Use this to start The Dark Mod.


== Installation ==


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.


== Prerequisites ==


{{important|headline=Important|text=The rest of this article is now out of date and refers to installing The Dark Mod versions 1.0-1.08.  The instructions for installing The Dark Mod 2.0 are somewhat different, as Doom3 is no longer required.}}
==== Operating Systems supported ====
*Windows (Vista/Win7/Win8/Win10/Win11)
*Linux


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


{{important|headline=Important|text=You'll need to install the [http://www.dramthethief.com/darkmod/files/DOOM3-1.3.1.exe Doom 3 patch 1.3.1] otherwise the Mod won't run. Furthermore, the new BFG edition of Doom 3 does not offer mod support, so this is a no go.}}
* Note: Microsoft no longer supports Vista or Win7


== Prerequisites ==
==== General ====
==== 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.
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.
 
==== Operating System ====
:*Windows (2000/XP/Vista/Win7)
:*Linux
:*MacOSX
 
==== Doom 3 Patch 1.3.1 ====
:In order to run The Dark Mod, you need to have the v1.3.1 patch for Doom 3 installed. See the [[#Weblinks|download section below]] for links, please use these links as there are some bad versions of this patch floating around some sites. Steam copies of Doom3 will already have the correct version and do not need to worry about this.


:*Linux users: make sure that the install path for Doom 3 is all lowercase (e.g. <code>/usr/local/lib/doom3</code>).
See the article [[Known System Configurations]] for a growing collection of system configurations and the corresponding user feedback.
:*Non-English Windows users: Some combinations of Doom 3 English and a non-English version of Windows can result in the patch installer having trouble or not offering an English option, please see [http://modetwo.net/darkmod/index.php?/topic/11815-trouble-patching-and-launching| this forum thread].


==== Hard Disk Space ====
==== Hard Disk Space ====
:A rough estimate of how disk space required is '''3-4gb'''. As TDM is under continual development this is likely to increase slowly over time.
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:
::* Doom 3 installation : 1.5 GB.
::* For the base TDM package you need another 2 GB.
::* Plus a variable amount of space you need for downloaded FM packages.
::* Plus a variable amount of space for screenshots, savegames, etc.
 
:*FM's (Fan Mission) sizes vary as they depends on the amount of custom content(models, textures etc) the FM author is packing in. Usually FMs are very small, if they're using the stock TDM content (1 to 10 MB). FM's with large amounts of custom content can be quite large (20-60mb+), all content however is pre-compressed. For more information please see [[Fan Missions for The_ Dark Mod]].
:*Savegames vary in size, they can be a few MB per save depending on the size of the FM.
:*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 ==
=== Install on Linux ===
# You need the native version of Doom 3 (non BFG edition). Installation on Linux is explained on Id's Doom 3 Linux FAQ([[#Weblinks|see below]]), where you will find download links and install instructions. Be sure to download the 1.3.1.1304-version (not the demo).
# 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.
# Create a folder <tt>~/.doom3/darkmod</tt> in your home directory. Mind the dot in the path.
# Download the Linux version of the [http://www.bloodgate.com/mirrors/tdm/pub/pk4/tdm_update_linux.zip TDM Updater] and save it to <tt>~/.doom3/darkmod/</tt>
# Extract ''tdm_update.linux'': <tt>unzip tdm_update_linux.zip</tt>
# Make ''tdm_update.linux'' executable: <tt>chmod +x tdm_update.linux</tt>
# Run the updater: <tt>./tdm_update.linux</tt>  It will connect to our mirrors and download the packages for you.
 
# 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>.
 
=== Install on Mac OSX ===
# Ensure that Doom 3 (non BFG edition) is patched to v1.3.1 RevA (which provides native support for Intel processors), see below for links.
# It is recommended that the "Doom 3" program folder is installed into the Application Support folder (i.e. <tt>~/Library/Application Support/Doom 3/</tt>). If Doom 3 is installed into a different location then additional steps will need to be followed.
# Download the experimental![OS X launcher]([http://www.fidcal.com/darkuser/OSX10_6_i386_malex.zip OSX10_6_i386_malex.zip]) and following file - download [http://www.bloodgate.com/mirrors/tdm/pub/pk4/mac/darkmod.zip darkmod.zip].)
# Create a folder called Darkmod inside the ~/<User.Name>/Library/Application Support/Doom 3/ folder. To get access user library folder, hold the option key while selecting go from the main menu.
# Copy the following files from the OSX10_6_i386_malex.zip into your ~/<User.Name>/Library/Application Support/Doom 3/darkmod folder:
* TDM.app (the one in the release folder)
* tdm_game03.pk4
* gdb.sh
* tdm_update.macosx
# Within the darkmod folder, double-click the tdm_update_helper.command file to begin downloading the latest release of TDM (approx 2GB).
# Start The Dark Mod by double-clicking the TDM.app application in your ~/Library/Application Support/Doom 3/darkmod folder.
 
==== Using a custom Doom 3 location ====
Until idTech4 is open sourced, there is some dependency on the Application Support folder, where FMs are currently downloaded to. If the Doom 3 folder is not located within Application Support, you'll need to do the following to allow TDM to function as intended:


# Open up a terminal window (if you don't know how to do this, type 'terminal' into the SpotLight search bar and press 'Enter' to run the terminal application).
Breakdown of the estimate:
# Type the command <tt>cd ~Library/Application\ Support/Doom\ 3/</tt> and press the 'Enter' key.
* Base TDM package takes around 3.5 GB of space.
# Enter the command 'mkdir darkmod' and then 'cd darkmod' to change to the new darkmod directory.
* 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 =)
# Create a symbolic link with the command <tt>ln /folder/darkmod/tdmlauncher.macosx tdmlauncher.macosx</tt> where /folder/ is the path to your "Doom 3" program folder.
* You also need some space for screenshots, savegames, etc --- negligible compared to the first two points.
# You should now be able to launch TDM by double clicking the tdmlauncher_helper.command script in your "Doom 3" program folder where TDM has downloaded.
* 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 )


==== tdmlauncher_helper.command ====
==== GPU Hardware ====
#!/bin/sh
export TDMDIR=`dirname "$0"`
exec "$TDMDIR/tdmlauncher.macosx" "$TDMDIR/../Doom 3.app/Contents/MacOS/Doom 3"


==== tdm_update_helper.command ====
* As of TDM 2.09, only OpenGL 3.3 and newer hardware are supported
#!/bin/sh
* As a general proviso, we recommend at least 512MB of Video RAM
export TDMDIR=`dirname "$0"`
cd "$TDMDIR"
chmod +x tdm_update.macosx
exec ./tdm_update.macosx
 
==== Known issues ====
The automatic restart (when installing a FM, or restarting from the Graphics screen) currently fails to relaunch TDM v1.06-1.08 occasionally. If this happens, TDM will need to be launched manually by running the launcher program or script.
 
==== Alternate instructions "10 Easy Steps" ====
 
Here's an instruction. "How to get TDM 1.08 working on Mac OSX in 10 easy steps."
 
1. Buy Doom 3 from the App Store and allow it to install.
2. Check version number. Open up Doom 3, hit Escape to skip the ID software cutscene, then hit ctrl+alt+~ to bring up the console. It should say 1.3.1.1304.
3. If the version number is not correct, I have uploaded the patch [https://docs.google.com/file/d/0B-q67oQkJY1mbWhBNTNVcWJILWc/edit?usp=sharing here]. Alternatively, get it [http://www.dramthethief.com/darkmod/files/Doom3Mac1.3.1RevA.dmg here] .
4. Get Malex' 1.08 build. I have uploaded it [https://docs.google.com/file/d/0B-q67oQkJY1mNWV3N0Y2MFhtSms/edit?usp=sharing here] so it doesn't require a login. Alternatively, get it from Malex' drive at http://www.mydrive.ch (login: "darkmod@malex984", Password: "darkmod"). Just navigate to the site and login with those credentials.
5. Unpack the file you downloaded to ~/LIbrary/Application Support/Doom 3/.
6. Open up Terminal, navigate to ~/Library/Application Support/Doom 3/darkmod. The following command will do the trick:
 
cd ~/Library/Application\ Support/Doom\ 3/darkmod
 
7. Next, run tdm_update.macosx with the following command (don't just go ctrl+click and run the script with Terminal, because the files it downloads will end up in your home folder):
 
exec ~/Library/Application\ Support/Doom\ 3/darkmod/tdm_update.macosx
 
8. Copy over TDM.app and tdm_game03.pk4 from /darkmod/release
 
Now for the fix.
 
9. Go to your Doom app, ctrl+click (or right click), select "Show Package Contents" and navigate to /Contents/Assets/base
10. Select everything that has "Pak" in it's name, and copy those files to ~/Library/Application Support/Doom 3/base
 
== Alternative Download Methods ==
If you have troubles running tdm_update, you can see if [[tdm_update|this page]] helps you. Otherwise, you can also use other download methods to get a initial copy of the mod. Visit [http://www.mindplaces.com/darkmod/downloads.php TDM Downloads].
 
 
 
== Launching The Dark Mod ==
Use the '''thedarkmod''' application to run The Dark Mod. This small application will take care of launching the Doom 3 process with the correct command line arguments. The application is available for all supported platforms.
 
* '''Windows:''' <tt>C:\Games\Doom3\darkmod\thedarkmod.exe</tt>
* '''Linux:''' <tt>~/.doom3/darkmod/thedarkmod.x86</tt>
** Before it can be run the first time, you must make '''tdmlauncher.linux''' executable: <br /><tt>chmod +x ~/.doom3/darkmod/thedarkmod.x86</tt>
* '''Mac OSX:''' <tt>~/Library/Application Support/Doom 3/darkmod/thedarkmod.macosx</tt>
** Before it can be run the first time, you must make '''thedarkmod.macosx''' executable: <br /><tt>chmod +x ~/Library/Application Support/Doom 3/darkmod/thedarkmod.macosx</tt>
 
'''Note:''' The application will also be used by the game itself when installing/re-installing/un-installing FM packages, so '''please don't delete tdmlauncher'''.
* See also [[Creating Desktop Shortcuts for TDM]].
* See also [[tdmlauncher in Gentoo Linux]]
 
==== Troubleshooting the application ====
The '''thedarkmod''' executable will generate a small logfile <tt>tdmlauncher.log</tt> each time it is invoked. The log file is located right next to the executable and might give some useful insight if the game fails to load.
 
==== Passing custom command line arguments ====
Some people like to have custom command line arguments to the game, which is supported by the executable. Open the <tt>dmargs.txt</tt> in your darkmod folder and add any arguments you'd like the application to pass to the Doom3 command line.
* See also [[Doom3 command line arguments]].


== First Startup ==
== First Startup ==
* Please take your time to read through [[The Dark Mod Gameplay]] article to get familiar with the game.
* 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 TDM gameplay. You should start this mission first even if you've played stealth games before.
* 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, like screen resolution and gameplay settings.
* 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.
* See also the [[Performance Tweaks]] article to make TDM run a little bit faster if you're on a lower end machine.
* If you encounter a problem please check the [[FAQ]] and failing that leave a post in the TDM Support forum.
* 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.


== Installing and Running Fan Missions ==
== Installing and Running Fan Missions ==
Line 169: Line 58:
Fan Missions can be downloaded from inside the TDM menu. Go to "New Mission" and click on "Get new 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 [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, this contains the content for all other languages than English.
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.
 
# Download the mission PK4 file - (IE7 may rename PK4s to zip, dont worry TDM looks for both pk4's and zip's).
# Drop the file into the fms/ folder, e.g. <tt>C:\Games\doom3\darkmod\fms\</tt> or <tt>~/.doom3/darkmod/fms</tt>
# Launch The Dark Mod.
# The mission should now be listed in your ''New Mission'' menu.
# Highlight the mission and select ''Install'' to install. TDM will automatically restart.
# Select ''New Mission'' and then ''Start this Mission'' on the upper left.


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


== DoomConfig.cfg Howto ==
Game configuration settings are stored in the file DoomConfig.cfg but there is one in every FM folder as well as base and darkmod folders. Normally you just use the Settings menu but if you want to manually change or add any settings you should read  [[DoomConfig.cfg]] to see how they all integrate together or you may lose some settings if you edit the wrong way.
== Weblinks ==
* Doom [http://www.dramthethief.com/darkmod/files/DOOM3-1.3.1.exe v1.3.1 patch for Windows]
* Doom v1.3.1 for Linux: [ftp://ftp.idsoftware.com/idstuff/doom3/ FTP] [http://zerowing.idsoftware.com:6969/ BitTorrent]
* Doom v1.3.1 RevA for Mac OSX (which provides native support for Intel processors): [http://support.aspyr.com/index.php/kb/article/000579 Doom v1.3.1 RevA] ([http://www.dramthethief.com/darkmod/files/Doom3Mac1.3.1RevA.dmg mirror])


== See also ==
== See also ==
* [[tdm_update]] - If you have trouble with running the installer/updater.
* [[FAQ]] - Frequently Asked Questions and their answers.
* [[FAQ]] - Frequently Asked Questions and their answers.
* [[Hosting 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