This is a heavily modified version of the original Dwarf Therapist.
Many new features (attributes, roles, optimization plans, health views, inventory, etc.) have been added, and many bugs have been resolved.
If you'd like to help support this project:
The changelog is available at GitHub.
The latest release is always published in the project's releases page. These releases normally contain packages for Windows and OSX.
If the latest published releases do not contain a package, they may be found on DFFD.
There is currently no official package for Linux. You can find the instructions to build from source in BUILDING.rst.
On default installations of most Debian-based distributions, you'll most likely need to run Dwarf Therapist with sudo. This is due to the Yama ptrace LSM enabled by default on such distros. You can explicitly give Dwarf Therapist permission to ptrace on Debian-based distributions with:
sudo apt-get install libcap2-bin && sudo setcap cap_sys_ptrace=eip ./bin/release/DwarfTherapist
Or, you can create a script that will run Dwarf Therapist as a child of Dwarf Fortress:
#!/bin/bash set -e cd df_linux ./df & cd ../dwarftherapist exec ./bin/release/DwarfTherapist
Alternatively, you can use the dist/dwarftherapist
wrapper to automatically grant DT permissions to attach to a running DF process.
Primary support is available at the Dwarf Therapist thread at the Bay 12 Forums; if you are sure you have found a bug, file an issue at the GitHub issue tracker.
Provide as much information as possible to help reproduce the issue.
Most runtime bugs will require you to send a save, preferably uploaded at DFFD.
You may also be requested to provide a log, which is saved in log/log.txt
on Windows and OSX and output to stderr on Linux systems (use 2> log.txt
to collect).
You can also join us in #dwarftherapist on Freenode.