How Dwarf Therapist Works (Labors, Skills & Assignments Explained)

Table of Contents

Introduction

Dwarf Therapist operates as an external companion application that reads live memory data from a running Dwarf Fortress session. It translates raw game data into a structured, visual interface that allows players to manage dwarf labors, monitor skill levels, and handle assignments far more efficiently than the base game permits.

Understanding how Dwarf Therapist works at a functional level helps players use it accurately and avoid common errors. The tool is not a mod and does not alter game files. It communicates with Dwarf Fortress through direct memory access, presenting and writing data in real time.

Quick Facts about How a Dwarf Therapist Works

Dwarf Therapist reads and writes to Dwarf Fortress memory while the game is running, without modifying any files on disk
Labor assignments made in Dwarf Therapist are reflected in the game after a brief processing interval
Skills are displayed as numerical values with color indicators showing proficiency tiers
Each column in the labor grid corresponds to a specific in-game labor category
Bulk assignment tools allow players to enable or disable labors across multiple dwarves simultaneously
Custom profession templates can be created and applied to groups of dwarves in seconds
Version matching between Dwarf Therapist and Dwarf Fortress is required for accurate data display
Dwarf attributes, stress indicators, and personality traits are accessible from the roster view
The application refresh rate determines how frequently displayed data updates from game memory

What Dwarf Therapist Actually Does Inside Dwarf Fortress

Dwarf Therapist does not inject code into Dwarf Fortress or install any files within the game directory. Its core function is memory reading and writing, which it performs through operating system level process access.

This approach allows it to remain functional across game sessions without requiring modifications to the game files. When a player connects Dwarf Therapist to a running fort, the application locates specific memory addresses tied to dwarf data.

These addresses hold information about each dwarf’s assigned labors, current skill ratings, stress levels, and attribute scores.

How Memory Reading and Data Display Work

Each release of Dwarf Therapist includes version-specific memory offset files. These files contain the mapped addresses corresponding to dwarf data structures in a particular build of Dwarf Fortress. When the application reads memory, it uses these offsets to locate and interpret the correct data for display.

The interface populates a grid where each row is one dwarf and each column represents a labor or data category. Skill levels appear as color-coded cells, ranging from unskilled through novice, competent, skilled, and up to legendary tier.

This visual system allows players to scan the entire population of a fortress at once rather than opening individual dwarf menus.

How Labor Writes Are Processed by the Game

When a player toggles a labor on or off within Dwarf Therapist, the application writes the updated value back to the corresponding memory address in the running game process. Dwarf Fortress reads this change during its next processing cycle.

It is important to unpause the game briefly after making labor changes so that Dwarf Fortress can register and process the updated assignments. Changes written while the game remains paused indefinitely may not fully propagate until the game ticks forward. This is a commonly misunderstood aspect of how the two applications interact.

Labors Explained: Categories, Assignments, and Best Practices

Labors in Dwarf Fortress determine which tasks each dwarf is eligible to perform. A dwarf with the mining labor enabled will pick up mining jobs when they appear in the job queue.

Without that labor enabled, the dwarf will ignore all mining tasks regardless of their skill level.

Dwarf Therapist organizes labors into logical groupings within the grid, making it straightforward to identify which categories are assigned to which dwarves. Common labor categories include mining, woodcutting, hauling, farming, crafting, medical, and construction.

Understanding the Labor Grid Layout

The labor grid is the central element of the Dwarf Therapist interface. Each column header identifies a specific labor, and each row represents one dwarf in the active fort. A filled or highlighted cell indicates that labor is currently enabled for that dwarf.

Players can interact with the grid in several ways:

Single cell click: Toggles one labor on or off for one dwarf
Column header click: Enables or disables a labor across all visible dwarves
Row selection with group edit: Applies labor changes to all selected dwarves simultaneously
Profession template application: Assigns a predefined labor configuration to selected dwarves instantly
Filter and sort tools: Narrows the visible roster to specific skill ranges, stress levels, or migration groups

Labor Category	Examples Included	Typical Assignment Strategy
Mining	Mining	Assign only to dwarves with mining skill
Woodcutting	Woodcutting	Limit to designated woodcutters
Hauling	Stone, Wood, Food, Refuse	Broad assignment across general population
Farming	Farming, Plant Gathering	Assign to dedicated agricultural dwarves
Crafting	Stonecrafting, Weaving, Smithing	Match to skilled specialists
Medical	Surgery, Diagnosis, Wound Dressing	Assign to dedicated medical staff only
Construction	Masonry, Carpentry, Architecture	Assign to skilled builders
Cleaning	Cleaning	Broad or general assignment recommended

Common Labor Assignment Problems and Solutions

Players frequently make errors in labor configuration that lead to inefficient forts. The following issues are among the most reported:

No dwarves completing a critical job: The required labor is not enabled on any dwarf. Check the relevant column in Dwarf Therapist and enable it for at least one qualified dwarf.
All dwarves abandoning skilled work for hauling: Too many dwarves have hauling labors enabled. Restrict hauling to a dedicated group to keep specialists focused.
Doctors not treating wounded dwarves: Medical labors require all sub-categories enabled on the same dwarf. Diagnosis, surgery, wound dressing, bone setting, and suturing should be assigned together.
Miners refusing to mine: Confirm the mining labor is enabled and that the dwarf is not assigned to a burrow that restricts movement to the mining area.
Newly arrived migrants left unassigned: Use Dwarf Therapist’s migration wave filter to quickly identify and configure new arrivals as a group.

Skills and Attributes: Reading and Using the Data Effectively

