Introduction
Dwarf Therapist has been a staple utility in the Dwarf Fortress community for over a decade. It simplifies one of the most time-consuming aspects of fortress management: assigning and maintaining dwarf labor roles.
The profile system within Dwarf Therapist takes this a step further by letting you build reusable templates that make fortress setup faster, more consistent, and far less error-prone.
Quick Facts Dwarf Therapist Profiles
- Dwarf Therapist is a free third-party utility for Dwarf Fortress that allows players to manage labor assignments efficiently outside the base game interface
- Profiles in Dwarf Therapist are saved labor configuration templates that can be applied instantly to new dwarves or entire fortresses
- Using profiles significantly reduces early fortress setup time, especially in the critical first few seasons
- Profiles store labor sets, skill priorities, and role groupings that reflect your preferred fortress structure
- Who it is for: Dwarf Fortress players who manage mid-to-large populations and want consistent, repeatable labor systems
- Who should avoid it: Complete beginners may find it more productive to learn the base game labor system first before using external tools
- Dwarf Therapist must be version-matched to your Dwarf Fortress build to function correctly
- Key risk: Mismatched versions between Dwarf Therapist and Dwarf Fortress can cause crashes or incorrect data reads
- Always back up your save files before making bulk labor changes through any third-party tool
This guide explains how to use those profiles effectively, from installation to practical application.
What Are Dwarf Therapist Profiles and How Do They Work
Understanding the Profile System
A profile in Dwarf Therapist is essentially a saved snapshot of labor assignments. It defines which jobs a dwarf with a specific role should perform, which skills take priority, and how the tool should group or filter dwarves.
When you create a profile, you are building a reusable template. That template can be applied to individual dwarves or to an entire labor category with a single action. This removes the need to manually configure each dwarf every time you start a new fortress or receive a new migrant wave.
Profiles are stored locally as configuration files. They persist between sessions and can be shared with other players or imported from community sources. This makes them especially useful for players who run multiple fortresses with similar structural goals.
Types of Profiles and Their Functions
Dwarf Therapist supports several approaches to profile use. Role-based profiles assign a dwarf to a specific function such as farmer, miner, crafter, or hauler. These profiles activate only the relevant labors and disable conflicting ones.
Hybrid profiles are more flexible. They allow a dwarf to cover multiple roles, which is useful in early fortress stages when the population is low, and every dwarf must contribute across several areas.
Skill-weighted profiles prioritize labors based on a dwarf’s natural aptitudes. If a dwarf arrives with high natural skill in masonry, a skill-weighted profile ensures that masonry tasks are enabled and competing labors are minimized.
Common Problems and Solutions:
- Profile not applying correctly: Confirm Dwarf Therapist version matches your current Dwarf Fortress release
- Labors resetting after save reload: Check that auto-sync settings are configured properly in Dwarf Therapist preferences
- Dwarves ignoring assigned labors: Verify the in-game labor system is not conflicting with third-party assignments
- Profile file not loading: Ensure the profile file uses the correct format and is placed in the expected directory
- Skill mismatches in applied profiles: Use the skill overlay in Dwarf Therapist to review dwarf aptitudes before applying fixed role profiles
Setting Up Dwarf Therapist for First Use
Installation and Version Matching
Download Dwarf Therapist only from the official GitHub repository maintained by the Dwarf Fortress Therapist community project. Avoid third-party download sites as these may distribute outdated or modified builds.
Version matching is the most critical step. Dwarf Therapist reads directly from Dwarf Fortress memory addresses. If the versions are mismatched, the tool will either fail to launch or display incorrect data that can corrupt labor assignments.
Check the release notes of each Dwarf Therapist version carefully. They list the specific Dwarf Fortress builds they support. Using the Steam version of Dwarf Fortress requires a different Dwarf Therapist build than the classic version.
Configuring Initial Preferences
Once installed, open Dwarf Therapist while Dwarf Fortress is running with a loaded save. The main grid will populate with your current dwarves and their labor states.
Before creating or applying profiles, navigate to the preferences panel. Set your preferred column layout to display the labor categories you use most. Disable any labor columns irrelevant to your playstyle to reduce visual clutter.
Enable the skill overlay feature. This adds a color-coded indicator to each cell showing dwarf aptitude for that labor. It is essential for making informed decisions when applying or building skill-weighted profiles.
| Profile Type | Best Use Case | Labor Scope | Skill Sensitivity |
| Role-Based | Stable mid-game fortress | Narrow, focused | Low |
| Hybrid | Early game, small population | Broad, flexible | Medium |
| Skill-Weighted | Optimized specialist roles | Targeted | High |
| Community Preset | Fast setup, standard builds | Variable | Variable |
How to Create and Save Custom Profiles
Building a Profile From Scratch
To create a new profile, select a dwarf whose labor configuration you want to use as a template. Enable the laborers you want to perform that role. Disable all others deliberately rather than leaving them in default states.
Once the configuration is set, navigate to the profiles menu and select the option to save the current labor set as a named profile. Give it a descriptive name that clearly reflects the role, such as “Early Miner,” “Full Hauler,” or “Dedicated Brewer.”
Avoid creating overly broad profiles that enable too much labor. Dwarves assigned too many tasks will spread their time inefficiently and fail to develop skills in priority areas.
Editing and Organizing Saved Profiles
Profiles can be edited at any time. Open the saved profile, adjust the labor selections, and save over the existing file or save as a new variant. Maintaining versioned profiles, such as “Farmer Early Game” and “Farmer Mid Game,” gives you flexibility as fortress needs shift.
Organize profiles into categories using naming conventions. A consistent naming structure makes it faster to locate and apply the right profile during busy gameplay sessions.
Best practices for profile organization:
- Use prefixes to group by phase: Early, Mid, Late
- Use role names that are self-explanatory without abbreviations
- Duplicate and rename rather than editing your primary templates
- Keep a backup folder of your most reliable profile configurations
Applying Profiles for Fast Fortress Setup
Early Game Application Strategy
The first thirty in-game days of a fortress are the most demanding for labor management. Applying profiles immediately after embark removes the need to configure each dwarf individually during this critical window.
Begin with a small set of essential profiles: one for mining, one for wood cutting and construction, one for food and farming, and one for a general laborer profile. Apply these to your starting seven dwarves based on their skill strengths visible in the skill overlay.
Do not apply identical profiles to multiple dwarves unless their roles are genuinely interchangeable. Early-game labor coverage diversity is more important than specialization.
Managing Migrant Waves With Profiles
Each migrant wave introduces new dwarves with undefined labor states. Without a profile system, assigning these dwarves manually can significantly disrupt gameplay flow.
With saved profiles ready, assess each new migrant’s skills using the skill overlay. Match them to the closest appropriate profile and apply it in seconds. This keeps your workforce organized without interrupting active management tasks.
For large migrant waves of ten or more dwarves, use the bulk apply feature with caution. Apply role-specific profiles to skill-matched subgroups rather than applying a single profile to all arrivals. This preserves the efficiency of skill development as your population grows.
Key reminders for migrant wave management:
- Review new dwarves’ skills before applying any profile
- Reassign profiles as skills develop over time
- Never bulk apply a specialist profile to unskilled migrants
- Revisit profile assignments after each seasonal migrant wave
This guide reflects community-informed, experience-based guidance developed through extensive documented use of Dwarf Therapist across multiple Dwarf Fortress versions. Recommendations are grounded in practical application rather than promotional positioning.
Frequently Asked Questions
Is Dwarf Therapist safe to use with Dwarf Fortress?
Dwarf Therapist is widely used and considered safe within the community. It reads and writes to game memory to manage labors. Always use a version-matched build and back up saves before making bulk changes.
Does Dwarf Therapist work with the Steam version of Dwarf Fortress?
Yes, but it requires a specific build of Dwarf Therapist compiled for the Steam release. Check the official GitHub releases page to confirm compatibility with your exact game version.
Can I share my Dwarf Therapist profiles with other players?
Yes. Profiles are stored as local configuration files and can be copied and shared directly. Many community members share optimized profile sets on forums and in the Dwarf Fortress subreddit.
How many profiles should I create for a standard fortress?
A practical starting set is six to ten profiles covering core roles: miner, woodcutter, mason, farmer, brewer, hauler, crafter, and a general early-game hybrid. Expand as your playstyle develops.
Will applying a profile override my existing labor settings?
Yes. Applying a profile replaces the dwarf’s current labor configuration. If you want to preserve an existing setup, save it as a profile first before applying a new one.
What happens if I use the wrong Dwarf Therapist version?
Using a mismatched version can cause Dwarf Therapist to read incorrect memory addresses. This may result in corrupted labor data, display errors, or application crashes. Always verify version compatibility before use.
Can profiles account for dwarf skill levels automatically?
Profiles themselves are static labor templates. However, using the skill overlay alongside profiles allows you to manually match profiles to dwarf aptitudes. Some community preset packages include skill-sensitive configurations.
Should beginners use Dwarf Therapist from the start?
It is recommended to spend at least a few fortress attempts using the base game labor interface first. Understanding how the native system works makes Dwarf Therapist significantly easier to configure and troubleshoot effectively.
Latest Post:
- How to Use Dwarf Therapist Profiles for Fast Fortress Setup
- How to Optimize Work Orders Using Dwarf Therapist
- How to Use Dwarf Therapist With Modded UI (Steam UI+ or Phoebus)
- Best Dwarf Fortress Assistant Tools Compared (DT vs DFHack vs Others)
- What Is Dwarf Therapist? Complete Guide for Dwarf Fortress Players
