- 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.
Difference between revisions of "Utility:Dwarf therapist"
(added updating section, removed some out of date info) |
(→Updating: updated for more recent DFHack usage and added DT option to open the data folder) |
||
| (3 intermediate revisions by 2 users not shown) | |||
| Line 5: | Line 5: | ||
* [http://www.bay12forums.com/smf/index.php?topic=168411.0 Bay12Forum] | * [http://www.bay12forums.com/smf/index.php?topic=168411.0 Bay12Forum] | ||
* [https://github.com/Dwarf-Therapist/Dwarf-Therapist/ Github] [https://github.com/Dwarf-Therapist/Dwarf-Therapist/releases Download] | * [https://github.com/Dwarf-Therapist/Dwarf-Therapist/ Github] [https://github.com/Dwarf-Therapist/Dwarf-Therapist/releases Download] | ||
| − | * [https://github.com/Dwarf-Therapist/Manual/releases Manual] | + | * [https://github.com/Dwarf-Therapist/Manual/releases Manual] (outdated) |
* [[Utility:Dwarf Therapist/Addons Repository|Addons Repository]] | * [[Utility:Dwarf Therapist/Addons Repository|Addons Repository]] | ||
}} | }} | ||
| Line 11: | Line 11: | ||
: ''It makes Dwarf fortress playable. It's that good. Get it! - unknown source.'' | : ''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 and | + | '''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 == | + | == Installation and use == |
| − | + | To get started, download the archive for your OS from the [https://github.com/Dwarf-Therapist/Dwarf-Therapist/releases 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|Updating]] below. Extract the archive to a folder, a Games folder in your user folder is a good place. | |
| + | |||
| + | 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 {{k|sep=+|ctrl|t}}. | ||
== Updating == | == Updating == | ||
| − | When ''Dwarf Fortress'' updates it is not necessary to wait for a '''Dwarf Therapist''' update if there is an updated [[DFHack]], since DFHack can generate an updated memory layout. | + | When ''Dwarf Fortress'' updates it is not necessary to wait for a '''Dwarf Therapist''' update if there is an updated [[DFHack]], since DFHack can generate an updated memory layout. Open the DFHack console with {{k|`}}, and run <code>devel/export-dt-ini</code>. This will create a file named <code>therapist.ini</code> in the DF root directory; move that file to <code>memory_layouts/windows</code> on Windows or <code>memory_layouts/linux</code> on Linux, in the '''Dwarf Therapist''' data directory, which can be opened from in '''Dwarf Therapist''' with the <code>Open data directory</code> option on the <code>File</code> menu.[http://www.bay12forums.com/smf/index.php?topic=168411.msg8532557#msg8532557][https://www.bay12forums.com/smf/index.php?topic=168411.msg8539193#msg8539193] |
| − | == | + | == Addons == |
| − | A collection of customizations for Dwarf Therapist submitted by the community. | + | A collection of customizations for Dwarf Therapist submitted by the community is maintained at the [[Utility:Dwarf Therapist/Addons Repository|Addons Repository]]. These files contain: |
* custom professions | * custom professions | ||
| Line 28: | Line 32: | ||
* new grid views | * new grid views | ||
| − | == | + | == History == |
| − | Initially released in 2009, by Trey Stout (or chmod, as he's known on the forums), the program solves one of the most basic and annoying problems with the | + | Initially released in 2009, by Trey Stout (or chmod, as he's known on the forums), the program solves one of the most basic and annoying problems with the game: the difficulty involved in setting Dwarven labor preferences. Before v50, the only way to acess dwarven labor preferences in the vanilla game was to get to a dwarf, go to their labors screen, and then crawl through a tedious menu bumping the individual labors on and off. All in the absence of a comprehensive view of ''other'' dwarfs labor preferences. Dwarf Therapist solved this problem by providing a functional and filterable tabular interface, plugged into the Dwarf Fortress memory, which allows the reading, editing, and committing of dwarven labor changes. Chmod kept updating and expanding this tool until 2010. DwarfEngineer took over its development through 2012. |
| + | |||
| + | Splinterz' 2013 fork of Dwarf Therapist is the currently maintained version. It is fully compatible with v50 Steam/Premium. | ||
| − | + | Up to version 41.2.5 Dwarf Therapist was also available as a native macOS release. | |
== Gallery == | == Gallery == | ||
<gallery widths=200px> | <gallery widths=200px> | ||
| − | File:dwarf_therapist.png| | + | File:dwarf_therapist.png|Screenshot of Dwarf Therapist |
</gallery> | </gallery> | ||
| + | |||
| + | == Links == | ||
| + | [https://www.youtube.com/watch?v=Wdfah-eNX-Q A Dwarf Therapist Starting Guide (Video Tutorial)] | ||
[[Category:Utilities]] | [[Category:Utilities]] | ||
[[ru:Utility:Dwarf therapist]] | [[ru:Utility:Dwarf therapist]] | ||
Latest revision as of 01:45, 13 August 2025
 | |
| Information | |
|---|---|
|
- 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[edit]
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.
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[edit]
When Dwarf Fortress updates it is not necessary to wait for a Dwarf Therapist update if there is an updated DFHack, since DFHack can generate an updated memory layout. Open the DFHack console with `, and run devel/export-dt-ini. This will create a file named therapist.ini in the DF root directory; move that file to memory_layouts/windows on Windows or memory_layouts/linux on Linux, in the Dwarf Therapist data directory, which can be opened from in Dwarf Therapist with the Open data directory option on the File menu.[1][2]
Addons[edit]
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[edit]
Initially released in 2009, by Trey Stout (or chmod, as he's known on the forums), the program solves one of the most basic and annoying problems with the game: the difficulty involved in setting Dwarven labor preferences. Before v50, the only way to acess dwarven labor preferences in the vanilla game was to get to a dwarf, go to their labors screen, and then crawl through a tedious menu bumping the individual labors on and off. All in the absence of a comprehensive view of other dwarfs labor preferences. Dwarf Therapist solved this problem by providing a functional and filterable tabular interface, plugged into the Dwarf Fortress memory, which allows the reading, editing, and committing of dwarven labor changes. Chmod kept updating and expanding this tool until 2010. DwarfEngineer took over its development through 2012.
Splinterz' 2013 fork of Dwarf Therapist is the currently maintained version. It is fully compatible with v50 Steam/Premium.
Up to version 41.2.5 Dwarf Therapist was also available as a native macOS release.
Gallery[edit]
Screenshot of Dwarf Therapist