Skill data in Dwarf Therapist is pulled directly from game memory and displayed numerically alongside color indicators. Each skill in Dwarf Fortress has a rating that progresses from level 0, which represents no skill, through to level 20, which represents a legendary plus five rating.

Dwarf Therapist makes this data scannable by applying color gradients to skill cells. Players do not need to open each dwarf individually to assess whether a candidate is suitable for a skilled role. The grid provides a population-wide overview in a single view.

Skill Tiers and What They Mean for Labor Decisions

Understanding skill tiers helps players make smarter labor assignments rather than defaulting to random configurations:

Levels 0 to 1: No skill or dabbling. Suitable only for unskilled labor roles.
Levels 2 to 4: Novice to adequate. Functional for general tasks but not production-critical work.
Levels 5 to 9: Competent to professional. Reliable for regular skilled production.
Levels 10 to 14: Accomplished to expert. Strong candidates for specialized workshops.
Levels 15 to 19: Exceptional to grand master. Reserve these dwarves for high-value production roles.
Level 20 and above: Legendary tier. Assign exclusively to the most critical production roles and protect these dwarves from unnecessary danger.

Attributes displayed in Dwarf Therapist, including strength, agility, toughness, and focus, provide additional context for labor decisions.

A dwarf with high focus is a stronger candidate for engraving or gem cutting. A dwarf with high strength and toughness is better suited to physically demanding roles.

Stress Indicators and Personality Data in Dwarf Therapist

Dwarf Therapist surfaces stress-related data alongside skill information. Stress in Dwarf Fortress accumulates when dwarves experience negative thoughts, witness death, go without food or sleep, or are assigned to roles that conflict with their personality preferences.

High stress levels displayed in a Dwarf Therapist are an early warning sign that a dwarf may be approaching a mental breakdown. Players can use this data to intervene before the dwarf becomes a threat to the fort or loses functionality. Personality facets, such as whether a dwarf values craftsmanship or dislikes working outdoors, are also accessible through the dwarf detail view.

Aligning labor assignments with personality preferences, where possible, helps reduce stress accumulation over time.

Custom Professions, Sorting, and Advanced Assignment Tools

Custom professions are one of the most powerful features Dwarf Therapist offers beyond basic labor toggling. A custom profession is a saved labor configuration that can be named, stored, and applied to any number of dwarves instantly.

A player might create a profession called “Hauler” with only hauling and cleaning labors enabled, a profession called “Miner” with exclusively mining enabled and all hauling disabled, and a profession called “Medical Staff” with all medical sub-labors active.

These templates eliminate repetitive manual configuration during each new game.

Creating and Applying Custom Professions

To create a custom profession in Dwarf Therapist:

Configure a single dwarf’s labors exactly as intended for the profession
Right-click the dwarf row and select the option to save the current configuration as a custom profession
Name the profession clearly for easy identification in the profession list
Select one or multiple dwarves in the grid to whom the profession should be applied
Apply the saved profession from the right-click context menu or profession panel

Custom professions do not lock a dwarf’s labors permanently. They apply a configuration at the point of use. Future changes can be made individually or by reapplying a different profession template at any time.

Sorting, Filtering, and Migration Wave Tools

Dwarf Therapist includes sorting and filtering tools that are especially useful as the population scales. Players can sort the roster by:

Overall skill rating in a specific labor
Stress level from highest to lowest
Migration wave to isolate newly arrived dwarves
Custom profession currently applied
Alphabetical order by dwarf name

Filtering by migration wave allows players to quickly locate all dwarves from the most recent arrival group and configure them in one editing session.

This prevents the common problem of migrants sitting unassigned and defaulting to random labors for extended periods after arrival.

Frequently Asked Questions

How does Dwarf Therapist read Dwarf Fortress data without modifying the game?

Dwarf Therapist uses operating system process memory access to read data directly from the running Dwarf Fortress process. It locates dwarf data using version-specific memory offset files included with each release. No game files are altered during this process.

Why do labor changes in Dwarf Therapist sometimes not appear in the game immediately?

Labor changes are written to game memory but require the game to process a tick before they take full effect. Unpausing Dwarf Fortress briefly after making changes in Dwarf Therapist ensures that the game registers the updated labor assignments correctly.

Can I use Dwarf Therapist to assign military roles or manage squads?

No. Dwarf Therapist is focused on civilian labor and skill management. Military squad assignments, weapon choices, and training schedules must be handled directly through the Dwarf Fortress in-game interface.

What does the color coding in the skill grid represent?

Color coding in Dwarf Therapist indicates skill proficiency levels. Lighter or neutral colors represent low or no skill. Progressively stronger colors indicate higher skill tiers, moving through novice, competent, skilled, expert, and legendary levels.

How do I set up custom professions in Dwarf Therapist?

Configure one dwarf’s labors as desired, right-click the dwarf row, and save the configuration as a named custom profession.
That profession can then be applied to any number of dwarves through the right-click menu or the profession management panel.

Is it safe to run Dwarf Therapist in the background while playing?

Yes. Dwarf Therapist is designed to run alongside Dwarf Fortress during active play. Its memory read and write operations are lightweight and should not cause instability when using a correctly matched version for your game build.

Why are some dwarves not showing up in the Dwarf Therapist roster?

Dwarves may not appear if the application has not refreshed since they arrived. Use the manual refresh option within Dwarf Therapist to prompt a data update. Persistent missing dwarves may indicate a version compatibility issue.

Can Dwarf Therapist help reduce dwarf stress levels?

Dwarf Therapist displays stress data but does not directly control stress levels. It helps indirectly by allowing players to identify high-stress dwarves quickly and make labor adjustments, such as removing unpleasant assignments or reassigning dwarves to roles better suited to their personality traits.

Latest Post: