v50 Steam/Premium information for editors
- v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
- Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.
Editing v0.34:Installation
Jump to navigation
Jump to search
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
You are editing a page for an older version of Dwarf Fortress ("Main" is the current version, not "v0.34"). Please make sure you intend to do this. If you are here by mistake, see the current page instead.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 8: | Line 8: | ||
You can also download the latest version here: | You can also download the latest version here: | ||
− | {{News/Mirrors/ | + | {{News/Mirrors/{{current/version}}}} |
Windows users should generally download one of the "Main" (SDL) versions (listed in the first row), unless the "Legacy" version is required for some reason. The "1" and "2" links are mirrors (but should be identical to their Bay12-hosted counterparts), and the "Small" link does not include [[music|sound]]. | Windows users should generally download one of the "Main" (SDL) versions (listed in the first row), unless the "Legacy" version is required for some reason. The "1" and "2" links are mirrors (but should be identical to their Bay12-hosted counterparts), and the "Small" link does not include [[music|sound]]. | ||
Line 15: | Line 15: | ||
== Third-Party Packages == | == Third-Party Packages == | ||
− | + | ||
− | *[http://www.bay12forums.com/smf/index.php?topic=126076 PeridexisErrant's Dwarf Fortress Starter Pack] (Windows) - A more comprehensive, and more importantly, up-to-date | + | *[http://www.bay12forums.com/smf/index.php?topic=126076 PeridexisErrant's Dwarf Fortress Starter Pack] (Windows) - A more comprehensive, and more importantly, up-to-date interpretation of the Lazy Newb Pack. As with the Lazy Newb Pack, PeridexisErrant's Dwarf Fortress Starter Pack has the full game plus utilities and graphics sets in one big package with tweaks to fix a lot of common bugs. Everything is preconfigured to work out of the box, and many options can be manually changed. |
*[http://www.bay12forums.com/smf/index.php?topic=128960 Fricy's MacNewbie] - essentially the Lazy Newb Pack, for OS X. | *[http://www.bay12forums.com/smf/index.php?topic=128960 Fricy's MacNewbie] - essentially the Lazy Newb Pack, for OS X. | ||
− | *[http://www.bay12forums.com/smf/index.php?topic=130792 Linux Lazy Newb Pack | + | *[http://www.bay12forums.com/smf/index.php?topic=130792 Linux Lazy Newb Pack] - exactly what it says. This will also try to find missing dependencies and so on. |
The Dwarf Fortress community often creates custom [[Graphics set repository|graphics sets]] and [[Tilesets|tilesets]]. They're like graphical mods that make DF look prettier or just different. A lot of people pack the game folder with the tileset installed and everything already set up, so all you have to do is extract and play. Among the most popular of these are [http://www.bay12forums.com/smf/index.php?topic=53180.0 Ironhand's Graphics Set] and [http://www.bay12forums.com/smf/index.php?topic=57557.0 Phoebus' Graphic Set]. Most notable graphics sets are included in the packs above. | The Dwarf Fortress community often creates custom [[Graphics set repository|graphics sets]] and [[Tilesets|tilesets]]. They're like graphical mods that make DF look prettier or just different. A lot of people pack the game folder with the tileset installed and everything already set up, so all you have to do is extract and play. Among the most popular of these are [http://www.bay12forums.com/smf/index.php?topic=53180.0 Ironhand's Graphics Set] and [http://www.bay12forums.com/smf/index.php?topic=57557.0 Phoebus' Graphic Set]. Most notable graphics sets are included in the packs above. | ||
Line 31: | Line 31: | ||
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. | Make sure to actually ''extract'' the archive; do not just open the archive and run the game from the window that appears. If you do this then it may appear to work, but your save game data will get discarded. This is the cause of many "my saved games keep getting deleted" complaints. The game also needs to be able to write to its own folder, so do '''not''' install it in C:\Program Files if you are running Windows Vista or later. | ||
− | == | + | == Mac == |
− | The | + | 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). | 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). | ||
Line 50: | Line 50: | ||
* '''Running''': Run '''./df''' to execute the Dwarf Fortress wrapper script. | * '''Running''': Run '''./df''' to execute the Dwarf Fortress wrapper script. | ||
* '''Troubleshooting''': If you get an error like this: | * '''Troubleshooting''': If you get an error like this: | ||
− | + | ./libs/Dwarf_Fortress: error while loading shared libraries: libSDL_image-1.2.so.0: | |
− | + | cannot open shared object file: No such file or directory | |
− | + | : it means that your system is missing one or more shared libraries. | |
− | |||
− | it means that your system is missing one or more shared libraries. | ||
To fix this problem run the following command in a new terminal: | To fix this problem run the following command in a new terminal: | ||
− | |||
− | |||
− | |||
− | |||
Ubuntu 14 (or systems without ia32-libs): | Ubuntu 14 (or systems without ia32-libs): | ||
− | + | sudo apt-get install libgtk2.0-0:i386 libglu1-mesa:i386 libsdl-image1.2:i386 libsdl-sound1.2:i386 libsdl-ttf2.0-0:i386 | |
− | |||
Ubuntu 13 and below: | Ubuntu 13 and below: | ||
− | + | sudo apt-get install ia32-libs libsdl-image1.2 libsdl-sound1.2 libsdl-ttf2.0-0 | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | + | After the last command has finished (it should take about 5-10 minutes) go back to the old terminal and retry the ./df command. | |
− | |||
− | |||
− | |||
* '''Upgrading''': Since every new version of Dwarf Fortress unpacks in a directory named '''df_linux''' you have to manage upgrades yourself. 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. | * '''Upgrading''': Since every new version of Dwarf Fortress unpacks in a directory named '''df_linux''' you have to manage upgrades yourself. 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. | ||
Line 146: | Line 131: | ||
cd to the correct directory, then use ln as shown above. | cd to the correct directory, then use ln as shown above. | ||
− | |||
− | + | ==== "Not found: /data/art/mouse.png" and similar errors ==== | |
+ | ===== Fix 1: Use bmp instead ===== | ||
+ | Another common difficulty with 64bit systems is related to the art packs. When DF is run on most (?all) 64bit Unix systems, it generates error messages related to the PNG variants of the art files, errors which prevent the game from starting. | ||
− | + | To solve this problem, you must first edit the ''/data/init/init.txt'' file and set the game to use the BMP variants of the art files, instead of the default PNG. This should solve all the error messages except for one: "''Not found: data/art/mouse.png''" since there is no setting in the ''init'' files to change it. The workaround for this is to edit the ''Dwarf_Fortress'' file found in the ''/your/path/df_linux/libs'' folder which contains the setting for the mouse cursor. | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
If you don't know how to do that, you can try this: | If you don't know how to do that, you can try this: | ||
* cd to the ''/df_linux/libs'' folder | * cd to the ''/df_linux/libs'' folder | ||
Line 179: | Line 155: | ||
Now the game should work properly. Have fun! | Now the game should work properly. Have fun! | ||
+ | |||
+ | ===== Fix 2: Preload zlib===== | ||
+ | According to the bugtracker[http://mail.bay12games.com/dwarves/mantisbt/view.php?id=2688#c24614] it seems, libgraphics.so from DF statically links to zlib and exports all of its symbols, so the system's libpng ends up calling the functions in libgraphics instead of the system zlib. Apparently something changed in the zlib API recently, and recent libpng versions rely on it, so on an up to date system it fails to work. | ||
+ | |||
+ | A solution I found is to preload the system zlib, so that it has priority over libgraphics, after you installed all the necessary 32bit libraries: | ||
+ | |||
+ | export LD_PRELOAD=/usr/lib/libz.so.1 | ||
+ | |||
+ | You can add this to the startup script which is ''/your/path/df_linux/df'' or ''/your/path/df_linux/dfhack'' if you use [[DFHack]]. | ||
=== Install on Arch Linux === | === Install on Arch Linux === |