Live patching

As an alternative, you can use the binpatch dfhack command to apply/remove patches live in memory during a DF session.

In this case, updating symbols.xml is not necessary.

die

Instantly kills DF without saving.

forcepause

Forces DF to pause. This is useful when your FPS drops below 1 and you lose control of the game.

• Activate with 'forcepause 1'
• Deactivate with 'forcepause 0'

nopause

Disables pausing (both manual and automatic) with the exception of pause forced by 'reveal hell'. This is nice for digging under rivers.

fastdwarf

Controls speedydwarf and teledwarf. Speedydwarf makes dwarves move quickly and perform tasks quickly. Teledwarf makes dwarves move instantaneously, but do jobs at the same speed.

• 'fastdwarf 0 0' disables both
• 'fastdwarf 0 1' disables speedydwarf and enables teledwarf
• 'fastdwarf 1 0' enables speedydwarf and disables teledwarf
• 'fastdwarf 1 1' enables both
• 'fastdwarf 0' disables both
• 'fastdwarf 1' enables speedydwarf and disables teledwarf
• 'fastdwarf 2 ...' sets a native debug flag in the game memory that implements an even more aggressive version of speedydwarf.

follow

Makes the game view follow the currently highlighted unit after you exit from current menu/cursor mode. Handy for watching dwarves running around. Deactivated by moving the view manually.

tidlers

Toggle between all possible positions where the idlers count can be placed.

twaterlvl

Toggle between displaying/not displaying liquid depth as numbers.

stockpile settings management

rename

Allows renaming various things.

Options:

rename squad <index> "name"

Rename squad by index to 'name'.

rename hotkey <index> \"name\"

Rename hotkey by index. This allows assigning longer commands to the DF hotkeys.

rename unit "nickname"

Rename a unit/creature highlighted in the DF user interface.

rename unit-profession "custom profession"

Change proffession name of the highlighted unit/creature.

rename building "name"

Set a custom name for the selected building. The building must be one of stockpile, workshop, furnace, trap, siege engine or an activity zone.

command-prompt

A one line command prompt in df. Same as entering command into dfhack console. Best used as a keybinding. Can be called with optional "entry" that will start prompt with that pre-filled.

rendermax

A collection of renderer replacing/enhancing filters. For better effect try changing the black color in palette to non totally black. For more info see thread in forums: http://www.bay12forums.com/smf/index.php?topic=128487.0

Options:

rendermax trippy

Randomizes each tiles color. Used for fun mainly.

rendermax light

Enable lighting engine.

rendermax light reload

Reload the settings file.

rendermax light sun <x>|cycle

Set time to <x> (in hours) or set it to df time cycle.

rendermax occlusionON|occlusionOFF

Show debug occlusion info.

rendermax disable

Disable any filter that is enabled.

An image showing lava and dragon breath. Not pictured here: sunlight, shining items/plants, materials that color the light etc...

adv-bodyswap

This allows taking control over your followers and other creatures in adventure mode. For example, you can make them pick up new arms and armor and equip them properly.

Usage:

• When viewing unit details, body-swaps into that unit.
• In the main adventure mode screen, reverts transient swap.

advtools

A package of different adventure mode tools (currently just one)

Usage:

list-equipped [all]

List armor and weapons equipped by your companions. If all is specified, also lists non-metal clothing.

metal-detector [all-types] [non-trader]

Reveal metal armor and weapons in shops. The options disable the checks on item type and being in shop.

3dveins

Removes all existing veins from the map and generates new ones using 3D Perlin noise, in order to produce a layout that smoothly flows between Z levels. The vein distribution is based on the world seed, so running the command for the second time should produce no change. It is best to run it just once immediately after embark.

This command is intended as only a cosmetic change, so it takes care to exactly preserve the mineral counts reported by prospect all. The amounts of different layer stones may slightly change in some cases if vein mass shifts between Z layers.

This command is very unlikely to work on maps generated before version 0.34.08.

Note that there is no undo option other than restoring from backup.

changelayer

Changes material of the geology layer under cursor to the specified inorganic RAW material. Can have impact on all surrounding regions, not only your embark! By default changing stone to soil and vice versa is not allowed. By default changes only the layer at the cursor position. Note that one layer can stretch across lots of z levels. By default changes only the geology which is linked to the biome under the cursor. That geology might be linked to other biomes as well, though. Mineral veins and gem clusters will stay on the map. Use 'changevein' for them.

tl;dr: You will end up with changing quite big areas in one go, especially if you use it in lower z levels. Use with care.

Options:

Examples:

changelayer GRANITE

Convert layer at cursor position into granite.

changelayer SILTY_CLAY force

Convert layer at cursor position into clay even if it's stone.

changelayer MARBLE all_biomes all_layers

Convert all layers of all biomes which are not soil into marble.

changevein

Changes material of the vein under cursor to the specified inorganic RAW material. Only affects tiles within the current 16x16 block - for veins and large clusters, you will need to use this command multiple times.

Example:

changevein NATIVE_PLATINUM

Convert vein at cursor position into platinum ore.

changeitem

Allows changing item material and base quality. By default the item currently selected in the UI will be changed (you can select items in the 'k' list or inside containers/inventory). By default change is only allowed if materials is of the same subtype (for example wood<->wood, stone<->stone etc). But since some transformations work pretty well and may be desired you can override this with 'force'. Note that some attributes will not be touched, possibly resulting in weirdness. To get an idea how the RAW id should look like, check some items with 'info'. Using 'force' might create items which are not touched by crafters/haulers.

Options:

Examples:

changeitem m INORGANIC:GRANITE here

Change material of all items under the cursor to granite.

changeitem q 5

Change currently selected item to masterpiece quality.

colonies

Allows listing all the vermin colonies on the map and optionally turning them into honey bee colonies.

Options:

createitem

Allows creating new items of arbitrary types and made of arbitrary materials. By default, items created are spawned at the feet of the selected unit.

Specify the item and material information as you would indicate them in custom reaction raws, with the following differences:

• Separate the item and material with a space rather than a colon
• If the item has no subtype, omit the :NONE
• If the item is REMAINS, FISH, FISH_RAW, VERMIN, PET, or EGG, specify a CREATURE:CASTE pair instead of a material token.

Corpses, body parts, and prepared meals cannot be created using this tool.

Examples:

createitem GLOVES:ITEM_GLOVES_GAUNTLETS INORGANIC:STEEL 2

Create 2 pairs of steel gauntlets.

createitem WOOD PLANT_MAT:TOWER_CAP:WOOD

Create tower-cap logs.

createitem FISH FISH_SHAD:MALE 5

Create a stack of 5 cleaned shad, ready to eat.

To change where new items are placed, first run the command with a destination type while an appropriate destination is selected.

Options:

deramp (by zilpin)

Removes all ramps designated for removal from the map. This is useful for replicating the old channel digging designation. It also removes any and all 'down ramps' that can remain after a cave-in (you don't have to designate anything for that to happen).

feature

Enables management of map features.

• Discovering a magma feature (magma pool, volcano, magma sea, or curious underground structure) permits magma workshops and furnaces to be built.
• Discovering a cavern layer causes plants (trees, shrubs, and grass) from that cavern to grow within your fortress.

Options:

infiniteSky

Automatically allocates new z-levels of sky at the top of the map as you build up, or on request allocates many levels all at once.

Examples:

infiniteSky n

Raise the sky by n z-levels.

infiniteSky enable/disable

Enables/disables monitoring of constructions. If you build anything in the second to highest z-level, it will allocate one more sky level. This is so you can continue to build stairs upward.

Bugs have been reported with this version of the plugin, so be careful. It is possible that new z-levels will suddenly disappear and possibly cause cave-ins. Saving and loading after creating new z-levels should fix the problem.

liquids

Allows adding magma, water and obsidian to the game. It replaces the normal dfhack command line and can't be used from a hotkey. Settings will be remembered as long as dfhack runs. Intended for use in combination with the command liquids-here (which can be bound to a hotkey).

For more information, refer to the command's internal help.

liquids-here

Run the liquid spawner with the current/last settings made in liquids (if no settings in liquids were made it paints a point of 7/7 magma by default).

Intended to be used as keybinding. Requires an active in-game cursor.

tiletypes

Can be used for painting map tiles and is an interactive command, much like liquids.

The tool works with two set of options and a brush. The brush determines which tiles will be processed. First set of options is the filter, which can exclude some of the tiles from the brush by looking at the tile properties. The second set of options is the paint - this determines how the selected tiles are changed.

Both paint and filter can have many different properties including things like general shape (WALL, FLOOR, etc.), general material (SOIL, STONE, MINERAL, etc.), state of 'designated', 'hidden' and 'light' flags.

The properties of filter and paint can be partially defined. This means that you can for example do something like this:

filter material STONE
filter shape FORTIFICATION
paint shape FLOOR

This will turn all stone fortifications into floors, preserving the material.

Or this:

filter shape FLOOR
filter material MINERAL
paint shape WALL

Turning mineral vein floors back into walls.

The tool also allows tweaking some tile flags:

Or this:

paint hidden 1
paint hidden 0

This will hide previously revealed tiles (or show hidden with the 0 option).

More recently, the tool supports changing the base material of the tile to an arbitrary stone from the raws, by creating new veins as required. Note that this mode paints under ice and constructions, instead of overwriting them. To enable, use:

paint stone MICROCLINE

This mode is incompatible with the regular material setting, so changing it cancels the specific stone selection:

paint material ANY

Since different vein types have different drop rates, it is possible to choose which one to use in painting:

paint veintype CLUSTER_SMALL

When the chosen type is CLUSTER (the default), the tool may automatically choose to use layer stone or lava stone instead of veins if its material matches the desired one.

Any paint or filter option (or the entire paint or filter) can be disabled entirely by using the ANY keyword:

paint hidden ANY
paint shape ANY
filter material any
filter shape any
filter any

You can use several different brushes for painting tiles:

• Point. (point)
• Rectangular range. (range)
• A column ranging from current cursor to the first solid tile above. (column)
• DF map block - 16x16 tiles, in a regular grid. (block)

Example:

range 10 10 1

This will change the brush to a rectangle spanning 10x10 tiles on one z-level. The range starts at the position of the cursor and goes to the east, south and up.

For more details, see the 'help' command while using this.

tiletypes-commands

Runs tiletypes commands, separated by ;. This makes it possible to change tiletypes modes from a hotkey.

tiletypes-here

Apply the current tiletypes options at the in-game cursor position, including the brush. Can be used from a hotkey.

tiletypes-here-point

Apply the current tiletypes options at the in-game cursor position to a single tile. Can be used from a hotkey.

tubefill

Fills all the adamantine veins again. Veins that were hollow will be left alone.

Options:

Beware that filling in hollow veins will trigger a demon invasion on top of your miner when you dig into the region that used to be hollow.

plant

A tool for creating shrubs, growing, or getting rid of them.

Subcommands:

create creates a new sapling under the cursor. Takes a raw ID as argument (e.g. TOWER_CAP). The cursor must be located on a dirt or grass floor tile.

grow works on the sapling under the cursor, and turns it into a tree. Works on all shrubs of the map if the cursor is hidden.

extirpate and immolate work only on the plant under the cursor.

For mass effects, use one of the additional options:

regrass

Regrows grass. Not much to it ;)

