github DFHack/dfhack 53.11-r2
DFHack 53.11-r2

5 hours ago

Q: How do I download DFHack?

A: Either add to your Steam library from our Steam page or scroll to the latest release on our GitHub releases page, expand the "Assets" list, and download the file for your platform (e.g. dfhack-XX.XX-rX-Windows-64bit.zip. If you are on Windows and are manually installing from the zip file, please remember to right click on the file after downloading, open the file properties, and select the "Unblock" checkbox. This will prevent issues with Windows antivirus programs.


This release is compatible with all distributions of Dwarf Fortress: Steam, Itch, and Classic.

Please report any issues (or feature requests) on the DFHack GitHub issue tracker. When reporting issues, please upload a zip file of your savegame and a zip file of your mods directory to the cloud and add links to the GitHub issue. Make sure your files are downloadable by "everyone with the link". We need your savegame to reproduce the problem and test the fix, and we need your active mods so we can load your savegame. Issues with savegames and mods attached get fixed first!

Highlights

Bug fixes

Bug fixes

This release fixes several bugs, most notably the rename tool, which was hanging, and several tools that managed work orders that were creating them wrong due to an underlying infrastructure change that interacted in an unexpected way.

In addition, a change in DF itself caused the DFHack console to work differently which caused problems displaying names with accent marks; this has been fixed, and the DFHack console will now work more reliably on Windows systems.

Announcements

Steam client issues, PSAs

Steam client issues

Steam has changed the way the Steam client installed DFHack in a way that prevents it from working automatically. Until we update our deployment mechanics, this means that users using DFHack via Steam may have to manually copy DFHack from the location Steam installs into, into DF's folder. Steam users who have to do this may also have to launch using the "Dwarf Fortress" entry in their Steam library, not from the "DFHack" entry. We have been aware of this as a coming thing for a while now, but we didn't have time to get it addressed before Steam's changes went live. We apologize for the inconvenience. Fixing this is a top priority right now, and and we expect to have this fixed within the next few weeks.

PSAs

As always, remember that, just like the vanilla DF game, DFHack tools can also have bugs. It is a good idea to save often and keep backups of the forts that you care about.

Some DFHack tools that worked in previous (pre-Steam) versions of DF have not been updated yet and are marked with the "unavailable" tag in their docs. If you try to run them, they will show a warning and exit immediately. You can run the command again to override the warning (though of course the tools may not work). We make no guarantees of reliability for the tools that are marked as "unavailable".

The in-game interface for running DFHack commands (gui/launcher) will not show "unavailable" tools by default. You can still run them if you know their names, or you can turn on dev mode by hitting Ctrl-D while in gui/launcher and they will be added to the autocomplete list. Some tools listed as "unavailable" in the docs do not compile yet and are not accessible at all, even when in dev mode.

If you see a tool complaining about the lack of a cursor, know that it's referring to the keyboard cursor (which used to be the only real option in Dwarf Fortress). You can enable the keyboard cursor by entering mining mode or selecting the dump/forbid tool and hitting Alt-K (the DFHack keybinding for toggle-kbd-cursor). We're working on making DFHack tools more mouse-aware and accessible so this step isn't necessary in the future.

Changelog

New tools, fixes, and improvements

Fixes

  • autoclothing, autoslab, tailor: orders will no longer be created with a repetition frequency of NONE
  • gui/rename: skip NONE when iterating through language name options
  • quickfort: work orders will no longer be created with a repetition frequency of NONE

Misc Improvements

  • General: DFHack will unconditionally use UTF-8 for the console on Windows, now that DF forces the process effective system code page to 65001 during startup

Structures

  • reordered XML attributes for consistency: ret-type, base-type, type-name, and pointer-type now appear first (and in that exact order)

Don't miss a new dfhack release

NewReleases is sending notifications on new releases.