- 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) |
m (→History: added missed maintainer) |
||
| (One intermediate revision by the same user not shown) | |||
| 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 happiness), 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. | + | '''Dwarf Therapist''' gives you an advanced GUI to manage and check dwarf job allocations, military assignments, statistics (such as attributes, personality traits and happiness), 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 == |
| − | Different distributions of Dwarf Therapist are available for different operating systems. To get started, download the executable from the [https://github.com/Dwarf-Therapist/Dwarf-Therapist/releases releases page] | + | Different distributions of Dwarf Therapist are available for different operating systems. To get started, download the executable from the [https://github.com/Dwarf-Therapist/Dwarf-Therapist/releases releases page]. Current versions are available for Windows and Linux. |
| + | |||
| + | Dwarf Therapist will start in a separate screen. Click on the "Connect" icon to the upper left. The application will load your current population into the spreadsheet. 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. For further instructions, consult the [https://github.com/Dwarf-Therapist/Manual/releases official manual]. | ||
== 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. In a DFHack command prompt, 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>%APPDATA%/Roaming/Dwarf Therapist/memory_layouts/windows</code> on Windows or <code>~/.local/share/dwarftherapist/memory_layouts/linux</code> on Linux.[http://www.bay12forums.com/smf/index.php?topic=168411.msg8532557#msg8532557] | 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. In a DFHack command prompt, 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>%APPDATA%/Roaming/Dwarf Therapist/memory_layouts/windows</code> on Windows or <code>~/.local/share/dwarftherapist/memory_layouts/linux</code> on Linux.[http://www.bay12forums.com/smf/index.php?topic=168411.msg8532557#msg8532557] | ||
| − | == | + | == 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 30: | ||
* 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' fork | + | 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 15:17, 2 December 2024
 | |
| 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 and happiness), 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]
Different distributions of Dwarf Therapist are available for different operating systems. To get started, download the executable from the releases page. Current versions are available for Windows and Linux.
Dwarf Therapist will start in a separate screen. Click on the "Connect" icon to the upper left. The application will load your current population into the spreadsheet. 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. For further instructions, consult the official manual.
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. In a DFHack command prompt, run devel/export-dt-ini. This will create a file named therapist.ini in the DF root directory; move that file to %APPDATA%/Roaming/Dwarf Therapist/memory_layouts/windows on Windows or ~/.local/share/dwarftherapist/memory_layouts/linux on Linux.[1]
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
