DFHack tools

DFHack comes with a lot of tools. This page attempts to make it clearer what they are, how they work, and how to find the ones you want.

What tools are and how they work

DFHack is a Dwarf Fortress memory access and modification framework, so DFHack tools normally access Dwarf Fortress internals and make some specific changes.

Some tools just make a targeted change when you run them, like unforbid, which scans through all your items and removes the forbidden flag from each of them.

Some tools need to be enabled, and then they run in the background and make changes to the game on your behalf, like autobutcher, which monitors your livestock population and automatically marks excess animals for butchering.

And some tools just exist to give you information that is otherwise hard to come by, like gui/petitions, which shows you the active petitions for guildhalls and temples that you have agreed to.

Finding the tool you need

DFHack tools are tagged with categories to make them easier to find. These categories are listed in the next few sections. Note that a tool can belong to more than one category. If you already know what you’re looking for, try the Search Page or Ctrl-F on this page. If you’d like to see the full list of tools in one flat list, please refer to the annotated index.

Some tools are part of our back catalog and haven’t been updated yet for v50 of Dwarf Fortress. These tools are tagged as unavailable. They will still appear in the alphabetical list at the bottom of this page, but unavailable tools will not listed in any of the indices.

DFHack tools by game mode

  • adventure

    Tools that are useful while in adventure mode.

  • dfhack

    Tools that you use to run DFHack commands or interact with the DFHack or DF system.

  • embark

    Tools that are useful while on the fort embark screen or while creating an adventurer.

  • fort

    Tools that are useful while in fort mode.

  • legends

    Tools that are useful while in legends mode.

DFHack tools by theme

  • armok

    Tools which give the player god-like powers or the ability to access information the game intentionally keeps hidden. Players that do not wish to see these tools can hide them in the Preferences tab of gui/control-panel.

  • auto

    Tools that run in the background and automatically manage routine, toilsome aspects of your fortress.

  • bugfix

    Tools that fix specific bugs, either permanently or on-demand.

  • design

    Tools that help you with fort layout.

  • dev

    Tools that are useful when debugging or developing mods.

  • fps

    Tools that help you prevent impact to your FPS.

  • gameplay

    Tools that introduce new gameplay elements.

  • inspection

    Tools that let you view information that is otherwise difficult to find.

  • productivity

    Tools that help you perform common tasks quickly and easily.

DFHack tools by what they affect

  • animals

    Tools that interact with animals.

  • buildings

    Tools that interact with buildings and furniture.

  • graphics

    Tools that interact with game graphics.

  • interface

    Tools that interact with or extend the DF user interface.

  • items

    Tools that interact with in-game items.

  • jobs

    Tools that interact with jobs.

  • labors

    Tools that deal with labor assignment.

  • map

    Tools that interact with the game map.

  • military

    Tools that interact with the military.

  • plants

    Tools that interact with grass, trees, shrubs, and crops.

  • stockpiles

    Tools that interact with stockpiles.

  • units

    Tools that interact with units.

  • workorders

    Tools that interact with workorders.

All DFHack tools alphabetically