09 Sep 06:15

8133bdb

DFHack 50.13-r5rc1 Pre-release

Pre-release

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.

On Steam, this beta release is available on the DFHack beta channel (for DF 50.13), the adventure-beta channel (for DF 51.01-beta), and the 50.14testing channel (for DF 50.14-beta).

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

Idle crafting, Room reservations, Ethics violation warning

Idle crafting

Dwarves will now have to option to go craft something when they have the need. The only thing you have to do is designate a Craftsdwarf's workshop as a place where dwarves can elect to go to do their crafting.

At the bottom of the "Workers" tab, you'll now see an option for "Allow idle dwarves to satisfy crafting needs". The option will only be toggleable if the workshop is not assigned to a master. If you set this option to "yes", then you'll see crafting jobs start to appear as your idle dwarves figure it's time to go craft something. Feel free to trade those crafts away to the next caravan.

This feature works best if you build a separate Craftsdwarf's workshop (or two) specifically for idle crafting, and you set the number of "General work orders allowed" to zero on the "Work orders" tab for the workshop. That way, the workshop is kept free for dwarves to use in their down time.

If you have the "Permitted General Work Order Labors" customized for the workshop, the kinds of crafting jobs that dwarves will do there will respect the setting. Note that you must have at least one of Stonecrafting or Bone Carving enabled for the workshop to be used for idle crafting.

Room reservations

This is actually two things in one: a bugfix and a quality of life tool. The bugfix part takes effect automatically when a unit leaves the map. The most common situation is a squad going out on a raid. You may have noticed that when a unit leaves the map, they lose ownership of all their rooms. If you have carefully assigned specific bedrooms to your squad members, you'll be annoyed to see the rooms snagged by some random dwarf while your squad is away. This is even more impactful if you have nobility or administrators in the squad: their room requirements will be suddenly unmet.

Now, when your units leave the map, their room will be reserved in their name for when they get back. The room's zone will be disabled, and you'll see a message when you click on the zone telling you who the room is reserved for. You have the option of cancelling the reservation and making the room available for general use, if you want to.

The second part of this feature is the ability to reserve rooms for specific noble or administrative roles. You can make a fine office and pre-reserve it for when a baron is appointed. The office will be disabled until a baron appears, and when someone is appointed to that role, the room will be automatically assigned to them. You can even prepare for the situation where you have many barons. If you prepare and reserve 10 offices for the baron role, one office will be assigned to up to 10 barons when they appear.

This is also very useful for administrative roles like managers. If you switch managers frequently, it can be a hassle to reassign the office each time. When you reserve the room for the manager role, the room will be automatically reassigned when a new citizen is appointed to the role.

Ethics violation warning

It is now much harder to accidentally offend the elves. To be clear, you can still offend them if you want to. It's just harder to do it unintentionally.

When you select items for trade in the bartering menu (when you are actually specifying which fort items to trade for which merchant items) and have an item selected that will cause the elves to declare you a heathen, you'll see an "Ethics warning" badge next to the Trade button. Clicking on this badge will list the offending items, and it will give you an option to deselect them. If you click the Trade button anyway, you'll get one final confirmation to make absolutely sure you know what you're doing.

Give it a try! Remember, happy elves bring friendly giant animals instead of hostile ones! : )

Announcements

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.

Many 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 do not compile yet and are not available 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

New Tools

embark-anyone: allows you to embark as any civilization, including dead and non-dwarven civs
gui/family-affairs: (reinstated) inspect or meddle with pregnancies, marriages, or lover relationships
idle-crafting: allow dwarves to independently satisfy their need to craft objects
notes: manage map-specific notes
preserve-rooms: manage room assignments for off-map units and noble roles. reserves rooms owned by traveling units and reinstates their ownership when they return to the site. also allows you to assign rooms to noble/administrator roles, and the rooms will be automatically assigned whenever the holder of the role changes

New Features

caravan:
- DFHack dialogs for trade screens (both Bring goods to depot and the Trade barter screen) can now filter by item origins (foreign vs. fort-made) and can filter bins by whether they have a mix of ethically acceptable and unacceptable items in them
- If you have managed to select an item that is ethically unacceptable to the merchant, an "Ethics warning" badge will now appear next to the "Trade" button. Clicking on the badge will show you which items that you have selected are problematic. The dialog has a button that you can click to deselect the problematic items in the trade list.
confirm: If you have ethically unacceptable items selected for trade, the "Are you sure you want to trade" confirmation will warn you about them
exportlegends: option to filter by race on historical figures page
quickfort: #zone blueprints now integrated with preserve-rooms so you can create a zone and automatically assign it to a noble or administrative role

