Utility:Dwarf therapist

Dwarf therapist

Information
Bay12Forum Github Download Manual (outdated) Addons Repository

It makes Dwarf fortress playable. It's that good. Get it! - unknown source.

Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments, statistics (such as attributes, personality traits, happiness, and health), sort dwarves by various criteria (e.g. profession, migration wave, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way. It further contains the "labor optimizer" a semi-automatic labor management system.

Installation and use

To get started, download the archive for your OS from the releases page. Versions are usually available for Windows and Linux. If there is not yet a release for the current version of Dwarf Fortress for your OS, use the latest version and see Updating below. Extract the archive to a folder, a Games folder in your user folder is a good place.

Screenshot of Dwarf Therapist, this screen showing a spreadsheet of dwarves, their skill levels and currently assigned labors, plus other information.

Start Dwarf Fortress and load a fortress save, then run the Dwarf Therapist executable from the folder you extracted to. It will start in a separate window and automatically connect to Dwarf Fortress. The application will load the current population data and show it in the default tabs; there are other tabs you can add, like Health to see the health status of all dwarves at once.

To actually edit any labors, you will need to click "Allow labor changes" first and confirm you want to use Dwarf Therapist for setting labors. Note that any changes only become active after you select "Commit Changes" on the right below the list of pending changes (or on the main tool bar or by pressing ctrl+t.

Updating

When Dwarf Fortress updates, Dwarf Therapist must update as well, to match the new coding details. However, it is not necessary to wait for a current Dwarf Therapist update; as soon as there is an updated DFHack (which should happen with every DF update), then DFHack can generate the necessary updated memory layout. [1][2]

1) Open Dwarf Fortress, and open your current game save. Open the DFHack console (default hotkey `), and type devel/export-dt-ini. (This is a standard DF Hack command - if you typed everything correctly, it will recognize it as an option.) Hit Enter to run the command; if you did it correctly, it will be confirmed by the text Command finished successfully and create a file named therapist.ini in the Dwarf Fortress root directory.

2) For the Steam version, right-click the game entry in the Steam library and choose Browse local files in the Manage sub-menu, which will open the location, usually C:\\Program Files (x86)\Steam\Steam apps\common\Dwarf Fortress. For other versions you should know where you extracted the game to, but you can do a file search for "Dwarf Fortress".

3) Open Dwarf Therapist, and close the Unidentified game version pop-up message. Open the File drop-down menu, and select the Open data directory option to open that location. Open the memory_layouts directory, then the windows or linux directory as appropriate for your operating system.

4) Move the newly created therapist.ini file (from step 1) from the Dwarf Fortress directory (from step 2) to the Dwarf Therapist data directory (from step 3).

5) Dwarf Therapist then needs to be restarted before it will see the new file.

The new file will work as named, but if you want to use Dwarf Therapist with multiple versions of Dwarf Fortress, you'll want to rename it.

Addons

A collection of customizations for Dwarf Therapist submitted by the community is maintained at the Addons Repository. These files contain:

• custom professions
• custom roles
• optimization plans
• filter scripts
• new grid views

History

Initially released in 2009 by Trey Stout (or chmod, as known on the forums), who kept updating and expanding it until 2010. DwarfEngineer took over development through 2012. Splinterz' 2013 fork of Dwarf Therapist is the currently maintained version, by Clément since 2017, and is fully compatible with v50+ premium and classic.

Up to version 41.2.5 Dwarf Therapist was also available as a native macOS release for use with the native macOS versions of Dwarf Fortress, the last of those being version 0.47.05.

Links

A Dwarf Therapist Starting Guide (Video Tutorial)