Installation: Difference between revisions

From The DarkMod Wiki
Jump to navigationJump to search
(Things that don't work in Linux section was out of date)
(general cleanup, replace multiple references to speculations with facts :-)
Line 1: Line 1:
== Requirements ==
== Requirements ==


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].
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.


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.
Make sure that the install path for Doom 3:


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.
* does not contain any blanks (e.g. <code>C:/doom3</code> is ok, <code>C:/Programm 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.


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


===Install on Windows===
===Install on Windows===
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.
 
#Download the DarkMod package, [[#Weblinks|see below]].  
# In the distribution is a DLL contained named <code>DevIL.dll</code> 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 <code>windows/system32</code> 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.  
# 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===
===Install on Linux===


You need the native version of Doom 3 installed and patched to v1.3.1. Download
# You need the native version of Doom 3 installed and patched to v1.3.1, [[#Weblinks|see below]] for download links and install instructions.
[http://zerowing.idsoftware.com/linux/doom/ here].
# 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.
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.
 
Instructions on how to install The Dark Mod on Linux will be added at a later point.


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


===Loading the mod manually===
===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. 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).
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)===
===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 commandline
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"
* '''Windows:''' "<path to Doom 3>/doom3.exe  set fs_game darkmod"
* '''Linux:''' "<path to Doom 3>/doom3 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.
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]].


== Things that don't work in Linux ==
== Things that don't work in Linux ==
Line 45: Line 51:


* Run it in fullscreen - about a 4fps increase.
* Run it in fullscreen - about a 4fps increase.
* Turn down anisotropic filtering (in DoomConfig.cfg), cos it defaults to 8. - ~1-2fps increase.
* Turn down anisotropic filtering (in DoomConfig.cfg), because it defaults to 8. - ~1-2fps increase.
 
Of course there is the "Low/Medium/High/Ultra" settings, but do '''NOT''' use the"Ultra" graphics setting, as this will result in many textures not being shown.
 
== Weblinks ==
 
* Doom [http://208.49.149.118/TheDarkMod/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]
* '''TODO:''' Insert download link to The DarkMod


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)


<div id="toc">
<div id="toc">
Line 54: Line 67:


[[Category:General]]
[[Category:General]]
{{todo}}

Revision as of 20:10, 22 October 2007

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:/Programm 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.

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.

Running the Mod

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.

Things that don't work in Linux

  • The lightgem is not yet implemented. For now, you can get a (very) rough approximation by entering tdm_lg_weak 1 in the console.

Performance Tweaks

To make TDM run a little bit faster:

  • Run it in fullscreen - about a 4fps increase.
  • Turn down anisotropic filtering (in DoomConfig.cfg), because it defaults to 8. - ~1-2fps increase.

Of course there is the "Low/Medium/High/Ultra" settings, but do NOT use the"Ultra" graphics setting, as this will result in many textures not being shown.

Weblinks


Retrieved from "https://wiki.thedarkmod.com/index.php?title=Installation&oldid=4601"