Fixes

DFHack screens that allow keyboard cursor and camera movement while focused now also allow diagonal and Z-change keyboard cursor keys
DFHack state for a site is now properly saved when retiring a fort
prevent hang when buildings in zones are destroyed in the case where the buildings were not added to the zone in the same order that they were created (uncommon)
System clipboard: when pasting single lines from the system clipboar...

Assets 4

04 Aug 07:42

github-actions

50.13-r4

b493885

DFHack 50.13-r4 Latest

Latest

Q: How do I download DFHack?

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

Highlights

Table of contents in gui/journal, timestream bugfixes and improvements

Table of contents in gui/journal

Community contributor psychowico has continued to deliver improvements to gui/journal. It now supports markdown syntax for section headers, and it will automatically build a hyperlinked table of contents as you add the headers.

To add a header, start a line with "# ", e.g. "# Fortress goals". You can add level 2 subheadings with "## ", and so on.

Due to the tool's popularity, there is now a global hotkey (in fort mode) for launching gui/journal: Ctrl-j

timestream bugfixes and improvements

The FPS fixer timestream has been significantly refined for better behavior at the highest FPS improvement levels. For example, jobs were not being generated quickly enough for the accelerated calendar rate. Also, some non-skill-based jobs, like eating and drinking, were taking too long to complete. With the updates, dwarves will no longer be left jobless or get stuck in the booze stockpile with seemingly unquenchable thirst.

Announcements

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.

Changelog

New tools, fixes, and improvements

New Features

gui/journal:
- new hotkey, accessible from anywhere in fort mode: Ctrl-j
- new automatic table of contents. add lines that start with "# ", like "# Entry for 502-04-02", to add hyperlinked headers to the table of contents

Fixes

Copy/Paste: Fix handling of multi-line text when interacting with the system clipboard on Windows
add-spatter: fix a crash related to unloading a savegame with add-spatter reactions, then loading a second savegame with add-spatter reactions
autodump: cancel any jobs that point to dumped items
build-now: fix error when building buildings that (in previous DF versions) required the architecture labor
changelayer: fix incorrect lookup of geological region in multi-region embarks
fix/dead-units: fix error when removing dead units from burrows and the unit with the greatest ID was dead
full-heal: fix -r --all_citizens option combination not resurrecting citizens
gui/autodump:
- prevent dumping into walls or invalid map areas
- properly turn items into projectiles when they are teleported into mid-air
gui/settings-manager: fix position of "settings restored" message on embark when the player has no saved embark profiles
gui/unit-info-viewer: correctly display skill levels when rust is involved
list-waves: no longer gets confused by units that leave the map and then return (e.g. squads who go out on raids)
locate-ore: fix sometimes selecting an incorrect tile when there are multiple mineral veins in a single map block
makeown: ensure names given to adopted units (or units created with gui/sandbox) are respected later in legends mode
open-legends: don't intercept text bound for vanilla legends mode search widgets
plant: properly detect trees in a specified cuboid that only have branches/leaves in the cuboid area
prioritize: fix incorrect restoring of saved settings on Windows
timestream:
- fix dwarves spending too long eating and drinking
- fix jobs not being created at a sufficient rate, leading to dwarves standing around doing nothing
zone: fix alignment of animal actions overlay panel (the one where you can click to geld/train/etc.) when the animal has a custom portrait (like named dragons)

Misc Improvements

performance improvements for DFHack tools and infrastructure
allneeds: display distribution of needs by how severely they are affecting the dwarf
autodump: allow dumping items into mid-air, converting them into projectiles like gui/autodump does
build-now: if suspendmanager is running, run an unsuspend cycle immediately before scanning for buildings to build
gui/pathable: give edge tiles where wagons can enter the map a special highlight to make them more identifiable. this is especially useful when the game decides that only a portion of the map edge is usable by wagons.
list-waves:
- now outputs the names of the dwarves in each migration wave
- can now display information about specific migration waves (e.g. list-waves 0 to identify your starting 7 dwarves)