weather

Prints the current weather map by default.

Also lets you change the current weather to 'clear sky', 'rainy' or 'snowing'.

Options:

cursecheck

Checks a single map tile or the whole map/world for cursed creatures (ghosts, vampires, necromancers, werebeasts, zombies).

With an active in-game cursor only the selected tile will be observed. Without a cursor the whole map will be checked.

By default cursed creatures will be only counted in case you just want to find out if you have any of them running around in your fort. Dead and passive creatures (ghosts who were put to rest, killed vampires, ...) are ignored. Undead skeletons, corpses, bodyparts and the like are all thrown into the curse category "zombie". Anonymous zombies and resurrected body parts will show as "unnamed creature".

Options:

Examples:

cursecheck detail all

Give detailed info about all cursed creatures including deceased ones (no in-game cursor).

cursecheck nick

Give a nickname all living/active cursed creatures on the map(no in-game cursor).

flows

A tool for checking how many tiles contain flowing liquids. If you suspect that your magma sea leaks into HFS, you can use this tool to be sure without revealing the map.

probe

Can be used to determine tile properties like temperature.

prospect

Prints a big list of all the present minerals and plants. By default, only the visible part of the map is scanned.

Options:

reveal

This reveals the map. By default, HFS will remain hidden so that the demons don't spawn. You can use 'reveal hell' to reveal everything. With hell revealed, you won't be able to unpause until you hide the map again. If you really want to unpause with hell revealed, use 'reveal demons'.

Reveal also works in adventure mode, but any of its effects are negated once you move. When you use it this way, you don't need to run 'unreveal'.

unreveal

Reverts the effects of 'reveal'.

revtoggle

Switches between 'reveal' and 'unreveal'.

revflood

This command will hide the whole map and then reveal all the tiles that have a path to the in-game cursor.

revforget

When you use reveal, it saves information about what was/wasn't visible before revealing everything. Unreveal uses this information to hide things again. This command throws away the information. For example, use in cases where you abandoned with the fort revealed and no longer want the data.

showmood

Shows all items needed for the currently active strange mood.

burrow

Miscellaneous burrow control. Allows manipulating burrows and automated burrow expansion while digging.

Options:

enable feature ...

Enable features of the plugin.

disable feature ...

Disable features of the plugin.

clear-unit burrow burrow ...

Remove all units from the burrows.

clear-tiles burrow burrow ...

Remove all tiles from the burrows.

set-units target-burrow src-burrow ...

Clear target, and adds units from source burrows.

add-units target-burrow src-burrow ...

Add units from the source burrows to the target.

remove-units target-burrow src-burrow ...

Remove units in source burrows from the target.

set-tiles target-burrow src-burrow ...

Clear target and adds tiles from the source burrows.

add-tiles target-burrow src-burrow ...

Add tiles from the source burrows to the target.

remove-tiles target-burrow src-burrow ...

Remove tiles in source burrows from the target.

For these three options, in place of a source burrow it is possible to use one of the following keywords: ABOVE_GROUND, SUBTERRANEAN, INSIDE, OUTSIDE, LIGHT, DARK, HIDDEN, REVEALED

Features:

digv

Designates a whole vein for digging. Requires an active in-game cursor placed over a vein tile. With the 'x' option, it will traverse z-levels (putting stairs between the same-material tiles).

digvx

