Dwarf Fortress Wiki - User contributions [en]

Installation

2021-07-03T06:09:36Z

Bachsau: /* Mac */

{{Quality|Exceptional|12:06, 26 January 2015 (UTC)}}
{{av}}
<br/>
{{quick download|{{current/version/ns}}}}
<br/>
{{TOC right}}
= Download =

Free alpha builds of ''Dwarf Fortress Classic'' are available directly from the developers, Bay 12 Games, at http://www.bay12games.com/dwarves/ . The three downloads linked at the top of the main page are 64-bit versions of DF for Windows, macOS, and Linux. "All versions" links to a page with additional choices, including 32-bit builds for all platforms, "small" builds for Windows (which lack sound files), and "legacy" builds for Windows. Generally, the SDL builds for Windows should be preferred, although the Legacy builds may be necessary on some older computers.

''Dwarf Fortress'' is slated to be released on the [https://store.steampowered.com/app/975370/Dwarf_Fortress/ Steam] and [https://kitfoxgames.itch.io/dwarf-fortress itch.io] platforms in the future. These paid versions of the game will include an all-new graphical [[tileset]] and new music tracks. Additionally, the Steam version will include Steam Workshop integration for [[mod]]ding. Most other features will be shared with ''Dwarf Fortress Classic'' (which will remain available for free).

== Third-Party Packages ==

{{main|Utility:Lazy Newb Pack}}

There are several packages which bundle the game with several utilities and graphics sets, usually configurable with an included launcher. These are listed on the [[Utility:Lazy Newb Pack|Lazy Newb Pack]] page.

The ''Dwarf Fortress'' community often creates custom [[Graphics set repository|graphics sets]], [[Tileset repository|tilesets]] and [[Color_scheme#Custom_color_schemes|color schemes]]. 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]. Most notable graphics sets are included in the packs mentioned above.

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

== Windows ==

There is no installer for the game - simply extract the archive contents to a folder somewhere and run the game from within that folder by opening "''Dwarf Fortress''.exe".

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 - 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. (However, this rather assumes that one actually ''has'' an archive extractor to begin with, perhaps preinstalled: [https://www.7-zip.org/ example remedy for that issue])

If you have an error stating that MSVCP140.dll is missing, it can be obtained by downloading [https://www.microsoft.com/en-us/download/details.aspx?id=48145 Visual C++ Redistributable for Visual Studio 2015]. When prompted choose the x64 version for 64-bit DF, or the x86 version for 32-bit DF.

If Windows is set to scale the display, you may need to disable that for DF. Right-click the ''Dwarf Fortress.exe'' icon, select '''Properties''', select the '''Compatibility''' tab, and then activate the '''Disable display scaling on high DPI settings''' (or '''Override high DPI scaling behavior, scaling performed by: Application''') check box.[https://support.microsoft.com/en-us/help/3025083/windows-scaling-issues-for-high-dpi-devices]

== Mac ==

The Mac version is not an application bundle. Like the Windows version, it consists of a folder containing the application and data files; 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". Launching "dwarfort.exe" by itself will ''not'' work (since the "df" script sets up [[wikipedia:environment variables|environment variables]] pointing to DF's libraries).

There are alternative installation options, such as [[Utility:Lazy newb pack|pre-packaged bundles]] and [https://github.com/Bachsau/DF-Mac-Launcher this third-party app launcher], that may make the game easier to start and fix some of the issues listed below.

=== Fixes for common issues ===

Changing the ``PRINT_MODE`` setting in data/init/[[init.txt]] from ``2D`` to ``STANDARD`` is necessary on some systems, particularly macOS 11+ (see below) and machines with Retina displays {{bug|6031}}. Doing this on any macOS system can improve performance significantly {{bug|10052}}. Other values for this setting, like ``FRAME_BUFFER``, may also help.

On macOS 10.15 (Catalina) and above, if you encounter gatekeeper security-related warnings that prevent DF from starting, one solution (from [https://github.com/DFHack/dfhack/issues/1465 here]) is to run the following command from the terminal in the folder containing <code>dwarfort.exe</code>:
* <code>find . -print0 | xargs -0 xattr -d com.apple.quarantine</code>

On macOS 11 (Big Sur) and above, if you see a blank white window when starting the game, you will need to change ``[PRINT_MODE:2D]`` to ``[PRINT_MODE:STANDARD]`` in [[init.txt]].

On case-sensitive filesystems, a freshly-installed version of the game will not launch. {{bug|11136}}
* Rename "libs/SDL_ttf.framework/Versions/A/Frameworks/FreeType.framework" to "libs/SDL_ttf.framework/Versions/A/Frameworks/freetype.framework" to fix this.

== Linux ==

You may want to check if the package manager for the Linux distribution you are using has a ''Dwarf Fortress'' package. A package will get the correct build of DF for your system, handle all the dependencies and configuration, make any necessary system-specific fixes, probably add an entry to the system application launcher or menu, and handle updates. Note that in some cases, these packages can lag behind official DF releases, and they typically only support a single system-wide installation of DF. If you want a version of DF newer than what your package manager provides, or if you want a portable installation, follow the instructions in the rest of this section instead.

As of 0.43.05, both 64-bit and 32-bit compiled builds of ''Dwarf Fortress'' are available for Linux. Note, to get the 32-bit edition, click the All Versions button on the ''Dwarf Fortress'' download page. Older 32-bit only versions can possibly run on a 64-bit system if the system has the required (32-bit) shared libraries, see below.

''Dwarf Fortress'' for Linux is expected to be run from a terminal (command-line) interface, and so the instructions here will assume you know how to log in and get to a command prompt. By default, however, ''Dwarf Fortress'' is a graphical desktop program (an X client), so you should be in a terminal emulator (inside an X session) before starting the game. (See [[Installation#TEXT mode]] for an alternative.) ''Dwarf Fortress'' will create a new window outside of the terminal window by default, so don't worry about the size of the terminal.

When you installed Linux, you chose either a 32-bit (i386, x86) or 64-bit (amd64, x86_64) architecture. Some systems are able to run programs for either, but it is best to use a version of DF compiled for the same architecture. If you've forgotten which one you have, you can check by running the command <code>uname -m</code> in a terminal. A result of <code>x86_64</code> and <code>i686</code> would indicate 64-bit or 32-bit respectively.

'''Downloading''': Either download it from the [http://www.bay12games.com/dwarves/ Dwarf Fortress Homepage] with a web browser, or with one of these terminal commands, replacing "XX_YY" with the numbers in the desired ''Dwarf Fortress'' file version, found on the [http://www.bay12games.com/dwarves/ site]:
wget http://www.bay12games.com/dwarves/df_XX_YY_linux.tar.bz2
or, for the 32-bit version:
wget http://www.bay12games.com/dwarves/df_XX_YY_linux32.tar.bz2

'''Unpacking''': ''Dwarf Fortress'' is shipped as a (bzip2) compressed tar archive. It will extract into a new directory called '''df_linux'''. So, <code>cd</code> to wherever you want the game to be unpacked, perhaps <code>~/games</code>, and then run
tar -xjf /path/to/df_XX_YY_linux.tar.bz2
where /path/to/df_XX_YY_linux.tar.bz2 is the path and filename of the actual file you downloaded.

(note: <code>tar -xjvf ./df_XX_YY_linux.tar.bz2</code> may be needed in some cases. [what cases? all this does is add verbosity and assume the file is in the current dir])

'''Running''': First, change to the new directory
cd df_linux
then execute the launcher script.
./df

Now you need to ensure that the required dependencies are installed. If you try to run the game and get errors about missing SDL_image libraries (etc.) then you need to install them. Use your distribution's package manager for this - details will be extremely distribution-specific. Specific installation commands for some distributions are in the sections below. 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 see any errors related to libstdc++ when starting DF (for example, "version `CXXABI_1.3.8' not found"), try removing libstdc++.so.6 and libgcc_s.so.1 from the "libs" folder. This will cause DF to use the system version of these libraries, which are more up-to-date on many modern systems than the libraries that DF includes.

Since ''Dwarf Fortress'' 0.43.05 and later are compiled for both architectures, running natively shouldn't be an issue. However if you're wanting to run an older version of ''Dwarf Fortress'' on a 64-bit system, things get a bit trickier. Since older DF is only a 32-bit application, it will need 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, you'll need to enable the 32bit architecture in your package manager and install the relevant 32-bit libraries like libSDL. If your distribution does not include these, then you may have to supply them manually. Though, at that point it may just be easier to run the old windows version of DF in Wine.

=== Debian-based ===

Installing the dependencies for ''Dwarf Fortress'' is simple, but varies slightly depending on whether you're running a 32-bit OS, a 64-bit OS, or a 32-bit version of ''Dwarf Fortress'' on a 64-bit OS.

==== 64-bit (recent version of ''Dwarf Fortress'', most modern machines) ====

===== Install dependencies =====

$ sudo apt install libsdl1.2debian libsdl-image1.2 libsdl-ttf2.0-0 libgtk2.0-0 libopenal1 libsndfile1 libncursesw5

This will install the SDL image and font libraries necessary, as well as libopenal and libsndfile, which are needed to get the sound working. It will also install libncursesw5, which is needed if you want to run ''Dwarf Fortress'' in ''TEXT'' mode.

===== Fix sound issues =====

In some old versions, ''Dwarf Fortress'' does not quite look in the correct place for the sound libraries it needs to play the wonderful music. This is easily fixed.

Switch to the ''Dwarf Fortress'' folder and add some symlinks to the correct location:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/x86_64-linux-gnu/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/x86_64-linux-gnu/libsndfile.so.1 libs/libsndfile.so

==== Running 32-bit ''Dwarf Fortress'' on 64-bit Debian ====

===== Install dependencies =====

If you're trying to run a version of ''Dwarf Fortress'' older than 0.43.05, you'll need to install the 32-bit versions of the libraries. You can do this with:

$ sudo dpkg --add-architecture i386
$ sudo apt-get update
$ sudo apt-get install libsdl1.2debian:i386 libsdl-image1.2:i386 libsdl-ttf2.0-0:i386 libopenal1:i386 libsndfile1:i386 libncursesw5:i386

===== Fix sound issues =====

Almost the same as above, but the libraries will be in a different location as you're looking for the 32-bit versions:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/i386-linux-gnu/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/i386-linux-gnu/libsndfile.so.1 libs/libsndfile.so

==== 32-bit ====

===== Install dependencies =====

$ sudo apt-get install libsdl1.2debian libsdl-image1.2 libsdl-ttf2.0-0 libopenal1 libsndfile1 libncursesw5

As above, this will install the SDL image and font libraries, sound libraries, and text libraries.

===== Fix sound issues =====

Switch to the ''Dwarf Fortress'' folder and add some symlinks to the correct location:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/libsndfile.so.1 libs/libsndfile.so

==== Standard package ====

''Dwarf Fortress'' is also available as a package in the (non-free) Debian repositories. You can install it (with all dependencies) with a simple

$ sudo apt-get install dwarf-fortress

=== Fedora ===

''Dwarf Fortress'' has been packaged in [https://rpmfusion.org/ RPM Fusion Nonfree], using a similar method as it is done in Arch Linux (see below). After [https://rpmfusion.org/Configuration installing RPM Fusion] you can simply run the following commands to install and run ''Dwarf Fortress'', which will pull in all the required dependencies:

$ sudo dnf install dwarffortress
$ dwarffortress

Some other tools are provided by the same packager in the [https://mars.arosser.com/fedora/dwarffortress/dwarffortress.repo "Dwarf Fortress for Fedora"] repository. For more information please [http://www.bay12forums.com/smf/index.php?topic=158289.msg7009116#msg7009116 see this forum thread].

If you want to install 64-bit ''Dwarf Fortress'' manually, you can run the following:

$ sudo dnf install SDL SDL_image SDL_ttf gtk2-devel openal-soft alsa-lib alsa-plugins-pulseaudio mesa-dri-drivers

On 64-bit Fedora installations, to install 32-bit ''Dwarf Fortress'' you can install 32-bit libraries by appending ".i686" to the package name:

$ sudo dnf install SDL.i686 SDL_image.i686 SDL_ttf.i686 gtk2-devel.i686 openal-soft.i686 alsa-lib.i686 alsa-plugins-pulseaudio.i686 mesa-dri-drivers.i686

Fedora installs all 32-bit libraries to /usr/lib and 64-bit libraries to /usr/lib64 (with /lib and /lib64 being links to these two directories), so if you need to install stuff manually, look in there.

=== Arch Linux ===
A 64-bit ''Dwarf Fortress'' package is available in the [https://wiki.archlinux.org/index.php/Official_repositories#community community repository]. There are also [https://aur.archlinux.org/packages/?O=0&K=dwarffortress other packages] available in the Arch User Repository ([https://wiki.archlinux.org/index.php/Arch_User_Repository AUR]).

==== Official package installation ====
Install the official package like any other
# pacman -Syu dwarffortress
Any required dependencies will be installed, too.

You can then launch ''Dwarf Fortress'' by running 'dwarffortress' in your terminal emulator. The package also includes a .desktop file so the game should appear in whatever application launcher or menu you might use.

The first time a user launches the game, the directory .dwarffortress will be created in that user's home directory. Game settings and files can be changed there. Note that some of the directories in there are links to common directories and changes to them will effect all users. Also, any changes to common files should be backed up since they will be overwritten when the package updates. You can find the locations of files installed by the package with the command
$ pacman -Ql dwarffortress

If you use tools like dfhack you might want to [https://wiki.archlinux.org/index.php/Pacman#Skip_package_from_being_upgraded configure pacman to not update] ''Dwarf Fortress'' until the tools are updated.

==== AUR package installation ====
Install an AUR package [https://wiki.archlinux.org/index.php/Arch_User_Repository#Installing_packages manually] or using an [https://wiki.archlinux.org/index.php/AUR_helpers AUR helper]. The different AUR packages may or may not install the game similarly to the official package - use the previous pacman command to check game file locations.

==== Manual or multiple installations ====
You can also manually install ''Dwarf Fortress'' in case you want to try other versions or with and without mods. Just follow the generic Linux instructions above with a different directory for each install. If you've installed one of the above packages, all the dependencies should already be installed. To launch this version: in a terminal emulator, 'cd' to that directory, and run './df'. If you get a permission error, you may need to mark the script and executable as being executable with:
$ chmod u+x df libs/Dwarf_Fortress
Once you get an install working you can create a [https://wiki.archlinux.org/index.php/Desktop_entries custom .desktop file] to launch it.

If you want to install a 32-bit version of ''Dwarf Fortress'' you will have to enable the [https://wiki.archlinux.org/index.php/Official_repositories#multilib multilib repository], install the 32-bit system libraries, and install the 32-bit game dependencies manually (check the Arch wiki for more information).

=== CentOS 7 ===

''Dwarf Fortress'' is now 64-bit, so simply run:

sudo yum install SDL SDL_image SDL_ttf openal

Note that CentOS 7 ships with glibc 2.17, but ''Dwarf Fortress'' by default would like 2.18. [http://www.bay12games.com/dwarves/mantisbt/view.php?id=9893 This bug] has a fix, simply copy the [http://pastebin.com/jX4Wf062 Pastebin script], then move the libraries into a new folder.

cd df_linux
curl -L http://pastebin.com/raw/jX4Wf062 > df
mkdir c_libs
mv libs/libgcc_s.so.1 libs/libstdc++.so.6 c_libs/
chmod a+x df

Then run it!
./df

=== Gentoo ===

There is a ''Dwarf Fortress'' [https://packages.gentoo.org/package/games-roguelike/dwarf-fortress ebuild] in the main Gentoo's portage tree compatible with the new multilib support.

# emerge -av games-roguelike/dwarf-fortress

=== Solus ===

Download ''Dwarf Fortress'' from the Bay 12 Games website. If you encounter the following error upon launch:

./libs/Dwarf_Fortress: error while loading shared libraries: libSDL_ttf-2.0.so.0: cannot open shared object file: No such file or directory

then simply run the following command to install the missing libraries:

sudo eopkg install sdl-ttf

If you are running a 32bit version of ''Dwarf Fortress'', simply replace <code>sdl-ttf</code> with <code>sdl-ttf-32bit</code> in the above command. You're all set!

=== OpenSuse Tumbleweed ===
These instructions should work for OpenSuse Leap as well, they just haven't been tested yet.
==== Dependencies ====
$ sudo zypper in libGLU1 libSDL_image-1_2-0 libSDL_ttf-2_0-0
==== Remove the included c++ library ====
The included library isn't compatible with OpenSuse's <code>libGLU1</code> package
$ cd path/to/df_linux/libs
$ rm libstdc++.so.6

cd back to df_linux/ and run the game!
$ cd ../
$ ./df
=== Wine ===
Downloading the windows version and running it with Wine works fine ([https://appdb.winehq.org/objectManager.php?sClass=version&iId=32503 platinum] on 1.7.47 as of .4x.xx, which means the program runs flawlessly without any initial user configuration). This also avoids any issues with 32-bit versus 64-bit mode.

=== Troubleshooting ===
If you get errors, it is likely that others will have had the same problem; Try searching the bay12games forum with the error message.
==== Sound ====

After installing, DF will run, but will complain that it cannot find the OpenAL library and cannot play sounds, even when OpenAL (i386) has been installed. This is due to a bug/feature in which there is no link from the name of the library that DF is looking for ("libopenal.so") to its implementation ("libopenal.so.1" - technically another link). To fix this, simply provide the necessary links in DF's own ''libs'' directory:

$ cd df_linux/libs
$ ln -s /usr/lib/i386-linux-gnu/libopenal.so.1 ./libopenal.so
$ ln -s /usr/lib/i386-linux-gnu/libsndfile.so.1 ./libsndfile.so

==== TEXT mode ====
In this mode - which can be activated in [[init.txt]] - DF uses a terminal as its display, much like classic roguelikes such as Rogue, Moria, and Nethack originally did. There are some caveats for using this mode.

Some key combinations in the default DF configuration will not work. These can be changed in game by pressing {{k|ESC}} then choosing the Key Bindings option or out of the game by editing the [[interface.txt]] file. This is due to the way terminal emulators handle input, the [https://en.wikipedia.org/wiki/Ncurses ncurses] library, and the way DF interfaces with them.{{bug|5494}} Some examples are the keypad keys with modifiers or {{k|Shift+Enter}}.

DF uses the CP437 [[Character_table|character set]] and TEXT mode translates those to UTF-8. Characters will only be displayed correctly if the font the terminal emulator is using has glyphs for all of the set. A UTF-8 encoded text file to test glyph coverage can be found [http://www.orenwatson.be/cp437.htm here]. Download the text file, view it in the terminal (using more, less, cat, etc.), and check if the font the terminal is using includes all the characters shown on the HTML version. Some terminals may be configured to use a [https://en.wikipedia.org/wiki/Fallback_font fallback font] if the main one lacks a glyph - that may result in different sized glyphs being used.

There is a [http://www.bay12forums.com/smf/index.php?topic=59983.0 utility] to convert a DF [[tileset]] to a TTF file. That thread also has downloads for some already converted sets. This does not work for graphics sets. This is one way to get a square font that includes all the characters. [https://www.kreativekorp.com/software/fonts/ksquare.shtml Kreative Square] is another though it has many more glyphs than are needed.

DF's [[colors.txt]] file will have no effect. However, many terminal emulators have settings to change the colors they display. See the terminal emulator's man page for details. Note that the order of the [[Color#Color_values|colors]] is different - the position of the blues and reds are switched as are the cyans and brown/yellow. So, when copying DF color schemes into terminal emulator settings, be sure to change them to the correct order or you'll get yellow "sky", red water, and blue blood.

Many terminal emulators have a setting to treat bright colored text as bold instead. This will cause dark grey text to be "displayed" as bold, black text - usually on a black background - making it unreadable. See the terminal emulator's man page for an option to disable this behavior. (Note that LXTerminal's disallowbold option does not currently seem to work.)

If the [[intro movie]] is enabled, DF will not use the full terminal size unless it receives a resize event. If the intro movie is disabled, DF will use the full size from the start. Note, however, that some DF screens do not use the full size of the window under any circumstance.

==== Upgrading ====

Since every new version of ''Dwarf Fortress'' unpacks in a directory named '''df_linux''' you have to manage upgrades yourself - or use the [http://dffd.wimbli.com/file.php?id=9639 Linux Updater Script]. As on all systems, 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.

==== Manually installing 32-bit libraries ====

If you do need to manually install the libraries, 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. Here are 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:
tar 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.

==== "Not found: /data/art/mouse.png" ====
===== Fix 1: Preload zlib=====
Due to incompatibilities between DF's included zlib and newer versions of zlib, libpng can fail on newer systems. A solution is to add this line to the beginning of <code>/your/path/df_linux/df</code> (or <code>/your/path/df_linux/dfhack</code> if you use [[DFHack]]):
export LD_PRELOAD=/usr/lib/libz.so.1
Note that this path can vary - be sure that it is referring to a '''32-bit''' zlib.
===== Fix 2: Use bmp instead =====
Another solution (if preloading zlib doesn't work) is to force DF to use the BMP versions of image files. You must first edit the ''/data/init/init.txt'' file and change all occurrences of "png" to "bmp". 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.<b>p</b>ng". 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!

==FreeBSD==

Although there is no official version ported to FreeBSD, ''Dwarf Fortress'' can nevertheless be run using either Wine or FreeBSD's compatibility with Linux. There is now an [https://www.freshports.org/games/linux-dwarffortress/ official port] and installing it can be done the following way (with ports):

cd /usr/ports/games/linux-dwarffortress/ && make install clean

or, with pkg:

pkg install linux-dwarffortress

You may also wish to download and run it manually. However, attempting to run the Linux version out of the blue will result in an error about missing library files. Such files must be downloaded from special linux-compatible packages or ports; using your preferred installation method, install the following:

===linux-c6===
sudo pkg install linux-c6-gtk2 linux-c6-sdl linux-c6-sdl_image linux-c6-sdl_ttf linux-c6-libGLU \
linux-c6-openal-soft linux-c6-libsndfile linux-c6-alsa-plugins-oss

===linux-f10===
If you don't have the linux-c6 ports available in your system, you can still run ''Dwarf Fortress'' (albeit without sound) using the following packages:
sudo pkg install linux-f10-alsa-lib linux-f10-atk linux-f10-cairo linux-f10-expat linux-f10-fontconfig \
linux-f10-gtk2 linux-f10-jpeg linux-f10-pango linux-f10-png linux-f10-sdl linux-f10-sdl_image linux-f10-tiff \
linux-f10-xorg-libs linux-sdl_ttf linux_base-f10 linux_dri linux-f10-libGLU
linux_dri might be optional if you have the NVIDIA driver. Note that due to the lack of a linux-f10-libsndfile port, the sound will not work. Requests are being made to [http://lists.freebsd.org/pipermail/freebsd-ports-bugs/2013-January/247698.html port] it, as well as a [https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=178474 DF] port itself.

After you install the required packages, copy (or symlink) DF's own library files to the linux-compatible directory:
cd dwarf_fortress_directory
sudo cp libs/lib* /compat/linux/usr/lib/
Or
cd dwarf_fortress_directory
sudo ln -s libs/lib* /compat/linux/usr/lib/

You can then run DF normally. Although it will likely display a bunch of warnings and errors about fonts, it should work.

If you want to avoid polluting your linux-compatible directory, you can always just set LD_LIBRARY_PATH when running df:
LD_LIBRARY_PATH=libs:$LD_LIBRARY_PATH ./df

== Chrome OS (Crostini) ==

It is possible to add ''Dwarf Fortress'' to Chrome OS using the Linux (Beta), to add Linux to Chrome OS, [https://support.google.com/chromebook/answer/9145439?p=chromebook_linuxapps check here to enable it]
You will need to edit the sources list to include the "non-free" repository, this is done by adding "non-free" to the end of the main sources file found at /etc/apt/sources.list

e.g.
# Generated by distrobuilder
deb https://deb.debian.org/debian buster main non-free
deb https://deb.debian.org/debian-security buster/updates main non-free
Followed by running
sudo apt-get update
Then just follow the Debian instructions above

== Android ==

There is no Android version, but the Windows version can be run on it using ExaGear, Eltech's Windows emulator (which is essentially Wine for Android), as documented [http://www.bay12forums.com/smf/index.php?topic=174983.0 here]. The app isn't free though.

== iOS ==

There is no iOS version, but you may remotely connect to a computer running DF through an app called [https://mifki.com/df/ Dwarf Fortress Remote]. This requires a special version of [[DFHack]] to be run on the target computer which you may download at the same time. It also provides a subscription where you connect to an already set up remote server.

= 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}}

DF2014 Talk:Installation

2019-08-15T00:33:29Z

Bachsau: /* libstdc++ compatibility */

==More info needed on Windows installation==
Currently says:
:extract the archive file to a folder somewhere
:and run the game from within the folder.

I already did the first step intuitively but <s>I am not sure how to run the game from within the folder. What file do you open?</s> okay I figured out it is Dwarf_Fortress.exe but I think it would be good to note that, will mention on the page. [[Special:Contributions/184.145.18.50|184.145.18.50]] 20:31, 27 February 2016 (UTC)

==Needed openSUSE info==

I can't find openSUSE info anywhere... --[[Special:Contributions/87.220.135.233|87.220.135.233]] 05:16, 29 April 2016 (UTC)

== 64bit support for Linux ==

Now that DF is built for amd64 much of the Linux section is unnecessary as only native libraries are needed now.
:Can confirm that the [https://www.archlinux.org/packages/community/x86_64/dwarffortress/ Arch Linux package] is x86_64 now. [[Special:Contributions/89.234.157.254|89.234.157.254]] 16:15, 18 October 2018 (UTC)
:I've updated the Debian-based instructions to clear up the dependency mess and only include the packages that you actually need; at some point I'll evaluate the current apt package on a new installation and see what other instructions it might need as well. It looks like the current package is v0.44.09, does anyone have experience getting it working? [[User:Tobultaran|Tobultaran]] ([[User talk:Tobultaran|talk]]) 22:58, 31 July 2019 (UTC)

==libstdc++ compatibility==
New installation on Debian Sid 64bit, DF 0.44.12, GCC 8.3.0. The guide works fine, but it fails with two "libs/libstdc++.so.6: version `CXXABI_1.3.8' not found (required by /usr/lib/x86_64-linux-gnu/libGLU.so.1)". It seems to get fixed (the game starts) with a "ln -sf /usr/lib/x86_64-linux-gnu/libstdc++.so.6 libs/libstdc++.so.6" like the ones for the sound (but with -f), but doing so deletes the already existing file and I don't know what's in there, so I didn't change the main page. [[User:DD|DD]] ([[User talk:DD|talk]]) 20:19, 14 August 2019 (UTC)
:Getting rid of the DF-provided libstdc++ is something I've seen suggested lots of places; I'm surprised it isn't mentioned in the article. (And removing it is fine - you don't even need the symlink step.) The [[DF2014:Installation#CentOS_7|CentOS instructions]] do that, although in a somewhat convoluted way. I'll mention it as a general Linux compatibility fix. —[[User:Lethosor|<span style="color:#074">Lethosor</span>]] ([[User talk:Lethosor|<span style="color:#092">talk</span>]]) 23:33, 14 August 2019 (UTC)
:Yes, just delete it. Bundling libstdc++ is a common MISTAKE developers keep on making ever again and it almost never works, because there are so much configuration options when compiling that it is always better to use the version shipped with a distribution. --[[User:Bachsau|Bachsau]] ([[User talk:Bachsau|talk]]) 00:33, 15 August 2019 (UTC)

User:Bachsau/Template:Welcome

2019-08-06T14:04:15Z

Bachsau:

<table border="0" cellpadding="0" cellspacing="0" style="margin:10px 0;border:1px solid #dfdfdf;padding:1em;background-color:#F8F8FF;"><tr><td style="vertical-align:top;">__TOC__</td><td style="padding-left:10px;vertical-align:top;">Welcome to my discussion page!

Please use the "<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=edit&section=new}} Add topic]</span>" tab when you start a new topic, and don't forget to add your signature (''<nowiki>--~~~~</nowiki>''). Questions asked on this page will be answered here. Answers to my questions on other user's pages are expected there. Please indent your answers with a colon.

Should you miss previous discussions, please have a look at the <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=history}} history]</span>. Once in a while I remove finished topics, and there's no sense in having an additional archive. <div style="float:right;font-size:smaller;text-align:right;"><span class="plainlinks" style="font-style:italic;">[{{fullurl:User talk:Bachsau|action=edit&oldid=235276&minor=1&summary=Archived+old+discussions}} Archive discussions]</span></div>{{Clear}}</td></tr></table>

Installation

2019-08-06T13:58:25Z

Bachsau: /* Mac */

{{Quality|Exceptional|12:06, 26 January 2015 (UTC)}}
{{av}}
<br/>
{{quick download|{{current/version/ns}}}}
<br/>
{{TOC right}}
= Download =

Free alpha builds of ''Dwarf Fortress Classic'' are available directly from the developers, Bay 12 Games, at http://www.bay12games.com/dwarves/ . The three downloads linked at the top of the main page are 64-bit versions of DF for Windows, macOS, and Linux. "All versions" links to a page with additional choices, including 32-bit builds for all platforms, "small" builds for Windows (which lack sound files), and "legacy" builds for Windows. Generally, the SDL builds for Windows should be preferred, although the Legacy builds may be necessary on some older computers.

''Dwarf Fortress'' is slated to be released on the [https://store.steampowered.com/app/975370/Dwarf_Fortress/ Steam] and [https://kitfoxgames.itch.io/dwarf-fortress itch.io] platforms in the future. These paid versions of the game will include an all-new graphical [[tileset]] and new music tracks. Additionally, the Steam version will include Steam Workshop integration for [[mod]]ding. Most other features will be shared with ''Dwarf Fortress Classic'' (which will remain available for free).

== Third-Party Packages ==

{{main|Utility:Lazy Newb Pack}}

There are several packages which bundle the game with several utilities and graphics sets, usually configurable with an included launcher. These are listed on the [[Utility:Lazy Newb Pack|Lazy Newb Pack]] page.

The ''Dwarf Fortress'' community often creates custom [[Graphics set repository|graphics sets]], [[Tileset repository|tilesets]] and [[Color_scheme#Custom_color_schemes|color schemes]]. 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]. Most notable graphics sets are included in the packs mentioned above.

= 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 by opening "Dwarf Fortress.exe".

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.

If you have an error stating that MSVCP140.dll is missing, it can be obtained by downloading [https://www.microsoft.com/en-us/download/details.aspx?id=48145 Visual C++ Redistributable for Visual Studio 2015]. When prompted choose the x64 version for 64-bit DF, or the x86 version for 32-bit DF.

== 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". Launching "dwarfort.exe" by itself will ''not'' work (since the "df" script sets up [[wikipedia:environment variables|environment variables]] pointing to DF's libraries).

On OS X 10.8 and above, you will need to [http://www.bay12games.com/dwarves/mantisbt/view.php?id=7389#c32194 update the SDL_ttf library] to run ''Dwarf Fortress''. {{bug|7389}}
* [https://www.libsdl.org/projects/SDL_ttf/release/SDL_ttf-2.0.11.dmg Download] SDL_ttf 2.0.11 and replace the file libs/SDL_ttf.framework with the one from the downloaded folder.

On OS X 10.11 and above, for the 32-bit version of DF only, you will need to [http://www.bay12games.com/dwarves/mantisbt/view.php?id=2624#c33110 update the SDL library]:
* [https://www.libsdl.org/release/SDL-1.2.15.dmg Download] SDL 1.2.15 and replace the file libs/SDL.framework with the one from the downloaded folder

On case-sensitive filesystems, the game will not launch ootb. {{bug|11136}}
* Rename "libs/SDL_ttf.framework/Versions/A/Frameworks/FreeType.framework" to "libs/SDL_ttf.framework/Versions/A/Frameworks/freetype.framework" to fix this.

Alternatively, instead of replacing SDL, you can change the PRINT_MODE setting in data/init/[[init.txt]] to STANDARD (or anything not related to 2D). {{bug|2624}}

Retina display users will also need to change PRINT_MODE to STANDARD (or any non-2D option) in [[init.txt]]. {{bug|6031}}

There is an [https://github.com/Bachsau/DF-Mac-Bundle/archive/master.zip .app-launcher] that expects the game to be installed in the "Library/Application Support/Dwarf Fortress" subdirectory of the user's home folder. It starts ''Dwarf Fortress'' without a terminal window from Launchpad or the Dock.

== Linux ==

As of 0.43.05, both 64-bit and 32-bit compiled editions are available for ''Dwarf Fortress''. For older versions you can run the 32-bit compiled edition with a 64-bit system, provided that you have the (32-bit) shared libraries available that the program needs. Note that users of 32-bit systems have to click the All Versions button on the ''Dwarf Fortress'' download page in order to get the 32-bit edition.

''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 (graphical desktop) 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.

*'''Downloading''': Either download it from the [http://www.bay12games.com/dwarves/ Dwarf Fortress Homepage], or from the terminal call (replacing "XX_YY" with the numbers in the most current ''Dwarf Fortress'' file version, found on the [http://www.bay12games.com/dwarves/ site]):
<code>wget http://www.bay12games.com/dwarves/df_XX_YY_linux.tar.bz2</code>
* '''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
cd df_linux
to change into the new directory, and
./df
to execute the ''Dwarf Fortress'' wrapper script.

(note: <code>tar -xjvf ./df_XX_YY_linux.tar.bz2</code> may be needed in some cases.)

When you installed Linux, you chose one of a 32-bit or 64-bit 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 by running the command <code>uname -m</code> in a terminal. A result of <code>x86_64</code> and <code>i686</code> would indicate a 64-bit or a 32-bit system respectively.

All that's needed now is to install the required dependencies. 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. Specific installation commands for some popular distributions are listed below.

Since ''Dwarf Fortress'' 0.43.05 is now compiled for both architectures, running natively shouldn't be an issue. However if you're wanting to run an older version of ''Dwarf Fortress'' on a 64-bit system, things get a bit trickier. Since older DF is only a 32-bit application, it will need 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, you'll need to enable the 32bit architecture in your package manager and install the relevant 32-bit libraries like libSDL. If your distribution does not include these, then you may have to supply them manually.

=== Debian-based ===

Installing the dependencies for ''Dwarf Fortress'' is simple, but varies slightly depending on whether you're running a 32-bit OS, a 64-bit OS, or a 32-bit version of ''Dwarf Fortress'' on a 64-bit OS.

==== 64-bit (recent version of ''Dwarf Fortress'', most modern machines) ====

===== Install dependencies =====

$ sudo apt-get install libsdl1.2debian libsdl-image1.2 libsdl-ttf2.0-0 libopenal1 libsndfile1 libncursesw5

This will install the SDL image and font libraries necessary, as well as libopenal and libsndfile, which are needed to get the sound working. It will also install libncursesw5, which is needed if you want to run ''Dwarf Fortress'' in ''TEXT'' mode.

===== Fix sound issues =====

Currently, ''Dwarf Fortress'' does not quite look in the correct place for the sound libraries it needs to play the wonderful music. This is easily fixed.

Switch to the ''Dwarf Fortress'' folder and add some symlinks to the correct location:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/x86_64-linux-gnu/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/x86_64-linux-gnu/libsndfile.so.1 libs/libsndfile.so

==== Running 32-bit ''Dwarf Fortress'' on 64-bit Debian ====

===== Install dependencies =====

If you're trying to run a version of ''Dwarf Fortress'' older than 0.43.05, you'll need to install the 32-bit versions of the libraries. You can do this with:

$ sudo dpkg --add-architecture i386
$ sudo apt-get update
$ sudo apt-get install libsdl1.2debian:i386 libsdl-image1.2:i386 libsdl-ttf2.0-0:i386 libopenal1:i386 libsndfile1:i386 libncursesw5:i386

===== Fix sound issues =====

Almost the same as above, but the libraries will be in a different location as you're looking for the 32-bit versions:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/i386-linux-gnu/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/i386-linux-gnu/libsndfile.so.1 libs/libsndfile.so

==== 32-bit ====

===== Install dependencies =====

$ sudo apt-get install libsdl1.2debian libsdl-image1.2 libsdl-ttf2.0-0 libopenal1 libsndfile1 libncursesw5

As above, this will install the SDL image and font libraries, sound libraries, and text libraries.

===== Fix sound issues =====

Switch to the ''Dwarf Fortress'' folder and add some symlinks to the correct location:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/libsndfile.so.1 libs/libsndfile.so

==== Standard package ====

''Dwarf Fortress'' is also available as a package in the (non-free) Debian repositories. You can install it (with all dependencies) with a simple

$ sudo apt-get install dwarf-fortress

=== Fedora ===

''Dwarf Fortress'' has been packaged in [https://rpmfusion.org/ RPM Fusion Nonfree], using a similar method as it is done in Arch Linux (see below). After [https://rpmfusion.org/Configuration installing RPM Fusion] you can simply run the following commands to install and run ''Dwarf Fortress'', which will pull in all the required dependencies:

$ sudo dnf install dwarffortress
$ dwarffortress

Some other tools are provided by the same packager in the [https://mars.arosser.com/fedora/dwarffortress/dwarffortress.repo "Dwarf Fortress for Fedora"] repository. For more information please [http://www.bay12forums.com/smf/index.php?topic=158289.msg7009116#msg7009116 see this forum thread].

If you want to install 64-bit ''Dwarf Fortress'' manually, you can run the following:

$ sudo dnf install SDL SDL_image SDL_ttf gtk2-devel openal-soft alsa-lib alsa-plugins-pulseaudio mesa-dri-drivers

On 64-bit Fedora installations, to install 32-bit ''Dwarf Fortress'' you can install 32-bit libraries by appending ".i686" to the package name:

$ sudo dnf install SDL.i686 SDL_image.i686 SDL_ttf.i686 gtk2-devel.i686 openal-soft.i686 alsa-lib.i686 alsa-plugins-pulseaudio.i686 mesa-dri-drivers.i686

Fedora installs all 32-bit libraries to /usr/lib and 64-bit libraries to /usr/lib64 (with /lib and /lib64 being links to these two directories), so if you need to install stuff manually, look in there.

=== Arch Linux ===
Although ''Dwarf Fortress'' may be installed using the method above (with some modifications), it is available through pacman (Arch Linux's package management system), in the [community], for 32-bit, and the [multilib], for 64-bit, repositories. These packages are updated as ''Dwarf Fortress'' is updated, and handle required dependencies.

==== 32-bit ====
All of the following commands must be run as root

First, download and install ''Dwarf Fortress'' with pacman
pacman -S dwarffortress
Any required dependencies will be installed, too.

Next you need to add the user(s) that will be playing the game to the games group
gpasswd -a [users] games

Any users you added to the games group must now be logged out, if they were logged in

Now ''Dwarf Fortress'' should be playable by typing:
dwarffortress
As any user in the games group. Any edits to game files must be done in the '.dwarffortress' directory in the user's home directory, not /opt/dwarffortress.

==== 64-Bit ====
Installing ''Dwarf Fortress'' on 64-bit installs of Arch Linux is the same as installing it on 32-bit systems, with the exception of the [multilib] repository needing to be enabled prior to install.

These commands also must be run as root.

To enable the [multilib] repository run:
nano /etc/pacman.conf
And delete the pound symbol(#) in front of these three lines (Make sure the top one says #[multilib] NOT #[multilib-testing]. Note that the <code>SigLevel</code> line may not be present under [multilib] and it will most likely be higher up in the pacman.conf. This is fine and you can then simply remove the pound symbol from the two other lines.
#[multilib]
#SigLevel = PackageRequired
#Include = /etc/pacman.d/mirrorlist
So that they look like this
[multilib]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist
Save the file by typing
ctrl x

Then run:
pacman -Syyu

===== Sound and Graphics =====

After that you can continue the install as detailed in the 32-bit section. Required 32-bit dependencies will automatically be installed, however you may have to install more dependencies, depending on what sound support you use, and your graphics card

If you use alsa sound, install lib32-alsa-lib with:
pacman -S lib32-alsa-lib

If use use pulse sound install lib32-libpulse with:
pacman -S lib32-libpulse

You will also need to install a 32-bit graphics driver. Install the driver from multilib that corresponds to your driver/device on [https://wiki.archlinux.org/index.php/Xorg#Driver_installation this chart]. ''For example'', if you have xf86-video-nouveau installed, you would run:
pacman -S lib32-mesa-libgl

If you don't know what driver/device you're currently using run:
lspci -k

Find the line that starts with "VGA compatible controller." Your driver will be listed under "kernel driver in use", like so:
01:00.0 VGA compatible controller: NVIDIA Corporation GK106M [GeForce GTX 765M] (rev a1)
Subsystem: ASUSTeK Computer Inc. Device 119d
Kernel driver in use: nvidia
Kernel modules: nouveau, nvidia

If you are using/wish to use the AMD catalyst drivers, please note that they are no longer available within the main arch repositories. You will have to install them from the AUR. [https://wiki.archlinux.org/index.php/AMD_Catalyst#Installation See here for more information.]

If you have Nvidia graphics, you may also want to install lib32-nvidia-utils with:
pacman -S lib32-nvidia-utils

=== CentOS 7 ===

''Dwarf Fortress'' is now 64-bit, so simply run:

sudo yum install SDL SDL_image SDL_ttf openal

Note that CentOS 7 ships with glibc 2.17, but ''Dwarf Fortress'' by default would like 2.18. [http://www.bay12games.com/dwarves/mantisbt/view.php?id=9893 This bug] has a fix, simply copy the [http://pastebin.com/jX4Wf062 Pastebin script], then move the libraries into a new folder.

cd df_linux
curl -L http://pastebin.com/raw/jX4Wf062 > df
mkdir c_libs
mv libs/libgcc_s.so.1 libs/libstdc++.so.6 c_libs/
chmod a+x df

Then run it!
./df

=== Gentoo ===

There is a ''Dwarf Fortress'' [https://packages.gentoo.org/package/games-roguelike/dwarf-fortress ebuild] in the main Gentoo's portage tree compatible with the new multilib support.

# emerge -av games-roguelike/dwarf-fortress

=== Solus ===

Download ''Dwarf Fortress'' from the Bay 12 Games website. If you encounter the following error upon launch:

./libs/Dwarf_Fortress: error while loading shared libraries: libSDL_ttf-2.0.so.0: cannot open shared object file: No such file or directory

then simply run the following command to install the missing libraries:

sudo eopkg install sdl-ttf

If you are running a 32bit version of ''Dwarf Fortress'', simply replace <code>sdl-ttf</code> with <code>sdl-ttf-32bit</code> in the above command. You're all set!

=== Wine ===
Downloading the windows version and running it with Wine works fine ([https://appdb.winehq.org/objectManager.php?sClass=version&iId=32503 platinum] on 1.7.47 as of .4x.xx, which means the program runs flawlessly without any initial user configuration). This also avoids any issues with 32-bit versus 64-bit mode.

=== Troubleshooting ===
If you get errors, it is likely that others will have had the same problem; Try searching the bay12games forum with the error message.
==== Sound ====

After installing, DF will run, but will complain that it cannot find the OpenAL library and cannot play sounds, even when OpenAL (i386) has been installed. This is due to a bug/feature in which there is no link from the name of the library that DF is looking for ("libopenal.so") to its implementation ("libopenal.so.1" - technically another link). To fix this, simply provide the necessary links in DF's own ''libs'' directory:

$ cd df_linux/libs
$ ln -s /usr/lib/i386-linux-gnu/libopenal.so.1 ./libopenal.so
$ ln -s /usr/lib/i386-linux-gnu/libsndfile.so.1 ./libsndfile.so

==== Upgrading ====

Since every new version of ''Dwarf Fortress'' unpacks in a directory named '''df_linux''' you have to manage upgrades yourself - or use the [http://dffd.wimbli.com/file.php?id=9639 Linux Updater Script]. As on all systems, 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.

==== Manually installing 32-bit libraries ====

If you do need to manually install the libraries, 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. Here are 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:
tar 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.

==== "Not found: /data/art/mouse.png" ====
===== Fix 1: Preload zlib=====
Due to incompatibilities between DF's included zlib and newer versions of zlib, libpng can fail on newer systems. A solution is to add this line to the beginning of <code>/your/path/df_linux/df</code> (or <code>/your/path/df_linux/dfhack</code> if you use [[DFHack]]):
export LD_PRELOAD=/usr/lib/libz.so.1
Note that this path can vary - be sure that it is referring to a '''32-bit''' zlib.
===== Fix 2: Use bmp instead =====
Another solution (if preloading zlib doesn't work) is to force DF to use the BMP versions of image files. You must first edit the ''/data/init/init.txt'' file and change all occurrences of "png" to "bmp". 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.<b>p</b>ng". 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!

==FreeBSD==

Although there is no official version ported to FreeBSD, ''Dwarf Fortress'' can nevertheless be run using either Wine or FreeBSD's compatibility with Linux. However, attempting to run the Linux version out of the blue will result in an error about missing library files. Such files must be downloaded from special linux-compatible packages or ports; using your preferred installation method, install the following:

===linux-c6===
sudo pkg install linux-c6-gtk2 linux-c6-sdl linux-c6-sdl_image linux-c6-sdl_ttf linux-c6-libGLU \
linux-c6-openal-soft linux-c6-libsndfile linux-c6-alsa-plugins-oss

===linux-f10===
If you don't have the linux-c6 ports available in your system, you can still run ''Dwarf Fortress'' (albeit without sound) using the following packages:
sudo pkg install linux-f10-alsa-lib linux-f10-atk linux-f10-cairo linux-f10-expat linux-f10-fontconfig \
linux-f10-gtk2 linux-f10-jpeg linux-f10-pango linux-f10-png linux-f10-sdl linux-f10-sdl_image linux-f10-tiff \
linux-f10-xorg-libs linux-sdl_ttf linux_base-f10 linux_dri linux-f10-libGLU
linux_dri might be optional if you have the NVIDIA driver. Note that due to the lack of a linux-f10-libsndfile port, the sound will not work. Requests are being made to [http://lists.freebsd.org/pipermail/freebsd-ports-bugs/2013-January/247698.html port] it, as well as a [https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=178474 DF] port itself.

After you install the required packages, copy (or symlink) DF's own library files to the linux-compatible directory:
cd dwarf_fortress_directory
sudo cp libs/lib* /compat/linux/usr/lib/
Or
cd dwarf_fortress_directory
sudo ln -s libs/lib* /compat/linux/usr/lib/

You can then run df normally. Although it will likely display a bunch of warnings and errors about fonts, it should work.

If you want to avoid polluting your linux-compatible directory, you can always just set LD_LIBRARY_PATH when running df:
LD_LIBRARY_PATH=libs:$LD_LIBRARY_PATH ./df

= 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}}

Installation

2019-08-06T13:51:12Z

Bachsau: /* Mac */

{{Quality|Exceptional|12:06, 26 January 2015 (UTC)}}
{{av}}
<br/>
{{quick download|{{current/version/ns}}}}
<br/>
{{TOC right}}
= Download =

Free alpha builds of ''Dwarf Fortress Classic'' are available directly from the developers, Bay 12 Games, at http://www.bay12games.com/dwarves/ . The three downloads linked at the top of the main page are 64-bit versions of DF for Windows, macOS, and Linux. "All versions" links to a page with additional choices, including 32-bit builds for all platforms, "small" builds for Windows (which lack sound files), and "legacy" builds for Windows. Generally, the SDL builds for Windows should be preferred, although the Legacy builds may be necessary on some older computers.

''Dwarf Fortress'' is slated to be released on the [https://store.steampowered.com/app/975370/Dwarf_Fortress/ Steam] and [https://kitfoxgames.itch.io/dwarf-fortress itch.io] platforms in the future. These paid versions of the game will include an all-new graphical [[tileset]] and new music tracks. Additionally, the Steam version will include Steam Workshop integration for [[mod]]ding. Most other features will be shared with ''Dwarf Fortress Classic'' (which will remain available for free).

== Third-Party Packages ==

{{main|Utility:Lazy Newb Pack}}

There are several packages which bundle the game with several utilities and graphics sets, usually configurable with an included launcher. These are listed on the [[Utility:Lazy Newb Pack|Lazy Newb Pack]] page.

The ''Dwarf Fortress'' community often creates custom [[Graphics set repository|graphics sets]], [[Tileset repository|tilesets]] and [[Color_scheme#Custom_color_schemes|color schemes]]. 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]. Most notable graphics sets are included in the packs mentioned above.

= 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 by opening "Dwarf Fortress.exe".

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.

If you have an error stating that MSVCP140.dll is missing, it can be obtained by downloading [https://www.microsoft.com/en-us/download/details.aspx?id=48145 Visual C++ Redistributable for Visual Studio 2015]. When prompted choose the x64 version for 64-bit DF, or the x86 version for 32-bit DF.

== 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". Launching "dwarfort.exe" by itself will ''not'' work (since the "df" script sets up [[wikipedia:environment variables|environment variables]] pointing to DF's libraries).

On OS X 10.8 and above, you will need to [http://www.bay12games.com/dwarves/mantisbt/view.php?id=7389#c32194 update the SDL_ttf library] to run ''Dwarf Fortress''. {{bug|7389}}
* [https://www.libsdl.org/projects/SDL_ttf/release/SDL_ttf-2.0.11.dmg Download] SDL_ttf 2.0.11 and replace the file libs/SDL_ttf.framework with the one from the downloaded folder.

On OS X 10.11 and above, for the 32-bit version of DF only, you will need to [http://www.bay12games.com/dwarves/mantisbt/view.php?id=2624#c33110 update the SDL library]:
* [https://www.libsdl.org/release/SDL-1.2.15.dmg Download] SDL 1.2.15 and replace the file libs/SDL.framework with the one from the downloaded folder

On case-sensitive filesystems, the game will not launch ootb. {{bug|11136}}
* Rename "libs/SDL_ttf.framework/Versions/A/Frameworks/FreeType.framework" to "libs/SDL_ttf.framework/Versions/A/Frameworks/freetype.framework" to fix this.

Alternatively, instead of replacing SDL, you can change the PRINT_MODE setting in data/init/[[init.txt]] to STANDARD (or anything not related to 2D). {{bug|2624}}

Retina display users will also need to change PRINT_MODE to STANDARD (or any non-2D option) in [[init.txt]]. {{bug|6031}}

== Linux ==

As of 0.43.05, both 64-bit and 32-bit compiled editions are available for ''Dwarf Fortress''. For older versions you can run the 32-bit compiled edition with a 64-bit system, provided that you have the (32-bit) shared libraries available that the program needs. Note that users of 32-bit systems have to click the All Versions button on the ''Dwarf Fortress'' download page in order to get the 32-bit edition.

''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 (graphical desktop) 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.

*'''Downloading''': Either download it from the [http://www.bay12games.com/dwarves/ Dwarf Fortress Homepage], or from the terminal call (replacing "XX_YY" with the numbers in the most current ''Dwarf Fortress'' file version, found on the [http://www.bay12games.com/dwarves/ site]):
<code>wget http://www.bay12games.com/dwarves/df_XX_YY_linux.tar.bz2</code>
* '''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
cd df_linux
to change into the new directory, and
./df
to execute the ''Dwarf Fortress'' wrapper script.

(note: <code>tar -xjvf ./df_XX_YY_linux.tar.bz2</code> may be needed in some cases.)

When you installed Linux, you chose one of a 32-bit or 64-bit 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 by running the command <code>uname -m</code> in a terminal. A result of <code>x86_64</code> and <code>i686</code> would indicate a 64-bit or a 32-bit system respectively.

All that's needed now is to install the required dependencies. 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. Specific installation commands for some popular distributions are listed below.

Since ''Dwarf Fortress'' 0.43.05 is now compiled for both architectures, running natively shouldn't be an issue. However if you're wanting to run an older version of ''Dwarf Fortress'' on a 64-bit system, things get a bit trickier. Since older DF is only a 32-bit application, it will need 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, you'll need to enable the 32bit architecture in your package manager and install the relevant 32-bit libraries like libSDL. If your distribution does not include these, then you may have to supply them manually.

=== Debian-based ===

Installing the dependencies for ''Dwarf Fortress'' is simple, but varies slightly depending on whether you're running a 32-bit OS, a 64-bit OS, or a 32-bit version of ''Dwarf Fortress'' on a 64-bit OS.

==== 64-bit (recent version of ''Dwarf Fortress'', most modern machines) ====

===== Install dependencies =====

$ sudo apt-get install libsdl1.2debian libsdl-image1.2 libsdl-ttf2.0-0 libopenal1 libsndfile1 libncursesw5

This will install the SDL image and font libraries necessary, as well as libopenal and libsndfile, which are needed to get the sound working. It will also install libncursesw5, which is needed if you want to run ''Dwarf Fortress'' in ''TEXT'' mode.

===== Fix sound issues =====

Currently, ''Dwarf Fortress'' does not quite look in the correct place for the sound libraries it needs to play the wonderful music. This is easily fixed.

Switch to the ''Dwarf Fortress'' folder and add some symlinks to the correct location:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/x86_64-linux-gnu/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/x86_64-linux-gnu/libsndfile.so.1 libs/libsndfile.so

==== Running 32-bit ''Dwarf Fortress'' on 64-bit Debian ====

===== Install dependencies =====

If you're trying to run a version of ''Dwarf Fortress'' older than 0.43.05, you'll need to install the 32-bit versions of the libraries. You can do this with:

$ sudo dpkg --add-architecture i386
$ sudo apt-get update
$ sudo apt-get install libsdl1.2debian:i386 libsdl-image1.2:i386 libsdl-ttf2.0-0:i386 libopenal1:i386 libsndfile1:i386 libncursesw5:i386

===== Fix sound issues =====

Almost the same as above, but the libraries will be in a different location as you're looking for the 32-bit versions:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/i386-linux-gnu/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/i386-linux-gnu/libsndfile.so.1 libs/libsndfile.so

==== 32-bit ====

===== Install dependencies =====

$ sudo apt-get install libsdl1.2debian libsdl-image1.2 libsdl-ttf2.0-0 libopenal1 libsndfile1 libncursesw5

As above, this will install the SDL image and font libraries, sound libraries, and text libraries.

===== Fix sound issues =====

Switch to the ''Dwarf Fortress'' folder and add some symlinks to the correct location:

$ cd ~/df_linux # or other location, depending on where you installed ''Dwarf Fortress''
$ ln -s /usr/lib/libopenal.so.1 libs/libopenal.so
$ ln -s /usr/lib/libsndfile.so.1 libs/libsndfile.so

==== Standard package ====

''Dwarf Fortress'' is also available as a package in the (non-free) Debian repositories. You can install it (with all dependencies) with a simple

$ sudo apt-get install dwarf-fortress

=== Fedora ===

''Dwarf Fortress'' has been packaged in [https://rpmfusion.org/ RPM Fusion Nonfree], using a similar method as it is done in Arch Linux (see below). After [https://rpmfusion.org/Configuration installing RPM Fusion] you can simply run the following commands to install and run ''Dwarf Fortress'', which will pull in all the required dependencies:

$ sudo dnf install dwarffortress
$ dwarffortress

Some other tools are provided by the same packager in the [https://mars.arosser.com/fedora/dwarffortress/dwarffortress.repo "Dwarf Fortress for Fedora"] repository. For more information please [http://www.bay12forums.com/smf/index.php?topic=158289.msg7009116#msg7009116 see this forum thread].

If you want to install 64-bit ''Dwarf Fortress'' manually, you can run the following:

$ sudo dnf install SDL SDL_image SDL_ttf gtk2-devel openal-soft alsa-lib alsa-plugins-pulseaudio mesa-dri-drivers

On 64-bit Fedora installations, to install 32-bit ''Dwarf Fortress'' you can install 32-bit libraries by appending ".i686" to the package name:

$ sudo dnf install SDL.i686 SDL_image.i686 SDL_ttf.i686 gtk2-devel.i686 openal-soft.i686 alsa-lib.i686 alsa-plugins-pulseaudio.i686 mesa-dri-drivers.i686

Fedora installs all 32-bit libraries to /usr/lib and 64-bit libraries to /usr/lib64 (with /lib and /lib64 being links to these two directories), so if you need to install stuff manually, look in there.

=== Arch Linux ===
Although ''Dwarf Fortress'' may be installed using the method above (with some modifications), it is available through pacman (Arch Linux's package management system), in the [community], for 32-bit, and the [multilib], for 64-bit, repositories. These packages are updated as ''Dwarf Fortress'' is updated, and handle required dependencies.

==== 32-bit ====
All of the following commands must be run as root

First, download and install ''Dwarf Fortress'' with pacman
pacman -S dwarffortress
Any required dependencies will be installed, too.

Next you need to add the user(s) that will be playing the game to the games group
gpasswd -a [users] games

Any users you added to the games group must now be logged out, if they were logged in

Now ''Dwarf Fortress'' should be playable by typing:
dwarffortress
As any user in the games group. Any edits to game files must be done in the '.dwarffortress' directory in the user's home directory, not /opt/dwarffortress.

==== 64-Bit ====
Installing ''Dwarf Fortress'' on 64-bit installs of Arch Linux is the same as installing it on 32-bit systems, with the exception of the [multilib] repository needing to be enabled prior to install.

These commands also must be run as root.

To enable the [multilib] repository run:
nano /etc/pacman.conf
And delete the pound symbol(#) in front of these three lines (Make sure the top one says #[multilib] NOT #[multilib-testing]. Note that the <code>SigLevel</code> line may not be present under [multilib] and it will most likely be higher up in the pacman.conf. This is fine and you can then simply remove the pound symbol from the two other lines.
#[multilib]
#SigLevel = PackageRequired
#Include = /etc/pacman.d/mirrorlist
So that they look like this
[multilib]
SigLevel = PackageRequired
Include = /etc/pacman.d/mirrorlist
Save the file by typing
ctrl x

Then run:
pacman -Syyu

===== Sound and Graphics =====

After that you can continue the install as detailed in the 32-bit section. Required 32-bit dependencies will automatically be installed, however you may have to install more dependencies, depending on what sound support you use, and your graphics card

If you use alsa sound, install lib32-alsa-lib with:
pacman -S lib32-alsa-lib

If use use pulse sound install lib32-libpulse with:
pacman -S lib32-libpulse

You will also need to install a 32-bit graphics driver. Install the driver from multilib that corresponds to your driver/device on [https://wiki.archlinux.org/index.php/Xorg#Driver_installation this chart]. ''For example'', if you have xf86-video-nouveau installed, you would run:
pacman -S lib32-mesa-libgl

If you don't know what driver/device you're currently using run:
lspci -k

Find the line that starts with "VGA compatible controller." Your driver will be listed under "kernel driver in use", like so:
01:00.0 VGA compatible controller: NVIDIA Corporation GK106M [GeForce GTX 765M] (rev a1)
Subsystem: ASUSTeK Computer Inc. Device 119d
Kernel driver in use: nvidia
Kernel modules: nouveau, nvidia

If you are using/wish to use the AMD catalyst drivers, please note that they are no longer available within the main arch repositories. You will have to install them from the AUR. [https://wiki.archlinux.org/index.php/AMD_Catalyst#Installation See here for more information.]

If you have Nvidia graphics, you may also want to install lib32-nvidia-utils with:
pacman -S lib32-nvidia-utils

=== CentOS 7 ===

''Dwarf Fortress'' is now 64-bit, so simply run:

sudo yum install SDL SDL_image SDL_ttf openal

Note that CentOS 7 ships with glibc 2.17, but ''Dwarf Fortress'' by default would like 2.18. [http://www.bay12games.com/dwarves/mantisbt/view.php?id=9893 This bug] has a fix, simply copy the [http://pastebin.com/jX4Wf062 Pastebin script], then move the libraries into a new folder.

cd df_linux
curl -L http://pastebin.com/raw/jX4Wf062 > df
mkdir c_libs
mv libs/libgcc_s.so.1 libs/libstdc++.so.6 c_libs/
chmod a+x df

Then run it!
./df

=== Gentoo ===

There is a ''Dwarf Fortress'' [https://packages.gentoo.org/package/games-roguelike/dwarf-fortress ebuild] in the main Gentoo's portage tree compatible with the new multilib support.

# emerge -av games-roguelike/dwarf-fortress

=== Solus ===

Download ''Dwarf Fortress'' from the Bay 12 Games website. If you encounter the following error upon launch:

./libs/Dwarf_Fortress: error while loading shared libraries: libSDL_ttf-2.0.so.0: cannot open shared object file: No such file or directory

then simply run the following command to install the missing libraries:

sudo eopkg install sdl-ttf

If you are running a 32bit version of ''Dwarf Fortress'', simply replace <code>sdl-ttf</code> with <code>sdl-ttf-32bit</code> in the above command. You're all set!

=== Wine ===
Downloading the windows version and running it with Wine works fine ([https://appdb.winehq.org/objectManager.php?sClass=version&iId=32503 platinum] on 1.7.47 as of .4x.xx, which means the program runs flawlessly without any initial user configuration). This also avoids any issues with 32-bit versus 64-bit mode.

=== Troubleshooting ===
If you get errors, it is likely that others will have had the same problem; Try searching the bay12games forum with the error message.
==== Sound ====

After installing, DF will run, but will complain that it cannot find the OpenAL library and cannot play sounds, even when OpenAL (i386) has been installed. This is due to a bug/feature in which there is no link from the name of the library that DF is looking for ("libopenal.so") to its implementation ("libopenal.so.1" - technically another link). To fix this, simply provide the necessary links in DF's own ''libs'' directory:

$ cd df_linux/libs
$ ln -s /usr/lib/i386-linux-gnu/libopenal.so.1 ./libopenal.so
$ ln -s /usr/lib/i386-linux-gnu/libsndfile.so.1 ./libsndfile.so

==== Upgrading ====

Since every new version of ''Dwarf Fortress'' unpacks in a directory named '''df_linux''' you have to manage upgrades yourself - or use the [http://dffd.wimbli.com/file.php?id=9639 Linux Updater Script]. As on all systems, 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.

==== Manually installing 32-bit libraries ====

If you do need to manually install the libraries, 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. Here are 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:
tar 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.

==== "Not found: /data/art/mouse.png" ====
===== Fix 1: Preload zlib=====
Due to incompatibilities between DF's included zlib and newer versions of zlib, libpng can fail on newer systems. A solution is to add this line to the beginning of <code>/your/path/df_linux/df</code> (or <code>/your/path/df_linux/dfhack</code> if you use [[DFHack]]):
export LD_PRELOAD=/usr/lib/libz.so.1
Note that this path can vary - be sure that it is referring to a '''32-bit''' zlib.
===== Fix 2: Use bmp instead =====
Another solution (if preloading zlib doesn't work) is to force DF to use the BMP versions of image files. You must first edit the ''/data/init/init.txt'' file and change all occurrences of "png" to "bmp". 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.<b>p</b>ng". 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!

==FreeBSD==

Although there is no official version ported to FreeBSD, ''Dwarf Fortress'' can nevertheless be run using either Wine or FreeBSD's compatibility with Linux. However, attempting to run the Linux version out of the blue will result in an error about missing library files. Such files must be downloaded from special linux-compatible packages or ports; using your preferred installation method, install the following:

===linux-c6===
sudo pkg install linux-c6-gtk2 linux-c6-sdl linux-c6-sdl_image linux-c6-sdl_ttf linux-c6-libGLU \
linux-c6-openal-soft linux-c6-libsndfile linux-c6-alsa-plugins-oss

===linux-f10===
If you don't have the linux-c6 ports available in your system, you can still run ''Dwarf Fortress'' (albeit without sound) using the following packages:
sudo pkg install linux-f10-alsa-lib linux-f10-atk linux-f10-cairo linux-f10-expat linux-f10-fontconfig \
linux-f10-gtk2 linux-f10-jpeg linux-f10-pango linux-f10-png linux-f10-sdl linux-f10-sdl_image linux-f10-tiff \
linux-f10-xorg-libs linux-sdl_ttf linux_base-f10 linux_dri linux-f10-libGLU
linux_dri might be optional if you have the NVIDIA driver. Note that due to the lack of a linux-f10-libsndfile port, the sound will not work. Requests are being made to [http://lists.freebsd.org/pipermail/freebsd-ports-bugs/2013-January/247698.html port] it, as well as a [https://bugs.freebsd.org/bugzilla/show_bug.cgi?id=178474 DF] port itself.

After you install the required packages, copy (or symlink) DF's own library files to the linux-compatible directory:
cd dwarf_fortress_directory
sudo cp libs/lib* /compat/linux/usr/lib/
Or
cd dwarf_fortress_directory
sudo ln -s libs/lib* /compat/linux/usr/lib/

You can then run df normally. Although it will likely display a bunch of warnings and errors about fonts, it should work.

If you want to avoid polluting your linux-compatible directory, you can always just set LD_LIBRARY_PATH when running df:
LD_LIBRARY_PATH=libs:$LD_LIBRARY_PATH ./df

= 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}}

User:Bachsau

2018-03-01T15:07:52Z

Bachsau: User Page

Welcome to my user page! I'll expand this page when I've time to.

User:Bachsau

2018-03-01T15:07:38Z

Bachsau: User Page

Welcome to my user page! My home wiki is the german wikipedia. I'll expand this page when I've time to.

Category:Noindexed pages

2018-03-01T15:06:18Z

Bachsau: A system category that should exist. Used by __NOINDEX__ magical word.

System category containing pages not indexed by search engines.

User talk:Bachsau/Template:Welcome

2018-03-01T15:04:01Z

Bachsau: User talk:Bachsau

#REDIRECT [[User talk:Bachsau]]

User:Bachsau/Template:Welcome

2018-03-01T15:02:41Z

Bachsau: Bugfix

<table border="0" cellpadding="0" cellspacing="0" style="margin:10px 0;border:1px solid #dfdfdf;padding:1em;background-color:#F8F8FF;"><tr><td style="vertical-align:top;">__TOC__</td><td style="padding-left:10px;vertical-align:top;">Welcome to my discussion page!

Please use the "<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=edit&section=new}} Add topic]</span>" tab when you start a new topic, and don't forget to add your signature (''<nowiki>--~~~~</nowiki>''). Questions asked on this page will be answered here. Answers to my questions on other user's pages are expected there. Please inset your answers with a colon.

Should you miss previous discussions, please have a look at the <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=history}} history]</span>. Once in a while I remove finished topics, and there's no sense in having an additional archive. <div style="float:right;font-size:smaller;text-align:right;"><span class="plainlinks" style="font-style:italic;">[{{fullurl:User talk:Bachsau|action=edit&oldid=235276&minor=1&summary=Archived+old+discussions}} Archive discussions]</span></div>{{Clear}}</td></tr></table>

User:Bachsau/Template:Welcome

2018-03-01T14:56:25Z

Bachsau: Introduction to my discussion page

<table border="0" cellpadding="0" cellspacing="0" style="margin:10px 0;border:1px solid #dfdfdf;padding:1em;background-color:#F8F8FF;"><tr><td style="vertical-align:top;">__TOC__</td><td style="padding-left:10px;vertical-align:top;">Welcome to my discussion page!

Please use the "<span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=edit&section=new}} Add topic]</span>" tab when you start a new topic, and don't forget to add your signature (''<nowiki>--~~~~</nowiki>''). Questions asked on this page will be answered here. Answers to my questions on other user's pages are expected there. Please inset your answers with a colon.

Should you miss previous discussions, please have a look at the <span class="plainlinks">[{{fullurl:{{FULLPAGENAME}}|action=history}} history]</span>. Once in a while I remove finished topics, and there's no sense in having an additional archive. <div style="float:right;font-size:smaller;text-align:right;"><span class="plainlinks" style="font-style:italic;">[{{fullurl:User talk:Bachsau|action=edit&oldid=235276&minor=1&summary=Archived+old+discussions}} Archive discussions]</span></div>{{Clear}}</div></td></tr></table>

User talk:Bachsau

2018-03-01T14:50:44Z

Bachsau: Reset Base #1

__NOINDEX__ {{User:Bachsau/Template:Welcome}}