Documentation

improved docs for dfhack.units module functions

Removed

The PRELOAD_LIB environment variable has been renamed to DF_PRELOAD to match the naming scheme of other environment variables used by the dfhack startup script. If you are preloading libraries (e.g. for performance testing) please define DF_PRELOAD instead of PRELOAD_LIB or LD_PRELOAD
cuboid::clamp(bool block): renamed to cuboid::clampMap(bool block), name taken by cuboid::clamp(cuboid other)
Units::getPhysicalDescription: function requires DF call point that is no longer available. alternative is to navigate the unit info sheet and extract the description from the UI (see markdown)
Units::MAX_COLORS, Units::findIndexById, Units::getNumUnits, Units::getUnit: replaced by DFHack::COLOR_MAX and the generated type-specific get_vector functions

API

cuboid:
- construct from df::map_block*, forBlock iterator to access map blocks in cuboid
- clamp(cuboid other), clampNew(cuboid other) for cuboid intersection. clampNew returns new cuboid instead of modifying.
Items: no longer need to pass MapCache parameter to moveToGround, moveToContainer, moveToBuilding, moveToInventory, makeProjectile, or remove
setAreaAquifer, removeAreaAquifer: add overloads that take cuboid range specifiers
Units::getCasteRaw: get a caste_raw from a unit or race and caste
Units::getProfessionName: bool land_title to append "of Sitename" where applicable, use Prisoner/Slave and noble spouse titles (controlled by ignore_noble)
Units::getProfession: account for units with fake identities
Units::getRaceChildName, getRaceChildNameById, getRaceBabyName, getRaceBabyNameById: bool plural to get plural form
Units::getReadableName: correct display of ghost+curse names w/r/t each other and unit prof, use curse.name instead of iterating syndrome name effects
Units::isDanger: added bool hiding_curse, passed to isUndead to avoid spoilers
`...

Assets 4

04 Jul 07:13

github-actions

50.13-r3

369b805

DFHack 50.13-r3

Q: How do I download DFHack?

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

Highlights

Designation designer, In-game journal, Fix FPS death, Map editing, Immigration control, Quick zoom, Trade depot pathability

Designating digging and constructions with shapes

Our digging layout tool, gui/design has had a major usability overhaul.

There is a new, button-oriented interface for selecting modes and shapes, and the overall experience of designating, stretching, rotating, moving, and applying to the map is much easier than it was before.

Have fun with those curves!

Keep notes in-game with the new fort journal

Brought to you by community member psychowico, gui/journal is a multi-line text editor that allows you to take notes on your fort's goals, plans, and progress. The text is saved with your fort, and the editor provides many mouse- and keyboard-friendly text editing conveniences, like cursor movement, text selection, and copy/paste (fully integrated with the system clipboard).

It is especially useful for jotting down what you're in the middle of doing so you can remind yourself when you load the game later.

Fix FPS death with timestream

timestream has a simple premise: when the FPS drops, speed up reality to compensate. It dynamically adjusts the calendar so that the flow of time scales to match a target FPS (usually 100). Put simply, it makes the game move as quickly as it did when you first embarked, even when you have hundreds of units on the map.

With timestream active, you can keep the game running at full speed as long as the vanilla FPS counter stays above 15 FPS. At that point, the game will still run faster than it would otherwise, but you'll start noticing the slowdown.

This tool breathes new life into old forts. If you start to feel frustrated that the game is getting sluggish, give timestream a try. It's on the "Gameplay" tab of gui/control-panel.

Interactive map editing

You may have heard of tiletypes as the command to use for editing the map. It has a reputation for being difficult to understand, and startlingly easy to get wrong. Thanks to community member tatoyoda600's efforts, we now have gui/tiletypes, which turns map editing into simple point and click!

You can now easily fill in gaps in accidentally-dug areas, change tiles to the materials of your choice for decoration, or reshape the terrain to your liking!

Control the rate of immigration

A common complaint is that very large migrant waves can overwhelm fort infrastructure. If you enable the pop-control tool in gui/control-panel (Gameplay tab), you can limit migration waves to a reasonable size. The default is 10, but you can adjust it to any number you feel comfortable with.

Note that this tool will overwrite the population caps set in the vanilla settings, so if you have those numbers customized, be sure to update the setting for pop-control itself. For example, if you want a maximum population of 100 (along with the default per-wave maximum of 10 immigrants), run

pop-control set max-pop 100

after you enable pop-control.

Quick find and zoom for people, locations, and artifacts

The new gui/sitemap tool helps you find and zoom to things quickly.

It works in both adventure and fort mode. In adventure mode, its primary use is to find what you're looking for when you get to a site. If you have a quest to talk to a specific person or find a specific artifact, it can be very frustrating to arrive at the correct site but then be completely unable to find what you're looking for on the map. It doesn't help that nobody at the site can give you directions! gui/sitemap will list all the people, places, and things of interest and let you zoom the screen to their location with a click. You'll still have to find your way over there, though, which can be a challenge if it's deep underground.

In fort mode, it serves as a faster alternative to the vanilla overview screens. It also has the unique benefit of telling you both the Dwarven and the English names of artifacts. Now, when you get a notification that Thunderbanner has been stolen, you can search for the artifact in gui/sitemap and see that it's actually warning you about Amudzulban. Then you can zoom to its current location and search some pockets.

Trade depot pathability visualization for wagons

Veteran players may remember a feature from Dwarf Fortress in its pre-Steam times: the ability to show where caravan wagons can path on their way to your trade depot. This feature was not brought forward to DF v50, so DFHack offers a replacement. If you are concerned about whether wagons can get to your depot, or if you'd like to identify the choke points, start up gui/pathable and select the "Depot" tab. That will highlight the tiles that wagons can traverse on their way to your trade depot (or any of your trade depots, if you have more than one).

Announcements

What does DFHack do for Adventure mode?, Locale-sensitive number formatting, Dreamfort updates, PSAs

What does DFHack do for Adventure mode?

DFHack supports the DF adventure mode beta on its own adventure-beta Steam branch. If you're subscribed to the beta branch for Dwarf Fortress, please subscribe to the adventure-beta branch for DFHack.

DFHack automatically applies a number of bugfixes and interface enhancements by default, such as:

fix corrupt throwing/shooting state, preventing save/load crashes after shooting a weapon
extend the searchable keywords in the conversation topic list to make it easier to find the topic you're looking for
add "ask whereabouts of" conversation topics so you can discover the location of people with whom you have some sort of relationship (before, you could only ask whereabouts of people involved in rumors)
add drowning/suffocation and blood loss countdown displays so you can tell how dire your situation is

There are also bugfixes, productivity tools, and sandbox (armok) tools specifically designed for adventure mode that you can run as needed:

advtools party: promotes one of your companions to become a controllable adventurer
advtools pets: fixes issues with companions' pets and pets you gift to others in adventure mode
fix/sleepers: fix sleeping units belonging to a camp that never wake up
gui/sitemap: list and zoom to people, locations, and artifacts
unretire-anyone: start an adventure as any historical figure in the world (use on embark preparation screen)
gui/reveal: reveal the adventure mode map and keep it revealed as you move
bodyswap: move adventurer control to another unit (any other unit)
flashstep: jump your adventurer across the map by hovering over a tile with the mouse and hitting a hotkey (Ctrl-t)
ghostly: allow your adventurer to walk through walls
resurrect-adv: revive a newly dead adventurer
`reveal-adv-ma...