A permanent alias for 'digv x'.

digl

Designates layer stone for digging. Requires an active in-game cursor placed over a layer stone tile. With the 'x' option, it will traverse z-levels (putting stairs between the same-material tiles). With the 'undo' option it will remove the dig designation instead (if you realize that digging out a 50 z-level deep layer was not such a good idea after all).

diglx

A permanent alias for 'digl x'.

digexp

This command can be used for exploratory mining.

See: http://df.magmawiki.com/index.php/DF2010:Exploratory_mining

There are two variables that can be set: pattern and filter.

Patterns:

Filters:

After you have a pattern set, you can use 'expdig' to apply it again.

Examples:

expdig diag5 hidden

Designate the diagonal 5 patter over all hidden tiles

expdig

Apply last used pattern and filter

expdig ladder designated

Take current designations and replace them with the ladder pattern

digcircle

A command for easy designation of filled and hollow circles. It has several types of options.

Shape:

Action:

Designation types:

After you have set the options, the command called with no options repeats with the last selected parameters.

Examples:

• 'digcircle filled 3' = Dig a filled circle with radius = 3.
• 'digcircle' = Do it again.

digtype

For every tile on the map of the same vein type as the selected tile, this command designates it to have the same designation as the selected tile. If the selected tile has no designation, they will be dig designated. If an argument is given, the designation of the selected tile is ignored, and all appropriate tiles are set to the specified designation.

Options:

digFlood

Automatically digs out specified veins as they are discovered. It runs once every time a dwarf finishes a dig job. It will only dig out appropriate tiles that are adjacent to the finished dig job. To add a vein type, use digFlood 1 [type]. This will also enable the plugin. To remove a vein type, use digFlood 0 [type] 1 to disable, then remove, then re-enable.

digFlood 0 disable

digFlood 1 enable

digFlood 0 MICROCLINE COAL_BITUMINOUS 1 disable plugin, remove microcline and bituminous coal from monitoring, then re-enable the plugin

digFlood CLEAR remove all inorganics from monitoring

digFlood digAll1 ignore the monitor list and dig any vein

digFlood digAll0 disable digAll mode

See help digFlood for details.

filltraffic

Set traffic designations using flood-fill starting at the cursor.

Traffic Type Codes:

Other Options:

Example:

filltraffic H

When used in a room with doors, it will set traffic to HIGH in just that room.

alltraffic

Set traffic designations for every single tile of the map (useful for resetting traffic designations).

Traffic Type Codes:

Example:

alltraffic N

Set traffic to 'normal' for all tiles.

restrictliquid

Restrict traffic on all visible tiles with liquid.

restrictice

Restrict traffic on all tiles on top of visible ice.

getplants

This tool allows plant gathering and tree cutting by RAW ID. Specify the types of trees to cut down and/or shrubs to gather by their plant names, separated by spaces.

Options:

Specifying both -t and -s will have no effect. If no plant IDs are specified, all valid plant IDs will be listed.

clean

Cleans all the splatter that get scattered all over the map, items and creatures. In an old fortress, this can significantly reduce FPS lag. It can also spoil your !!FUN!!, so think before you use it.

Options:

Extra options for 'map':

spotclean

Works like 'clean map snow mud', but only for the tile under the cursor. Ideal if you want to keep that bloody entrance 'clean map' would clean up.

autodump

This utility lets you quickly move all items designated to be dumped. Items are instantly moved to the cursor position, the dump flag is unset, and the forbid flag is set, as if it had been dumped normally. Be aware that any active dump item tasks still point at the item.

Cursor must be placed on a floor tile so the items can be dumped there.

Options:

autodump-destroy-here

Destroy items marked for dumping under cursor. Identical to autodump destroy-here, but intended for use as keybinding.

autodump-destroy-item

Destroy the selected item. The item may be selected in the 'k' list, or inside a container. If called again before the game is resumed, cancels destroy.

cleanowned

Confiscates items owned by dwarfs. By default, owned food on the floor and rotten items are confistacted and dumped.

Options:

Example:

cleanowned scattered X

This will confiscate rotten and dropped food, garbage on the floors and any worn items with 'X' damage and above.

drybuckets

This utility removes water from all buckets in your fortress, allowing them to be safely used for making lye.

fixdiplomats

Up to version 0.31.12, Elves only sent Diplomats to your fortress to propose tree cutting quotas due to a bug; once that bug was fixed, Elves stopped caring about excess tree cutting. This command adds a Diplomat position to all Elven civilizations, allowing them to negotiate tree cutting quotas (and allowing you to violate them and potentially start wars) in case you haven't already modified your raws accordingly.

fixmerchants

This command adds the Guild Representative position to all Human civilizations, allowing them to make trade agreements (just as they did back in 0.28.181.40d and earlier) in case you haven't already modified your raws accordingly.

fixveins

Removes invalid references to mineral inclusions and restores missing ones. Use this if you broke your embark with tools like tiletypes, or if you accidentally placed a construction on top of a valuable mineral floor.

tweak

Contains various tweaks for minor bugs.

One-shot subcommands:

Subcommands that persist until disabled or DF quit:

stable-cursor:	Saves the exact cursor position between t/q/k/d/etc menus of dwarfmode.
fast-heat:	Further improves temperature update performance by ensuring that 1 degree of item temperature is crossed in no more than specified number of frames when updating from the environment temperature. This reduces the time it takes for stable-temp to stop updates again when equilibrium is disturbed.
advmode-contained:
	Works around bug 6202, i.e. custom reactions with container inputs in advmode. The issue is that the screen tries to force you to select the contents separately from the container. This forcefully skips child reagents.
fast-trade:	Makes Shift-Down in the Move Goods to Depot and Trade screens select the current item (fully, in case of a stack), and scroll down one line.
military-stable-assign:
	Preserve list order and cursor position when assigning to squad, i.e. stop the rightmost list of the Positions page of the military screen from constantly resetting to the top.
military-color-assigned:
	Color squad candidates already assigned to other squads in yellow/green to make them stand out more in the list.
craft-age-wear:	Fixes the behavior of crafted items wearing out over time (bug 6003). With this tweak, items made from cloth and leather will gain a level of wear every 20 years.
adamantine-cloth-wear:
	Prevents adamantine clothing from wearing out while being worn (bug 6481).
farm-plot-select:
	Adds "Select all" and "Deselect all" options to farm plot menus
import-priority-category:
	Allows changing the priority of all goods in a category when discussing an import agreement with the liaison
manager-quantity:
	Removes the limit of 30 jobs per manager order
civ-view-agreement:
	Fixes overlapping text on the "view agreement" screen
nestbox-color:	Fixes the color of built nestboxes

fix-armory

Enables a fix for storage of squad equipment in barracks.

Specifically, it prevents your haulers from moving squad equipment to stockpiles, and instead queues jobs to store it on weapon racks, armor stands, and in containers.

Note that the buildings in the armory are used as follows:

• Weapon racks (when patched) are used to store any assigned weapons. Each rack belongs to a specific squad, and can store up to 5 weapons.
• Armor stands belong to specific squad members and are used for armor and shields. By default one stand can store one item of each type (hence one boot or gauntlet); if patched, the limit is raised to 2, which should be sufficient.
• Cabinets are used to store assigned clothing for a specific squad member. They are never used to store owned clothing.
• Chests (boxes, etc) are used for a flask, backpack or quiver assigned to the squad member. Due to a probable bug, food is dropped out of the backpack when it is stored.

Contrary to the common misconception, all these uses are controlled by the Individual Equipment usage flag. The Squad Equipment flag is actually intended for ammo, but the game does even less in that area than for armor and weapons. This plugin implements the following rules almost from scratch:

• Combat ammo is stored in chests inside rooms with Squad Equipment enabled.
• If a chest is assigned to a squad member due to Individual Equipment also being set, it is only used for that squad's ammo; otherwise, any squads with Squad Equipment on the room will use all of the chests at random.
• Training ammo is stored in chests inside archery ranges designated from archery targets, and controlled by the same Train flag as archery training itself. This is inspired by some defunct code for weapon racks.

There are some minor traces in the game code to suggest that the first of these rules is intended by Toady; the rest are invented by this plugin.

lair

This command allows you to mark the map as 'monster lair', preventing item scatter on abandon. When invoked as 'lair reset', it does the opposite.

Unlike reveal, this command doesn't save the information about tiles - you won't be able to restore state of real monster lairs using 'lair reset'.

Options:

mode

This command lets you see and change the game mode directly. Not all combinations are good for every situation and most of them will produce undesirable results. There are a few good ones though.

I take no responsibility of anything that happens as a result of using this tool

ssense / stonesense

An isometric visualizer that runs in a second window. This requires working graphics acceleration and at least a dual core CPU (otherwise it will slow down DF).

All the data resides in the 'stonesense' directory. For detailed instructions, see stonesense/README.txt

Compatible with Windows > XP SP3 and most modern Linux distributions.

Older versions, support and extra graphics can be found in the bay12 forum thread: http://www.bay12forums.com/smf/index.php?topic=43260.0

Some additional resources: http://df.magmawiki.com/index.php/Utility:Stonesense/Content_repository

mapexport

Export the current loaded map as a file. This will be eventually usable with visualizers.

dwarfexport

Export dwarves to RuneSmith-compatible XML.

exportlegends

Controls legends mode to export data - especially useful to set-and-forget large worlds, or when you want a map of every site when there are several hundred.

Options:

job

Command for general job query and manipulation.

Options:

no extra options

Print details of the current job. The job can be selected in a workshop, or the unit/jobs screen.

list

Print details of all jobs in the selected workshop.

item-material <item-idx> <material[:subtoken]>

Replace the exact material id in the job item.

item-type <item-idx> <type[:subtype]>

Replace the exact item type id in the job item.

job-material

Alter the material of the selected job.

Invoked as:

job-material <inorganic-token>

Intended to be used as a keybinding:

• In 'q' mode, when a job is highlighted within a workshop or furnace, changes the material of the job. Only inorganic materials can be used in this mode.
• In 'b' mode, during selection of building components positions the cursor over the first available choice with the matching material.

job-duplicate

Duplicate the selected job in a workshop:

• In 'q' mode, when a job is highlighted within a workshop or furnace building, instantly duplicates the job.

stockflow

Allows the fortress bookkeeper to queue jobs through the manager, based on space or items available in stockpiles.

Usage:

stockflow enable

Enable the plugin.

stockflow disable

Disable the plugin.

stockflow fast

Enable the plugin in fast mode.

stockflow list

List any work order settings for your stockpiles.

stockflow status

Display whether the plugin is enabled.

While enabled, the 'q' menu of each stockpile will have two new options:

• j: Select a job to order, from an interface like the manager's screen.
• J: Cycle between several options for how many such jobs to order.

Whenever the bookkeeper updates stockpile records, new work orders will be placed on the manager's queue for each such selection, reduced by the number of identical orders already in the queue.

In fast mode, new work orders will be enqueued once per day, instead of waiting for the bookkeeper.

workflow

Manage control of repeat jobs.

Usage:

workflow enable [option...], workflow disable [option...]

If no options are specified, enables or disables the plugin. Otherwise, enables or disables any of the following options:

• drybuckets: Automatically empty abandoned water buckets.
• auto-melt: Resume melt jobs when there are objects to melt.

workflow jobs

List workflow-controlled jobs (if in a workshop, filtered by it).

workflow list

List active constraints, and their job counts.

workflow list-commands

List active constraints as workflow commands that re-create them; this list can be copied to a file, and then reloaded using the script built-in command.

workflow count <constraint-spec> <cnt-limit> [cnt-gap]

Set a constraint, counting every stack as 1 item.

workflow amount <constraint-spec> <cnt-limit> [cnt-gap]

Set a constraint, counting all items within stacks.

workflow unlimit <constraint-spec>

Delete a constraint.

workflow unlimit-all

Delete all constraints.

ITEM[:SUBTYPE]/[GENERIC_MAT,...]/[SPECIFIC_MAT:...]/[LOCAL,<quality>]

workflow amount AMMO:ITEM_AMMO_BOLTS/METAL 1000 100
workflow amount AMMO:ITEM_AMMO_BOLTS/WOOD,BONE 200 50

workflow count FOOD 120 30
workflow count DRINK 120 30

workflow count BIN 30
workflow count BARREL 30
workflow count BOX/CLOTH,SILK,YARN 30

workflow count BAR//COAL 20
workflow count BAR//COPPER 30

workflow count CRAFTS//GOLD 20

workflow count POWDER_MISC/SAND 20
workflow count BOULDER/CLAY 20

workflow amount POWDER_MISC//MUSHROOM_CUP_DIMPLE:MILL 100 20

workflow count CRAFTS///LOCAL,EXCEPTIONAL 100 90

seedwatch

Watches the numbers of seeds available and enables/disables seed and plant cooking.

Each plant type can be assigned a limit. If their number falls below that limit, the plants and seeds of that type will be excluded from cookery. If the number rises above the limit + 20, then cooking will be allowed.

The plugin needs a fortress to be loaded and will deactivate automatically otherwise. You have to reactivate with 'seedwatch start' after you load the game.

Options:

Examples:

seedwatch MUSHROOM_HELMET_PLUMP 30

add MUSHROOM_HELMET_PLUMP to the watch list, limit = 30

seedwatch MUSHROOM_HELMET_PLUMP

removes MUSHROOM_HELMET_PLUMP from the watch list.

seedwatch all 30

adds all plants from the abbreviation list to the watch list, the limit being 30.

zone

Helps a bit with managing activity zones (pens, pastures and pits) and cages.

Options:

Filters:

autonestbox

Assigns unpastured female egg-layers to nestbox zones. Requires that you create pen/pasture zones above nestboxes. If the pen is bigger than 1x1 the nestbox must be in the top left corner. Only 1 unit will be assigned per pen, regardless of the size. The age of the units is currently not checked, most birds grow up quite fast. Egglayers who are also grazers will be ignored, since confining them to a 1x1 pasture is not a good idea. Only tame and domesticated own units are processed since pasturing half-trained wild egglayers could destroy your neat nestbox zones when they revert to wild. When called without options autonestbox will instantly run once.

Options:

autobutcher

Assigns lifestock for slaughter once it reaches a specific count. Requires that you add the target race(s) to a watch list. Only tame units will be processed.

Named units will be completely ignored (to protect specific animals from autobutcher you can give them nicknames with the tool 'rename unit' for single units or with 'zone nick' to mass-rename units in pastures and cages).

Creatures trained for war or hunting will be ignored as well.

Creatures assigned to cages will be ignored if the cage is defined as a room (to avoid butchering unnamed zoo animals).

Once you have too much adults, the oldest will be butchered first. Once you have too much kids, the youngest will be butchered first. If you don't set any target count the following default will be used: 1 male kid, 5 female kids, 1 male adult, 5 female adults.

Options:

Examples:

You want to keep max 7 kids (4 female, 3 male) and max 3 adults (2 female, 1 male) of the race alpaca. Once the kids grow up the oldest adults will get slaughtered. Excess kids will get slaughtered starting with the youngest to allow that the older ones grow into adults. Any unnamed cats will be slaughtered as soon as possible.

autobutcher target 4 3 2 1 ALPACA BIRD_TURKEY
autobutcher target 0 0 0 0 CAT
autobutcher watch ALPACA BIRD_TURKEY CAT
autobutcher start

Automatically put all new races onto the watchlist and mark unnamed tame units for slaughter as soon as they arrive in your fort. Settings already made for specific races will be left untouched.

autobutcher target 0 0 0 0 new
autobutcher autowatch
autobutcher start

Stop watching the races alpaca and cat, but remember the target count settings so that you can use 'unwatch' without the need to enter the values again. Note: 'autobutcher unwatch all' works, but only makes sense if you want to keep the plugin running with the 'autowatch' feature or manually add some new races with 'watch'. If you simply want to stop it completely use 'autobutcher stop' instead.

autobutcher unwatch ALPACA CAT

Note:

Settings and watchlist are stored in the savegame, so that you can have different settings for each world. If you want to copy your watchlist to another savegame you can use the command list_export:

Load savegame where you made the settings.
Start a CMD shell and navigate to the df directory. Type the following into the shell:
dfhack-run autobutcher list_export > autobutcher.bat
Load the savegame where you want to copy the settings to, run the batch file (from the shell):
autobutcher.bat

autochop

Automatically manage tree cutting designation to keep available logs withing given quotas.

Open the dashboard by running:

getplants autochop

The plugin must be activated (with 'a') before it can be used. You can then set logging quotas and restrict designations to specific burrows (with 'Enter') if desired. The plugin's activity cycle runs once every in game day.

If you add

enable getplants

to your dfhack.init there will be a hotkey to open the dashboard from the chop designation menu.

autolabor

Automatically manage dwarf labors to efficiently complete jobs. Autolabor tries to keep as many dwarves as possible busy but also tries to have dwarves specialize in specific skills.

The key is that, for almost all labors, once a dwarf begins a job it will finish that job even if the associated labor is removed. Autolabor therefore frequently checks which dwarf or dwarves should take new jobs for that labor, and sets labors accordingly. Labors with equiptment (mining, hunting, and woodcutting), which are abandoned if labors change mid-job, are handled slightly differently to minimise churn.

Warning: autolabor will override any manual changes you make to labors while it is enabled, including through other tools such as Dwarf Therapist

Simple usage:

Anything beyond this is optional - autolabor works well on the default settings.

Advanced usage:

Examples:

By default, each labor is assigned to between 1 and 200 dwarves (2-200 for mining). By default 33% of the workforce become haulers, who handle all hauling jobs as well as cleaning, pulling levers, recovering wounded, removing constructions, and filling ponds. Other jobs are automatically assigned as described above. Each of these settings can be adjusted.

Jobs are rarely assigned to nobles with responsibilities for meeting diplomats or merchants, never to the chief medical dwarf, and less often to the bookeeper and manager.

Hunting is never assigned without a butchery, and fishing is nver assigned without a fishery.

For each labor a preference order is calculated based on skill, biased against masters of other trades and excluding those who can't do the job. The labor is then added to the best <minimum> dwarves for that labor. We assign at least the minimum number of dwarfs, in order of preference, and then assign additional dwarfs that meet any of these conditions:

• The dwarf is idle and there are no idle dwarves assigned to this labor
• The dwarf has nonzero skill associated with the labor
• The labor is mining, hunting, or woodcutting and the dwarf currently has it enabled.

We stop assigning dwarfs when we reach the maximum allowed.

catsplosion

Makes cats just multiply. It is not a good idea to run this more than once or twice.

dfusion

This is the DFusion lua plugin system by Warmist, running as a DFHack plugin. There are two parts to this plugin: an interactive script that shows a text based menu and lua modules. Some of the functionality of is intentionaly left out of the menu:

See the bay12 thread for details: http://www.bay12forums.com/smf/index.php?topic=93317.0

embark-tools

A collection of embark-related tools.

Usage:

embark-tools enable/disable tool [tool]...

Tools:

• anywhere: Allows embarking anywhere (including sites, mountain-only biomes, and oceans). Use with caution.
• nano: An implementation of nano embark - allows resizing below 2x2 when enabled.
• sand: Displays an indicator when sand is present in the currently-selected area, similar to the default clay/stone indicators.
• sticky: Maintains the selected local area while navigating the world map

petcapRemover

This plugin allows you to remove or raise the pet population cap. In vanilla DF, pets will not reproduce unless the population is below 50 and the number of children of that species is below a certain percentage. This plugin allows removing the second restriction and removing or raising the first. Pets still require PET or PET_EXOTIC tags in order to reproduce. Type help petcapRemover for exact usage. In order to make population more stable and avoid sudden population booms as you go below the raised population cap, this plugin counts pregnancies toward the new population cap. It can still go over, but only in the case of multiple births.

petcapRemover

cause pregnancies now and schedule the next check

petcapRemover every n

set how often in ticks the plugin checks for possible pregnancies

petcapRemover cap n

set the new cap to n. if n = 0, no cap

petcapRemover pregtime n

sets the pregnancy duration to n ticks. natural pregnancies are 300000 ticks for the current race and 200000 for everyone else

misery

When enabled, every new negative dwarven thought will be multiplied by a factor (2 by default).

Usage:

strangemood

Creates a strange mood job the same way the game itself normally does it.

Options:

Known limitations: if the selected unit is currently performing a job, the mood will not be started.

log-region

When enabled in dfhack.init, each time a fort is loaded identifying information will be written to the gamelog. Assists in parsing the file if you switch between forts, and adds information for story-building.

Rationale

Siege engines are a very interesting feature, but sadly almost useless in the current state because they haven't been updated since 2D and can only aim in four directions. This is an attempt to bring them more up to date until Toady has time to work on it. Actual improvements, e.g. like making siegers bring their own, are something only Toady can do.

Configuration UI

The configuration front-end to the plugin is implemented by the gui/siege-engine script. Bind it to a key (the example config uses Alt-A) and activate after selecting a siege engine in 'q' mode.

The main mode displays the current target, selected ammo item type, linked stockpiles and the allowed operator skill range. The map tile color is changed to signify if it can be hit by the selected engine: green for fully reachable, blue for out of range, red for blocked, yellow for partially blocked.

Pressing 'r' changes into the target selection mode, which works by highlighting two points with Enter like all designations. When a target area is set, the engine projectiles are aimed at that area, or units within it (this doesn't actually change the original aiming code, instead the projectile trajectory parameters are rewritten as soon as it appears).

After setting the target in this way for one engine, you can 'paste' the same area into others just by pressing 'p' in the main page of this script. The area to paste is kept until you quit DF, or select another area manually.

Pressing 't' switches to a mode for selecting a stockpile to take ammo from.

Exiting from the siege engine script via ESC reverts the view to the state prior to starting the script. Shift-ESC retains the current viewport, and also exits from the 'q' mode to main menu.

Rationale

The vanilla game contains only water wheels and windmills as sources of power, but windmills give relatively little power, and water wheels require flowing water, which must either be a real river and thus immovable and limited in supply, or actually flowing and thus laggy.

Steam engines are an alternative to water reactors that actually makes sense, and hopefully doesn't lag. Also, unlike e.g. animal treadmills, it can be done just by combining existing features of the game engine in a new way with some glue code and a bit of custom logic.

Construction

The workshop needs water as its input, which it takes via a passable floor tile below it, like usual magma workshops do. The magma version also needs magma.

After constructing the building itself, machines can be connected to the edge tiles that look like gear boxes. Their exact position is extracted from the workshop raws.

Operation

In order to operate the engine, queue the Stoke Boiler job (optionally on repeat). A furnace operator will come, possibly bringing a bar of fuel, and perform it. As a result, a "boiling water" item will appear in the 't' view of the workshop.

Every such item gives 100 power, up to a limit of 300 for coal, and 500 for a magma engine. The building can host twice that amount of items to provide longer autonomous running. When the boiler gets filled to capacity, all queued jobs are suspended; once it drops back to 3+1 or 5+1 items, they are re-enabled.

While the engine is providing power, steam is being consumed. The consumption speed includes a fixed 10% waste rate, and the remaining 90% are applied proportionally to the actual load in the machine. With the engine at nominal 300 power with 150 load in the system, it will consume steam for actual 300*(10% + 90%*150/300) = 165 power.

Masterpiece mechanism and chain will decrease the mechanical power drawn by the engine itself from 10 to 5. Masterpiece barrel decreases waste rate by 4%. Masterpiece piston and pipe decrease it by further 4%, and also decrease the whole steam use rate by 10%.

Explosions

The engine must be constructed using barrel, pipe and piston from fire-safe, or in the magma version magma-safe metals.

During operation weak parts get gradually worn out, and eventually the engine explodes. It should also explode if toppled during operation by a building destroyer, or a tantruming dwarf.

Save files

It should be safe to load and view engine-using fortresses from a DF version without DFHack installed, except that in such case the engines won't work. However actually making modifications to them, or machines they connect to (including by pulling levers), can easily result in inconsistent state once this plugin is available again. The effects may be as weird as negative power being generated.