0.47.05-r1

Installation instructions

• Download and extract Dwarf Fortress 0.47.05.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.47.05-r1.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

Changes since the previous version

• Disabling the camera now remembers what unit or item you were following.
• Fixed a crash related to lockstep mode on Windows.
• If the manager does not have an office, chairs will be queued directly at the workshop.
• Manager orders are no longer queued for tiny changes in amount.
• Outdoor gathering zones are now hidden from view.
• Sheriff will not be assigned until there is a jail.
• The AI buys animals from traders.
• The AI can free caged citizens and pets using a lever.
• The AI prioritizes important jobs, like preparing food or drinks when stocks are low.

Military

• Added the ability to craft wooden ammo.
• Squad orders to attack enemies who have left the map are now cancelled.
• The AI no longer attacks non-hostile undead.
• The AI will now make weapons if there are not enough picks but also no metal to make picks with.

Floor Plan

• Added an area at the start of the fortress with some necessities to reduce startup time.
• Added cage traps to the fortress entrance.
• Fixed a case where irrigating a farm plot would never stop.
• Fixed miners waiting for trees to be cut down in pastures.
• Fixed nest boxes not being built. Fertile eggs in nest boxes are automatically forbidden.
• Improved pathfinding for mining and cavern outposts. The AI now builds a small structure to start these projects.
• Optimized stockpile configuration to take fewer button presses.
• Removed dining halls from the blueprint. Dwarves now eat at the tavern.
• Reorganized construction priorities in the generic01 plan.
• Rooms are now ordered by distance from the fortress entrance.
• Rooms can now count as multiple other rooms, such as the new dormitory room.
• Rooms with a required value are now monitored and decorated.
• Staircases are now simplified to only go in one direction if there is nothing on the other side.

0.47.04-r3

Installation instructions

• Download and extract Dwarf Fortress 0.47.04.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.47.04-r3.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

0.47.04-r1

Installation instructions

• Download and extract Dwarf Fortress 0.47.04.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.47.04-r1.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

0.47.04-beta1

Installation instructions

• Download and extract Dwarf Fortress 0.47.04.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.47.04-beta1.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

Changes since the previous version

Exclusive Mode

• Error messages are now more likely to contain the correct line number.
• Fixed an error that would occur when abandoning before embark.
• If an expected screen is not present, the AI will pause until it is, to avoid crashing. User input may be required in the case of such bugs.

Military

• Fixed a stall while attempting to draft dwarves into the military when the entire government is dead.

Floor Plan

• Required room value is now tracked.
• Petitions for guildhalls and temples can now be accepted.
• Stockpiles and activity zones are now built using the UI.
• Improvements to pastures:
  • The AI will no longer attempt to floor over saplings.
  • Pastures can now be constructed before shrubs are removed.
  • Added some safeguards against animals being butchered if a pasture is not quite ready.
• Improved readability in the weblegends blueprint.

Blueprint

• Fixed some corridors in the generic01 plan missing a staircase.
• Reduced the number of staircases generated by generic01.
• Unused corridors are now removed after the blueprint is generated.
• Added the ability for room instances to blacklist certain templates.
• Removed legacy blueprint and legacy layout generation code.

0.47.03-beta1

Installation instructions

• Download and extract Dwarf Fortress 0.47.03.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.47.03-beta1.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

Changes since the previous version

• Planning the fortress now happens on a custom viewscreen.
• Petitions are handled more intelligently.
• Cleaned up weblegends output.
• Fixed some crashes and hangs.

0.44.12-r3

Installation instructions

• Download and extract Dwarf Fortress 0.44.12.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.44.12-r3.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

Changes since the previous version

None. This is simply a new build to maintain compatibility with DFHack.

0.44.12-r2

Installation instructions

• Download and extract Dwarf Fortress 0.44.12.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.44.12-r2.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

Changes since the previous version

• The web UI has a new coat of paint. (#53, thanks @mattregul)

Military

• The AI no longer requires that there are more picks and axes than soldiers. (#55, thanks @mattregul)
  • Instead, if a mining or woodcutting job is waiting and no civilian has access to the tool needed, it will be taken from a military dwarf.
  • Weapons will not be confiscated from military dwarves who are currently in combat.
  • When a weapon is confiscated, the dwarf will be assigned a new melee weapon type, favoring weapon types that are in stock and craftable within the fortress.

Blueprint

• The code to ensure rooms had walls is no longer completely broken. (#56, thanks @mattregul)
• Fixed room entrances sometimes being embedded in rock at the back of the room. (#57, #59, thanks @mattregul)

0.44.12-r1 update 1

Installation instructions

• Download and extract Dwarf Fortress 0.44.12.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.44.12-r1.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

Changes since the previous version

• This version fixes several crashes and hangs present in the initial df-ai 0.44.12-r1 release.

0.44.12-r1

Important: This version is very buggy. If you want to run df-ai on DFHack 0.44.12-r1, I suggest using the latest prerelese build for the next version of df-ai.

Installation instructions

• Download and extract Dwarf Fortress 0.44.12.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.44.12-r1.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

Changes since the previous version

• Exclusive callbacks now use a coroutine-based implementation. This should not have any visible change in behavior, but as always, if there are problems, report them on the issues page.

0.44.12-alpha1

Installation instructions

• Download and extract Dwarf Fortress 0.44.12.
  Windows (32-bit) - Linux (32-bit) - Mac OS X (32-bit)
• Install DFHack 0.44.12-alpha1.
• Place the df-ai.plug.* file in hack/plugins.
• Extract the df-ai-blueprints folder from df-ai-assets.zip into the Dwarf Fortress root (the same folder as hack and dfhack-config).
  If there is a df-ai-blueprints folder from a previous version of df-ai, remove it first.
  df-ai-assets.zip can be found in the list of files above.
• Optional: Add the corresponding version of weblegends to enable the df-ai web interface.
• Enter enable df-ai into the DFHack console.

Floor plan generator

• Added an entirely new plan: generic01.
  • Rooms no longer have fixed locations. However, a few rooms have specific constraints to limit how crazy the fortress layout can be:
    • Corridor segments that have bedrooms may only have bedrooms.
    • Each corridor segment has at least one exit that can only be another corridor.
    • Staircases are only connected to corridors.
    • Regular-sized (3x3) workshops are placed in groups of 3 with a small stockpile nearby, similar to the legacy plan.
    • Underground farm plots are placed in clusters and use the same irrigation style as the legacy plan. However, the generic01 underground farm plots connect to the rest of the fortress on the upper level so floods will not affect other areas.
  • There are no cage traps at the fortress entrance. This may or may not be modified in the future.
  • The central staircase is 3x3 instead of 1x3. There may also be more than one major staircase in the fortress.
  • Kennels and siege workshops have been added to the plan, but the AI does not currently use them.
  • There can now be multiple taverns, libraries, and temples in the fortress. Only one of each will be built before most of the fortress has been completed.
  • Additional rooms and room variants will be added in the future. Suggestions and bug reports of all kinds are encouraged.
• The plan editor is partially functional and may be helpful when modifying or viewing rooms or plans.
• Editors such as Visual Studio Code that support JSON Schema now have auto-complete and partial validation for df-ai plan and room JSON files, which makes manually editing them much easier.
• Disabled legacy plan by default. It can be re-enabled by renaming the file from legacy.json.disabled to legacy.json.
• Fixed an issue where only non-corridor rooms would block their own exits.
• Documented plan verbosity level 4, which logs messages about room exits being discarded.