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.

Difference between revisions of "Utility:Dwarf therapist"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
m (→‎History: added missed maintainer)
 
(2 intermediate revisions by 2 users 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. This version contains the "labor optimizer" semi-automatic labor management system.
+
'''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 release page] (cross platform: Windows, Linux, macOS). Dwarf Therapist is large part of the standard Dwarf Fortress utilities package, like the widely available [[Utility:Lazy Newb Pack|starter pack]].
+
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.
  
== [[Utility:Dwarf Therapist/Addons Repository|Addons Repository]] ==
+
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].
A collection of customizations for Dwarf Therapist submitted by the community.
+
 
 +
== 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]
 +
 
 +
== Addons ==
 +
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 25: Line 30:
 
* new grid views
 
* new grid views
  
== About ==
+
== 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 game—the difficulty involved in setting Dwarven labor preferences. In the vanilla game, the only way to set dwarven labor preferences (probably the most important setting there is, dwarf- wise) was to get to the dwarf, get to their labors screen, and then crawl through a tedious menu bumping this labor off or this one on. A starting group of seven dwarves? Not fun, but in grander scheme of the game, doable. 200 of them running amok? No way. Dwarf Therapist solved this problem by providing a functional tabular interface, plugged into the Dwarf Fortress memory, which allows the reading, editing, and committing of dwarven labor changes.
+
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.
  
Splinterz' fork <!-- since? --> of Dwarf Therapist is the currently updated version
+
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

Dwarf therapist
DFDefault.png
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]

Links[edit]

A Dwarf Therapist Starting Guide (Video Tutorial)