v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "Known bugs and issues"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(→‎Lingering bugs: added 7769, shown to still exist: https://www.reddit.com/r/dwarffortress/comments/t5fpjd/a_migrant_remembered_to_bring_his_wife_and_kids/)
m (→‎Major bugs with workarounds: Updated workaround info and added a source.)
(10 intermediate revisions by 4 users not shown)
Line 1: Line 1:
{{Quality|Superior|23:36, 4 September 2013 (UTC)}}
+
{{Quality|Unrated}}
 
{{av}}
 
{{av}}
 
:''"Bugs" redirects here. For insects, see [[Vermin]] and [[Creature]].''
 
:''"Bugs" redirects here. For insects, see [[Vermin]] and [[Creature]].''
[[File:bug_icon.png|100px|right]]''''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 [https://www.bay12games.com/dwarves/mantisbt/my_view_page.php Mantis Bug Tracker]. Please do '''not''' report bugs here; they should be reported on the [https://www.bay12games.com/dwarves/mantisbt/my_view_page.php bug tracker] instead. If you have issues signing up for the bug tracker, see the [http://www.bay12forums.com/smf/index.php?board=6.0 forum bug tracker board] for instructions (but don't report bugs on the forum either).
+
[[File:bug_icon.png|100px|right]]
  
Some bugs {{dffd|6741|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.
+
''Dwarf Fortress'' is a constant work-in-progress, and is thus full of '''bugs'''. An official compilation of all bugs, and their development status, can be found on the [https://dwarffortress.mantishub.io/ Mantis Bug Tracker]. The search results in the bug tracker sometimes have an unintuitive sort order, so make sure to scroll to the bottom of the first page of results when searching for bugs. To comment on any bug, you can "Login anonymously" and add a note.
  
== Severe bugs ==
+
== Reporting new bugs ==
{{catbox|DF2014:Bugs}}These bugs can significantly interfere with play.  They may do this by crashing the game, making certain parts of the game unavailable, or giving players a bad time.
+
Please do '''not''' report new bugs here; to report a new bug, follow the [https://kitfoxgames.notion.site/How-to-Report-Bugs-in-Dwarf-Fortress-b5e2ca19dabe408897d1c2669599b7a2 How to Report Bugs in Dwarf Fortress] instructions. For any other discussion of new or existing bugs, visit the <code>#bug-discussion</code> channel on the [https://discord.com/invite/kitfoxgames Official Kitfox Discord].
  
* {{bugl|11014}}: Crash from corrupted military equipment lists (v0.44)
+
When reporting a bug:
**Workaround: refrain from [[raid]]ing
+
* Make a note of any mods you're using.  If you made the mod yourself, include the raws for any relevant objects.
* {{bugl|10369}}: Crash when Dwarves return from mission (v0.44) -- one major cause fixed in v0.44.10
+
* If the game is crashing or refusing to open, include any error message that appears, along with your computer specifications and operating system.
**Workaround: refrain from [[raid]]ing
+
* If you have a save that reliably reproduces the bug, it may be helpful to upload the save to the [https://dffd.bay12games.com/category.php?id=20 DF File Depot - Bugged Saves] or another file hosting site.
* {{bugl|9905}}: Crash when filtering material type condition in work order
+
 
**Workaround: avoid using job manager material selection in large worlds
+
== Major bugs with workarounds ==
 +
{{catbox|Bugs}} This is a list of major bugs with workarounds that would be useful for most players to know. Bugs added to this list should: 1) impact most players in a significant way in the current version, and 2) have some workaround that is useful to share. Please link the source of any posted workarounds.
 +
 
 +
* {{bugl|0012008}}: Dwarves will not equip [[Ammunition|ammunition]]. When a squad is created, it takes note of the amount of ammunition in the fortress but never updates this figure.
 +
**Workaround: Set up a [[Squad#Equipping_soldiers|uniform]] which includes a ranged weapon. Form a new squad using this uniform, which updates the squad's knowledge of how much ammunition is available. Assign the desired dwarves to that squad. Set them to train with a schedule of your choice. The dwarves should equip ammunition. (Note: [[Ambusher|Hunter]] dwarves "reserve" roughly 100 to 200 bolts each. Your ammo stockpile must include more bolts than 200 x number of hunters. This extra ammo will be used by your marksdwarves.) ([https://www.reddit.com/r/dwarffortress/comments/10mwqtw/dwarves_not_equipping_boltsarrows_learn_from_my/ Source])
 +
* {{bugl|11985}} ('''Healthcare labors bug''')<span id="healthcare-labors-bug"/>: Dwarves assigned to doctoring occupations not performing doctor labors.
 +
**Workaround: Make any change on the work details page, such as adding and removing a dwarf from a work detail. This will cause labors to be properly updated basd on occupations. ([https://www.youtube.com/watch?v=79J3X8ulER0&t=1765s source])
 +
* {{bugl|349}}: [[Animal care]] labor does nothing.
 +
**Workaround: Use DFHack's [https://docs.dfhack.org/en/0.47.04-r2/docs/Plugins.html#dwarfvet dwarfvet plugin]].
 +
* {{bugl|1451}}: The equipment required for [[miner]]s, [[hunter]]s, and [[woodcutter]]s to do their job conflicts with military uniforms.
 +
**Workaround: never assign these three labors to military dwarves.
 
* {{bugl|9653}}: Tavern keeper/performers repeatedly serve alcohol until patrons drink themselves to death
 
* {{bugl|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
 
**Workaround: do not assign tavern keepers or performers, or do not place any alcohol within the tavern zone
* {{bugl|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
 
* {{bugl|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)
 
* {{bugl|7185}}: Scared traders immediately scuttle wagons and leave.
 
 
* {{bugl|9004}}: Items in containers are "unavailable" while a dwarf is hauling another item to store in the container
 
* {{bugl|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: new STORE_DIST_* settings in [[d_init.txt]] can tweak the behavior.
 
** Workaround: clever [[stockpile design]]s can reduce the impact
 
** Workaround: clever [[stockpile design]]s can reduce the impact
 
** Workaround: avoid using containers (use [[exploit|quantum stockpiles]], [[minecart]] stockpiles, or no stockpiles instead)
 
** Workaround: avoid using containers (use [[exploit|quantum stockpiles]], [[minecart]] stockpiles, or no stockpiles instead)
* {{bugl|7107}} Fighting berserk citizens and citizen werebeasts causes defenders to lose loyalty.
 
* {{bugl|565}}: [Freez]es when generating [...] world with "Complete Edge Oceans" set to anything besides 0 or 4
 
 
== New bugs ==
 
These bugs are new in recent versions (v0.42+).  (There are many more; these are just a few of the most prominent.)
 
 
* {{bugl|10878}}: "Civil war" with parent civilization
 
* {{bugl|10490}}: "Spies" arrive as part of migrant group
 
* {{bugl|10349}}: Were-dwarves stuck in weird spot between injured and healed
 
* {{bugl|10346}}: NPCs demanding other characters identify themselves in a loop
 
* {{bugl|9588}}: Animal people with [MEANDERER] tag move too slowly
 
* {{bugl|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.  (Year numbers in parenthesis.)
 
  
* {{bugl|1451}} (2010): Military equipment interferes with civilian equipment (picks/axes/crossbows/quivers). It is not possible to use a single axe for both [[wood cutter|wood cutting]] and combat, or a single pick for both [[miner|mining]] and combat. Crossbows in the hands of [[hunter]]s can also cause problems.
 
* {{bugl|94}} (2010): Seriously wounded dwarves sometimes don't get taken to bed.
 
* {{bugl|2712}} (2010): Weapons, especially whips, cut through steel armor like butter.
 
**Workaround: appropriate [[modding]] to [http://www.bay12forums.com/smf/index.php?topic=115448 nerf] these weapons
 
* {{bugl|2780}} (2010): 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
 
* {{bugl|535}} (2010): Equipping weapons/armor on military is erratic. This is a long-standing bug that has been slowly but surely rolled back.
 
* {{bugl|296}} (2010): 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, they will actually multiply to other tiles.
 
**Workaround: routinely run [https://github.com/DFHack/dfhack/blob/master/Readme.rst#clean clean] in [[Utility:DFHack|DFHack]]
 
* {{bugl|4550}} (2011): Dodging into river/lava/pit etc. Apparently, dwarves are stupid. Related: they tend to get thrown off of [[waterfall]]s and die from fall damage because they did not account for the current.
 
* {{bugl|425}} (2010): Dwarves perform [[cleaning]] erratically at best -- improved in v0.44.06
 
**Workaround: routinely run [https://github.com/DFHack/dfhack/blob/master/Readme.rst#clean clean] in [[Utility:DFHack|DFHack]]
 
* {{bugl|39}} (2010): "Guts is bruised," "guts has popped out"
 
* {{bugl|5986}} (2012): Designating large areas for smoothing slows game to a crawl.
 
* {{bugl|797}} (2010): Animals repeatedly path through "tightly closed" [[door]]s causing lag.
 
* {{bugl|4065}} (2011): Untradeable creatures (hostiles, wild animals) are released from [[cage]]s when the cages are ordered taken to the [[trade depot]].
 
* {{bugl|1582}} (2010): 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.
 
* {{bugl|5097}} (2012): Names overwriting text with TrueType and {{bugl|5696}} strange gaps in report texts. 
 
**Workaround: Hitting F12 to toggle TrueType can often get you around this problem.
 
* {{bugl|2587}} (2010): Saving fails silently when folder is not writeable (due to full disk, permissions, etc)
 
* {{bugl|8698}} (2015): Dwarf entering a strange mood when isolated (e.g. on a stepladder) causes severe lag
 
* {{bugl|7872}} (2014): Trees grow through bridges, can make the bridge unusable.
 
* {{bugl|7760}} (2014): Dwarves construct walls from wrong side, wall themselves out of fortress or into alcove
 
* {{bugl|7423}} (2014): Embark-purchased fruit must be removed from bags before [[brewing]].
 
* {{bugl|9440}} (2016): 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
 
* {{bugl|7769}} (2017): Historical figures who are mortally wounded (destruction of head, neck, torso etc.) are sometimes considered to be still alive in worldgen and may appear in migrant waves, only to quickly die due to suffocation and/or missing vital organs
 
  
  

Revision as of 21:44, 30 January 2023

This article is about the current version of DF.
Note that some content may still need to be updated.

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

Dwarf Fortress is a constant work-in-progress, and is thus full of bugs. An official compilation of all bugs, and their development status, can be found on the Mantis Bug Tracker. The search results in the bug tracker sometimes have an unintuitive sort order, so make sure to scroll to the bottom of the first page of results when searching for bugs. To comment on any bug, you can "Login anonymously" and add a note.

Reporting new bugs

Please do not report new bugs here; to report a new bug, follow the How to Report Bugs in Dwarf Fortress instructions. For any other discussion of new or existing bugs, visit the #bug-discussion channel on the Official Kitfox Discord.

When reporting a bug:

  • Make a note of any mods you're using. If you made the mod yourself, include the raws for any relevant objects.
  • If the game is crashing or refusing to open, include any error message that appears, along with your computer specifications and operating system.
  • If you have a save that reliably reproduces the bug, it may be helpful to upload the save to the DF File Depot - Bugged Saves or another file hosting site.

Major bugs with workarounds

This is a list of major bugs with workarounds that would be useful for most players to know. Bugs added to this list should: 1) impact most players in a significant way in the current version, and 2) have some workaround that is useful to share. Please link the source of any posted workarounds.

  • Bug 0012008: Dwarves will not equip ammunition. When a squad is created, it takes note of the amount of ammunition in the fortress but never updates this figure.
    • Workaround: Set up a uniform which includes a ranged weapon. Form a new squad using this uniform, which updates the squad's knowledge of how much ammunition is available. Assign the desired dwarves to that squad. Set them to train with a schedule of your choice. The dwarves should equip ammunition. (Note: Hunter dwarves "reserve" roughly 100 to 200 bolts each. Your ammo stockpile must include more bolts than 200 x number of hunters. This extra ammo will be used by your marksdwarves.) (Source)
  • Bug 11985 (Healthcare labors bug): Dwarves assigned to doctoring occupations not performing doctor labors.
    • Workaround: Make any change on the work details page, such as adding and removing a dwarf from a work detail. This will cause labors to be properly updated basd on occupations. (source)
  • Bug 349: Animal care labor does nothing.
  • Bug 1451: The equipment required for miners, hunters, and woodcutters to do their job conflicts with military uniforms.
    • Workaround: never assign these three labors to military dwarves.
  • 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 9004: Items in containers are "unavailable" while a dwarf is hauling another item to store in the container