Known bugs and issues

xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼

v50.14 · v0.47.05 This article is about the current version of DF. Note that some content may still need to be updated. More Info · V

"Bugs" redirects here. For insects, see Vermin and Creature.

Dwarf Fortress is a constant work in progress, and is thus full of bugs. Some of them are minor and completely harmless, some are small and annoying, and some are major and even game-changing. Some of the best-known bugs are compiled below; an official compilation of all bugs, and their development status, can be found on the Mantis Bug Tracker. Please do not report bugs here; they should be reported on the bug tracker instead. If you have issues signing up for the bug tracker, see the forum bug tracker board for instructions (but don't report bugs on the forum either).

Some bugs were fixed in v0.34 by a temporary binary patch made by Quietust and other users; most of these fixes were rolled into v0.40.

Severe bugs

These bugs can significantly interfere with play.

• Bug 11014: Crash from corrupted military equipment lists
• Bug 10369: Crash when Dwarves return from mission -- one major cause fixed in v0.44.10
• Bug 9905: Crash when filtering material type condition in work order
• Bug 9653: Tavern keeper/performers repeatedly serve alcohol until patrons drink themselves to death
  • Workaround: do not assign tavern keepers or performers, or do not place any alcohol within the tavern zone
• Bug 9438: Caravans/invasions do not come reliably from accessible civilizations
• Bug 9593: Caravans/invasions sometimes get "stuck" off-map
  • Workaround: teleport merchants on to map with dfhack
  • Workaround: save prior to arrival, and reload until the caravan successfully appears
• Bug 7161: Morale is screwy -- saves demonstrating morale problems in v0.44.03+ requested
  • Workaround: mod creatures to have natural Discipline skill
  • Workaround: barracks training raises Discipline
  • Workaround: continual exposure to sentient corpses raises Discipline (along with feelings of horror)
• Bug 7185: Scared traders immediately scuttle wagons and leave.
• Bug 9004: Items in containers are "unavailable" while a dwarf is hauling another item to store in the container
  • Workaround: new STORE_DIST_* settings in d_init.txt can tweak the behavior.
  • Workaround: clever Stockpile Designs can reduce the impact
  • Workaround: avoid using containers (use quantum stockpiles, minecart stockpiles, or no stockpiles instead)
• Bug 7107 Fighting berserk citizens and citizen werebeasts causes defenders to lose loyalty.

New bugs

These bugs are new in recent versions (v0.42+). (There are many more; these are just a few of the most prominent.)

• Bug 10490: "Spies" arrive as part of migrant group
• Bug 10346: NPCs demanding other characters identify themselves in a loop
• Bug 10349: Were-dwarfs stuck in weird spot between injured and healed
• Bug 9588: Animal people with [MEANDERER] tag move too slowly
• Bug 9221: Visiting scholars leave carrying fortress books/scrolls/copies/codices

Lingering bugs

These bugs are not new to v0.42/v0.44, but have been confirmed as still existing.

• Bug 1451: Military equipment interferes with civilian equipment (picks/axes/crossbows/quivers). It is not possible to use a single axe for both wood cutting and combat, or a single pick for both mining and combat. Crossbows in the hands of hunters can also cause problems.
• Bug 94: Seriously wounded dwarfs sometimes don't get taken to bed.
• Bug 2712: Weapons, especially whips, cut through steel armor like butter.
  • Workaround: appropriate modding to nerf these weapons
• Bug 2780: Pond/pool populations (e.g. pond turtles) do not replenish, gradually become extinct
  • Supposedly fixed in 0.40.01 but reported to still be happening with ponds
• Bug 535: Equipping weapons/armor on military is erratic. This is a long-standing bug that has been slowly but surely rolled back.
• Bug 296: Pools/smears/spatters of blood, dust and other materials multiply themselves, get tracked around too much. Contaminant physics are strange in Dwarf Fortress; instead of washing away, when exposed to running water, it will actually multiply to other tiles.
  • Workaround: routinely run clean in DFHack
• Bug 4550: Dodging into river/lava/pit etc. Apparently, dwarves are stupid. Related: they tend to get thrown off of waterfalls and die from fall damage because they did not account for the current.
• Bug 425: Dwarves perform cleaning erratically at best -- improved in v0.44.06
  • Workaround: routinely run clean in DFHack
• Bug 5986: Designating large areas for smoothing slows game to a crawl.
• Bug 797: Animals repeatedly path through "tightly closed" doors causing lag.
• Bug 4065: Untradeable creatures (hostiles, wild animals) are released from cages when the cages are ordered taken to the trade depot.
• Bug 1582: Injured dwarf in bed in stocked hospital ignored by idle doctors. Medical jobs are too low-priority, and will be ignored in favor of pretty much everything else, hauling included, forcing players that need to administer medical care to disable all other labors; and even then, doctors tend to idle a bit in between their jobs.
• Bug 5097: Names overwriting text with TrueType and Bug 5696 strange gaps in report texts.
  • Workaround: Hitting F12 to toggle True Type can often get you around this problem.
• Bug 2587: Saving fails silently when folder is not writeable (due to full disk, permissions, etc)
• Bug 8426: Foreign nobles elevated along with fortress nobles, make regular mandates and demands -- fixed v0.44.11
• Bug 8698: Dwarf entering a strange mood when isolated (e.g. on a stepladder) causes severe lag
• Bug 7444: Sparring dwarves can knock each other through walls with charge attacks.
• Bug 7872: Trees grow through bridges, can make the bridge unusable.
• Bug 7760: Dwarves construct walls from wrong side, wall themselves out of fortress or into alcove
• Bug 7423: Embark-purchased fruit must be removed from bags before brewing.
• Bug 9440: Wounded dwarves die of dehydration if they grab a goblet they can't use
  • Workaround: forbid all goblets so dwarves will drink straight from the barrels