Assets 4

29 Jun 09:05

github-actions

50.13-r3rc3

f32e2bc

DFHack 50.13-r3rc3 Pre-release

Pre-release

Q: How do I download DFHack?

On Steam, this beta release is available on the DFHack beta channel (for DF 50.13) and the adventure-beta channel (for DF 51.01-beta).

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

Changelog

Fixes

timestream: Don't increase thirst level for animals when skipping time -- animals do not get thirsty

Assets 4

28 Jun 21:42

github-actions

50.13-r3rc2

b1ac93e

DFHack 50.13-r3rc2 Pre-release

Pre-release

Q: How do I download DFHack?

On Steam, this beta release is available on the DFHack beta channel (for DF 50.13) and the adventure-beta channel (for DF 51.01-beta).

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

Highlights

In addition to the features introduced in DFHack 50.13-r3rc1, there are some new highlights for this beta release:

Fix FPS death with timestream, Trade depot pathability visualization for wagons

Fix FPS death with timestream

timestream has a simple premise: when the FPS drops, speed up the world to compensate. It dynamically adjusts the calendar so that time flows at a rate that makes you feel like you're playing at a much higher FPS. It makes the game much more responsive and snappy, even when you have hundreds of units on the map.

With timestream active, you can keep the game running at full speed as long as the vanilla FPS counter stays above 15 FPS. At that point, you'll hit other limitations and you'll start noticing the slowdown.

