Editing Utility:DFHack/scripts

DFHack is an advanced Dwarf Fortress memory access library and a set of tools and scripts using this library, providing direct object-oriented access to Dwarf Fortress's internals as if it were compiled into the game itself. Releases support versions up through 0.34.11 (as of June 22nd, 2012) and some of them have been [http://dwarffortresswiki.org/User:Quietust#DFHack-40d backported] to earlier versions. It runs on Windows, Linux, and MacOS X. As of July 4th, the latest version is [http://www.bay12forums.com/smf/index.php?topic=139553 r5].

Originally a simple memory hacking tool, DFHack has grown to become a full-fledged unofficial extension of the game itself, adding in functionality where official development has lacked. Due to its open-source and collaborative nature, anyone can add their own contribution to this tool. There are different kinds of contributions:
*Binpatches are raw memory edits that alter the game's behavior, which is usually deduced from disassembling. Their main use is bugfixing or the removal of cumbersome, easily alterable constraints. They can be found in the hack/patches folder. 
*Plugins are snippets of C++ code that uses DFHack's library to fix bugs or add functionality. They must be compiled before use and are thus platform and dfhack-version dependent. They can be found in the hack/plugins folder.
*Scripts are files written in a scripting language (usually Lua or Ruby) that when loaded by DFHack fix bugs or add functionality. Contrary to plugins, they are not compiled and can be transferred between any platform. However any change within the DFHack data structures (between versions) may break some of these scripts.

This page's purpose is to provide a comprehensive collection of all the plugins, scripts and binpatches ever written.

*[http://www.bay12forums.com/smf/index.php?topic=137011.msg5076999#msg5076999 announce.lua] - Print an announcement to the screen and the gamelog.
*[https://github.com/jjyg/df-ai/ df-ai] - a script that plays alone in fortress mode.
*[[Utility:DFHack/createitem|createitem]]: Creates arbitrary items made of any material
*[https://gist.github.com/Putnam3145/7005776 force] - Allows forcing of events. Some of them are iffy, some don't work at all. It's mostly functional.
*[https://gist.github.com/Putnam3145/8207480 hackWish] - Use a swanky GUI interface to create an item with any material and quality.
*[https://gist.github.com/Putnam3145/7021922 instant transmission] - Allows teleportation to units in adventure mode by adventurer. Also gives power level readout.
*[https://gist.github.com/Putnam3145/7005730 itemsyndrome] - Allows items to impart syndromes when equipped.
*[https://gist.github.com/Putnam3145/7005768 moddableGods] - Allows custom gods to be added as hist figures. They do nothing as of now. Might do something funny next version, but nobody knows what exactly.
*[http://www.bay12forums.com/smf/index.php?topic=134774.0 Probability Syndrome] - Run AutoSyndrome commands which honour reaction probabilities.
*[https://gist.github.com/Putnam3145/7005764 projectileExpansion] - Allows a lot of stuff related to projectiles, such as explosions, syndrome addition and script running-on-creatures.
*[https://gist.github.com/warmist/8450238 rip-heart] - removes units heart for a better storage (usually kills in process)
*[https://gist.github.com/Putnam3145/7021958 shapechange] - Allows willful polymorph into arbitrary creature with filtering by ID or size.
*[https://gist.github.com/Putnam3145/7839350 skillroll] - Allows for skills to be considered when running Lua scripts. Probability Syndrome is probably better for most purposes.
*[https://gist.github.com/Putnam3145/7035209 take-slave] - Like hire-guard, but with more transformation. Requires a SLAVE caste for currently played race.
*[https://gist.github.com/Putnam3145/7243759 teleport] - Allows simple teleportation of unit to position. Position can be cursor or hardcoded.
*[https://gist.github.com/Devduweb/6409714 trainskill] - Raises the skill level of an unit.
*[https://gist.github.com/Devduweb/6350270 fovcommand] - Executes a dfhack command on targets within the line of sight of an unit.
*[https://gist.github.com/Devduweb/6323075 callsiege] - Causes a random siege, you can set a probability for this to happen.
*[https://gist.github.com/Devduweb/6210329 naturalSkills] - Make sure creatures have their natural skills.
*[http://www.bay12forums.com/smf/index.php?topic=135506.msg4925005#msg4925005 dwarves and points] - Allows to pick any number of embark dwarves and points.
*[https://gist.github.com/IndigoFenix/8543661 construct-creature] - Allows you to construct creatures with reactions that incorporate the reagent materials into the creature's body.  Perfect for robots and golems.
*[https://gist.github.com/IndigoFenix/8543557 slam] - A simple script that slams a creature into the ground at a given velocity.  Can cause targets to explode at high enough values.
*[https://gist.github.com/IndigoFenix/8543616 exile] - Sends units away into the wild. Options include fort members, pets, wild animals, invaders, merchants, and diplomats.
*[https://gist.github.com/IndigoFenix/8776696 hfspit] - Creates a pit under the target leading straight to the underworld.  Instant death to non-fliers.  Very small chance of triggering a demon attack.
*[http://www.bay12forums.com/smf/index.php?topic=135597.0 DFHack spells] - Set of scripts for more complex interaction based spells
*[https://gist.github.com/warmist/8563110 spawn unit] - finally a central place for spawn unit script updates 
*[https://gist.github.com/warmist/8594614 heal unit] - heal units script
*[http://www.bay12forums.com/smf/index.php?topic=137011.msg5077002#msg5077002 rubble_fluids module] - Functions for easy fluid and minecart interaction from Lua code.
*[http://www.bay12forums.com/smf/index.php?topic=137011.msg5077002#msg5077002 rubble_fluids command] - Test driver and autoSyndrome command for the rubble_fluids module.
*[http://www.bay12forums.com/smf/index.php?topic=136725.0 whosout] - lists any dorfs who are not in any of the burrows passed as arguments.
*[http://www.bay12forums.com/smf/index.php?topic=136975.0 show-cursed] - list assumed name of any cursed dorfs
*[http://www.bay12forums.com/smf/index.php?topic=136749.0 show-dfhack-version] - outputs dfhack release to the console (put it in your dfhack.init)
*[http://www.bay12forums.com/smf/index.php?topic=136748.msg5045463#msg5045463 show-speeds] - Shows current speed and encumbrance for each citizen.
*[http://www.bay12forums.com/smf/index.php?topic=128487.0 Rendermax], a plugin that implements a lighting system at the graphics level.
*[http://www.bay12forums.com/smf/index.php?topic=136155.0 Dwarven Emigration], a plugin that allows unhappy dwarves to emigrate with their families.