- v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
- Use this page to report any issues related to the migration.
Difference between revisions of "Utility:DFHack"
(→Scripts and Plugins: add scripts section/link to createitem, fix headings) |
|||
| Line 29: | Line 29: | ||
One of the best features of DFHack is it's extensibility - anyone can create scripts or plugins. Some of the more notable are listed below; feel free to add to the list. | One of the best features of DFHack is it's extensibility - anyone can create scripts or plugins. Some of the more notable are listed below; feel free to add to the list. | ||
| − | + | === User Interface === | |
The best-known are [http://www.bay12forums.com/smf/index.php?topic=119575 Falconne's UI Plugins], a collection which improves the in-game interface with features such as search functions in screens with big lists, the ability to place furniture before it's built and have it automatically allocated when available, box-select constructions(like laying designations) - including easier material selection and open space placement, easier pasturing, live happiness monitor, '''mouse support''', and an enhanced stocks screen. The plugins make existing tasks significantly easier, and also add new functions to the game which greatly enhance the experience - such as the autochop log quotas, or the ability (with buildingplanner) to lay out rooms with Quickfort before creating the required furniture. | The best-known are [http://www.bay12forums.com/smf/index.php?topic=119575 Falconne's UI Plugins], a collection which improves the in-game interface with features such as search functions in screens with big lists, the ability to place furniture before it's built and have it automatically allocated when available, box-select constructions(like laying designations) - including easier material selection and open space placement, easier pasturing, live happiness monitor, '''mouse support''', and an enhanced stocks screen. The plugins make existing tasks significantly easier, and also add new functions to the game which greatly enhance the experience - such as the autochop log quotas, or the ability (with buildingplanner) to lay out rooms with Quickfort before creating the required furniture. | ||
| Line 35: | Line 35: | ||
There is also a [http://www.bay12forums.com/smf/index.php?topic=124708 GUI for the Autobutcher plugin]. | There is also a [http://www.bay12forums.com/smf/index.php?topic=124708 GUI for the Autobutcher plugin]. | ||
| − | + | === Bugfixing === | |
| − | Many bugfixes are included with DFHack, but not enabled by default - check dfhack.init to see if the tweak-* and fix/* lines are commented out. | + | Many bugfixes are included with DFHack, but not enabled by default - check dfhack.init to see if the tweak-* and fix/* lines are commented out. The [[Utility:Lazy_Newb_Pack|Starter Packs]] enable all bugfixes by default. |
The [http://www.bay12forums.com/smf/index.php?topic=126558 growth bug] is not fixed by DFHack by default, and can be patched with either a [http://dffd.wimbli.com/file.php?id=7849 plugin] (windows) or a [http://www.bay12forums.com/smf/index.php?topic=91166.msg4313566#msg4313566 script] (any platform). | The [http://www.bay12forums.com/smf/index.php?topic=126558 growth bug] is not fixed by DFHack by default, and can be patched with either a [http://dffd.wimbli.com/file.php?id=7849 plugin] (windows) or a [http://www.bay12forums.com/smf/index.php?topic=91166.msg4313566#msg4313566 script] (any platform). | ||
| − | + | === Features === | |
| − | These plugins add features to the game, and are mostly used by modders. | + | These plugins and scripts add features to the game, and are mostly used by modders. |
* [http://www.bay12forums.com/smf/index.php?topic=127116 Digging invaders], a plugin that allows hostiles to dig and deconstruct walls to path to one's fortress. | * [http://www.bay12forums.com/smf/index.php?topic=127116 Digging invaders], a plugin that allows hostiles to dig and deconstruct walls to path to one's fortress. | ||
* [http://www.bay12forums.com/smf/index.php?topic=128487 Rendermax], a plugin that implements a lighting system at the graphics level. | * [http://www.bay12forums.com/smf/index.php?topic=128487 Rendermax], a plugin that implements a lighting system at the graphics level. | ||
| Line 47: | Line 47: | ||
* [http://www.bay12forums.com/smf/index.php?topic=135597 DFHack scripts designed for use in interactions as "spells"] | * [http://www.bay12forums.com/smf/index.php?topic=135597 DFHack scripts designed for use in interactions as "spells"] | ||
* [http://www.bay12forums.com/smf/index.php?topic=135506 Miscellaneous DFHack script collection] | * [http://www.bay12forums.com/smf/index.php?topic=135506 Miscellaneous DFHack script collection] | ||
| + | |||
| + | === Plugins and scripts === | ||
| + | DFHack includes numerous plugins and scripts, covered in the [https://github.com/DFHack/dfhack/blob/master/Readme.rst Readme]. The following plugins are also covered on this wiki: | ||
| + | * [[/createitem/]]: Creates arbitrary items made of any material at the feet of a unit | ||
Revision as of 17:56, 3 May 2014
DFHack is an extensive standardized memory access library, packaged alongside a suite of basic tools that use it. Currently tools come in the form of plugins; external application is a planned feature for the future. For developers, DFHack is a comprehensive, standardized memory access package that unites the various ways tools access the Dwarf Fortress memory space, allowing for easier development of new tools. For users, it is a very useful utility complex that allows users to tweak their games in numerous ways in-game. This is probably one of the most useful and most-used utilities for the game, after Dwarf Therapist and the tilesets, and is included in recent versions of the Lazy Newb Pack on all platforms.
For an exhaustive list of and manual on the commands in the utility, see the GitHub documentation. This wiki also has a DFHack programming page.
If you are using DFHack, do not report bugs on the Dwarf Fortress bug tracker unless you can prove that the bug is not being caused by DFHack or one of its plugins.
Installation
If you use a recent edition of the Lazy Newb Pack, DFHack is already installed and configured; otherwise see the instructions on the Bay12 forum thread for separate installation. The project is currently hosted on GitHub; for source, binaries, and a detailed discussion of how the program works, see here. All new releases are announced in a thread on the Bay12 forums. DFHack works on Windows XP, Vista, 7, any modern Linux distribution, and OS X 10.6 and later. On Windows, you have to use the SDL version of DF. Currently, version 0.34.11 is supported (and tested). If you need DFHack for older versions, look for older releases.
DFHack is currently also being ported to Dwarf Fortress versions 0.28.181.40d and 0.23.130.23a - more information can be found here and here, respectively.
Common Uses
DFHack is often used to automate some aspects of Fortress Mode, or to make a specific one-off change.
Automation
See: workflow, autolabor, autobutcher, autochop, autonestbox, seedwatch, df-ai, dwarf manipulator.
One-off changes
Includes commands like "cleanowned scattered x" or "reveal".
Additional features
Steam engines, power meter, improved siege engines.
Stonesense
DFHack comes with Stonesense by default (except for unofficial r4 builds).
Scripts and Plugins
One of the best features of DFHack is it's extensibility - anyone can create scripts or plugins. Some of the more notable are listed below; feel free to add to the list.
User Interface
The best-known are Falconne's UI Plugins, a collection which improves the in-game interface with features such as search functions in screens with big lists, the ability to place furniture before it's built and have it automatically allocated when available, box-select constructions(like laying designations) - including easier material selection and open space placement, easier pasturing, live happiness monitor, mouse support, and an enhanced stocks screen. The plugins make existing tasks significantly easier, and also add new functions to the game which greatly enhance the experience - such as the autochop log quotas, or the ability (with buildingplanner) to lay out rooms with Quickfort before creating the required furniture.
There is also a GUI for the Autobutcher plugin.
Bugfixing
Many bugfixes are included with DFHack, but not enabled by default - check dfhack.init to see if the tweak-* and fix/* lines are commented out. The Starter Packs enable all bugfixes by default.
The growth bug is not fixed by DFHack by default, and can be patched with either a plugin (windows) or a script (any platform).
Features
These plugins and scripts add features to the game, and are mostly used by modders.
- Digging invaders, a plugin that allows hostiles to dig and deconstruct walls to path to one's fortress.
- Rendermax, a plugin that implements a lighting system at the graphics level.
- Dwarven Emigration, a plugin that allows unhappy dwarves to emigrate with their families.
- DFHack scripts designed for use in interactions as "spells"
- Miscellaneous DFHack script collection
Plugins and scripts
DFHack includes numerous plugins and scripts, covered in the Readme. The following plugins are also covered on this wiki:
- createitem: Creates arbitrary items made of any material at the feet of a unit