Introduction
Using Dwarf Therapist with a modded UI such as Steam UI+ or Phoebus is entirely achievable, but it requires understanding a few compatibility layers that differ from a standard vanilla installation.
Players who switch to graphical tilesets or enhanced interface packs sometimes find that Dwarf Therapist behaves unexpectedly or fails to connect without additional configuration.
The core reason for this is straightforward. Dwarf Therapist reads game memory directly, and modded UI packages often ship with specific executable builds or file structures that differ from the base game. Knowing how to align these components correctly makes the setup process reliable and repeatable.
Quick Answer about How to Use Dwarf Therapist With Modded UI
- Dwarf Therapist works with modded UIs including Steam UI+ and Phoebus, but requires version matched memory offset files to function correctly
- Steam UI+ is a graphical enhancement layer built on top of the Steam release of Dwarf Fortress and does not change core game memory structure significantly
- Phoebus is a tileset and graphical mod that replaces sprite assets and may ship with a patched executable depending on the distribution
- The most common failure point is a mismatch between the game executable version and the memory offset file Dwarf Therapist uses to read data
- Dwarf Therapist must be launched after the game is already running, regardless of which UI mod is active
- Players should always download the Dwarf Therapist release that corresponds to their exact game version, not the latest release by default
- Do not run Dwarf Therapist as administrator unless the game itself is also running with administrator privileges, as permission mismatches cause connection failures
- Tileset and graphical changes do not affect labor data or skill reading; only executable version and memory layout matter
- Community maintained offset repositories are the primary source for mod compatible configurations
What Modded UIs Actually Change in Dwarf Fortress
Understanding what a modded UI does and does not modify is the foundation of troubleshooting any Dwarf Therapist compatibility issue. Many players assume graphical changes affect tool connectivity, but the relationship is more specific than that.
Difference Between Tileset Mods and Executable Mods
Tileset based mods such as Phoebus replace the graphic assets used to render the game world. These include character sprites, terrain tiles, and interface icons. They do not alter the game logic, memory addresses, or the underlying data structures that Dwarf Therapist reads.
A pure tileset installation alongside an unmodified executable will behave identically to a vanilla installation from Dwarf Therapist’s perspective.
The tool will connect, read skill data, and write labor changes without any additional steps required. The situation changes when a modded UI distribution includes a custom or patched game executable. Some older Phoebus packages and certain community bundles shipped with executables that differed from the official release, which in turn shifted memory addresses and broke standard offset files.
How Steam UI+ Interacts With Dwarf Therapist
Steam UI+ is primarily a quality of life enhancement layer for the Steam release of Dwarf Fortress. It typically modifies the interface presentation, key bindings, and visual layout rather than the core executable binary. Because the Steam version of Dwarf Fortress uses a distinct memory layout from the classic version,
Dwarf Therapist requires Steam specific offset files regardless of whether UI+ is active. The presence of Steam UI+ itself does not introduce additional offset complexity in most cases.
Players who experience connection failures after installing Steam UI+ should first confirm they are using the Steam compatible Dwarf Therapist release rather than a version built for the classic game. This single version mismatch accounts for the majority of reported issues in this setup.
How to Configure Dwarf Therapist for a Modded UI Installation
Correct configuration follows a specific sequence. Skipping steps or performing them out of order is the primary cause of persistent connection failures in modded setups.
Verifying Your Game Version and Matching Offset Files
Before launching anything, identify the exact version number of your Dwarf Fortress installation. On Steam, this appears in the game properties panel. For classic installations, the version string displays on the main menu screen.
Navigate to the Dwarf Therapist releases page on its official repository and locate the release that explicitly lists support for your game version. Download that specific release rather than defaulting to the most recent one.
Inside the Dwarf Therapist installation directory, locate the folder named released or memory_layouts. This folder contains the offset files that tell Dwarf Therapist where to read
data in the game’s memory. Confirm the correct layout file for your operating system and game version is present.
- Open Dwarf Fortress and load or start a fortress before launching Dwarf Therapist
- Launch Dwarf Therapist after the fortress is actively running, not from the main menu
- Navigate to Game in the Dwarf Therapist menu bar and select Read Dwarves
- If the grid populates with dwarf data, the connection is successful
- If the grid is empty or an error appears, proceed to offset file verification
Resolving Offset Mismatches in Phoebus Installations
Phoebus installations that include a modified executable require a corresponding custom offset file. Standard offset files will not align correctly with a patched binary, and Dwarf Therapist will either fail to connect or display corrupted data.
Do not attempt to use a standard offset file with a known patched executable. The result is unreliable data that can mislead labor decisions rather than informing them.
The recommended resolution is to source the Phoebus compatible offset file from the same community distribution that provided the Phoebus package. Many Phoebus bundles include a preconfigured Dwarf Therapist folder with matching layouts already in place.
Common Problems and Solutions:
- Empty grid after connecting: Game version and offset file version do not match; download the correct Dwarf Therapist release for your exact game build
- Dwarf Therapist shows wrong dwarf count: Filters may be excluding unit types; reset all active filters and refresh the connection
- Labor changes not applying in game: Confirm the game is unpaused during write operations; some write functions require the game to be in an active simulation state
- Application crashes on connection attempt: Operating system memory protection settings may be blocking the read process; check security software exceptions
- Phoebus dwarves show corrupted skill data: A patched executable is present and requires a distribution specific offset file rather than the standard community release
- Steam UI+ installation not detected: Confirm Dwarf Therapist is using the Steam game path and not a classic installation path configured from a previous setup
Setting Up Profession Templates With a Modded UI Active
Profession templates in Dwarf Therapist function independently of the active UI mod. The template system stores labor configurations locally and applies them through memory writes, which are unaffected by graphical layers.
Creating Templates That Work Across UI Configurations
Building profession templates while a modded UI is active produces fully portable templates. Because templates store labor toggle states rather than any graphical or UI data, they remain valid whether the player later switches between UI mods or returns to vanilla.
A well structured template library covers the core production roles a fortress requires across its development stages.
Start by building templates for the highest priority roles specific to your play style before expanding to secondary and tertiary assignments.
- Dedicated Miner: Mining labor only, no hauling tasks enabled
- Stone Crafter: Stonecrafting and Gem Cutting labors, no unrelated production tasks
- Field Farmer: Farming and Plant Gathering, optionally Cooking if no dedicated cook exists
- Combat Ready: All civilian labors disabled, allowing full military schedule compliance
- General Hauler: All hauling tasks enabled, all production tasks disabled
- Medical Specialist: Healthcare, Diagnosis, Surgery, and Bone Setting labors only
Switching Between UI Mods Without Losing Template Data
Template data is stored in the Dwarf Therapist configuration files on the local system, not inside the game save or the UI mod directory. This means switching from Phoebus to Steam UI+ or back to vanilla does not erase or affect saved templates.
Always back up the Dwarf Therapist configuration folder before reinstalling or updating the tool. Updates occasionally reset the local configuration to default values, removing custom templates that have not been exported or separately preserved.
The configuration folder location varies by operating system. On Windows it typically resides in the application data directory associated with the Dwarf Therapist installation path. Confirming this location before any update protects template investments made over many play sessions.
| UI Configuration | Offset File Needed | Template Compatibility | Labor Write Support |
| Vanilla Steam | Steam specific layout | Full | Yes |
| Steam UI+ | Steam specific layout | Full | Yes |
| Phoebus (pure tileset) | Standard classic layout | Full | Yes |
| Phoebus (patched executable) | Distribution specific layout | Full | Requires correct offset |
| Classic Vanilla | Classic layout | Full | Yes |
| Custom community bundle | Bundle provided layout | Full | Requires matching file |
Troubleshooting Dwarf Therapist Connectivity With Modded Setups
Persistent connectivity issues in modded environments almost always trace back to one of three root causes: version mismatch, permission conflicts, or interference from security software.
Diagnosing Version and Permission Issues
Start every troubleshooting session by confirming the exact game version and the exact Dwarf Therapist version side by side. Even a minor patch to the game executable can shift memory addresses enough to invalidate a previously working offset file.
On Windows systems, running Dwarf Therapist without administrator privileges while the game runs with them, or the reverse, prevents the memory reading process from completing.
Both applications should run under identical permission levels. Security software, including antivirus and anti-cheat tools, frequently flags memory-reading applications as suspicious.
Dwarf Therapist may need to be added to an exception list before it can access game memory reliably. This is a common requirement on systems with aggressive real time scanning enabled.
When to Seek Community Maintained Offset Files
The official Dwarf Therapist release cycle does not always keep pace with rapid game updates, particularly during active development periods for Dwarf Fortress. Community contributors maintain offset files for versions not yet covered by official releases.
The Bay12 Forums and the Dwarf Therapist GitHub repository issues section are the most reliable sources for community offset files. Searching for your specific game version number in those locations will typically surface working configuration files within a short time after a game update releases.
When using a community sourced offset file, place it in the memory layouts directory of your Dwarf Therapist installation and restart the application before attempting to connect. The tool will automatically detect available layout files on startup.
Frequently Asked Questions
Does Dwarf Therapist work with Phoebus tileset installed?
Yes, Dwarf Therapist works with Phoebus when the tileset is installed without a patched executable. If the Phoebus distribution includes a modified game executable, a matching distribution specific offset file is required for correct connectivity.
Will Steam UI+ break my existing Dwarf Therapist setup?
Steam UI+ itself does not alter the game executable or memory layout in ways that affect Dwarf Therapist. However, if a game update accompanied the UI+ installation, the offset file may need to be updated to match the new game version.
Where do I find the correct memory offset file for my game version?
Check the official Dwarf Therapist repository releases page first. If your version is not listed, search the Bay12 Forums or the GitHub issues section for community contributed offset files specific to your game version and operating system.
Can I run Dwarf Therapist alongside other Dwarf Fortress mods?
Yes. Dwarf Therapist reads labor and skill data and is not affected by content mods that add new items, creatures, or mechanics. Only mods that include a modified game executable may require additional configuration steps.
Why does Dwarf Therapist show corrupted skill data with my modded setup?
Corrupted or nonsensical skill data almost always indicates an offset file mismatch. The tool is reading memory at the wrong addresses. Identify your exact game version and source the corresponding offset file to resolve this.
Do I need to reconfigure Dwarf Therapist every time I switch tilesets?
No. Switching between pure tileset mods does not require any Dwarf Therapist reconfiguration. Reconfiguration is only needed when the underlying game executable version changes.
Is it safe to edit labors through Dwarf Therapist in a modded game?
Labor editing through Dwarf Therapist functions through direct memory writes and is not affected by UI or content mods.
The process carries the same risk profile as using it in a vanilla game, which the community has used extensively without reported save corruption under normal operation.
What should I do if Dwarf Therapist cannot find my Steam installation?
Open Dwarf Therapist settings and manually set the game executable path to the correct Steam installation directory. The tool sometimes defaults to a previously configured classic game path when both versions are installed on the same system.
Latest Post:
