Dwarf Fortress Wiki - User contributions [en]

v0.31:Temperature

2011-12-13T22:37:00Z

Ourai: /* Reference Chart */ Re-ordered temps to be consistent

{{quality|Fine|08:00, 22 May 2010 (UTC)}}{{av}}

''For temperature as it relates to choosing an embarkation site, see [[DF2010:Climate|Climate]].''

==Temperature scale==
Dwarf Fortress uses its own temperature scale in most cases, often called "Degrees [[Main:Urist|Urist]]" on this wiki.
So if you see something like [HOMEOTHERM:10067], don't be amazed.

[[Main:Magma|Magma]]'s temperature is 12,000° Urist.

The highest possible temperature in Dwarf Fortress is 60,000°U - the temperature 60,001°U is used internally for temperatures which have been set to "NONE".

===Conversion===

[DF scale] = [FAHRENHEIT] + 9968

[DF scale] = [CELSIUS] * 9/5 + 10000

[DF scale] = [KELVIN] * 9/5 + 9508.33

[DF scale] = [RANKINE] + 9508.33

''(Note: Mod-makers may find this [http://www.bay12forums.com/smf/index.php?topic=80523.0 Temperature Conversion Utility] handy if they find themselves having to convert a lot of temperatures to and/or from Degrees Urist.)''

===Reference Chart===

{| {{prettytable}}
|- bgcolor="#ddd"
! Significance
! DF Scale
! Fahrenheit
! Celsius
! Kelvin
! Rankine

|-
| Boiling Point of Water
| 10180
| 212
| 100
| 373.15
| 671.67

|-
|Human Body Temperature
| 10066.62
| 98.6
| 37.0
| 310.15
| 558.27

|-
| Freezing Point of Water
| 10000
| 32
| 0
| 273.15
| 491.67

|-
| Absolute Zero
| 9508.332
| -459.67
| −273.15
| 0
| 0

|-
| DF Scale's Zero1
| 0
| -9968
| -5555.555...
| -5282.40555...
| -9508.33
|}


:1 - Yes, temperatures in Dwarf Fortress can go '''far, far''' below absolute zero, which is physically impossible. Considering Dwarf Fortress also allows [[water wheel#Perpetual motion|perpetual motion]], it's best not to ask questions.
:2 - Technically, fractional/decimal temperatures are not possible in Dwarf Fortress, as they are stored as unsigned 16-bit integers. For instance, body temp for humans in the raws is rounded to 10067.


Some general information about temperatures in DF (copied from somewhere on the forums):
{| class="prettytable"
|-
! Event / location
! Temperature
|-
| alcohol freezes
| 9850 U
|-
| water freezes
| 10000 U
|-
| underground
| 10015 U
|-
| outside (varies)
| 10048 U
|-
| dwarf/human body temp
| 10067 U
|-
| floor above magma
| 10075 U
|-
| fat melts
| 10078 U
|-
| water boils
| 10180 U
|-
| fire
| 11000 U
|-
| common stone melts
| 11500 U
|-
| magma
| 12000 U
|-
|}

==Melting point==

This is the temperature at which an object will melt.

==Boiling point==

This is the temperature at which an object will evaporate.

==Ignition point==

This is the temperature at which an object will catch fire.

==Heat damage point==

This is the temperature above which an object will begin to take heat [[wear|damage]]. Flammable items without a heat damage point (or with an exceptionally high one) will take damage very slowly, causing them to burn for about 9-10 months before disappearing.

==Cold damage point==

This is the temperature below which an object will begin to take frost [[wear|damage]].

==Specific heat==

This determines how long it takes an object to heat up or cool down. An object with high specific heat will change temperature more slowly.

==Fixed temperature==

A substance's temperature can be forced to always be a certain value via the MAT_FIXED_TEMP [[material definition token]]. The only standard material which uses this is the [[nether-cap]], whose temperature is always at the melting point of water. If a substance's temperature is fixed to between its cold damage point and its heat damage point then items made from that substance will never suffer cold/heat damage, unless it's [[dump]]ed into [[magma]] or [[water]]. This makes nether cap [[fire-safe]] and [[magma safe]], in spite of being [[wood]].

The fixed temperature of an item is set when the item comes into existence, so you can't change the MAT_FIXED_TEMP token to cause an existing item to melt/burn/etc.

The fixed temperature of a [[container]] has no effect on its contents, so you can't freeze [[water]] by putting it into a [[bucket]] made from nether cap.

The fixed temperature of a substance only affects items made from that substance. For example, setting a type of rock to have a fixed temperature over its melting point won't cause walls made from that rock to instantly melt, cause ice walls adjacent to the rock walls to melt, or even cause them to be considered [[Main:warm stone|warm stone]].

v0.31:System requirements

2011-12-13T08:09:48Z

Ourai: /* OS */ Added ref to Lion tweak

{{av}}
{{Quality|Fine|08:51, 1 July 2010 (UTC)}}

''If you're looking for information on improving the performance of Dwarf Fortress on your computer, see [[Maximizing framerate|Maximizing Framerate]]. For installation instructions, see [[Installation]].''

__TOC__

== OS ==

* '''Windows''' requires XP SP3 or newer.
* '''Linux''' runs natively or using Wine.
* '''Mac''' needs Intel chip. (OS X Lion works, but requires [http://df.magmawiki.com/index.php/DF2010:Installation#Mac a short modification] to run)

'''Note:''' ''The [[40d:System requirements|40d article]] has detailed info on Non-Windows OS' that is probably mostly still valid.''

== RAM ==

DF is not particularly RAM-hungry. Expect the process to allocate between 300 and 700 MB with medium regions. With 512MB you may be a bit on the short side, but 1 GB is absolutely sufficient. World Generation can eat up far more than that, but Generation will only be slower if less RAM is available. Otherwise the influence of RAM on game speed is limited, as DF is not loading and offloading big chunks of data much. 

There are no detailed requirements per se. However, because simply saying the more RAM you have and the faster your CPU is the better is not all that helpful, here are some stats that users have experienced while playing this game on a variety of different environments. (Please note that ‘fast game-play’ and ‘slow game-play’ are subjective terms and not intended to relay anything specific or exact. What may be fast to one person might be slow to another). It's also essential that you mention the state of your fortress - how many dwarves there are, animals, terrain, speedups, and so forth.

== What is SDL and Legacy version difference? ==
SDL is a cross-platform application framework. The SDL version of DF uses that framework and so runs on mac and linux, along with including Baughn's new opengl code, which should be faster, allows png files for tilesets, zooming with the mousewheel, etc. The SDL version is quite new, so isn't proven yet. It's also being actively worked on, getting features like "separate files for graphics and font", and true-type font support.

Legacy is Toady's old code, only kept in case the SDL version doesn't work for someone. There is no legacy version for mac or linux.

== Experiential reports ==
=== Report format ===
Please read [[DF2010:System_requirements/Report_Template | the report template]] page before contributing any reports

=== Reports ===
Configuration type: AMD based, full desktop PC
;Game info
:Game version: 31.08 - graphics
:World size: Medium region (default, nonmodified)
:Embark size: 5x5
:Age of fort: 6 years
:Number of dwarves: 140
:Average fps: 6-14
:Default/nondefault raws: nondefault, dwarven speed modified, some smelting recipes modified.
:Tileset in use: Phoebus prebuilt version
:Amount of stone dug: 8693 at the moment of measure
:Amount of water and state: A brook, dammed and diverted into big cisterns for trap use, mostly static and pressurised.
:Approximate amount of z-levels: Beyond 200 below the ground level, around 5 upwards from ground.
:RAM usage of game: Around 1.25 GB when playing
:Draw mode in init.txt: VBO

;PC info
:CPU: AMD 7750x2 BE @ 2.7GHz
:MBO: Gigabyte GA-MA78G-DS3h
:RAM: 4GB DDR2 800
:GPU: XFX GTX260
:OS: Windows 7 x64 Ultimate

----

;Game info
:Game version: 31.12
:World size: Smaller Region
:Embark size: 4x4
:Number of dwarves: 7
:Average fps: 90-100
:Default/nondefault raws: Giant Eagles can be everywhere. No aquifers, and one cavern layer.
:Tileset in use: Ironhand.
:Amount of stone dug: ~150
:Amount of water and state: A dozen murky pools.
:Approximate amount of z-levels: 40-50.
:RAM usage of game: Unknown.
:Draw mode in init.txt: 2D.

;PC info
:CPU: 1.6 GHz Intel Centrino.
:MBO: Unknown.
:RAM: 512 MB.
:GPU: Unknown.
:OS: Windows XP.

----

Configuration type: Intel Based, Fairly clean copy of Windows, Defragged weekly and virus scanned daily at night.
;Game info
:Game version: .31.18 Graphics
:World size: Medium
:Embark size: 3x3
:Age of fort: 3 years
:Number of dwarves: 100
:Average fps: ~95
:Default/nondefault raws: Default raws
:Tileset in use: Phoebus
:Amount of stone dug: ~600 blocks
:Amount of water and state: ~200 blocks, with river
:Approximate amount of z-levels: 7 in use around 150-200 in all
:RAM usage of game: 330 Mb.
:Draw mode in init.txt: 2d

;PC info
:CPU: Core 2 Quad 2.6 Ghz
:MBO: Asus P5N-D
:RAM: 6 Gigs DDR2 (x2 1 Gig, x2 2 Gig)
:GPU: EVGA Geforce Gtx 465 1 Gig
:OS: Windows 7 Ultimate x64

----
Configuration type: Thinkpad T42
;Game info
:Game version: v0.31.25
:World size: Medium
:Embark size: 4x4
:Age of fort: 10 years
:Number of dwarves: ~200
:Number of animals: ~250
:Average fps: 12-15
:Default/nondefault raws: default
:Tileset in use: default
:Amount of stone dug: ~15000
:Amount of water and state: 1 flowing river that splits and merges back, numerous murky pools
:Approximate amount of z-levels: 20 in use, 45 total
:RAM usage of game: 600-900mb
:Draw mode in init.txt: VBO

;PC info
:CPU: Pentium M 1.8ghz
:MBO:
:RAM: 1gb
:GPU: ATI Mobility Radeon 7500
:OS: Windows XP Pro SP3

=== Archived reports ===
Older, incomplete reports can be found [[DF2010:System_requirements/Archived_reports | here]].

v0.31:Installation

2011-12-13T08:07:04Z

Ourai: /* Mac */ Formalized the subsection on how to run DF under Lion

= Download =
__NOTOC__
You can always get Dwarf Fortress as [[Main:Toady One|Toady One]], the developer, released it from the [http://www.bay12games.com/dwarves/ Bay12 site] (check the top of the page).

You can also download the latest version here:
{{News/Mirrors/{{current/version}}}}
Windows users: Use the "Main" version unless there's some reason not to.
== Third-Party Packages ==

*[[Main:Lazy Newb Pack|Lazy Newb Pack]] (Windows Only) - the full game plus utilities and graphics sets in one big package
*[http://www.bay12forums.com/smf/index.php?topic=53180.0 Ironhand's Graphics Set] - improves the look of tiles
*[http://www.bay12forums.com/smf/index.php?topic=57557.0 Phoebus' Graphic Set] - another graphics set
*[[Utilities#Dwarf_Therapist|Dwarf Therapist]] - Utility for managing dwarves

The Dwarf Fortress community often creates custom [[Graphics set repository|graphics sets]] and [[Tilesets|tilesets]]. They're like graphical mods that make DF look prettier or just different. A lot of people pack the game folder with the tileset installed and everything already set up, so all you have to do is extract and play. Among the most popular of these are [http://www.bay12forums.com/smf/index.php?topic=53180.0 Ironhand's Graphics Set] and [http://www.bay12forums.com/smf/index.php?topic=57557.0 Phoebus' Graphic Set].

There's also the (Windows only) [[Main:Lazy Newb Pack|Lazy Newb Pack]] which has several tilesets and utilities gathered together to make it easier for new players to get started and to experiment with the different tilesets. The only disadvantage to downloading LNP is that there is usually some lag time between when a new version of the game is released and when the LNP is updated to include it. So, if a new version of the game has just been released it may not be in the LNP yet.

Also see [[Utilities]] for a long list of utilities that people have created, including the incredibly useful [[Utilities#Dwarf_Therapist|Dwarf Therapist]], something that many people won't play the game without.

= Installation =
:''Also see: [[System requirements]]''

== Windows ==

There is no installer for the game. Simply extract the archive file to a folder somewhere and run the game from within the folder.

Make sure to actually ''extract'' the archive; do not just open the archive and run the game from the window that appears. If you do this then it may appear to work, but your save game data will get discarded. This is the cause of many "my saved games keep getting deleted" complaints. The game also needs to be able to write to its own folder, so do '''not''' install it in C:\Program Files if you are running Windows Vista or later.

== Mac ==

The Mac version is not a single application bundle, but like the Windows version it consists of a folder containing the application along with data files and there is no installer. The entire folder can be dragged into the Applications folder or placed elsewhere. As with the Windows version, the game must be able to write to its own folder.

To start the game execute the launch script "df".

=== OS X 10.7 Lion ===

When first running Dwarf Fortress on 10.7 Lion, you may be startled to discover that Terminal crashes without so much as a by-your-leave. Don't worry; Dwarf Fortress will still run on Lion. The issue lies in the libraries; they haven't changed from the ones in Snow Leopard, but their naming scheme has. The fix is a quick one. Open up the "df" launch script in a text editor of your choice (TextEdit is the default), and locate the following lines:

:export DYLD_FALLBACK_LIBRARY_PATH=${PWD}/libs 
:export DYLD_FALLBACK_FRAMEWORK_PATH=${PWD}/libs

Change them to read as follows:

:export DYLD_LIBRARY_PATH=${PWD}/libs 
:export DYLD_FRAMEWORK_PATH=${PWD}/libs

With the change, Dwarf Fortress should run normally.

== Linux ==

The Linux version of the game is shipped as a compiled 32-bit x86 (Intel/AMD) application. It will also run on a system with a 64-bit AMD or Intel processor and a 64-bit kernel, provided that you have the (32-bit) shared libraries available that the program needs.

Dwarf Fortress for Linux is meant to be run from a terminal (command-line) interface, and so the instructions here will assume you know how to login and get to a command prompt. At least in the default mode, however, Dwarf Fortress is an X client program, so you should be in a terminal inside an X session before starting the game. Dwarf Fortress will create a new X window outside of the terminal window, so don't worry about the size of the terminal.

* '''Unpacking''': Dwarf Fortress is shipped as a (bzip2) compressed tar archive. It will extract into a new directory called '''df_linux'''. So, cd to wherever you want the game to be unpacked, and then run '''tar xjf /path/to/df_XX_YY_linux.tar.bz2''' (where df_XX_YY_linux.tar.bz2 is the filename). Then run '''cd df_linux''' to change into the new directory.
* '''Running''': Run '''./df''' to execute the Dwarf Fortress wrapper script.
* '''Troubleshooting''': If you get an error like this:
./libs/Dwarf_Fortress: error while loading shared libraries: libSDL_image-1.2.so.0:
cannot open shared object file: No such file or directory
: it means that your system is missing one or more shared libraries. See below.
* '''Upgrading''': Since every new version of Dwarf Fortress unpacks in a directory named '''df_linux''' you have to manage upgrades yourself. You should '''not''' unpack a new version of DF on top of an old version's directory -- this will cause things to break, usually in subtle and mysterious ways. Instead, you should either delete or rename the old '''df_linux''' directory first, before extracting the new version.

=== 32-bit vs. 64-bit systems ===

Modern desktop PCs (of the Intel/AMD persuasion) contain CPUs that can run in either 32-bit or 64-bit modes. When you install Linux, you choose one of these architectures. The programs on your system will then be compiled either for the 32-bit (i386, x86) arch, or the 64-bit (amd64, x86_64) arch. If you've forgotten which one you have, you can check:

$ file /bin/ls
/bin/ls: ELF 64-bit LSB executable, x86-64, version 1 (SYSV), dynamically linked (uses shared libs),
for GNU/Linux 2.6.18, stripped

The above would indicate a 64-bit system. Here's one from a 32-bit system:

$ file /bin/ls
/bin/ls: ELF 32-bit LSB executable, Intel 80386, version 1 (SYSV), dynamically linked (uses shared libs),
for GNU/Linux 2.6.18, stripped

Dwarf Fortress is compiled for 32-bit systems, so if you're on a 32-bit system, things will be slightly easier. If you are getting errors about missing SDL_image libraries (etc.) then you simply need to install them. Use your distribution's package manager for this -- details will be extremely distribution-specific. You don't need the development versions of the packages with the headers (although that won't hurt) -- you just need the runtime versions, with the actual shared libraries.

If you're on a 64-bit system, then things get a bit trickier. Since DF is a 32-bit application, it needs 32-bit versions of the shared libraries. Some Linux distributions provide these in one or more packages that you can download. For example, in Debian, the ia32-libs package contains most of the common 32-bit libraries, including libSDL. Unfortunately, it does ''not'' include the SDL add-on libraries such as libSDL_image and libSDL_ttf. If your distribution does not include these, then you may have to supply them manually.

If this is the case, then the first step is to figure out where you will be putting them. Check to see where your other 32-bit libraries are already installed; for example, on Debian, some are in /lib32 and others are in /usr/lib32. Since libSDL is in /usr/lib32 on a Debian system, that's where we'll want to put libSDL_image and libSDL_ttf. On other distributions, the path could be different.

The second step is to get the 32-bit libraries. You can typically do this by downloading them directly from your distribution's 32-bit package repository. Again using Debian as our example, we can perform a search at http://packages.debian.org/ for files containing the word libSDL_image for the Intel x86 architecture. This takes us to [http://packages.debian.org/search?searchon=contents&keywords=libSDL_image&mode=filename&suite=stable&arch=i386 a results page] from which we can proceed to [http://packages.debian.org/squeeze/libsdl-image1.2 the libsdl-image1.2 package page] with a list of download links arranged by architecture. Grab the i386 package from here, and repeat this for the libSDL_ttf package, and whatever other library you are missing. Store these package files somewhere convenient.

The third step is to extract the libraries from the packages and get them in the proper location. You probably ''won't'' be able simply to install the packages using your package manager, because they are for the wrong architecture. Instead, you'll probably have to extract them by hand. The steps for doing this are distribution-specific, so when in doubt consult your distribution's help resources. I'll show the steps for a .deb package.

* cd into some temporary working directory such as /tmp
* Extract the files from the .deb archive, which is in ar(1) format:
ar x /path/to/libsdl-image1.2*_i386.deb
: This creates three files: debian-binary, control.tar.gz and data.tar.gz. We only care about data.tar.gz.
* Extract data.tar.gz:
tar xzf data.tar.gz
: This creates a subdirectory named usr with various files inside it. We only care about usr/lib/libSDL_image-1.2.so.0.8.2 (or whatever precise version yours has).
* Move the shared library into place:
sudo mv usr/lib/libSDL_image-1.2.so.* /usr/lib32/
* Create a symlink to it:
cd /usr/lib32
sudo ln -s libSDL_image-1.2.so.0.* libSDL_image-1.2.so.0
cd -

Repeat this for libSDL_ttf and whatever other libraries are required.

'''NOTE''': If you get the error that libsndfile.so is not found, you must use the following:
find */libsndfile.so*
cd to the correct directory, then use ln as shown above.

Another common difficulty with 64bit systems is related to the art packs. When DF is run on most (?all) 64bit Unix systems, it generates error messages related to the PNG variants of the art files, errors which prevent the game from starting.

To solve this problem, you must first edit the ''/data/init/init.txt'' file and set the game to use the BMP variants of the art files, instead of the default PNG. This should solve all the error messages except for one: "''Not found: data/art/mouse.png''" since there is no setting in the ''init'' files to change it. The workaround for this is to edit the ''Dwarf_Fortress'' file found in the ''/your/path/df_linux/libs'' folder which contains the setting for the mouse cursor.
If you don't know how to do that, you can try this:
* cd to the ''/df_linux/libs'' folder
* open ''Dwarf_Fortress'' in ''vi'' or any other editor of your choise:
vi ./Dwarf_Fortress
: This opens the file for editing (text mode). If you are not familiar with ''vi'', it would be a good idea to follow these steps exactly and not press any other keys since they all activate specific commands. If you do press a key though, you can press the ''ESC key'' a few times to cancel the command.
* With vi open, write the following string and press ''Enter'':
/mouse
: This will search for all the strings that contain the word "mouse" and place the cursor on the first match. Pressing the ''n key'' will cycle through all the matches.
* Press the ''n'' key until the cursor moves to the desired string, which is "''data/art/mouse.png''". If you accidentally move past the string, you can cycle back through the matched strings using the ''N key'' (shift + n).
* Once you find the right string, you will have to move the cursor over the "p" in "[..]/mouse.png". You do that by pressing the ''l key'' which will move the cursor to the right. There is also the ''h key'' to move the cursor to the left, in case you move past it.
* With the cursor in the right position press the following key sequence:
xxxibmp
: This will replace the ''.png'' extension with the ''.bmp'' one which solves the problem of the missing ''/data/art/mouse.png'' error.
* All there is left to do is to save the modifications to the file and quit ''vi''. For that, press the ''ESC key'' once or twice and then press the following key sequence after which you press ''Enter'':
:wq
: This saves the changes and quits 'vi'

Now the game should work properly. Have fun!

= Documentation =

Fortunately the documentation on this wiki is very detailed and extensive. You may want to start out with:
* [[Tutorials]]
* [[Quickstart_guide|Fortress Mode Quickstart Guide]]
* [[Adventure mode quick start|Adventure Mode Quickstart Guide]]

Then move on to:
* [[Dwarf fortress mode|Fortress Mode reference]]
* [[Adventure mode|Adventure Mode reference]]
* [[Special:Search|Searching]] the wiki

{{Getting Started}}
{{Category|Guides}}