Difference between revisions of "v0.31:Utilities"

Revision as of 23:41, 15 April 2010

Template:AV Template:Elven Please only list utilities that are known to work with the newest version here.

Here are third party applications developed for Dwarf Fortress.

Dwarf Fortress File Depot

The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of Janus; for files related to Dwarf Fortress only.

Reveal (or Reveal.exe as it is commonly referred to) is a program that runs alongside Dwarf Fortress and shows all "unexplored" or "undug" tiles of the map (in fortress mode). To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal (Not required in the latest version using the parameters below, simply start the .exe file.). Playing on revealed map might (read "will") cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, and a lot more). Using Reveal has been known to corrupt saved game folders. and, as such, it is highly recommended to only use Reveal to preview a biome's layout and then restart without running Reveal.

There are two versions of Reveal, one for Vista and newer, one for XP and older.

The new version of Reveal.exe (Reveal2) is in public beta, you can find it here Reveal2. Please report problems in 0x517A5D's Talk page.

Pasting the following code into reveal2.ini makes it work for the newest (DF2010) version of Dwarf Fortress:

;; DF2010 31.02
[4BBDF378]
map_data=0x016ad718
map_x_count=0x016ad738
map_y_count=0x016ad73c
map_z_count=0x016ad740

[4BB45F99] can be substituted in for 31.01.

For 31.03, the following works:

; .31.03
[4BC3C470]
dwarf_fortress=0x00A5ED94
map_data=0x016AE760
map_x_count=0x016AE780
map_y_count=0x016AE784
map_z_count=0x016AE788
map_data_designation_offset=0x29C

However, do not save your game, it can mess up many things including civilisations (Giant Toad and Cave Crocodile civilisations, you will also embark with those if it should occur.)

Dwarf Therapist

Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments (40d), statistics (such as attributes, personality traits and happiness), plus sort dwarves by various criteria (eg. profession, migration wave etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

As of version 0.5.0 (released 04/10/10), stable support for labours and social skills has been added for DF versions 0.31.01 and 0.31.02.

Unofficial support for 0.31.03 can be added by making a .ini file in the "\DwarfTherapist-0.5.0\etc\memory_layouts\windows" folder called "v0.31.03". The contents should be copy-pasted from here. Then add "0x4bc3c470 = v0.31.03" to game_data.ini under "#windows" in the "\etc\" folder.

Dfterm

Dfterm is a tool to run dwarf fortress via terminals remotely. multiple people can connect and watch or join in.

Main article here: Dfterm.

DFHack

DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.3.1.3) release only supports the new DF 0.31.01, 0.31.02 and 0.31.03 versions. It consists of some of the more useful DFHack tools.

Code and binary releases are available from the Github site.

DFhack tools for DF 2010

dfcleanmap

Cleans all the bloodsmears that get scattered all over the map.

dfliquids

Allows creating liquids (water and magma), making them flow or preventing them from flowing. It's a command-prompt style utility where you type in very simple commands.

dfprospector

Lists all available minerals on the map and how much of them there is.

dfreveal

Reveals the whole map. Use with caution, releases HFS! Same warnings as to the original Reveal tool apply.

dfvdig

Designates a whole vein for digging. Point the cursor at a vein and run this thing :)

@@ Line 59: / Line 59: @@
 == [http://www.bay12games.com/forum/index.php?topic=41916.0 DFHack] ==
-DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.3.1.3) release only supports the new DF 0.31.01, 0.31.02 an 0.31.03 versions. It consists of some of the more useful DFHack tools.
+DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.3.1.3) release only supports the new DF 0.31.01, 0.31.02 and 0.31.03 versions. It consists of some of the more useful DFHack tools.
 Code and binary releases are available from the [http://github.com/peterix/dfhack/downloads Github site].
@@ Line 67: / Line 67: @@
 Cleans all the bloodsmears that get scattered all over the map.
 ==== dfliquids ====
-Allows creating liquids (water and magma), making them flow or preventing them from flowing. It's a command-prompt style utility where you type in (very simple) commands.
+Allows creating liquids (water and magma), making them flow or preventing them from flowing. It's a command-prompt style utility where you type in very simple commands.
 ==== dfprospector ====
 Lists all available minerals on the map and how much of them there is.