Releases: DFHack/dfhack
DFHack 0.47.05-r1
DFHack 0.47.05-r1
Fixes
confirm
: stopped exposing alternate names when convicting unitsembark-assistant
: fixed bug in soil depth determination for ocean tilesorders
: don't crash when importing orders with malformed JSONprospector
: improved pre embark rough estimates, particularly for small clustersquickfort
: raw numericquickfort-dig-priorities
(e.g.3
, which is a valid shorthand ford3
) now works when used in .xlsx blueprints
Misc Improvements
autohauler
: allowed theAlchemist
labor to be enabled inmanipulator
and other labor screens so it can be used for its intended purpose of flagging that no hauling labors should be assigned to a dwarf. Before, the only way to set the flag was to use an external program like Dwarf Therapist.embark-assistant
: slightly improved performance of surveyinggui/no-dfhack-init
: clarified how to dismiss dialog that displays when nodfhack.init
file is foundquickfort
:- Dreamfort blueprint set improvements: significant refinements across the entire blueprint set. Dreamfort is now much faster, much more efficient, and much easier to use. The checklist now includes a mini-walkthrough for quick reference. The spreadsheet now also includes embark profile suggestions
- added aliases for configuring masterwork and artifact core quality for all stockpile categories that have them; made it possible to take from multiple stockpiles in the
quantumstop
alias - an active cursor is no longer required for running #notes blueprints (like the dreamfort walkthrough)
- you can now be in any mode with an active cursor when running
#query
blueprints (before you could only be in a few "approved" modes, like look, query, or place) - refined
#query
blueprint sanity checks: cursor should still be on target tile at end of configuration, and it's ok for the screen ID to change if you are destroying (or canceling destruction of) a building - now reports how many work orders were added when generating manager orders from blueprints in the gui dialog
- added
--dry-run
option to process blueprints but not change any game state - you can now specify the number of desired barrels, bins, and wheelbarrows for individual stockpiles when placing them
quickfort orders
on a#place
blueprint will now enqueue manager orders for barrels, bins, or wheelbarrows that are explicitly set in the blueprint.- you can now add alias definitions directly to your blueprint files instead of having to put them in a separate aliases.txt file. makes sharing blueprints with custom alias definitions much easier.
- new commandline options for setting the initial state of the gui dialog. for example:
quickfort gui -l dreamfort notes
will start the dialog filtered for the dreamfort walkthrough blueprints
Structures
- Dropped support for 0.47.03-0.47.04
- Identified scattered enum values (some rhythm beats, a couple of corruption unit thoughts, and a few language name categories)
viewscreen_loadgamest
: renamedcur_step
enumeration to match style ofviewscreen_adopt_regionst
andviewscreen_savegamest
viewscreen_savegamest
: identifiedcur_step
enumeration
Documentation
digfort
: added deprecation warnings - digfort has been replaced byquickfort
fortplan
: added deprecation warnings - fortplan has been replaced byquickfort
DFHack 0.47.05-beta1
DFHack 0.47.05-beta1
This is a beta release for DF 0.47.05. Not many things appear to have changed since 0.47.04, but let us know right away of any problems you encounter with 0.47.05 specifically.
Fixes
embark-assistant
: fixed bug in soil depth determination for ocean tilesorders
: don't crash when importing orders with malformed JSONquickfort
: raw numericquickfort-dig-priorities
(e.g.3
, which is a valid shorthand ford3
) now works when used in .xlsx blueprints
Misc Improvements
quickfort
: new commandline options for setting the initial state of the gui dialog. for example:quickfort gui -l dreamfort notes
will start the dialog filtered for the dreamfort walkthrough blueprints
Structures
- Dropped support for 0.47.03-0.47.04
DFHack 0.47.04-r5
DFHack 0.47.04-r5
New Scripts
gui/quickfort
: fast access to the quickfort interactive dialogworkorder-recheck
: resets the selected work order to theChecking
state
Fixes
embark-assistant
:- fixed order of factors when calculating min temperature
- improved performance of surveying
quickfort
:- fixed eventual crashes when creating zones
- fixed library aliases for tallow and iron, copper, and steel weapons
- zones are now created in the active state by default
- solve rare crash when changing UI modes
search
: fixed crash when searching thek
sidebar and navigating to another tile with certain keys, like<
or>
seedwatch
: fixed an issue where the plugin would disable itself on map loadstockflow
: fixedj
character being intercepted when naming stockpilesstockpiles
: no longer outputs hotkey help text beneathstockflow
hotkey help text
Misc Improvements
- Lua label widgets (used in all standard message boxes) are now scrollable with Up/Down/PgUp/PgDn keys
autofarm
: now fallows farms if all plants have reached the desired countbuildingplan
:- added ability to set global settings from the console, e.g.
buildingplan set boulders false
- added "enable all" option for buildingplan (so you don't have to enable all building types individually). This setting is not persisted (just like quickfort_mode is not persisted), but it can be set from onMapLoad.init
- modified
Planning Mode
status in the UI to show whether the plugin is in quickfort mode, "enable all" mode, or whether just the building type is enabled.
- added ability to set global settings from the console, e.g.
quickfort
:- Dreamfort blueprint set improvements: added a streamlined checklist for all required dreamfort commands and gave names to stockpiles, levers, bridges, and zones
- added aliases for bronze weapons and armor
- added alias for tradeable crafts
- new blueprint mode:
#ignore
, useful for scratch space or personal notes - implement
{Empty}
keycode for use in quickfort aliases; useful for defining blank-by-default alias values - more flexible commandline parsing allowing for more natural parameter ordering (e.g. where you used to have to write
quickfort list dreamfort -l
you can now writequickfort list -l dreamfort
) - print out blueprint names that a
#meta
blueprint is applying so it's easier to understand what meta blueprints are doing - whitespace is now allowed between a marker name and the opening parenthesis in blueprint modelines. for example,
#dig start (5; 5)
is now valid (you used to be required to write#dig start(5; 5)
)
Lua
dfhack.run_command()
: changed to interface directly with the console when possible, which allows interactive commands and commands that detect the console encoding to work properlyprocessArgsGetopt()
added to utils.lua, providing a callback interface for parameter parsing and getopt-like flexibility for parameter ordering and combination (see docs inlibrary/lua/utils.lua
andlibrary/lua/3rdparty/alt_getopt.lua
for details).
Structures
job
: identifiedorder_id
field
Documentation
- Added documentation for Lua's
dfhack.run_command()
and variants
DFHack 0.47.04-r4
DFHack 0.47.04-r4
New Scripts
fix/corrupt-equipment
: fixes some military equipment-related corruption issues that can cause DF crashes
Fixes
- Fixed an issue on some Linux systems where DFHack installed through a package manager would attempt to write files to a non-writable folder (notably when running
exportlegends
orgui/autogems
) adaptation
: fixed handling of units with no cave adaptation suffered yetassign-goals
: fixed error preventing new goals from being createdassign-preferences
: fixed handling of preferences for flourbuildingplan
:- fixed an issue preventing artifacts from being matched when the maximum item quality is set to
artifacts
- stopped erroneously matching items to buildings while the game is paused
- fixed a crash when pressing 0 while having a noble room selected
- fixed an issue preventing artifacts from being matched when the maximum item quality is set to
deathcause
: fixed an error when inspecting certain corpsesdwarfmonitor
: fixed a crash when opening theprefs
screen if units have vague preferencesdwarfvet
: fixed a crash that could occur when discharging patientsembark-assistant
:- fixed an issue causing incursion resource matching (e.g. sand/clay) to skip some tiles if those resources were provided only through incursions
- corrected river size determination by performing it at the MLT level rather than the world tile level
quickfort
:- fixed handling of modifier keys (e.g.
{Ctrl}
or{Alt}
) in query blueprints - fixed misconfiguration of nest boxes, hives, and slabs that were preventing them from being built from build blueprints
- fixed valid placement detection for floor hatches, floor grates, and floor bars (they were erroneously being rejected from open spaces and staircase tops)
- fixed query blueprint statistics being added to the wrong metric when both a query and a zone blueprint are run by the same meta blueprint
- added missing blueprint labels in gui dialog list
- fixed occupancy settings for extent-based structures so that stockpiles can be placed within other stockpiles (e.g. in a checkerboard or bullseye pattern)
- fixed handling of modifier keys (e.g.
search
: fixed an issue where search options might not display if screens were destroyed and recreated programmatically (e.g. withquickfort
)unsuspend
: now leaves buildingplan-managed buildings alone and doesn't unsuspend underwater tasksworkflow
: fixed an error when creating constraints on "mill plants" jobs and some other plant-related jobszone
: fixed an issue causing theenumnick
subcommand to run when attempting to runassign
,unassign
, orslaughter
Misc Improvements
buildingplan
:- added support for all buildings, furniture, and constructions (except for instruments)
- added support for respecting building job_item filters when matching items, so you can set your own programmatic filters for buildings before submitting them to buildingplan
- changed default filter setting for max quality from
artifact
tomasterwork
- changed min quality adjustment hotkeys from 'qw' to 'QW' to avoid conflict with existing hotkeys for setting roller speed - also changed max quality adjustment hotkeys from 'QW' to 'AS' to make room for the min quality hotkey changes
- added a new global settings page accessible via the
G
hotkey when on any building build screen;Quickfort Mode
toggle for legacy Python Quickfort has been moved to this page - added new global settings for whether generic building materials should match blocks, boulders, logs, and/or bars - defaults are everything but bars
devel/export-dt-ini
: updated for Dwarf Therapist 41.2.0embark-assistant
: split the lair types displayed on the local map into mound, burrow, and lairgui/advfort
: added support for linking to hatches and pressure plates with mechanismsmodtools/add-syndrome
: added support for specifying syndrome IDs instead of namesprobe
: added more output for designations and tile occupancyquickfort
:- The Dreamfort sample blueprints now have complete walkthroughs for each fort level and importable orders that automate basic fort stock management
- added more blueprints to the blueprints library: several bedroom layouts, the Saracen Crypts, and the complete fortress example from Python Quickfort: TheQuickFortress
- query blueprint aliases can now accept parameters for dynamic expansion - see dfhack-config/quickfort/aliases.txt for details
- alias names can now include dashes and underscores (in addition to letters and numbers)
- improved speed of first call to
quickfort list
significantly, especially for large blueprint libraries - added
query_unsafe
setting to disable query blueprint error checking - useful for query blueprints that send unusual key sequences - added support for bookcases, display cases, and offering places (altars)
- added configuration support for zone pit/pond, gather, and hospital sub-menus in zone blueprints
- removed
buildings_use_blocks
setting and replaced it with more flexible functionality inbuildingplan
- added support for creating uninitialized stockpiles with :kbd:
c
API
buildingplan
: added Lua interface APIBuildings::setSize()
: changed to reuse existing extents when possibledfhack.job.isSuitableMaterial()
: added an item type parameter so thenon_economic
flag can be properly handled (it was being matched for all item types instead of just boulders)
Lua
utils.addressof()
: fixed for raw userdata
Structures
building_extents_type
: new enum, used forbuilding_extents.extents
world_mountain_peak
: new struct (was previously inline) - used inworld_data.mountain_peaks
Documentation
- Quickfort alias guide: alias syntax and alias standard library documentation for
quickfort
blueprints - Quickfort library guide: overview of the quickfort blueprint library
DFHack 0.47.04-r3
This release includes a new Quickfort implementation by @myk002 - feedback is welcome, and please let us know of any issues you encounter in the issue tracker.
DFHack 0.47.04-r3
New Plugins
xlsxreader
: provides an API for Lua scripts to read Excel spreadsheets
New Scripts
quickfort
: DFHack-native implementation of quickfort with many new features and integrations - see the quickfort user guide for detailstimestream
: controls the speed of the calendar and creaturesuniform-unstick
: prompts units to reevaluate their uniform, by removing/dropping potentially conflicting worn items
Fixes
-
ban-cooking
: fixed an error in several subcommands -
buildingplan
: fixed handling of buildings that require buckets -
getplants
: fixed a crash that could occur on some maps -
search
: fixed an issue causing item counts on the trade screen to display inconsistently when searching -
stockpiles
:- fixed an error when saving furniture stockpiles
- fixed a crash when loading food stockpiles
Misc Improvements
-
createitem
:- added an
inspect
subcommand to print the item and material tokens of existing items, which can be used to create additional matching items - added support for plant growths (fruit, berries, leaves, etc.)
- added an
-
embark-assistant
: added support for searching for taller waterfalls (up to 50 z-levels tall) -
search
: added support for searching for names containing non-ASCII characters using their ASCII equivalents -
stocks
: added support for searching for items containing non-ASCII characters using their ASCII equivalents -
unretire-anyone
: made undead creature names appear in the historical figure list -
zone
:- added slaughter indication to
uinfo
output - added an
enumnick
subcommand to assign enumerated nicknames (e.g "Hen 1", "Hen 2"...)
- added slaughter indication to
API
- Added
DFHack::to_search_normalized()
(Lua:dfhack.toSearchNormalized()
) to convert non-ASCII alphabetic characters to their ASCII equivalents
Structures
history_event_masterpiece_createdst
: fixed alignment, including subclasses, and identifiedskill_at_time
item_body_component
: fixed some alignment issues and identified some fields (also applies to subclasses likeitem_corpsest
)stockpile_settings
: removedfurniture.sand_bags
(no longer present)
Documentation
- Fixed syntax highlighting of most code blocks to use the appropriate language (or no language) instead of Python
DFHack 0.47.04-r2
DFHack 0.47.04-r2
New Scripts
animal-control
: helps manage the butchery and gelding of animalsdevel/kill-hf
: kills a historical figuregeld
: gelds or ungelds animalslist-agreements
: lists all guildhall and temple agreementslist-waves
: displays migration wave information for citizens/unitsungeld
: ungelds animals (wrapper aroundgeld
)
New Tweaks
tweak
do-job-now: adds a job priority toggle to the jobs listtweak
reaction-gloves: adds an option to make reactions produce gloves in sets with correct handedness
Fixes
-
Fixed a segfault when attempting to start a headless session with a graphical PRINT_MODE setting
-
Fixed an issue with the macOS launcher failing to un-quarantine some files
-
Fixed
Units::isEggLayer
,Units::isGrazer
,Units::isMilkable
,Units::isTrainableHunting
,Units::isTrainableWar
, andUnits::isTamable
ignoring the unit's caste -
Linux: fixed
dfhack.getDFPath()
(Lua) andProcess::getPath()
(C++) to always return the DF root path, even if the working directory has changed -
digfort
:- fixed an issue causing blueprints touching the southern or eastern edges of the map to be rejected (northern and western edges were already allowed). This allows blueprints that span the entire embark area.
- fixed y-line tracking when .csv files contain lines with only commas
-
embark-assistant
: fixed a couple of incursion handling bugs. -
embark-skills
: fixed an issue with structures causing thepoints
option to do nothing -
exportlegends
:- stopped including some tags with
-1
values which don't provide useful information - fixed an issue where two different
<reason>
tags could be included in a<historical_event>
- stopped including some tags with
-
getplants
: fixed issues causing plants to be collected even if they have no growths (or unripe growths) -
gui/advfort
: fixed "operate pump" job -
gui/load-screen
: fixed an issue causing longer timezones to be cut off -
labormanager
:- fixed an issue preventing custom furnaces from being built
- fixed handling of new jobs in 0.47
-
modtools/moddable-gods
:- made
-depictedAs
argument work - removed unused
-domain
and-description
arguments - fixed an error when creating the historical figure
- made
-
names
:- fixed an issue causing renamed units to display their old name in legends mode and some other places
- fixed an error preventing the script from working
-
pref-adjust
: fixed some compatibility issues and a potential crash -
RemoteFortressReader
:- fixed an issue that could cause block coordinates to be incorrect
- fixed a couple crashes that could result from decoding invalid enum items (
site_realization_building_type
andimprovement_type
)
-
rendermax
: fixed a hang that could occur when enabling some renderers, notably on Linux -
stonesense
:- fixed some issues that could cause the splash screen to hang
- fixed a crash when launching Stonesense
Misc Improvements
-
Linux/macOS: Added console keybindings for deleting words (Alt+Backspace and Alt+d in most terminals)
-
add-recipe
:- added a command explanation or error message when entering an invalid command
- added tool recipes (minecarts, wheelbarrows, stepladders, etc.)
-
armoks-blessing
: added adjustments to values and needs -
blueprint
:- now automatically creates folder trees when organizing blueprints into subfolders (e.g.
blueprint 30 30 1 rooms/dining dig
will create the fileblueprints/rooms/dining-dig.csv
); previously it would fail if theblueprints/rooms/
directory didn't already exist - now writes blueprints to the
blueprints/
subfolder instead of the df root folder
- now automatically creates folder trees when organizing blueprints into subfolders (e.g.
-
confirm
: added a confirmation dialog for convicting dwarves of crimes -
devel/query
: added many new query options -
digfort
:- added a
force
option to truncate blueprints if the full blueprint would extend off the edge of the map - documented that removing ramps, cutting trees, and gathering plants are indeed supported
- handled double quotes (") at the start of a string, allowing .csv files exported from spreadsheets to work without manual modification
- added a
-
dwarf-op
:- added ability to protect dwarves based on symbols in their custom professions
- added ability to select dwarves based on migration wave
-
exportlegends
:- added ability to save all files to a subfolder, named after the region folder and date by default
- changed some enum values from numbers to their string representations
- changed some flags to be represented by self-closing tags instead of true/false strings (e.g.
<is_volcano/>
) - note that this may require changes to other XML-parsing utilities
-
gui/advfort
: added support for specifying the entity used to determine available resources -
gui/gm-editor
: added support for automatically following ref-targets when pressing thei
key -
manipulator
: added a new column option to display units' goals -
modtools/moddable-gods
: added support forneuter
gender -
pref-adjust
:- added a new
goth
profile - added support for adjusting just the selected dwarf
- added a new
-
remove-stress
: added a-value
argument to enable setting stress level directly -
workorder
: changed default frequency from "Daily" to "OneTime"
API
- Added
Filesystem::mkdir_recursive
- Extended
Filesystem::listdir_recursive
to optionally make returned filenames relative to the start directory Units
: added goal-related functions:getGoalType()
,getGoalName()
,isGoalAchieved()
Internals
- Added support for splitting scripts into multiple files in the
scripts/internal
folder without polluting the output ofls
Lua
- Added a
ref_target
field to primitive field references, corresponding to theref-target
XML attribute - Made
dfhack.units.getRaceNameById()
,dfhack.units.getRaceBabyNameById()
, anddfhack.units.getRaceChildNameById()
available to Lua
Ruby
- Updated
item_find
andbuilding_find
to use centralized logic that works on more screens
Structures
- Added a new
<df-other-vectors-type>
, which allowsworld.*.other
collections of vectors to use the correct subtypes for items creature_raw
: renamedgender
tosex
to match the field inunit
, which is more frequently usedcrime
: identifiedwitnesses
, which contains the data held by the old field namedreports
intrigue
: new type (split out fromhistorical_figure_relationships
)items_other_id
: removedBAD
, and by extension,world.items.other.BAD
, which was overlapping withworld.items.bad
job_type
: added job types new to 0.47plant_raw
: material_defs now contains arrays rather than loose fieldspronoun_type
: new enum (previously documented in field comments)setup_character_info
: fixed a couple alignment issues (needed byembark-skills
)ui_advmode_menu
: identified some new enum items
Documentation
- Added some new dev-facing pages, including dedicated pages about the remote API, memory research, and documentation
- Expanded the installation guide
- Made a couple theme adjustments
DFHack 0.47.04-r1
DFHack 0.47.04-r1
New Scripts
color-schemes
: manages color schemesdevel/print-event
: prints the description of an event by ID or indexdevel/sc
: checks size of structuresdevel/visualize-structure
: displays the raw memory of a structuregui/color-schemes
: an in-game interface forcolor-schemes
light-aquifers-only
: changes heavy aquifers to light aquiferson-new-fortress
: runs DFHack commands only in a new fortressonce-per-save
: runs DFHack commands unless already run in the current saveresurrect-adv
: brings your adventurer back to lifereveal-hidden-units
: exposes all sneaking unitsworkorder
: allows queuing manager jobs; smart about shear and milk creature jobs
Fixes
-
Fixed a crash in
find()
for some types when no world is loaded -
Fixed a crash when starting DFHack in headless mode with no terminal
-
Fixed translation of certain types of in-game names
-
autogems
: fixed an issue with binned gems being ignored in linked stockpiles -
catsplosion
: fixed error when handling races with only one caste (e.g. harpies) -
deep-embark
:- prevented running in non-fortress modes
- ensured that only the newest wagon is deconstructed
-
devel/visualize-structure
: fixed padding detection for globals -
exportlegends
:- added UTF-8 encoding and XML escaping for more fields
- added checking for unhandled structures to avoid generating invalid XML
- fixed missing fields in
history_event_assume_identityst
export
-
full-heal
:- when resurrected by specifying a corpse, units now appear at the location of the corpse rather than their location of death
- resurrected units now have their tile occupancy set (and are placed in the prone position to facilitate this)
- fixed issues with removing corpses
- fixed resurrection for non-historical figures
-
spawnunit
: fixed an error when forwarding some arguments but not a location tomodtools/create-unit
-
stocks
: fixed display of book titles -
teleport
: fixed setting new tile occupancy -
tweak
embark-profile-name: fixed handling of the native shift+space key
Misc Improvements
-
Added "bit" suffix to downloads (e.g. 64-bit)
-
Tests:
- moved from DF folder to hack/scripts folder, and disabled installation by default
- made test runner script more flexible
-
deep-embark
:- improved support for using directly from the DFHack console
- added a
-clear
option to cancel
-
devel/export-dt-ini
: updated some field names for DT for 0.47 -
devel/visualize-structure
: added human-readable lengths to containers -
dfhack-run
: added color output support -
embark-assistant
:- updated embark aquifer info to show all aquifer kinds present
- added neighbor display, including kobolds (SKULKING) and necro tower count
- updated aquifer search criteria to handle the new variation
- added search criteria for embark initial tree cover
- added search criteria for necro tower count, neighbor civ count, and specific neighbors. Should handle additional entities, but not tested
-
exportlegends
:- added evilness and force IDs to regions
- added profession and weapon info to relevant entities
- added support for many new history events in 0.47
- added historical event relationships and supplementary data
- made interaction export more robust and human-readable
- removed empty
<item_subtype>
and<claims>
tags - added identity information
- added creature raw names and flags
-
full-heal
:- made resurrection produce a historical event viewable in Legends mode
- made error messages more explanatory
-
getplants
: added switches for designations for farming seeds and for max number designated per plant -
gui/prerelease-warning
: updated links and information about nightly builds -
install-info
: added DFHack build ID to report -
manipulator
: added intrigue to displayed skills -
modtools/create-item
: added-matchingGloves
and-matchingShoes
arguments -
modtools/create-unit
:- added
-duration
argument to make the unit vanish after some time - added
-locationRange
argument to allow spawning in a random position within a defined area - added
-locationType
argument to specify the type of location to spawn in - added
-equip
option to equip created units - added
-skills
option to give skills to units - added
-profession
and-customProfession
options to adjust unit professions
- added
-
modtools/syndrome-trigger
: enabled simultaneous use of-synclass
and-syndrome
-
repeat
: added-list
option -
search
: added support for the fortress mode justice screen -
dfhack.init-example
: enabledautodump
API
- Added
Items::getBookTitle
to get titles of books. Catches titles buried in improvements, unlike getDescription.
Internals
- Added separate changelogs in the scripts and df-structures repos
- Improved support for tagged unions, allowing tools to access union fields more safely
- Moved
reversing
scripts to df_misc repo
Lua
pairs()
now returns available class methods for DF types
Structures
-
Added an XML schema for validating df-structures syntax
-
Added globals:
cur_rain
,cur_rain_counter
,cur_snow
,cur_snow_counter
,weathertimer
,jobvalue
,jobvalue_setter
,interactitem
,interactinvslot
,handleannounce
,preserveannounce
,updatelightstate
-
Added
divination_set_next_id
andimage_set_next_id
globals -
Dropped support for 0.44.12-0.47.02
-
abstract_building_type
: added types (and subclasses) new to 0.47 -
activity_entry_type
: new enum type -
adventure_optionst
: identified many vmethods -
agreement_details_data_plot_sabotage
: new struct type, along with relatedagreement_details_type.PlotSabotage
-
agreement_details_type
: added enum -
agreement_details
:- identified most fields of most sub-structs
- added struct type (and many associated data types)
-
agreement_party
: added struct type -
announcement_type
: added types new to 0.47 -
architectural_element
: new enum -
artifact_claim_type
: added enum -
artifact_claim
:- identified several fields
- added struct type
-
artifact_record
: identified several fields -
battlefield
: new struct type -
breath_attack_type
: addedSHARP_ROCK
-
breed
: new struct type -
building_offering_placest
: new class -
building_type
: addedOfferingPlace
-
caste_raw_flags
:- renamed and identified many flags to match information from Toady
- renamed many items to match DF names
-
creature_handler
: identified vmethods -
creature_interaction_effect
: added subclasses new to 0.47 -
creature_raw_flags
:- renamed and identified many flags to match information from Toady
- renamed many items to match DF names
- identified several more items
-
crime_type
: new enum type -
crime
: removed fields ofreports
that are no longer present -
dfhack_room_quality_level
: added enum attributes for names of rooms of each quality -
d_init
: added settings new to 0.47 -
entity_name_type
: addedMERCHANT_COMPANY
,CRAFT_GUILD
-
entity_position_responsibility
: added values new to 0.47 -
entity_site_link_type
: new enum type -
export_map_type
: new enum type -
fortress_type
: added enum -
general_ref_type
: addedUNIT_INTERROGATEE
-
ghost_type
: addedNone
value -
goal_type
: added goals types new to 0.47 -
histfig_site_link
: added subclasses new to 0.47 -
historical_entity.flags
: identified several flags -
historical_entity.relations
: renamed fromunknown1b
and identified several fields -
historical_figure.vague_relationships
: identified -
historical_figure_info.known_info
: renamed fromsecret
, identified some fields -
historical_figure
: renamedunit_id2
tonemesis_id
-
history_event_circumstance_info
: new struct type (and changed severalhistory_event
subclasses to use this) -
history_event_collection
: added subtypes new to 0.47 -
history_event_context
:- identified fields
- added lots of new fields
-
history_event_reason_info
: new struct type (and changed severalhistory_event
subclasses to use this) -
history_event_reason
:- added items new to 0.47
- added captions for all items
-
history_event_type
: added types for events new to 0.47, as well as correspondinghistory_event
subclasses (too many to list here) -
honors_type
:- identified several fields
- added struct type
-
identity_type
: new enum -
identity
: renamedciv
toentity_id
, identifiedtype
-
image_set
: new struct type -
interaction_effect_create_itemst
: new struct type -
interaction_effect_summon_unitst
: new struct type -
interaction_effect
: added subtypes new to 0.47 -
interaction_source_experimentst
: added class type -
interaction_source_usage_hint
: added values new to 0.47 -
interface_key
: added items for keys new to 0.47 -
interrogation_report
: new struct type -
itemdef_flags
: new enum, withGENERATED
flag -
item
: identified several vmethods -
job_skill
: addedINTRIGUE
,RIDING
-
justification
: new enum -
lair_type
: added enum -
layer_type
: new enum type -
lever_target_type
: identifiedLeverMechanism
andTargetMechanism
values -
monument_type
: added enum -
next_global_id
: added enum -
plant.damage_flags
: addedis_dead
-
plot_role_type
: new enum type -
plot_strategy_type
: new enum type -
poetic_form_action
: addedBeseech
-
region_weather
: new struct type -
relationship_event_supplement
: new struct type -
relationship_event
: new struct type -
setup_character_info
: expanded ...
DFHack 0.47.04-beta1
DFHack 0.47.04-beta1
0.47.04 support is hopefully nearly complete. We're relying on community testing to promote this to a stable release, so let us know what you find!
To download, scroll down to "assets".
Updates since this was released:
- There is a fixed exportlegends script that can generate maps here. To use, click "Raw", download the file, and save it to your hack/scripts folder (this should replace the file that is already there - if not, make sure you only give it the
.lua
extension).
New Scripts
color-schemes
: manages color schemesdevel/print-event
: prints the description of an event by ID or indexgui/color-schemes
: an in-game interface forcolor-schemes
light-aquifers-only
: changes heavy aquifers to light aquiferson-new-fortress
: runs DFHack commands only in a new fortressonce-per-save
: runs DFHack commands unless already run in the current saveresurrect-adv
: brings your adventurer back to lifereveal-hidden-units
: exposes all sneaking unitsworkorder
: allows queuing manager jobs; smart about shear and milk creature jobs
Fixes
-
Fixed a crash when starting DFHack in headless mode with no terminal
-
devel/visualize-structure
: fixed padding detection for globals -
exportlegends
:- added UTF-8 encoding and XML escaping for more fields
- added checking for unhandled structures to avoid generating invalid XML
- fixed missing fields in
history_event_assume_identityst
export
-
full-heal
:- when resurrected by specifying a corpse, units now appear at the location of the corpse rather than their location of death
- resurrected units now have their tile occupancy set (and are placed in the prone position to facilitate this)
Misc Improvements
-
Added "bit" suffix to downloads (e.g. 64-bit)
-
Tests:
- moved from DF folder to hack/scripts folder, and disabled installation by default
- made test runner script more flexible
-
dfhack-run
: added color output support -
embark-assistant
:- updated embark aquifer info to show all aquifer kinds present
- added neighbor display, including kobolds (SKULKING) and necro tower count
- updated aquifer search criteria to handle the new variation
- added search criteria for embark initial tree cover
- added search criteria for necro tower count, neighbor civ count, and specific neighbors. Should handle additional entities, but not tested
-
devel/export-dt-ini
: updated some field names for DT for 0.47 -
devel/visualize-structure
: added human-readable lengths to containers -
exportlegends
:- added evilness and force IDs to regions
- added profession and weapon info to relevant entities
- added support for many new history events in 0.47
- added historical event relationships and supplementary data
-
full-heal
:- made resurrection produce a historical event viewable in Legends mode
- made error messages more explanatory
-
install-info
: added DFHack build ID to report -
modtools/create-item
: added-matchingGloves
and-matchingShoes
arguments -
modtools/create-unit
:- added
-duration
argument to make the unit vanish after some time - added
-locationRange
argument to allow spawning in a random position within a defined area - added
-locationType
argument to specify the type of location to spawn in
- added
Internals
- Improved support for tagged unions, allowing tools to access union fields more safely
- Added separate changelogs in the scripts and df-structures repos
- Moved
reversing
scripts to df_misc repo
Structures
- Added an XML schema for validating df-structures syntax
- Added
divination_set_next_id
andimage_set_next_id
globals activity_entry_type
: new enum typeadventure_optionst
: identified many vmethodsagreement_details
: identified most fields of most sub-structsartifact_claim
: identified several fieldsartifact_record
: identified several fieldscaste_raw_flags
: renamed and identified many flags to match information from Toadycreature_raw_flags
: renamed and identified many flags to match information from Toadycrime_type
: new enum typedfhack_room_quality_level
: added enum attributes for names of rooms of each qualityentity_site_link_type
: new enum typeexport_map_type
: new enum typehistorical_entity.flags
: identified several flagshistorical_entity.relations
: renamed fromunknown1b
and identified several fieldshistorical_figure.vague_relationships
: identifiedhistorical_figure_info.known_info
: renamed fromsecret
, identified some fieldshistorical_figure
: renamedunit_id2
tonemesis_id
history_event_circumstance_info
: new struct type (and changed severalhistory_event
subclasses to use this)history_event_reason_info
: new struct type (and changed severalhistory_event
subclasses to use this)honors_type
: identified several fieldsinteraction_effect_create_itemst
: new struct typeinteraction_effect_summon_unitst
: new struct typeitem
: identified several vmethodslayer_type
: new enum typeplant.damage_flags
: addedis_dead
plot_role_type
: new enum typeplot_strategy_type
: new enum typerelationship_event_supplement
: new struct typerelationship_event
: new struct typespecific_ref
: moved union data todata
fieldui_look_list
: moved union fields todata
and renamed to matchtype
enumui_sidebar_menus.location
: added new profession-related fields, renamed and fixed types of deity-related fieldsui_sidebar_mode
: addedZonesLocationInfo
unit_action
: rearranged as tagged union with new sub-types; existing code should be compatiblevague_relationship_type
: new enum typevermin_flags
: identifiedis_roaming_colony
viewscreen_justicest
: identified interrogation-related fieldsworld_data.field_battles
: identified and named several fields
DFHack 0.47.03-beta1
- Scroll down for downloads (under "assets")
- This release only supports DF 0.47.03
- This is more stable than earlier builds, but you may still run into issues, including crashes
DFHack 0.47.03-beta1
New Scripts
devel/sc
: checks size of structuresdevel/visualize-structure
: displays the raw memory of a structure
Fixes
-
adv-max-skills
: fixed for 0.47 -
deep-embark
:- prevented running in non-fortress modes
- ensured that only the newest wagon is deconstructed
-
full-heal
:- fixed issues with removing corpses
- fixed resurrection for non-historical figures
-
modtools/create-unit
: added handling for arena tame setting -
teleport
: fixed setting new tile occupancy
Misc Improvements
-
deep-embark
:- improved support for using directly from the DFHack console
- added a
-clear
option to cancel
-
exportlegends
:- added identity information
- added creature raw names and flags
-
gui/prerelease-warning
: updated links and information about nightly builds -
modtools/syndrome-trigger
: enabled simultaneous use of-synclass
and-syndrome
-
repeat
: added-list
option
Structures
- Dropped support for 0.44.12-0.47.02
abstract_building_type
: added types (and subclasses) new to 0.47agreement_details_type
: added enumagreement_details
: added struct type (and many associated data types)agreement_party
: added struct typeannouncement_type
: added types new to 0.47artifact_claim_type
: added enumartifact_claim
: added struct typebreath_attack_type
: addedSHARP_ROCK
building_offering_placest
: new classbuilding_type
: addedOfferingPlace
creature_interaction_effect
: added subclasses new to 0.47creature_raw_flags
: identified several more itemsd_init
: added settings new to 0.47entity_name_type
: addedMERCHANT_COMPANY
,CRAFT_GUILD
entity_position_responsibility
: added values new to 0.47fortress_type
: added enumgeneral_ref_type
: addedUNIT_INTERROGATEE
ghost_type
: addedNone
valuegoal_type
: added goals types new to 0.47histfig_site_link
: added subclasses new to 0.47history_event_collection
: added subtypes new to 0.47history_event_context
: added lots of new fieldshistory_event_reason
: added captions for all itemshistory_event_reason
: added items new to 0.47history_event_type
: added types for events new to 0.47, as well as correspondinghistory_event
subclasses (too many to list here)honors_type
: added struct typeinteraction_effect
: added subtypes new to 0.47interaction_source_experimentst
: added class typeinteraction_source_usage_hint
: added values new to 0.47interface_key
: added items for keys new to 0.47job_skill
: addedINTRIGUE
,RIDING
lair_type
: added enummonument_type
: added enumnext_global_id
: added enumpoetic_form_action
: addedBeseech
setup_character_info
: expanded significantly in 0.47text_system
: added layout for structtile_occupancy
: addedvaried_heavy_aquifer
tool_uses
: added items:PLACE_OFFERING
,DIVINATION
,GAMES_OF_CHANCE
viewscreen_counterintelligencest
: new class (only layout identified so far)
DFHack 0.44.12-r3
- Important reminder: this only supports DF 0.44.12, because that was the newest version that existed when this DFHack version was released. See https://dfhack.org/builds/ for unstable builds that support newer versions.
- Look under "Assets" below for downloads
- Thanks to the 12 new contributors who made contributions to this release!
DFHack 0.44.12-r3
New Plugins
autoclothing
: automatically manage clothing work ordersautofarm
: replaces the previous Ruby script of the same name, with some fixesmap-render
: allows programmatically rendering sections of the map that are off-screentailor
: automatically manages keeping your dorfs clothed
New Scripts
assign-attributes
: changes the attributes of a unitassign-beliefs
: changes the beliefs of a unitassign-facets
: changes the facets (traits) of a unitassign-goals
: changes the goals of a unitassign-preferences
: changes the preferences of a unitassign-profile
: sets a dwarf's characteristics according to a predefined profileassign-skills
: changes the skills of a unitcombat-harden
: sets a unit's combat-hardened value to a given percentdeep-embark
: allows embarking undergrounddevel/find-twbt
: finds a TWBT-related offset needed by the newmap-render
plugindwarf-op
: optimizes dwarves for fort-mode work; makes managing labors easierforget-dead-body
: removes emotions associated with seeing a dead bodygui/create-tree
: creates a tree at the selected tilelinger
: takes over your killer in adventure modemodtools/create-tree
: creates a treemodtools/pref-edit
: add, remove, or edit the preferences of a unitmodtools/set-belief
: changes the beliefs (values) of unitsmodtools/set-need
: sets and edits unit needsmodtools/set-personality
: changes the personality of unitsmodtools/spawn-liquid
: spawns water or lava at the specified coordinatesset-orientation
: edits a unit's orientationunretire-anyone
: turns any historical figure into a playable adventurer
Fixes
-
Fixed a crash in the macOS/Linux console when the prompt was wider than the screen width
-
Fixed inconsistent results from
Units::isGay
for asexual units -
Fixed some cases where Lua filtered lists would not properly intercept keys, potentially triggering other actions on the same screen
-
autofarm
:- fixed biome detection to properly determine crop assignments on surface farms
- reimplemented as a C++ plugin to make proper biome detection possible
-
bodyswap
: fixed companion list not being updated often enough -
cxxrandom
: removed some extraneous debug information -
digfort
: now accounts for z-level changes when calculating maximum y dimension -
embark-assistant
:- fixed bug causing crash on worlds without generated metals (as well as pruning vectors as originally intended).
- fixed bug causing mineral matching to fail to cut off at the magma sea, reporting presence of things that aren't (like DF does currently).
- fixed bug causing half of the river tiles not to be recognized.
- added logic to detect some river tiles DF doesn't generate data for (but are definitely present).
-
eventful
: fixed invalid building ID in some building events -
exportlegends
: now escapes special characters in names properly -
getplants
: fixed designation of plants out of season (note that picked plants are still designated incorrectly) -
gui/autogems
: fixed error when no world is loaded -
gui/companion-order
:- fixed error when resetting group leaders
leave
now properly removes companion links
-
gui/create-item
: fixed module support - can now be used from other scripts -
gui/stamper
:- stopped "invert" from resetting the designation type
- switched to using DF's designation keybindings instead of custom bindings
- fixed some typos and text overlapping
-
modtools/create-unit
:- fixed an error associating historical entities with units
- stopped recalculating health to avoid newly-created citizens triggering a "recover wounded" job
- fixed units created in arena mode having blank names
- fixed units created in arena mode having the wrong race and/or interaction effects applied after creating units manually in-game
- stopped units from spawning with extra items or skills previously selected in the arena
- stopped setting some unneeded flags that could result in glowing creature tiles
- set units created in adventure mode to have no family, instead of being related to the first creature in the world
-
modtools/reaction-product-trigger
:- fixed an error dealing with reactions in adventure mode
- blocked
\\BUILDING_ID
for adventure mode reactions - fixed
-clear
to work without passing other unneeded arguments
-
modtools/reaction-trigger
:- fixed a bug when determining whether a command was run
- fixed handling of
-resetPolicy
-
mousequery
: fixed calculation of map dimensions, which was sometimes preventing scrolling the map with the mouse when TWBT was enabled -
RemoteFortressReader
: fixed a crash when a unit's path has a length of 0 -
stonesense
: fixed crash due to wagons and other soul-less creatures -
tame
: now sets the civ ID of tamed animals (fixes compatibility withautobutcher
) -
title-folder
: silenced error whenPRINT_MODE
is set toTEXT
Misc Improvements
-
Added a note to
dfhack-run
when called with no arguments (which is usually unintentional) -
On macOS, the launcher now attempts to un-quarantine the rest of DFHack
-
bodyswap
: added arena mode support -
combine-drinks
: added more default output, similar tocombine-plants
-
createitem
: added a list of valid castes to the "invalid caste" error message, for convenience -
devel/export-dt-ini
: added more size information needed by newer Dwarf Therapist versions -
dwarfmonitor
: enabled widgets to access other scripts and plugins by switching to the core Lua context -
embark-assistant
:- added an in-game option to activate on the embark screen
- changed waterfall detection to look for level drop rather than just presence
- changed matching to take incursions, i.e. parts of other biomes, into consideration when evaluating tiles. This allows for e.g. finding multiple biomes on single tile embarks.
- changed overlay display to show when incursion surveying is incomplete
- changed overlay display to show evil weather
- added optional parameter "fileresult" for crude external harness automated match support
- improved focus movement logic to go to only required world tiles, increasing speed of subsequent searches considerably
-
exportlegends
: added rivers to custom XML export -
exterminate
: added support for a specialenemy
caste -
gui/gm-unit
:- added support for editing:
- added attribute editor
- added orientation editor
- added editor for bodies and body parts
- added color editor
- added belief editor
- added personality editor
-
modtools/create-item
: documented already-existing-quality
option -
modtools/create-unit
:- added the ability to specify
\\LOCAL
for the fort group entity - now enables the default labours for adult units with CAN_LEARN.
- now sets historical figure orientation.
- improved speed of creating multiple units at once
- made the script usable as a module (from other scripts)
- added the ability to specify
-
modtools/reaction-trigger
:- added
-ignoreWorker
: ignores the worker when selecting the targets - changed the default behavior to skip inactive/dead units; added
-dontSkipInactive
to include creatures that are inactive - added
-range
: controls how far elligible targets can be from the workshop - syndromes now are applied before commands are run, not after
- if both a command and a syndrome are given, the command only runs if the syndrome could be applied
- added
-
mousequery
: made it more clear when features are enabled -
RemoteFortressReader
:- added a basic framework for controlling and reading the menus in DF (currently only supports the building menu)
- added support for reading item raws
- added a check for whether or not the game is currently saving or loading, for utilities to check if it's safe to read from DF
- added unit facing direction estimate and position within tiles
- added unit age
- added unit wounds
- added tree information
- added check for units' current jobs when calculating the direction they are facing
API
- Added new
plugin_load_data
andplugin_save_data
events for plugins to load/save persistent data - Added
Maps::GetBiomeType
andMaps::GetBiomeTypeByRef
to infer biome types properly - Added
Units::getPhysicalDescription
(note that this depends on theunit_get_physical_description
offset, which is not yet available for all DF builds)
Internals
- Added new Persistence module
- Cut down on internal DFHack dependencies to improve build times
- Improved concurrency in event and server handlers
- Persistent data is now stored in JSON files instead of historical figures - existing data will be migrated when saving
stonesense
: fixed some OpenGL build issues on Linux
Lua
- Exposed
gui.dwarfmode.get_movement_delta
andgui.dwarfmode.get_hotkey_target
dfhack.run_command
now returns the command's return code
Ruby
- Made
unit_ishostile
consistently return a boolean
Structures
-
Added
unit_get_physical_description
function offset on some platforms -
Added/identified types:
assume_identity_mode
musical_form_purpose
musical_form_style
...