Trade depot pathability visualization for wagons

Announcements

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.

Changelog

This changelog has been trimmed to only show the difference from the previous beta.

New tools, fixes, and improvements

New Tools

devel/luacov: (reinstated) add Lua script coverage reporting for use in testing and performance analysis
fix/sleepers: (reinstated) fixes sleeping units belonging to a camp that never wake up.
timestream: (reinstated) keep the game running quickly even when there are large numbers of units on the map

New Features

Locale-senstive number formatting: select your preferred format in gui/control-panel. prices and other large numbers in DFHack UIs can be displayed with commas (English formatting), the number formatting used by your system locale, in SI units (e.g. 12.3k), or even in scientific notation
gui/pathable: new "Depot" mode that shows whether wagons can path to your trade depot

Fixes

clear-smoke: properly tag smoke flows for garbage collection to avoid memory leak
overlay: overlay positions are now adjusted according to the configured max interface width percentage in the DF settings
zone: animal assignment overlay button moved to not conflict with vanilla aquarium/terrarium button on glass cages

Misc Improvements

empty-bin: select a stockpile, tile, or building to empty all containers in the stockpile, tile, or building
exterminate:
- add --limit option to limit number of exterminated creatures
- add knockout and traumatize method for non-lethal incapacitation
gui/unit-syndromes: make werecreature syndromes easier to search for
orders: you can now delete your exported orders from the import dialog

Removed

adv-fix-sleepers: renamed to fix/sleepers

Lua

gui.get_interface_rect, gui.get_interface_frame: convenience functions for working with scaled interfaces
overlay: new attributes: fullscreen and full_interface for overlays that need access to the entire screen or the scaled interface area, respectively
string:wrap: now preserves inter-word spacing and can return the wrapped lines as a table of strings instead of a single multi-line string

Assets 4

20 Jun 01:23

github-actions

50.13-r3rc1

b1141b1

DFHack 50.13-r3rc1 Pre-release

Pre-release

Q: How do I download DFHack?

On Steam, this beta release is available on the DFHack beta channel (for DF 50.13) and the adventure-beta channel (for DF 51.01-beta).

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

Highlights

Designating digging and constructions with shapes, Interactive map editing, Quick find and zoom for people, locations, and artifacts, Controlling rate of immigration, Plant and tree manipulation, Locale-sensitive number formatting

Designating digging and constructions with shapes

Our digging design tool, gui/design has had a major usability overhaul.

There are now icons for selecting modes and shapes, and the overall experience of designating shapes, stretching, rotating, and moving them, and finally applying them to the map is much easier than it was before.

Have fun with those curves!

Interactive map editing

You can now easily fill in gaps in accidentally-dug areas, spawn tiles of the material of your choice for digging, or reshape the surface terrain to your liking!

Quick find and zoom for people, locations, and artifacts

The new gui/sitemap tool helps you find and zoom to things quickly.

Controlling rate of immigration

pop-control set max-pop 100

after you enable pop-control.

Plant and tree manipulation

For those looking to meddle in the natural order, we now have the commandline plant tool for spawning, growing, and removing plant life.

For example, to grow a sapling into a tree, enter mining mode, enable the keyboard cursor, and highlight the tile with the sapling on it. Then, run plant grow here to increase the sapling's age. Once you unpause the game, the sapling will instantly grow into a tree!

Locale-sensitive number formatting

DFHack tools can display a lot of large numbers, especially where prices and weights are involved. We have traditionally formatted those numbers exactly the same as DF itself does -- that is, no formatting; just numbers. For example, one million is written as 1000000.

This can be hard to read, but it's also not perfectly clear how else the numbers should be formatted. In English, we often add commas to numbers, one comma every third digit, so one million would be written as 1,000,000. That would make it easier to read, assuming English is your native language. People from India might prefer to see one million as 10,00,000, and people from Germany might prefer 1.000.000.

