The DarkMod Wiki - User contributions [en]

Thief's Den

2008-10-02T02:17:35Z

Noerrorsfound: /* FAQ */ vid_restart for applying resolution changes

[[Image:Thiefs den splash.jpg|right]] Welcome to this short mission demo of [[The Dark Mod]]. Thief's Den is just a few rooms but it is a complete, fully playable mission, and includes a good selection of the main Dark Mod features. Keep in mind that The Dark Mod is still a work in progress and this is reflected in the demo. Voices are temporary placeholders, for example, and AI behaviour is not yet fully developed. You will certainly find bugs and glitches but we hope that doesn't spoil your enjoyment too much.

Any flaws or failings in this demo do not necessarily indicate limitations in The Dark Mod's potential but just this particular demo — which was originally begun as a very rough accompaniment to a mission development tutorial. It was never intended for release as a playable mission but was modified into a workable game so everyone could see the current state of progress and have some fun.

{{Important|headline=Important|text=We recommend you start the download then please read through this page and especially [[Thief's Den Gameplay]] while downloading. You cannot complete the mission without being aware of new features described on that page.}}

__TOC__
== Download ==
Choose a download mirror below. The download is about 200 Mbyte and works for both Windows and Linux. It's a self-extracting 7-zip archive, not a fully-fledged installer.

{{Important|headline=Important|text=
<br>
When the downloaded file does report errors during extraction, your download got corrupted, and you '''MUST''' download the file again. A package extracted only half or with errors will '''NOT''' run properly.

If you are unsure whether you got the right file, either use the torrent (it checks the file to be correct), or compare the [http://en.wikipedia.org/wiki/md5sum md5sum] of the download to <code>d162dfdb7b1c9f9a9d0aaac915a75099</code>.}}

'''Mirrors:'''
* [http://72.8.59.188/TheDarkMod/release/thiefs_den_v1.0.exe Darkmod FTP] (might be slow)
* [http://www.shadowdarkkeep.com/missions/thiefs_den_v1.0.exe Shadowdark Keep] (thanks to Komag!)
* [http://www.southquarter.com/fms/data/thiefs_den_v1.0.exe Southquarter] (thanks to Brethren!)
* [http://bloodgate.com/mirrors/tdm/ bloodgate.com] (North America, thanks to Tels)
* [http://www.thirdfilms.com/thiefs_den_v1.0.exe Third Films] (Thanks to Godismygoldfish)

* '''Torrent:''' [http://bloodgate.com/mirrors/tdm/pub/thiefs_den_v1.0.exe.torrent thiefs_den_v1.0.exe.torrent] (thanks to everybody helping to distribute)

== Installation ==
{{important|headline=Summary:|text=Don't be put off - all you need is Doom 3 installed with patch, extract our download into the Doom folder, then make/modify a desktop shortcut and you're playing!}}

You'll need the following to play the Thief's Den:
# Windows or Linux
# About '''500 Mbytes''' free disk space
# At least '''512 Mbyte''' system memory, better are '''1024 Mbyte''' or more
# A grafic card with at least '''64 Mbyte''' video memory, better are '''128 Mbyte''' or more
# A working Doom 3 installation
# Doom 3 must be patched to 1.3.1. You can download the correct patch (20 Mbyte) here:
#* '''Windows''': Doom [http://72.8.59.188/TheDarkMod/Files/DOOM3-1.3.1.exe v1.3.1 patch for Windows]
#* '''Linux''': Doom v1.3.1 for Linux: [ftp://ftp.idsoftware.com/idstuff/doom3/ FTP] [http://zerowing.idsoftware.com:6969/ BitTorrent]

Already patched Doom 3 before reading this? Make sure you have the correct version of the 1.3.1 patch. See the [[#FAQ|FAQ]] below.

=== Windows ===

Now proceed with the following steps. Substitute your own Doom 3 path for <tt>C:\games\doom3</tt>.

# [[#Download|Download]] thiefs_den.exe and copy it to <tt>C:\games\doom3</tt>.
# Run thiefs_den.exe. A thiefs_den folder will be created.
# In <tt>C:\games\doom3\thiefs_den</tt> is a file called <tt>DevIL.dll</tt>. You MUST copy this into your <tt>C:\games\doom3</tt> folder OR your <tt>C:\WINDOWS\system32</tt> folder (where it can be shared by other applications. If there is already one there then use the newest date.)
# Now you'll need to create a shortcut to the Thief's Den demo:
## Copy the existing Doom 3 shortcut on your desktop. Rename the copy "Thief's Den".
## Right-click, choose Properties and edit the command line. It should read
C:\games\doom3\DOOM3.exe +set fs_game thiefs_den

You're done! All you need to do is double-click the shortcut to run the demo. But before you do, '''please take a minute to read [[Thief's Den Gameplay]] for information on how to actually play The Dark Mod''' (many features will be familiar to Thief players, but there are important differences).

=== Linux ===

* [[#Download|Download]] thiefs_den.exe and copy it to the <code>.doom3</code> folder in your home directory. This directory might not be visible if you use a file manager like Konqueror, so use a console, Midnight Commander, or type ".doom3" into the location bar in Konqueror to navigate there.
* ''Either:''
*# Right-click on <tt>thiefs_den.exe</tt> and select "Open with Wine Windows Emulator" from the menu. Click OK and wait for the package to extract.
* ''Or:''
*# Install the package '''p7zip'''
*# In a console, type:
*# <tt>cd ~/.doom3</tt>
*# <tt>7z x thiefs_den.exe</tt>
* Copy the existing Doom 3 shortcut on your desktop to a new one and rename it to "Thief's Den".
* Right-click, open the properties of that shortcut, go to the "Application" or "Launcher" tab and edit the command line. It should read:
/usr/local/games/doom3/doom.x86 +seta com_allowConsole 1 +set fs_game thiefs_den
* Install the packages '''libmng''' and '''libdevil1c2''' (or '''libdevel1''', depending on distribution)
* Double-click the shortcut to run the game.
** If it doesn't start, please see the [[#FAQ|FAQ]]
* Open the Doom 3 console using the key below the Escape key ({{key|~}} on US keyboards), and compile the map by typing: <tt>dmap thiefs_den</tt>
* Click "Start Mission" to start the game.

== Playing Thief's Den, Settings ==

For information on changing settings, and on unique features of The Dark Mod and stealth gaming in general, see [[Thief's Den Gameplay]].

Note that you shouldn't expect The Dark Mod to run at the same settings as Doom3. TDM does far more processing, and uses higher resolution graphics, than Doom3 did. If your computer is close to the minimum specs to play Doom3, you will unfortunately have a laggy experience (or will have to turn your video settings down) with the demo. In this case, please refer to the [[Performance Tweaks]] article.

== The Mission, Objectives, Loot Count ==

You play a thief who has been double-crossed by another! Can you retrieve your ill-gotten gains and incriminate your adversary to divert the attention from you of the ruthless city watch? Full briefing and objectives are shown at the start of the mission.

You can play stealthily or use the weapons at your disposal to make it easier. There are no difficulty levels yet but as an extra challenge this mission can be ghosted without using any weapons including rope arrows.

End of mission statistics are not implemented yet. Total loot count for Thief's Den is 904. Good luck!

== Feedback ==
Of course we're anxious to hear your impressions about our Thief's Den Pre-Beta Release. There is a public feedback & discussion thread open in our forums: [http://modetwo.net/darkmod/index.php?showtopic=7082 Pre-Beta Discussion]. Please drop by and let us know what you think.
{{Important|headline=That being said,|text=don't rush into the forums and spend an hour writing up detailed bug lists of what's working and what you think needs fixing. It's very likely that we are already aware of these problems. The list below is only a small sampling of things we have yet to address.}}
Crashes and installation help requests are of course something different, feel free to contact us, but be sure to check the FAQ on this page first.

== Known Issues and Bugs ==

'''Please read before posting feedback!'''

The Dark Mod is not slated for a beta-release until the end of 2008, so this demo has plenty of incomplete features and known issues/bugs. In addition, many values (like mantling height, walking speed, volume of sounds, visual acuity of AI, etc) are not necessarily at their final settings. Here are a few of the more common issues you may encounter:

'''AI WIP issues:''' The vocalizations for the AI are placeholders, so don't expect much. Many of the animations (like the walk animation) are also placeholders, and many animations are not yet included. The Thug model has some imperfections that are known issues. The Thief model has a field of view that is oriented improperly, meaning he can sometimes see things at angles he shouldn't be able to.

AI intelligence is far from perfect. They still have problems pathfinding sometimes, and may get stuck on doors and KO'd bodies. They are also missing a ‘searching’ animation, so they will sometimes walk, run, and then walk again while looking around.

AI do not react to some environmental factors (like getting a crate thrown at them or hearing an elevator) that they should.

'''AI Weapons Float:''' It is a known issue that AI weapons don’t always stay attached to the AI’s hands when attacking.

'''AI Shadow:''' The shadows of AI occasionally get cut-off, usually at the head, making the shadow look weird. This is particularly noticeable with characters carrying or standing near a lightsource.

'''Sounds:''' Some sound effects are placeholders. Collision sounds (where things bump into other things) are especially poor. It is a known issue that the player’s footsteps are somewhat irregular.

'''Bow Aiming:''' The lack of a bow-sight is intentional. However, the bow currently is offset slightly—the arrow actually goes up a bit from where you are aiming, as if you were ‘lobbing’ your shot. This is a known (minor) issue that needs to be fixed, but it shouldn't cause too many problems in the meantime.

'''Subtle Highlighting:''' The "froblight" effect that highlights an object is occasionally difficult to see, especially on bright-coloured objects. This needs to be tweaked individually, eventually.

'''Objects Not Moving:''' Not really a mod issue, but in the map there are objects that look like they should probably move if you bump them (like the boots or the wine-bottles), but they don't. Many objects have intentionally been left as static for this map.

'''Particle effects cut off:''' Sometimes particle effects (like splashes from water arrows or gas clouds) are cut off or flicker when they occur at particular angles to the player. This is a purely cosmetic issue we have yet to track down.

'''Menu issues:''' Changing certain graphic settings, like the resolution, requires a restart of Doom 3. However, there is not yet a message that tells you to do so.

More importantly, occasionally navigation breaks down and you might get 'trapped' in a blank menu background. Rather than delay launch further we had to leave that unfixed. If this happens to you then Alt+F4 will exit the program (in Windows.)

'''Saved Game issues:''' Loading saved games works well during a single play session. If you quit Doom3 and then run the game later, however, you may experience some strangeness when attempting to load saved games. The Thiefs Den map can be completed in less than half-an-hour, so try to complete it in one sitting for best results.

'''Keyboard mappings:''' They default mapping of keys is for American/English keyboards. This means that some keys are inaccessible when you use a different keyboard layout. For instance "[" cannot be reached on a German keyboard as the required pressing of {{key|ALT GR}}+{{key|8}} will toggle crouch instead due to Doom not making a difference between the two {{key|ALT}}-keys.

The used fonts do not contain any special characters beyond ASCII. This means if you for instance have a German keybord and bind the key "ü" to a function, it will show up empty in the settings menu. The key will still work in game, though.

''' Missing Texture: ''' The logs in the pot near the fireplace are black because a skin file was left out of the package at the last minute (oops!).

== Troubleshooting ==

'''If''' (and only if) you're experiencing problems, here are some things to try:

# Make sure Doom 3 is patched correctly. You need the correct version of the 1.3.1 patch. See the [[#FAQ|FAQ]] below.
# 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). This is especially important for Linux.

=== Performance Tweaks ===

In case you experience slowdowns, see [[Performance Tweaks]].

== FAQ ==
; Can I use the Demo version of Doom 3?
: Almost certainly not.

; How can I check whether my Doom 3 is correctly patched?
: Open Doom 3 and hit {{key|Ctrl}}+{{key|Alt}}+{{key|~}} (tilde, {{key|^}} on German keyboards) to open the console. You'll see the version printed in the lower left corner of the console. It should read '''1.3.1.1304'''. If your version is ending on 1302, you've got the wrong patch installed.

; Where can I get the right patch?
: We have the patch hosted on our FTP. See [[#Installation|above]] to find a link to it.
:
: If you have version 1.3.1.1302, you may need to uninstall and reinstall before patch 1.3.1.1304 will let you apply it.

; What's that issue with the 1.3.1 patch?
: When the 1.3.1 patch was released by Id, they released it a bit too early. Some download sites picked it up quite fast though and started to distribute it. The problem is, that Id replaced that patch with a different one, and, probably thinking that it hadn't spread yet, didn't bother to change the version number. However, you can still find "wrong" 1.3.1 patches and these will not work with the mod. That's why it is important to check the version number in the console to make sure that the right 1.3.1 patch is installed if the mod doesn't work. The link provided here on our own page points to the correct patch, so if you downloaded it from here you don't need to worry about it.

; Does it run with the Steam version of Doom 3?
: Yes :)

; Which Windows versions can I use?
: Doom 3 needs at least Windows XP or Windows 2000. Thief's Den was successfully run under Windows XP and Vista. Support for 64 bit Windows or Windows 2000 was not tested.

; Does it run in Linux?
: Yes, Linux is supported. You may need:
:* the package '''libdevil1''',
:* either Wine or p7zip to extract the contents from the EXE file
:* recompile the map via the console, or the pathfinding of the AI is broken
:* use your package manager to install '''libdevil1''' or '''libdevil1c2'''

; Does it run in 64 Bit Linux?
: Yes, Linux 64 bit is supported. In addition to the steps above, you need 32 bit compatibility libraries, since Doom3 is 32 bit only:
:* On '''SuSE''', they should be included.
:* On Ubuntu/Kubuntu, install the package '''ia32'''.
:* Since you cannot install 32 bit libraries on a 64 bit system with the normal package manager, you should use [http://ubuntuforums.org/showthread.php?t=474790 getlibs] to install '''libdevil''' and '''libmng''':
::<code>getlibs libIL.so.1</code>
::<code>getlibs libmng.so.1</code>

; Does it run in MacOS?
: No. Or at least not yet. The Doom 3 game itself is supporting MacOS, but The Dark Mod is not - mainly because we don't have anyone developing on Macs. If you can help us getting it to run on MacOS, please [http://modetwo.net/darkmod/index.php?showtopic=7082 apply at the forum].

; Changing the screen resolution/aspect ratio does nothing!?
: These changes require a restart of Doom to work. Currently, our GUI does not warn you about this. You can enter <b>vid_restart</b> in the console to restart the renderer without quitting the game.

; I've finished all objectives except for the last one (leaving), and I can't find this "front door". Where is it?
: Look at your map (default: {{key|M}}). The front door is inside the main building (on the far side from where you enter). You came in through the back door.

== Ok, I've finished the mission. Now what? ==
It's probably occurred to some of you eager mappers out there that with Thief's Den and [[Dark Radiant]] (our Dark Mod editor), it is possible to start mapping for The Dark Mod. You're right. Although we stripped a number of unnecessary files out of the demo release, it does have a number of models, textures, and code (not to mention the great tutorial on the wiki that explains how much of the map was made) that can be used as a starting point for mapping.

Feel free to start experimenting now. Although there is no promise that maps made using the demo assets will be 100% compatible with the mod when it is released (as many things will no doubt be added/updated by then), you certainly can get a good start. It's also an excellent way to earn a spot as a beta-mapper with the team, which gives you access to the full mod.

{{installation}}
{{thiefs_den}}

DarkRadiant - Compiling in Linux

2008-05-14T19:59:43Z

Noerrorsfound: Oops, should have been a subsection

== Install Libraries and Tools ==

=== Ubuntu 7.04 ===

You'll need a bunch of packages to get DarkRadiant to compile without glitches. I can't remember all from the top of my head, I will try to complete this list during my next Linux setup, but don't hold your breath. These are the names as found in Ubuntu 7.04 (Feisty Fawn):

* g++
* gcc-4.1
* scons 0.96.93 (or higher)
* libboost-dev
* libboost-serialization-dev
* libboost-filesystem-dev
* libboost-regex-dev
* libglew-dev
* libgtk2.0-dev
* libglib2.0-dev (maybe installed with libgtk2.0-dev)
* libgtkglext1-dev
* libxml2-dev
* libopenal-dev
* libalut-dev
* libvorbis-dev

Always download all the dependencies as well. Python should already be installed by Ubuntu at least, other distributions might require to install it separately.

If you get an error about the G++ compiler not being found, make sure you also install the <code>g++</code> package, and not just the <code>g++-4.1</code> package.

=== Ubuntu 7.10 ===
* g++
* scons 0.97
* libboost-dev
* libboost-regex-dev
* libgtk2.0-dev
* libglew1.4-dev
* libgtkglext1-dev
* libxml2-dev
* libboost-serialization-dev
* libboost-filesystem-dev
* libboost-date-time-dev
* libalut-dev
* libvorbis-dev

Always download all the dependencies as well.

For the D3Hook plugin, the boost/asio library is needed (version 0.3.7, newer versions don't work). This library is located in the plugins/dm.d3hook/boost/ folder and should be ready for compilation.

=== Ubuntu 8.04 ===
Copy and paste the following into a terminal:

<code>sudo apt-get install g++ scons libboost-dev libboost-regex-dev libgtk2.0-dev libglew1.5-dev libgtkglext1-dev libxml2-dev libboost-serialization-dev libboost-filesystem-dev libboost-date-time-dev libalut-dev libvorbis-dev</code>

In the terminal, Ctrl Shift V is used for pasting instead of Ctrl V.

== Obtain the source ==

Install the subversion client. On Ubuntu this can be done via the Synaptic Manager or the command line:
sudo apt-get install subversion

Change to the directory where you want the source code to be in and then check the current version out of SVN with:

svn checkout https://darkradiant.svn.sourceforge.net/svnroot/darkradiant/trunk/darkradiant/ darkradiant

== Compile ==

Change to the source directory and use <code>scons</code> to create a release build:

cd darkradiant
scons BUILD="release"

The compilation can take quite a few minutes, depending on your system.

If you use <code>scons</code> without arguments, a debugging build will be created, which can take even longer.

Next time you want to compile DarkRadiant, you can just type '''scons''', the last build type is remembered by scons.

A fresh compile can be performed by clearing the compiled binaries first:
scons -c
scons BUILD="release"

If you want to update the source with the latest version from the SVN, just issue:

svn update

in the darkradiant source directory. <code>svn info</code> shows you what version you currently have.

= Note for users with Multiprocessor Systems =
Scons can run several jobs simultaneously, which can use your multicore system to its full capacity. By calling

scons JOBS="2"

the tool runs up to two compile tasks at the same time, which speeds up things a bit.

For a dual-core setup, a value of 2 jobs should be is sufficient, especially if you have only one Gbyte of memory, or less. If your machine has 2 or more Gbyte, you can also try higher values like:

scons JOBS="4"

== See also ==
* [[DarkRadiant Linux Issues]]

{{coding}}
{{darkradiant|sort=Compilation}}

DarkRadiant - Compiling in Linux

2008-05-14T19:58:54Z

Noerrorsfound: Ubuntu 8.04 instructions (I used code tags because the box you get by putting a space before the text doesn't have word wrap)

== Install Libraries and Tools ==

=== Ubuntu 7.04 ===

You'll need a bunch of packages to get DarkRadiant to compile without glitches. I can't remember all from the top of my head, I will try to complete this list during my next Linux setup, but don't hold your breath. These are the names as found in Ubuntu 7.04 (Feisty Fawn):

* g++
* gcc-4.1
* scons 0.96.93 (or higher)
* libboost-dev
* libboost-serialization-dev
* libboost-filesystem-dev
* libboost-regex-dev
* libglew-dev
* libgtk2.0-dev
* libglib2.0-dev (maybe installed with libgtk2.0-dev)
* libgtkglext1-dev
* libxml2-dev
* libopenal-dev
* libalut-dev
* libvorbis-dev

Always download all the dependencies as well. Python should already be installed by Ubuntu at least, other distributions might require to install it separately.

If you get an error about the G++ compiler not being found, make sure you also install the <code>g++</code> package, and not just the <code>g++-4.1</code> package.

=== Ubuntu 7.10 ===
* g++
* scons 0.97
* libboost-dev
* libboost-regex-dev
* libgtk2.0-dev
* libglew1.4-dev
* libgtkglext1-dev
* libxml2-dev
* libboost-serialization-dev
* libboost-filesystem-dev
* libboost-date-time-dev
* libalut-dev
* libvorbis-dev

Always download all the dependencies as well.

For the D3Hook plugin, the boost/asio library is needed (version 0.3.7, newer versions don't work). This library is located in the plugins/dm.d3hook/boost/ folder and should be ready for compilation.

== Ubuntu 8.04 ==
Copy and paste the following into a terminal:

<code>sudo apt-get install g++ scons libboost-dev libboost-regex-dev libgtk2.0-dev libglew1.5-dev libgtkglext1-dev libxml2-dev libboost-serialization-dev libboost-filesystem-dev libboost-date-time-dev libalut-dev libvorbis-dev</code>

In the terminal, Ctrl Shift V is used for pasting instead of Ctrl V.

== Obtain the source ==

Install the subversion client. On Ubuntu this can be done via the Synaptic Manager or the command line:
sudo apt-get install subversion

Change to the directory where you want the source code to be in and then check the current version out of SVN with:

svn checkout https://darkradiant.svn.sourceforge.net/svnroot/darkradiant/trunk/darkradiant/ darkradiant

== Compile ==

Change to the source directory and use <code>scons</code> to create a release build:

cd darkradiant
scons BUILD="release"

The compilation can take quite a few minutes, depending on your system.

If you use <code>scons</code> without arguments, a debugging build will be created, which can take even longer.

Next time you want to compile DarkRadiant, you can just type '''scons''', the last build type is remembered by scons.

A fresh compile can be performed by clearing the compiled binaries first:
scons -c
scons BUILD="release"

If you want to update the source with the latest version from the SVN, just issue:

svn update

in the darkradiant source directory. <code>svn info</code> shows you what version you currently have.

= Note for users with Multiprocessor Systems =
Scons can run several jobs simultaneously, which can use your multicore system to its full capacity. By calling

scons JOBS="2"

the tool runs up to two compile tasks at the same time, which speeds up things a bit.

For a dual-core setup, a value of 2 jobs should be is sufficient, especially if you have only one Gbyte of memory, or less. If your machine has 2 or more Gbyte, you can also try higher values like:

scons JOBS="4"

== See also ==
* [[DarkRadiant Linux Issues]]

{{coding}}
{{darkradiant|sort=Compilation}}