So now you have a choice. In gui/control-panel, in the Preferences tab, there is now a Large number formatting preference that you can set.

You have several options:

None (the default), which formats the numbers without embellishment like vanilla DF does (e.g. 1234567)
English, which formats the numbers with commas every third digit (e.g. 1,234,567)
System locale, which formats the numbers according to the locale settings for your operating system (system-dependent)
SI suffix, which shows up to three significant digits and a metric-system suffix (e.g. 1.23M)
Scientific, which shows numbers in scientific notation (e.g. 1.2e+06)

Your choice will apply to DFHack displays, such as gui/unit-info-viewer or the prices on the DFHack trade screens. Vanilla DF displays will not be affected.

Announcements

Behind-the-scenes changes, Dreamfort has been updated, PSAs

Behind-the-scenes changes

This release marks a significant step forward in aligning the DFHack names for variables with the actual names used internally by the Dwarf Fortress code. Not only does this help smooth communication between DFHack and DF devs, but it opens up a whole new world for modders who can now access large new sections of the game state. Expect new tools soon that capitalize on this improvement in accessibility, especially in regards to the world map!

One of the major reasons for this beta is to test the existing DFHack tools and ensure they were all properly migrated to the new naming scheme. Please be on the lookout for commands that you know worked before but that now spit out errors.

Dreamfort has been updated

The Dreamfort quickfort blueprints have seen significant updates in this release. If you are in the middle of building from the Dreamfort blueprints, expect some minor errors or misplaced furniture if you started building from the Dreamfort blueprints in the previous DFHack version.

Starting from a new embark, of course, will work perfectly fine.

If you're not already familiar with it, Dreamfort is DFHack's marquee blueprint set for a complete fort layout. It demonstrates good design patterns for new players and shows what the game is capable of. For more experienced players, it provides a simple, yet complete fortress that you can quickly get up and running when you want to focus on specific aspects of the game and not worry too much about infrastructure.

![image](https://github.com/DF...

Assets 4

22 May 14:11

github-actions

50.13-r2.1

cc27b97

DFHack 50.13-r2.1

Q: How do I download DFHack?

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

Changelog

New tools, fixes, and improvements

Fixes

suspendmanager: stop suspending single tile stair constructions

Assets 4

09 May 23:49

github-actions

50.13-r2

5bda414

DFHack 50.13-r2

Q: How do I download DFHack?

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

Highlights

Localization support, Adventure mode support, Export unit and item descriptions, Quick switch favorites for building planner materials

Localization support

You can now install both DFHack and the Dwarf Fortress localization project for translating essential parts of the DF UI into your native language!

It currently has good support for:

Spanish
Italian
Russian
German
Portuguese (Brazil)
French
Polish

The translations are done by volunteers. Please consider contributing to the translations if you are bilingual -- these translations help make Dwarf Fortress more accessible to non-English speakers.

More details at the Dwarf Fortress localization project home page: https://github.com/dfint

Adventure mode support

Dwarf Fortress adventure mode is currently available on DF's Steam beta branch. DFHack supports the adventure beta on its own adventure-beta branch. Please make sure you are subscribed to DFHack's adventure-beta branch if you are running the DF adventure beta!

We are going through our back catalog and steadily updating adventure mode tools. Moreover, we are modifying existing tools as necessary to be useful for adventure mode.

Here's what's been validated so far:

flashstep: teleport the adventurer to the mouse cursor
ghostly: allow the adventurer to walk through walls
gui/create-item: create arbitrary items
gui/reveal: reveal the map beyond your cone of vision
gui/sandbox: create units or trees (or items too)
gui/unit-info-viewer: get extended information on the selected unit
resurrect-adv: bring your adventurer back to life
reveal-adv-map: reveal hidden world map tiles
reveal-hidden-sites: reveal hidden world map sites
reveal-hidden-units: reveal hidden units on the local map
unretire-anyone: start an adventure as anybody in the world

In addition, all tools that aren't mode-specific, such as the mod manager and the new markdown unit/item description export, should work just fine too. If you try to use a tool in adventure mode and it doesn't behave as you'd expect, please tell us so we can improve the experience!

Expectations for the adventure mode beta

DFHack needs to release a new compatible build whenever a new DF beta is pushed, just like we need to release a new compatible build whenever a stable DF version is released.

The good news is that DFHack now has a process in place to automatically build a compatible DFHack version when a new DF beta drops. DFHack should be compatible with new DF betas within 15 minutes. Sometimes, however, Steam gets one update but not the other. If you get a message that DFHack does not recognize the version of Dwarf Fortress, try going into the app settings in your Steam client for both DFHack and Dwarf Fortress, click on Installed Files, and click the Verify integrity of game files button. That will poke Steam to ensure that both DF and DFHack are fully updated.

In addition to compatibility bumps, the adventure-beta branch of DFHack will be updated frequently as DFHack's support for adventure mode is improved.

Export unit and item descriptions

This release includes a unit/item description exporter that will write details about the selected unit or item to a formatted markdown text file.

Just select a unit or item and hit the Ctrl-t hotkey (or select markdown from the DFHack logo context menu)! The text will be written to a file in your Dwarf Fortress game directory, named after your current world. If you export multiple times, the text will be appended to the same file, so feel free to run markdown on all your forgotten beasts and expensive artifacts. The whole list will be ready for you when you're done.

Quick switch favorites for building planner materials

When you want to use a specific material for construction, say because you are designing a pattern in your tavern floor, it can be annoying to have to set the material filter each time. Now, you can set your favorite material filters and quickly switch among them with the new building planner favorites panel!

Your favorites are saved with your fort, so they'll be there for you if you save and load the game.

You can also rename a favorite by shift-clicking on the name.

Announcements

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.

Changelog

New tools, fixes, and improvements

New Tools

Updated for adventure mode:
- reveal
- gui/sandbox, gui/create-item, gui/reveal
adaptation: (reinstated) inspect or set unit cave adaptation levels
fix/engravings: fix corrupt engraving tiles
flashstep: (reinstated) teleport your adventurer to the mouse cursor
ghostly: (reinstated) allow your adventurer to phase through walls
markdown: (reinstated) export description of selected unit or item to a text file
resurrect-adv: (reinstated) allow your adventurer to recover from death
reveal-adv-map: (reinstated) reveal (or hide) the adventure map
unretire-anyone: (reinstated) choose anybody in the world as an adventurer

New Features

DFHack and the Dwarf Fortress translation project can now both be run at the same time
buildingplan: quick material filter favorites on main planner panel
instruments: new subcommand instruments order for creating instrument work orders

Fixes

blueprint: correctly define stockpile boundaries in recorded stockpile ("place") blueprints when there are adjacent non-rectangular stockpiles of identical types
caravan: don't include undiscovered divine artifacts in the goods lis...

Assets 4

25 Apr 05:39

github-actions

50.13-r1.1

f7916c0

DFHack 50.13-r1.1

Q: How do I download DFHack?

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

Changelog

See https://github.com/DFHack/dfhack/releases/tag/50.13-r1 for the major changes in this release

New tools, fixes, and improvements

Fixes

deathcause: fix error on run
gui/quantum: accept all item types in the output stockpile as intended

Documentation

Update docs on release procedures and symbol generation

Assets 4

23 Apr 16:03

github-actions

50.13-r1

969bce7

DFHack 50.13-r1

Q: How do I download DFHack?

This release is for the non-beta 50.13 release of DF. For the DF v51.01 adventure mode beta, please subscribe to the DFHack adventure-beta beta branch on Steam. The adventure-beta DFHack branch includes everything in this release as well.

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

Highlights

Point and click quantum stockpiles, Extended unit info summary

Point and click quantum stockpiles

Run gui/quantum and you'll get a visual, interactive interface for creating quantum stockpiles.

Quantum stockpiles simplify fort management by allowing a small stockpile to contain a large number of items. This reduces the complexity of your storage design, lets your dwarves find items more efficiently, and increases FPS. Until now, though, they were a bit fiddly to set up and it was easy to make a mistake that would prevent them from working correctly.

Quantum stockpiles work by linking a “feeder” or "input" stockpile to a one-tile minecart hauling route. Whenever an item from the feeder stockpile is placed in the minecart, the minecart is tipped and the item spills out onto an adjacent tile. The single-tile "output" stockpile in that adjacent tile holds all the items spilled out of the minecart and is your quantum stockpile. You can also choose to not have a receiving stockpile and instead have the minecart dump into a pit (perhaps a pit filled with magma).

The gui/quantum UI will walk you through the steps:

Select a stockpile to be the feeder by clicking on it.
Set configuration (like what the quantum stockpile will be named) with the onscreen options.
Click on a free tile on the map to build the minecart stop and (optionally) designate the output stockpile.

If there are minecarts available, one will be automatically assigned to the track stop for you. If you don’t have a free minecart, gui/quantum will enqueue a manager order to make a wooden one. Once it is manufactured, you’ll have to run assign-minecarts all to assign it to the route, or you can open the (H)auling menu and assign the minecart manually. The quantum stockpile will not function until the minecart is in place.

See the wiki for more information on quantum stockpiles.

Extended unit info summary

gui/unit-info-viewer will give you detailed (but non-spoilery) data on the currently selected unit and their race. Among other things, this handy lookup tool will tell you if a creature needs grass or lays eggs. It will even tell you the unit's current size in cubic centimeters.

If you have any ghosts walking (floating?) around, you'll get some interesting info on them as well : )

Announcements

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.

Changelog

New tools, fixes, and improvements

New Tools

gui/quantum: (reinstated) point and click interface for creating quantum stockpiles or quantum dumps
gui/unit-info-viewer: (reinstated) give detailed information on a unit, such as egg laying behavior, body size, birth date, age, and information about their afterlife behavior (if a ghost)

Fixes

Fixed incorrect DFHack background window texture when DF is started in ascii mode and subsequently switched to graphics mode
Fixed misidentification of visitors from your own civ as residents; affects all tools that iterate through citizens/residents
cursecheck: act on selected unit only if a unit is selected
exterminate: don't classify dangerous non-invader units as friendly (e.g. snatchers)
gui/create-item:
- properly restrict bags to bag materials by default
- allow gloves and shoees to be made out of textiles by default
open-legends: don't interfere with the dragging of vanilla list scrollbars

Misc Improvements

gui/gm-unit: changes to unit appearance will now immediately be reflected in the unit portrait
open-legends: allow player to cancel the "DF will now exit" dialog and continue browsing
suspendmanager: Account for walls planned on the z-layer below when determining accessibility to a job

Structures

biome_type: add enum attrs for caption and plant_raw_flags

Documentation

autoclothing: add section comparing autoclothing and tailor to guide players choosing which to enable

Assets 4

Releases: DFHack/dfhack

DFHack 50.13-r5rc1

Q: How do I download DFHack?

Highlights

Idle crafting

Room reservations

Ethics violation warning

Announcements

PSAs

Changelog

New Tools

New Features

Fixes

DFHack 50.13-r4

Q: How do I download DFHack?

Highlights

Table of contents in gui/journal

timestream bugfixes and improvements

Announcements

PSAs

Changelog

New Features

Fixes

Misc Improvements

Documentation

Removed

API

DFHack 50.13-r3

Q: How do I download DFHack?

Highlights

Designating digging and constructions with shapes

Keep notes in-game with the new fort journal

Fix FPS death with timestream

Interactive map editing

Control the rate of immigration

Quick find and zoom for people, locations, and artifacts

Trade depot pathability visualization for wagons

Announcements

What does DFHack do for Adventure mode?

DFHack 50.13-r3rc3

Q: How do I download DFHack?

Changelog

Fixes

DFHack 50.13-r3rc2

Q: How do I download DFHack?

Highlights

Fix FPS death with timestream

Trade depot pathability visualization for wagons

Announcements

PSAs

Changelog

New Tools

New Features

Fixes

Misc Improvements

Removed

Lua

DFHack 50.13-r3rc1

Q: How do I download DFHack?

Highlights

Designating digging and constructions with shapes

Interactive map editing

Quick find and zoom for people, locations, and artifacts

Controlling rate of immigration

Plant and tree manipulation

Locale-sensitive number formatting

Announcements

Behind-the-scenes changes

Dreamfort has been updated

DFHack 50.13-r2.1

Q: How do I download DFHack?

Changelog

Fixes

DFHack 50.13-r2

Q: How do I download DFHack?

Highlights

Localization support

Adventure mode support

Expectations for the adventure mode beta

Export unit and item descriptions