Dwarf Fortress Wiki - User contributions [en]

Quickfort Community Blueprints

2010-11-22T21:59:27Z

Joelpt:

Below is a list of Quickfort-compatible blueprints created by Dwarf Fortress community members.

Feel free to add your own contributions. Multifile blueprint sets should be packaged as a .zip file.

*NOTE: After creating this page I realized you cannot upload .csv or .zip files here.

Quickfort Community Blueprints

2010-11-22T21:59:15Z

Joelpt:

v0.31:Utilities

2010-11-22T21:58:08Z

Joelpt: /* Quickfort */

{{AV}}
{{Quality|Exceptional}}
Please only list utilities that are known to work with the newest version here.

Here are third party applications useful for Dwarf Fortress.
__TOC__

==Dwarf Fortress filesharing services==

=== [http://dffd.wimbli.com/ Dwarf Fortress File Depot] ===
The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of [[User:Janus|Janus]]; for files related to Dwarf Fortress only.

=== [http://mkv25.net/dfma/ DF Map Archive] ===

* http://mkv25.net/dfma/

The Dwarf Fortress Map Archive is a large collection of user-submitted maps and a nice flash viewer for perusing them.
Maps are uploaded, stored, and downloaded in a special compressed format created by the DF Map Compressor (see below).

Read more about the [[User:Markavian/DF_Map_Archive|DF Map Archive]] on [[User:Markavian|Markavian]]'s User page.

=== DF Map Compressor ===

*[http://shadowlord13.googlepages.com/dfmap-index.html SL's DF Map Compressor - Website] (currently not accessible)
*Download from [http://dffd.wimbli.com/file.php?id=997 DF File Depot]

The DF Map Compressor encodes multiple bitmaps exported from Dwarf Fortress into a single, very compressed, .fdf-map file, and functions as a viewer for this format. It can also export the maps to PNG format.

The .fdf-map file can then be shared with your friends by uploading to the [http://mkv25.net/dfma/ DF Map Archive] that features an online viewer (written in Flash).

The map compressor was created by Shadowlord in May 2007. The web site is currently not accessible. Extract from the website :
<blockquote>
"The '''DF Map Compressor''' is a program I made to encode Dwarf Fortress fortress or world map images into a much smaller format than is possible with normal image formats. Here's a quick summary of how it works: It determines the size of your tiles from your DF font file (or asks you), splits the map up into tiles, identifies duplicate tiles, writes out every unique tile image, and then writes out a list of ID#s for each tile position which points to the tile image for that tile. What it outputs is piped through the LZMA compressor (the one used in 7-zip), to compress it further. The .df-map file which it writes out is usually less than 100 KB in size. (By comparison, a PNG of the same map can exceed 2 megabytes, depending on how well you compress it, whether you change the color depth, and whether you are using a graphical tileset or detailed font)."
</blockquote>

There is a little bit of information at the [http://dffd.wimbli.com/file.php?id=997 DF File Depot] page, where the compressor can be downloaded:
<blockquote>
"It requires either .NET 2.0 or newer (If you have Windows Vista, you already have this, if not, you might need to get it), or if you're on Linux or a Mac or other non-Windows OS, requires Mono.
* .NET 2.0: http://www.microsoft.com/downloads/details.aspx?familyid=0856eacb-4362-4b0d-8edd-aab15c5e04f5
* Mono: http://www.mono-project.com/"
</blockquote>

To get it working on OSX, according to [http://www.bay12forums.com/smf/index.php?topic=64174.msg1511109#msg1511109 this forum post]:
:1. [http://www.go-mono.com/mono-downloads/ download the Mono Framework] and install it. If you're on a modern Mac, you want the [http://ftp.novell.com/pub/mono/archive/2.8.1/macos-10-x86/3/MonoFramework-2.8.1_3.macos10.novell.x86.dmg latest Intel version], which requires OSX 10.5 or 10.6. [http://www.mono-project.com/OldReleases Older versions are available] but no longer supported.
:2. export your map from Dwarf Fortress (Esc -> Export Local Image)
:3. download the [http://dffd.wimbli.com/file.php?id=997 DF Map Compressor from the DF File Depot].
:4. open the terminal, navigate to the DF Map Compressor folder and type:
mono DwarfFortressMapCompressor.3.3.4.exe
:5. WAIT a bit for the DF Map Compressor windows to appear (''I almost thought it had crashed, it's rather slow'')
:6. follow the on screen instructions

== 3D Visualizers ==

=== [[Utility:Stonesense|Stonesense]] ===
[[File:stonesense.jpg|208px|thumb|right|Stonesense Screenshot]]
''by Jonask, Solifuge, Kaypy and Japa''

Stonesense is a third party real-time visualizer that lets you view your Dwarf Fortress world in a classic isometric perspective.

More information is available in [http://www.bay12games.com/forum/index.php?topic=43260.0 this forum thread].

Stonesense is now in version 2.1 Slate, supports v0.31.12 - [http://stonesense.googlecode.com/files/Stonesense_Slate_2.1.zip Download]

=== [[Utility:Overseer|Fortress Overseer]] ===
''by thewonderidiot and sexymustard''

Overseer is a full 3D visualizer for DF2010 using the DFHack library. Its appearance is highly customizable and will be even more so in the near future. Check out its [http://www.bay12forums.com/smf/index.php?topic=63484.0 forum thread] for more details or download it from [http://dffd.wimbli.com/file.php?id=2922 here].

== Interface tools ==

===[http://www.bay12games.com/forum/index.php?topic=50643.0 Dfterm2]===

Dfterm2 is a tool to run Dwarf Fortress via terminals remotely. Multiple people can connect and watch or join in.

Main article here: [[Dfterm2]].

== Game manipulation tools ==

=== [http://dffd.wimbli.com/file.php?id=645 Reveal] ===

The standalone Reveal utility is obsolete due to missing source code. [[DF2010:Utilities#DFHack|DFHack]]'s dfreveal module works like Reveal did, and has built-in undo capability.

Reveal (or Reveal.exe as it is commonly referred to) is a program that runs alongside Dwarf Fortress and shows all "unexplored" or "undug" tiles of the map (in fortress mode). To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal (Not required in the latest version using the parameters below, simply start the .exe file.). Playing on revealed map might ''(read "will")'' cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, and a lot more). '''Using Reveal has been known to corrupt saved game folders.''' and, as such, it is highly recommended to only use Reveal to preview a biome's layout and then restart without running Reveal.


===[http://www.bay12forums.com/smf/index.php?topic=66525 Dwarf Therapist]===

Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments (40d), statistics (such as attributes, personality traits and happiness), plus sort dwarves by various criteria (eg. profession, migration wave, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 0.6.4 is out (October 4, 2010). This version supports DF builds up to 0.31.16.

''NOTE'': This project is currently seeking a new maintainer.

New dedicated support forum: http://code.google.com/p/dwarftherapist/

Read the full changelog here: http://code.google.com/p/dwarftherapist/source/browse/CHANGELOG.txt



Instruction for making it work with new versions here: http://code.google.com/p/dwarftherapist/wiki/MappingNewVersions This page also tends to have the new addresses within an hour or two of new releases of Dwarf Fortress.

=== [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] ===
Runesmith is a Dwarf information viewing and editing tool inspired by the original Dwarf Companion. It uses the DFHack library to interface with Dwarf Fortress and Qt to provide a robust and professional looking cross-platform GUI. http://www.bay12forums.com/smf/index.php?topic=59056.0

Version 0.1.7 is out for Windows, currently supporting 0.31.16. Since it uses DFHack, all versions of DF that DFHack supports, Runesmith supports!

* Windows: http://dffd.wimbli.com/file.php?id=2538
* Linux: to follow (the windows one is reported to work fine under wine though)

"A tool that allows smithing (editing) of the digits and runes (letters) that control all life in DF. By smithing these runes, the metagods (players) can meddle with DF mortals to suit their games, be it recasting a soul into a new species body, blessing and cursing indiviudals or just to make predictions of when a mortal will attain the next degree of competence to guide them on how they should spend their limited time." - Psieye - (http://www.bay12forums.com/smf/index.php?topic=57003.msg1324765#msg1324765)

=== [http://www.bay12forums.com/smf/index.php?topic=58809 DFHack] ===

DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.5.0.2) release only supports versions 0.31.01 - 0.31.03 Legacy, 0.31.04 - 0.31.16 SDL, and 0.31.05 - 0.31.14 on Linux. It consists of some of the more useful DFHack tools.

Code and binary releases are available from the [http://github.com/peterix/dfhack/downloads Github site].

=== DFhack tools for DF 2010 ===
==== dfcleanmap ====
Cleans all the bloodsmears that get scattered all over the map.
==== dfliquids ====
Allows creating liquids (water and magma), making them flow or preventing them from flowing. Newly also allows making obsidian walls. It's a command-prompt style utility where you type in very simple commands. Replaces the older magma_create tool.

Use like this:

game: place 'k' cursor on the tile or on the upper left corner of the area to manipulate.

tool: enter 'range' in the tool and specify width and height of the rectangle.

- remove water

'w'
'0'
's-'
<ENTER>

- create obsidian wall (only works for a single tile, even if a range is specified)

'o'
'1'
's.'
<ENTER>

note that previously existing water or magma still stays at this spot.

- create magma

'm'
'7'
's+'
<ENTER>

==== dfprospector ====
Lists all available minerals on the map and how much of them there is.
==== dfreveal ====
Pauses the game and reveals the whole map, then unreveals it afterwards (unless you press Ctrl+C). Use with caution, releases [[HFS]]! Same warnings as to the original Reveal tool apply.

==== dfvdig ====
Designates a whole vein for digging. When using the '-x' option, it will dig stairs into other z-levels. Point the cursor at a vein and run this thing :)

=== [[Utility:DwarfForeman|Dwarf Foreman]] ===
Dwarf Foreman is a third party program to automatically dispatch jobs to your workers.

=== [[Utility:DwarfScript|Dwarf Script]] ===
Dwarf Script is a program and allows you to manipulate DF's memory using a script.

== Fortress layout tools ==

=== [http://sun2design.com/quickfort/ Quickfort] ===

Quickfort is an AutoHotkey-based utility for Dwarf Fortress that helps you build fortresses from "blueprint" .CSV files (comma separated values). These files are easily created and edited in an app like Excel. Most building-oriented DF commands are supported through the use of multiple .CSV files to describe the different phases of DF construction (designation, building, stockpiles, and making adjustments.

=== [[User:Soundandfury/DF_Designer|DF Designer]] ===
DF Designer, by [[User:Soundandfury|soundnfury]] is a fort layout planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and both Linux and Windows builds are available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent. Supports exporting to Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=55025.0 ChromaFort] ===
Chromafort allows you to convert 24-bit bitmap (.bmp) images into Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=64723.15 DF Architect] ===
DF Architect is a short cut to using Chromafort in conjunction with DF Designer. It uses 24-bit bitmap files and directly designates them into Dwarf Fortress. It is an early release program and currently only supports digging, stairs (up, down, and both), and ramps. Its defining feature is the use of an 'index' which allows for the designer to visually connect the cursor to the image. Be careful when using this program as it had no abort or terminating ability while designating, nor will it check to see if you've uploaded correct formats.

=== [http://www.irritablegourmet.com/dwarf/index.htm Quickfort Mapping Tool] ===
Quickfort Mapping Tool is a simple to use web app for creating Quickfort blueprints graphically.

== Modding tools ==

=== [http://dffd.wimbli.com/file.php?id=2068 Custom Workshop Workshop] ===
WYSIWYG editor for designing the raws for a custom workshop.
(Not all raws, just the tiles and colors) Lets you see how it will look at each stage of construction. Comes with the default 16x16 CURSES font built in, but you can load any .BMP formatted DF font you like, keeping in mind that if its bigger than 16x16 it won't fit.

Accommodates up to 32x32 workshops, not that there's any reason for such a large workshop, right?

=== [http://dffd.wimbli.com/file.php?id=1996 Uristmod] ===
A program which uses text files to automatically change/update raw files. Makes installation of mods easier. However at this time, the documentation is a little confusing and makes creating mods harder for beginners. [http://www.bay12forums.com/smf/index.php?topic=53028.0 Forum Thread]

=== [http://dffd.wimbli.com/file.php?id=2088 Accent replacement tool] ===
A small application to remove accented characters from a file. A quick solution if you need the language files for a tileset that has images in place of special characters.
Alternatively, you can use this 20-line perl script: http://github.com/rofl0r/df-mayday/blob/master/charfix.pl

== Raw tile tools ==

=== [[Raw tile selector]] ===

Provides an easy to use graphical interface to select which tiles and colors should be displayed for plants, stones and small creatures.

Made to ease the job of creators of tilesets with edited raws. It will also be useful for users that dislike decisions made by tileset creators or users that could not find the edited raws for a tileset.

[http://dffd.wimbli.com/file.php?id=2113 Download]

Currently for windows only.

=== Raw tile merger ===
Provides an easy to use interface to change the tile and color data of raws to match the data of another set of raw files.

Made to ease the job of creators of tilesets with edited raws when new versions of df are released. The edited raws for your tileset for a new df version can now be created with a few clicks.

[http://dffd.wimbli.com/file.php?id=2178 Download]

== World Map / World Gen Tools ==

=== [http://www.bay12forums.com/smf/index.php?topic=57428 PerfectWorldDF] ===
Very detailed Windows program to help create customize world gens.
 [http://www.bay12forums.com/smf/index.php?topic=57428 Bay 12 forum link]
 [http://dffd.wimbli.com/file.php?id=2354 Dwarf Fortress File Depot link (may be old version)]
 [http://dffd.wimbli.com/who.php?id=1314 Dwarf Fortress File Depot listing for the author]

== Other/miscellaneous ==

=== [http://winmerge.org/ WinMerge] ===
Winmerge allows you to compare the contents of folders or files. It highlights any differences between files and allows you to merge them. It is most useful for modders or users of mods. If you compare modified raw files with unmodified ones you can quickly see any differences.

= Tools under development =

'''The tools listed below are under development for DF 2010, but cannot perform the task they are intended for at this time.'''

=== [[Utility:Obsidian|Obsidian]] ===
''by Skeggox''

Obsidian is a toolset for converting DF maps into a renderable scene, manipulating the result, and displaying it directly in 3D or exporting to 3rd party renderers and raytracers.

Its a modular Lua framework, using Open Scene Graph for rendering and DFHack for talking with Dwarf Fortress.

This [http://www.bay12forums.com/smf/index.php?topic=57920.0 forum thread] has more detail.

Quickfort Community Blueprints

2010-11-22T21:56:18Z

Joelpt:

Below is a list of Quickfort-compatible blueprints created by Dwarf Fortress community members.

Feel free to add your own contributions. Multifile blueprint sets should be packaged as a .zip file.

Quickfort Community Blueprints

2010-11-22T21:56:02Z

Joelpt: Created page with 'Below is a list of Quickfort-compatible blueprints created by Dwarf Fortress community members. Feel free to add your own contributions. Multifile blueprint sets should be packag…'

Below is a list of Quickfort-compatible blueprints created by Dwarf Fortress community members. Feel free to add your own contributions. Multifile blueprint sets should be packaged as a .zip file.

v0.31:Utilities

2010-11-22T21:53:10Z

Joelpt: /* Fortress layout tools */

{{AV}}
{{Quality|Exceptional}}
Please only list utilities that are known to work with the newest version here.

Here are third party applications useful for Dwarf Fortress.
__TOC__

==Dwarf Fortress filesharing services==

=== [http://dffd.wimbli.com/ Dwarf Fortress File Depot] ===
The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of [[User:Janus|Janus]]; for files related to Dwarf Fortress only.

=== [http://mkv25.net/dfma/ DF Map Archive] ===

* http://mkv25.net/dfma/

The Dwarf Fortress Map Archive is a large collection of user-submitted maps and a nice flash viewer for perusing them.
Maps are uploaded, stored, and downloaded in a special compressed format created by the DF Map Compressor (see below).

Read more about the [[User:Markavian/DF_Map_Archive|DF Map Archive]] on [[User:Markavian|Markavian]]'s User page.

=== DF Map Compressor ===

*[http://shadowlord13.googlepages.com/dfmap-index.html SL's DF Map Compressor - Website] (currently not accessible)
*Download from [http://dffd.wimbli.com/file.php?id=997 DF File Depot]

The DF Map Compressor encodes multiple bitmaps exported from Dwarf Fortress into a single, very compressed, .fdf-map file, and functions as a viewer for this format. It can also export the maps to PNG format.

The .fdf-map file can then be shared with your friends by uploading to the [http://mkv25.net/dfma/ DF Map Archive] that features an online viewer (written in Flash).

The map compressor was created by Shadowlord in May 2007. The web site is currently not accessible. Extract from the website :
<blockquote>
"The '''DF Map Compressor''' is a program I made to encode Dwarf Fortress fortress or world map images into a much smaller format than is possible with normal image formats. Here's a quick summary of how it works: It determines the size of your tiles from your DF font file (or asks you), splits the map up into tiles, identifies duplicate tiles, writes out every unique tile image, and then writes out a list of ID#s for each tile position which points to the tile image for that tile. What it outputs is piped through the LZMA compressor (the one used in 7-zip), to compress it further. The .df-map file which it writes out is usually less than 100 KB in size. (By comparison, a PNG of the same map can exceed 2 megabytes, depending on how well you compress it, whether you change the color depth, and whether you are using a graphical tileset or detailed font)."
</blockquote>

There is a little bit of information at the [http://dffd.wimbli.com/file.php?id=997 DF File Depot] page, where the compressor can be downloaded:
<blockquote>
"It requires either .NET 2.0 or newer (If you have Windows Vista, you already have this, if not, you might need to get it), or if you're on Linux or a Mac or other non-Windows OS, requires Mono.
* .NET 2.0: http://www.microsoft.com/downloads/details.aspx?familyid=0856eacb-4362-4b0d-8edd-aab15c5e04f5
* Mono: http://www.mono-project.com/"
</blockquote>

To get it working on OSX, according to [http://www.bay12forums.com/smf/index.php?topic=64174.msg1511109#msg1511109 this forum post]:
:1. [http://www.go-mono.com/mono-downloads/ download the Mono Framework] and install it. If you're on a modern Mac, you want the [http://ftp.novell.com/pub/mono/archive/2.8.1/macos-10-x86/3/MonoFramework-2.8.1_3.macos10.novell.x86.dmg latest Intel version], which requires OSX 10.5 or 10.6. [http://www.mono-project.com/OldReleases Older versions are available] but no longer supported.
:2. export your map from Dwarf Fortress (Esc -> Export Local Image)
:3. download the [http://dffd.wimbli.com/file.php?id=997 DF Map Compressor from the DF File Depot].
:4. open the terminal, navigate to the DF Map Compressor folder and type:
mono DwarfFortressMapCompressor.3.3.4.exe
:5. WAIT a bit for the DF Map Compressor windows to appear (''I almost thought it had crashed, it's rather slow'')
:6. follow the on screen instructions

== 3D Visualizers ==

=== [[Utility:Stonesense|Stonesense]] ===
[[File:stonesense.jpg|208px|thumb|right|Stonesense Screenshot]]
''by Jonask, Solifuge, Kaypy and Japa''

Stonesense is a third party real-time visualizer that lets you view your Dwarf Fortress world in a classic isometric perspective.

More information is available in [http://www.bay12games.com/forum/index.php?topic=43260.0 this forum thread].

Stonesense is now in version 2.1 Slate, supports v0.31.12 - [http://stonesense.googlecode.com/files/Stonesense_Slate_2.1.zip Download]

=== [[Utility:Overseer|Fortress Overseer]] ===
''by thewonderidiot and sexymustard''

Overseer is a full 3D visualizer for DF2010 using the DFHack library. Its appearance is highly customizable and will be even more so in the near future. Check out its [http://www.bay12forums.com/smf/index.php?topic=63484.0 forum thread] for more details or download it from [http://dffd.wimbli.com/file.php?id=2922 here].

== Interface tools ==

===[http://www.bay12games.com/forum/index.php?topic=50643.0 Dfterm2]===

Dfterm2 is a tool to run Dwarf Fortress via terminals remotely. Multiple people can connect and watch or join in.

Main article here: [[Dfterm2]].

== Game manipulation tools ==

=== [http://dffd.wimbli.com/file.php?id=645 Reveal] ===

The standalone Reveal utility is obsolete due to missing source code. [[DF2010:Utilities#DFHack|DFHack]]'s dfreveal module works like Reveal did, and has built-in undo capability.

Reveal (or Reveal.exe as it is commonly referred to) is a program that runs alongside Dwarf Fortress and shows all "unexplored" or "undug" tiles of the map (in fortress mode). To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal (Not required in the latest version using the parameters below, simply start the .exe file.). Playing on revealed map might ''(read "will")'' cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, and a lot more). '''Using Reveal has been known to corrupt saved game folders.''' and, as such, it is highly recommended to only use Reveal to preview a biome's layout and then restart without running Reveal.


===[http://www.bay12forums.com/smf/index.php?topic=66525 Dwarf Therapist]===

Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments (40d), statistics (such as attributes, personality traits and happiness), plus sort dwarves by various criteria (eg. profession, migration wave, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 0.6.4 is out (October 4, 2010). This version supports DF builds up to 0.31.16.

''NOTE'': This project is currently seeking a new maintainer.

New dedicated support forum: http://code.google.com/p/dwarftherapist/

Read the full changelog here: http://code.google.com/p/dwarftherapist/source/browse/CHANGELOG.txt



Instruction for making it work with new versions here: http://code.google.com/p/dwarftherapist/wiki/MappingNewVersions This page also tends to have the new addresses within an hour or two of new releases of Dwarf Fortress.

=== [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] ===
Runesmith is a Dwarf information viewing and editing tool inspired by the original Dwarf Companion. It uses the DFHack library to interface with Dwarf Fortress and Qt to provide a robust and professional looking cross-platform GUI. http://www.bay12forums.com/smf/index.php?topic=59056.0

Version 0.1.7 is out for Windows, currently supporting 0.31.16. Since it uses DFHack, all versions of DF that DFHack supports, Runesmith supports!

* Windows: http://dffd.wimbli.com/file.php?id=2538
* Linux: to follow (the windows one is reported to work fine under wine though)

"A tool that allows smithing (editing) of the digits and runes (letters) that control all life in DF. By smithing these runes, the metagods (players) can meddle with DF mortals to suit their games, be it recasting a soul into a new species body, blessing and cursing indiviudals or just to make predictions of when a mortal will attain the next degree of competence to guide them on how they should spend their limited time." - Psieye - (http://www.bay12forums.com/smf/index.php?topic=57003.msg1324765#msg1324765)

=== [http://www.bay12forums.com/smf/index.php?topic=58809 DFHack] ===

DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.5.0.2) release only supports versions 0.31.01 - 0.31.03 Legacy, 0.31.04 - 0.31.16 SDL, and 0.31.05 - 0.31.14 on Linux. It consists of some of the more useful DFHack tools.

Code and binary releases are available from the [http://github.com/peterix/dfhack/downloads Github site].

=== DFhack tools for DF 2010 ===
==== dfcleanmap ====
Cleans all the bloodsmears that get scattered all over the map.
==== dfliquids ====
Allows creating liquids (water and magma), making them flow or preventing them from flowing. Newly also allows making obsidian walls. It's a command-prompt style utility where you type in very simple commands. Replaces the older magma_create tool.

Use like this:

game: place 'k' cursor on the tile or on the upper left corner of the area to manipulate.

tool: enter 'range' in the tool and specify width and height of the rectangle.

- remove water

'w'
'0'
's-'
<ENTER>

- create obsidian wall (only works for a single tile, even if a range is specified)

'o'
'1'
's.'
<ENTER>

note that previously existing water or magma still stays at this spot.

- create magma

'm'
'7'
's+'
<ENTER>

==== dfprospector ====
Lists all available minerals on the map and how much of them there is.
==== dfreveal ====
Pauses the game and reveals the whole map, then unreveals it afterwards (unless you press Ctrl+C). Use with caution, releases [[HFS]]! Same warnings as to the original Reveal tool apply.

==== dfvdig ====
Designates a whole vein for digging. When using the '-x' option, it will dig stairs into other z-levels. Point the cursor at a vein and run this thing :)

=== [[Utility:DwarfForeman|Dwarf Foreman]] ===
Dwarf Foreman is a third party program to automatically dispatch jobs to your workers.

=== [[Utility:DwarfScript|Dwarf Script]] ===
Dwarf Script is a program and allows you to manipulate DF's memory using a script.

== Fortress layout tools ==

=== [http://sun2design.com/quickfort/ Quickfort] ===

Quickfort is an AutoHotkey-based utility for Dwarf Fortress that helps you build fortresses from "blueprint" .CSV files (comma separated values). These files are easily created and edited in an app like Excel. Most building-oriented DF commands are supported through the use of multiple .CSV files to describe the different phases of DF construction (designation, building, stockpiles, and making adjustments.

[Community submitted blueprints] are hosted on this Wiki.

=== [[User:Soundandfury/DF_Designer|DF Designer]] ===
DF Designer, by [[User:Soundandfury|soundnfury]] is a fort layout planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and both Linux and Windows builds are available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent. Supports exporting to Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=55025.0 ChromaFort] ===
Chromafort allows you to convert 24-bit bitmap (.bmp) images into Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=64723.15 DF Architect] ===
DF Architect is a short cut to using Chromafort in conjunction with DF Designer. It uses 24-bit bitmap files and directly designates them into Dwarf Fortress. It is an early release program and currently only supports digging, stairs (up, down, and both), and ramps. Its defining feature is the use of an 'index' which allows for the designer to visually connect the cursor to the image. Be careful when using this program as it had no abort or terminating ability while designating, nor will it check to see if you've uploaded correct formats.

=== [http://www.irritablegourmet.com/dwarf/index.htm Quickfort Mapping Tool] ===
Quickfort Mapping Tool is a simple to use web app for creating Quickfort blueprints graphically.

== Modding tools ==

=== [http://dffd.wimbli.com/file.php?id=2068 Custom Workshop Workshop] ===
WYSIWYG editor for designing the raws for a custom workshop.
(Not all raws, just the tiles and colors) Lets you see how it will look at each stage of construction. Comes with the default 16x16 CURSES font built in, but you can load any .BMP formatted DF font you like, keeping in mind that if its bigger than 16x16 it won't fit.

Accommodates up to 32x32 workshops, not that there's any reason for such a large workshop, right?

=== [http://dffd.wimbli.com/file.php?id=1996 Uristmod] ===
A program which uses text files to automatically change/update raw files. Makes installation of mods easier. However at this time, the documentation is a little confusing and makes creating mods harder for beginners. [http://www.bay12forums.com/smf/index.php?topic=53028.0 Forum Thread]

=== [http://dffd.wimbli.com/file.php?id=2088 Accent replacement tool] ===
A small application to remove accented characters from a file. A quick solution if you need the language files for a tileset that has images in place of special characters.
Alternatively, you can use this 20-line perl script: http://github.com/rofl0r/df-mayday/blob/master/charfix.pl

== Raw tile tools ==

=== [[Raw tile selector]] ===

Provides an easy to use graphical interface to select which tiles and colors should be displayed for plants, stones and small creatures.

Made to ease the job of creators of tilesets with edited raws. It will also be useful for users that dislike decisions made by tileset creators or users that could not find the edited raws for a tileset.

[http://dffd.wimbli.com/file.php?id=2113 Download]

Currently for windows only.

=== Raw tile merger ===
Provides an easy to use interface to change the tile and color data of raws to match the data of another set of raw files.

Made to ease the job of creators of tilesets with edited raws when new versions of df are released. The edited raws for your tileset for a new df version can now be created with a few clicks.

[http://dffd.wimbli.com/file.php?id=2178 Download]

== World Map / World Gen Tools ==

=== [http://www.bay12forums.com/smf/index.php?topic=57428 PerfectWorldDF] ===
Very detailed Windows program to help create customize world gens.
 [http://www.bay12forums.com/smf/index.php?topic=57428 Bay 12 forum link]
 [http://dffd.wimbli.com/file.php?id=2354 Dwarf Fortress File Depot link (may be old version)]
 [http://dffd.wimbli.com/who.php?id=1314 Dwarf Fortress File Depot listing for the author]

== Other/miscellaneous ==

=== [http://winmerge.org/ WinMerge] ===
Winmerge allows you to compare the contents of folders or files. It highlights any differences between files and allows you to merge them. It is most useful for modders or users of mods. If you compare modified raw files with unmodified ones you can quickly see any differences.

= Tools under development =

'''The tools listed below are under development for DF 2010, but cannot perform the task they are intended for at this time.'''

=== [[Utility:Obsidian|Obsidian]] ===
''by Skeggox''

Obsidian is a toolset for converting DF maps into a renderable scene, manipulating the result, and displaying it directly in 3D or exporting to 3rd party renderers and raytracers.

Its a modular Lua framework, using Open Scene Graph for rendering and DFHack for talking with Dwarf Fortress.

This [http://www.bay12forums.com/smf/index.php?topic=57920.0 forum thread] has more detail.

v0.31:Utilities

2010-11-22T21:44:33Z

Joelpt: /* Fortress layout tools */

{{AV}}
{{Quality|Exceptional}}
Please only list utilities that are known to work with the newest version here.

Here are third party applications useful for Dwarf Fortress.
__TOC__

==Dwarf Fortress filesharing services==

=== [http://dffd.wimbli.com/ Dwarf Fortress File Depot] ===
The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of [[User:Janus|Janus]]; for files related to Dwarf Fortress only.

=== [http://mkv25.net/dfma/ DF Map Archive] ===

* http://mkv25.net/dfma/

The Dwarf Fortress Map Archive is a large collection of user-submitted maps and a nice flash viewer for perusing them.
Maps are uploaded, stored, and downloaded in a special compressed format created by the DF Map Compressor (see below).

Read more about the [[User:Markavian/DF_Map_Archive|DF Map Archive]] on [[User:Markavian|Markavian]]'s User page.

=== DF Map Compressor ===

*[http://shadowlord13.googlepages.com/dfmap-index.html SL's DF Map Compressor - Website] (currently not accessible)
*Download from [http://dffd.wimbli.com/file.php?id=997 DF File Depot]

The DF Map Compressor encodes multiple bitmaps exported from Dwarf Fortress into a single, very compressed, .fdf-map file, and functions as a viewer for this format. It can also export the maps to PNG format.

The .fdf-map file can then be shared with your friends by uploading to the [http://mkv25.net/dfma/ DF Map Archive] that features an online viewer (written in Flash).

The map compressor was created by Shadowlord in May 2007. The web site is currently not accessible. Extract from the website :
<blockquote>
"The '''DF Map Compressor''' is a program I made to encode Dwarf Fortress fortress or world map images into a much smaller format than is possible with normal image formats. Here's a quick summary of how it works: It determines the size of your tiles from your DF font file (or asks you), splits the map up into tiles, identifies duplicate tiles, writes out every unique tile image, and then writes out a list of ID#s for each tile position which points to the tile image for that tile. What it outputs is piped through the LZMA compressor (the one used in 7-zip), to compress it further. The .df-map file which it writes out is usually less than 100 KB in size. (By comparison, a PNG of the same map can exceed 2 megabytes, depending on how well you compress it, whether you change the color depth, and whether you are using a graphical tileset or detailed font)."
</blockquote>

There is a little bit of information at the [http://dffd.wimbli.com/file.php?id=997 DF File Depot] page, where the compressor can be downloaded:
<blockquote>
"It requires either .NET 2.0 or newer (If you have Windows Vista, you already have this, if not, you might need to get it), or if you're on Linux or a Mac or other non-Windows OS, requires Mono.
* .NET 2.0: http://www.microsoft.com/downloads/details.aspx?familyid=0856eacb-4362-4b0d-8edd-aab15c5e04f5
* Mono: http://www.mono-project.com/"
</blockquote>

To get it working on OSX, according to [http://www.bay12forums.com/smf/index.php?topic=64174.msg1511109#msg1511109 this forum post]:
:1. [http://www.go-mono.com/mono-downloads/ download the Mono Framework] and install it. If you're on a modern Mac, you want the [http://ftp.novell.com/pub/mono/archive/2.8.1/macos-10-x86/3/MonoFramework-2.8.1_3.macos10.novell.x86.dmg latest Intel version], which requires OSX 10.5 or 10.6. [http://www.mono-project.com/OldReleases Older versions are available] but no longer supported.
:2. export your map from Dwarf Fortress (Esc -> Export Local Image)
:3. download the [http://dffd.wimbli.com/file.php?id=997 DF Map Compressor from the DF File Depot].
:4. open the terminal, navigate to the DF Map Compressor folder and type:
mono DwarfFortressMapCompressor.3.3.4.exe
:5. WAIT a bit for the DF Map Compressor windows to appear (''I almost thought it had crashed, it's rather slow'')
:6. follow the on screen instructions

== 3D Visualizers ==

=== [[Utility:Stonesense|Stonesense]] ===
[[File:stonesense.jpg|208px|thumb|right|Stonesense Screenshot]]
''by Jonask, Solifuge, Kaypy and Japa''

Stonesense is a third party real-time visualizer that lets you view your Dwarf Fortress world in a classic isometric perspective.

More information is available in [http://www.bay12games.com/forum/index.php?topic=43260.0 this forum thread].

Stonesense is now in version 2.1 Slate, supports v0.31.12 - [http://stonesense.googlecode.com/files/Stonesense_Slate_2.1.zip Download]

=== [[Utility:Overseer|Fortress Overseer]] ===
''by thewonderidiot and sexymustard''

Overseer is a full 3D visualizer for DF2010 using the DFHack library. Its appearance is highly customizable and will be even more so in the near future. Check out its [http://www.bay12forums.com/smf/index.php?topic=63484.0 forum thread] for more details or download it from [http://dffd.wimbli.com/file.php?id=2922 here].

== Interface tools ==

===[http://www.bay12games.com/forum/index.php?topic=50643.0 Dfterm2]===

Dfterm2 is a tool to run Dwarf Fortress via terminals remotely. Multiple people can connect and watch or join in.

Main article here: [[Dfterm2]].

== Game manipulation tools ==

=== [http://dffd.wimbli.com/file.php?id=645 Reveal] ===

The standalone Reveal utility is obsolete due to missing source code. [[DF2010:Utilities#DFHack|DFHack]]'s dfreveal module works like Reveal did, and has built-in undo capability.

Reveal (or Reveal.exe as it is commonly referred to) is a program that runs alongside Dwarf Fortress and shows all "unexplored" or "undug" tiles of the map (in fortress mode). To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal (Not required in the latest version using the parameters below, simply start the .exe file.). Playing on revealed map might ''(read "will")'' cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, and a lot more). '''Using Reveal has been known to corrupt saved game folders.''' and, as such, it is highly recommended to only use Reveal to preview a biome's layout and then restart without running Reveal.


===[http://www.bay12forums.com/smf/index.php?topic=66525 Dwarf Therapist]===

Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments (40d), statistics (such as attributes, personality traits and happiness), plus sort dwarves by various criteria (eg. profession, migration wave, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 0.6.4 is out (October 4, 2010). This version supports DF builds up to 0.31.16.

''NOTE'': This project is currently seeking a new maintainer.

New dedicated support forum: http://code.google.com/p/dwarftherapist/

Read the full changelog here: http://code.google.com/p/dwarftherapist/source/browse/CHANGELOG.txt



Instruction for making it work with new versions here: http://code.google.com/p/dwarftherapist/wiki/MappingNewVersions This page also tends to have the new addresses within an hour or two of new releases of Dwarf Fortress.

=== [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] ===
Runesmith is a Dwarf information viewing and editing tool inspired by the original Dwarf Companion. It uses the DFHack library to interface with Dwarf Fortress and Qt to provide a robust and professional looking cross-platform GUI. http://www.bay12forums.com/smf/index.php?topic=59056.0

Version 0.1.7 is out for Windows, currently supporting 0.31.16. Since it uses DFHack, all versions of DF that DFHack supports, Runesmith supports!

* Windows: http://dffd.wimbli.com/file.php?id=2538
* Linux: to follow (the windows one is reported to work fine under wine though)

"A tool that allows smithing (editing) of the digits and runes (letters) that control all life in DF. By smithing these runes, the metagods (players) can meddle with DF mortals to suit their games, be it recasting a soul into a new species body, blessing and cursing indiviudals or just to make predictions of when a mortal will attain the next degree of competence to guide them on how they should spend their limited time." - Psieye - (http://www.bay12forums.com/smf/index.php?topic=57003.msg1324765#msg1324765)

=== [http://www.bay12forums.com/smf/index.php?topic=58809 DFHack] ===

DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.5.0.2) release only supports versions 0.31.01 - 0.31.03 Legacy, 0.31.04 - 0.31.16 SDL, and 0.31.05 - 0.31.14 on Linux. It consists of some of the more useful DFHack tools.

Code and binary releases are available from the [http://github.com/peterix/dfhack/downloads Github site].

=== DFhack tools for DF 2010 ===
==== dfcleanmap ====
Cleans all the bloodsmears that get scattered all over the map.
==== dfliquids ====
Allows creating liquids (water and magma), making them flow or preventing them from flowing. Newly also allows making obsidian walls. It's a command-prompt style utility where you type in very simple commands. Replaces the older magma_create tool.

Use like this:

game: place 'k' cursor on the tile or on the upper left corner of the area to manipulate.

tool: enter 'range' in the tool and specify width and height of the rectangle.

- remove water

'w'
'0'
's-'
<ENTER>

- create obsidian wall (only works for a single tile, even if a range is specified)

'o'
'1'
's.'
<ENTER>

note that previously existing water or magma still stays at this spot.

- create magma

'm'
'7'
's+'
<ENTER>

==== dfprospector ====
Lists all available minerals on the map and how much of them there is.
==== dfreveal ====
Pauses the game and reveals the whole map, then unreveals it afterwards (unless you press Ctrl+C). Use with caution, releases [[HFS]]! Same warnings as to the original Reveal tool apply.

==== dfvdig ====
Designates a whole vein for digging. When using the '-x' option, it will dig stairs into other z-levels. Point the cursor at a vein and run this thing :)

=== [[Utility:DwarfForeman|Dwarf Foreman]] ===
Dwarf Foreman is a third party program to automatically dispatch jobs to your workers.

=== [[Utility:DwarfScript|Dwarf Script]] ===
Dwarf Script is a program and allows you to manipulate DF's memory using a script.

== Fortress layout tools ==

=== [http://sun2design.com/quickfort/ Quickfort] ===

Quickfort is an AutoHotkey-based utility for Dwarf Fortress that helps you build fortresses from "blueprint" .CSV files (comma separated values). These files are easily created and edited in an app like Excel. Most building-oriented DF commands are supported through the use of multiple .CSV files to describe the different phases of DF construction (designation, building, stockpiles, and making adjustments.

[Community submitted blueprints] are hosted on this Wiki.

=== [[User:Soundandfury/DF_Designer|DF Designer]] ===
DF Designer, by [[User:Soundandfury|soundnfury]] is a fort layout planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and both Linux and Windows builds are available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent. Supports exporting to Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=55025.0 ChromaFort] ===
Chromafort allows you to convert 24-bit bitmap (.bmp) images into Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=64723.15 DF Architect] ===
DF Architect is a short cut to using Chromafort in conjunction with DF Designer. It uses 24-bit bitmap files and directly designates them into Dwarf Fortress. It is an early release program and currently only supports digging, stairs (up, down, and both), and ramps. Its defining feature is the use of an 'index' which allows for the designer to visually connect the cursor to the image. Be careful when using this program as it had no abort or terminating ability while designating, nor will it check to see if you've uploaded correct formats.

=== [http://www.irritablegourmet.com/dwarf/index.htm|Quickfort Mapping Tool]
Quickfort Mapping Tool is a simple to use web app for creating Quickfort blueprints graphically.

== Modding tools ==

=== [http://dffd.wimbli.com/file.php?id=2068 Custom Workshop Workshop] ===
WYSIWYG editor for designing the raws for a custom workshop.
(Not all raws, just the tiles and colors) Lets you see how it will look at each stage of construction. Comes with the default 16x16 CURSES font built in, but you can load any .BMP formatted DF font you like, keeping in mind that if its bigger than 16x16 it won't fit.

Accommodates up to 32x32 workshops, not that there's any reason for such a large workshop, right?

=== [http://dffd.wimbli.com/file.php?id=1996 Uristmod] ===
A program which uses text files to automatically change/update raw files. Makes installation of mods easier. However at this time, the documentation is a little confusing and makes creating mods harder for beginners. [http://www.bay12forums.com/smf/index.php?topic=53028.0 Forum Thread]

=== [http://dffd.wimbli.com/file.php?id=2088 Accent replacement tool] ===
A small application to remove accented characters from a file. A quick solution if you need the language files for a tileset that has images in place of special characters.
Alternatively, you can use this 20-line perl script: http://github.com/rofl0r/df-mayday/blob/master/charfix.pl

== Raw tile tools ==

=== [[Raw tile selector]] ===

Provides an easy to use graphical interface to select which tiles and colors should be displayed for plants, stones and small creatures.

Made to ease the job of creators of tilesets with edited raws. It will also be useful for users that dislike decisions made by tileset creators or users that could not find the edited raws for a tileset.

[http://dffd.wimbli.com/file.php?id=2113 Download]

Currently for windows only.

=== Raw tile merger ===
Provides an easy to use interface to change the tile and color data of raws to match the data of another set of raw files.

Made to ease the job of creators of tilesets with edited raws when new versions of df are released. The edited raws for your tileset for a new df version can now be created with a few clicks.

[http://dffd.wimbli.com/file.php?id=2178 Download]

== World Map / World Gen Tools ==

=== [http://www.bay12forums.com/smf/index.php?topic=57428 PerfectWorldDF] ===
Very detailed Windows program to help create customize world gens.
 [http://www.bay12forums.com/smf/index.php?topic=57428 Bay 12 forum link]
 [http://dffd.wimbli.com/file.php?id=2354 Dwarf Fortress File Depot link (may be old version)]
 [http://dffd.wimbli.com/who.php?id=1314 Dwarf Fortress File Depot listing for the author]

== Other/miscellaneous ==

=== [http://winmerge.org/ WinMerge] ===
Winmerge allows you to compare the contents of folders or files. It highlights any differences between files and allows you to merge them. It is most useful for modders or users of mods. If you compare modified raw files with unmodified ones you can quickly see any differences.

= Tools under development =

'''The tools listed below are under development for DF 2010, but cannot perform the task they are intended for at this time.'''

=== [[Utility:Obsidian|Obsidian]] ===
''by Skeggox''

Obsidian is a toolset for converting DF maps into a renderable scene, manipulating the result, and displaying it directly in 3D or exporting to 3rd party renderers and raytracers.

Its a modular Lua framework, using Open Scene Graph for rendering and DFHack for talking with Dwarf Fortress.

This [http://www.bay12forums.com/smf/index.php?topic=57920.0 forum thread] has more detail.

v0.31:Utilities

2010-11-22T21:42:52Z

Joelpt: /* Quickfort */

{{AV}}
{{Quality|Exceptional}}
Please only list utilities that are known to work with the newest version here.

Here are third party applications useful for Dwarf Fortress.
__TOC__

==Dwarf Fortress filesharing services==

=== [http://dffd.wimbli.com/ Dwarf Fortress File Depot] ===
The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of [[User:Janus|Janus]]; for files related to Dwarf Fortress only.

=== [http://mkv25.net/dfma/ DF Map Archive] ===

* http://mkv25.net/dfma/

The Dwarf Fortress Map Archive is a large collection of user-submitted maps and a nice flash viewer for perusing them.
Maps are uploaded, stored, and downloaded in a special compressed format created by the DF Map Compressor (see below).

Read more about the [[User:Markavian/DF_Map_Archive|DF Map Archive]] on [[User:Markavian|Markavian]]'s User page.

=== DF Map Compressor ===

*[http://shadowlord13.googlepages.com/dfmap-index.html SL's DF Map Compressor - Website] (currently not accessible)
*Download from [http://dffd.wimbli.com/file.php?id=997 DF File Depot]

The DF Map Compressor encodes multiple bitmaps exported from Dwarf Fortress into a single, very compressed, .fdf-map file, and functions as a viewer for this format. It can also export the maps to PNG format.

The .fdf-map file can then be shared with your friends by uploading to the [http://mkv25.net/dfma/ DF Map Archive] that features an online viewer (written in Flash).

The map compressor was created by Shadowlord in May 2007. The web site is currently not accessible. Extract from the website :
<blockquote>
"The '''DF Map Compressor''' is a program I made to encode Dwarf Fortress fortress or world map images into a much smaller format than is possible with normal image formats. Here's a quick summary of how it works: It determines the size of your tiles from your DF font file (or asks you), splits the map up into tiles, identifies duplicate tiles, writes out every unique tile image, and then writes out a list of ID#s for each tile position which points to the tile image for that tile. What it outputs is piped through the LZMA compressor (the one used in 7-zip), to compress it further. The .df-map file which it writes out is usually less than 100 KB in size. (By comparison, a PNG of the same map can exceed 2 megabytes, depending on how well you compress it, whether you change the color depth, and whether you are using a graphical tileset or detailed font)."
</blockquote>

There is a little bit of information at the [http://dffd.wimbli.com/file.php?id=997 DF File Depot] page, where the compressor can be downloaded:
<blockquote>
"It requires either .NET 2.0 or newer (If you have Windows Vista, you already have this, if not, you might need to get it), or if you're on Linux or a Mac or other non-Windows OS, requires Mono.
* .NET 2.0: http://www.microsoft.com/downloads/details.aspx?familyid=0856eacb-4362-4b0d-8edd-aab15c5e04f5
* Mono: http://www.mono-project.com/"
</blockquote>

To get it working on OSX, according to [http://www.bay12forums.com/smf/index.php?topic=64174.msg1511109#msg1511109 this forum post]:
:1. [http://www.go-mono.com/mono-downloads/ download the Mono Framework] and install it. If you're on a modern Mac, you want the [http://ftp.novell.com/pub/mono/archive/2.8.1/macos-10-x86/3/MonoFramework-2.8.1_3.macos10.novell.x86.dmg latest Intel version], which requires OSX 10.5 or 10.6. [http://www.mono-project.com/OldReleases Older versions are available] but no longer supported.
:2. export your map from Dwarf Fortress (Esc -> Export Local Image)
:3. download the [http://dffd.wimbli.com/file.php?id=997 DF Map Compressor from the DF File Depot].
:4. open the terminal, navigate to the DF Map Compressor folder and type:
mono DwarfFortressMapCompressor.3.3.4.exe
:5. WAIT a bit for the DF Map Compressor windows to appear (''I almost thought it had crashed, it's rather slow'')
:6. follow the on screen instructions

== 3D Visualizers ==

=== [[Utility:Stonesense|Stonesense]] ===
[[File:stonesense.jpg|208px|thumb|right|Stonesense Screenshot]]
''by Jonask, Solifuge, Kaypy and Japa''

Stonesense is a third party real-time visualizer that lets you view your Dwarf Fortress world in a classic isometric perspective.

More information is available in [http://www.bay12games.com/forum/index.php?topic=43260.0 this forum thread].

Stonesense is now in version 2.1 Slate, supports v0.31.12 - [http://stonesense.googlecode.com/files/Stonesense_Slate_2.1.zip Download]

=== [[Utility:Overseer|Fortress Overseer]] ===
''by thewonderidiot and sexymustard''

Overseer is a full 3D visualizer for DF2010 using the DFHack library. Its appearance is highly customizable and will be even more so in the near future. Check out its [http://www.bay12forums.com/smf/index.php?topic=63484.0 forum thread] for more details or download it from [http://dffd.wimbli.com/file.php?id=2922 here].

== Interface tools ==

===[http://www.bay12games.com/forum/index.php?topic=50643.0 Dfterm2]===

Dfterm2 is a tool to run Dwarf Fortress via terminals remotely. Multiple people can connect and watch or join in.

Main article here: [[Dfterm2]].

== Game manipulation tools ==

=== [http://dffd.wimbli.com/file.php?id=645 Reveal] ===

The standalone Reveal utility is obsolete due to missing source code. [[DF2010:Utilities#DFHack|DFHack]]'s dfreveal module works like Reveal did, and has built-in undo capability.

Reveal (or Reveal.exe as it is commonly referred to) is a program that runs alongside Dwarf Fortress and shows all "unexplored" or "undug" tiles of the map (in fortress mode). To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal (Not required in the latest version using the parameters below, simply start the .exe file.). Playing on revealed map might ''(read "will")'' cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, and a lot more). '''Using Reveal has been known to corrupt saved game folders.''' and, as such, it is highly recommended to only use Reveal to preview a biome's layout and then restart without running Reveal.


===[http://www.bay12forums.com/smf/index.php?topic=66525 Dwarf Therapist]===

Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments (40d), statistics (such as attributes, personality traits and happiness), plus sort dwarves by various criteria (eg. profession, migration wave, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way.

Version 0.6.4 is out (October 4, 2010). This version supports DF builds up to 0.31.16.

''NOTE'': This project is currently seeking a new maintainer.

New dedicated support forum: http://code.google.com/p/dwarftherapist/

Read the full changelog here: http://code.google.com/p/dwarftherapist/source/browse/CHANGELOG.txt



Instruction for making it work with new versions here: http://code.google.com/p/dwarftherapist/wiki/MappingNewVersions This page also tends to have the new addresses within an hour or two of new releases of Dwarf Fortress.

=== [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] ===
Runesmith is a Dwarf information viewing and editing tool inspired by the original Dwarf Companion. It uses the DFHack library to interface with Dwarf Fortress and Qt to provide a robust and professional looking cross-platform GUI. http://www.bay12forums.com/smf/index.php?topic=59056.0

Version 0.1.7 is out for Windows, currently supporting 0.31.16. Since it uses DFHack, all versions of DF that DFHack supports, Runesmith supports!

* Windows: http://dffd.wimbli.com/file.php?id=2538
* Linux: to follow (the windows one is reported to work fine under wine though)

"A tool that allows smithing (editing) of the digits and runes (letters) that control all life in DF. By smithing these runes, the metagods (players) can meddle with DF mortals to suit their games, be it recasting a soul into a new species body, blessing and cursing indiviudals or just to make predictions of when a mortal will attain the next degree of competence to guide them on how they should spend their limited time." - Psieye - (http://www.bay12forums.com/smf/index.php?topic=57003.msg1324765#msg1324765)

=== [http://www.bay12forums.com/smf/index.php?topic=58809 DFHack] ===

DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.5.0.2) release only supports versions 0.31.01 - 0.31.03 Legacy, 0.31.04 - 0.31.16 SDL, and 0.31.05 - 0.31.14 on Linux. It consists of some of the more useful DFHack tools.

Code and binary releases are available from the [http://github.com/peterix/dfhack/downloads Github site].

=== DFhack tools for DF 2010 ===
==== dfcleanmap ====
Cleans all the bloodsmears that get scattered all over the map.
==== dfliquids ====
Allows creating liquids (water and magma), making them flow or preventing them from flowing. Newly also allows making obsidian walls. It's a command-prompt style utility where you type in very simple commands. Replaces the older magma_create tool.

Use like this:

game: place 'k' cursor on the tile or on the upper left corner of the area to manipulate.

tool: enter 'range' in the tool and specify width and height of the rectangle.

- remove water

'w'
'0'
's-'
<ENTER>

- create obsidian wall (only works for a single tile, even if a range is specified)

'o'
'1'
's.'
<ENTER>

note that previously existing water or magma still stays at this spot.

- create magma

'm'
'7'
's+'
<ENTER>

==== dfprospector ====
Lists all available minerals on the map and how much of them there is.
==== dfreveal ====
Pauses the game and reveals the whole map, then unreveals it afterwards (unless you press Ctrl+C). Use with caution, releases [[HFS]]! Same warnings as to the original Reveal tool apply.

==== dfvdig ====
Designates a whole vein for digging. When using the '-x' option, it will dig stairs into other z-levels. Point the cursor at a vein and run this thing :)

=== [[Utility:DwarfForeman|Dwarf Foreman]] ===
Dwarf Foreman is a third party program to automatically dispatch jobs to your workers.

=== [[Utility:DwarfScript|Dwarf Script]] ===
Dwarf Script is a program and allows you to manipulate DF's memory using a script.

== Fortress layout tools ==

=== [http://sun2design.com/quickfort/ Quickfort] ===

Quickfort is an AutoHotkey-based utility for Dwarf Fortress that helps you build fortresses from "blueprint" .CSV files (comma separated values). These files are easily created and edited in an app like Excel. Most building-oriented DF commands are supported through the use of multiple .CSV files to describe the different phases of DF construction (designation, building, stockpiles, and making adjustments.

[Community submitted blueprints] are hosted on this Wiki.

=== [[User:Soundandfury/DF_Designer|DF Designer]] ===
DF Designer, by [[User:Soundandfury|soundnfury]] is a fort layout planning tool. It enables you to work out your designs before you start to build, and even see how they look in 3-D.
It's written in C with SDL, and both Linux and Windows builds are available. The source code is freely available under the GPL.
Since DF Designer does not 'talk to' Dwarf Fortress, it is version-independent. Supports exporting to Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=55025.0 ChromaFort] ===
Chromafort allows you to convert 24-bit bitmap (.bmp) images into Quickfort-compatible CSV files.

=== [http://www.bay12forums.com/smf/index.php?topic=64723.15 DF Architect] ===
DF Architect is a short cut to using Chromafort in conjunction with DF Designer. It uses 24-bit bitmap files and directly designates them into Dwarf Fortress. It is an early release program and currently only supports digging, stairs (up, down, and both), and ramps. Its defining feature is the use of an 'index' which allows for the designer to visually connect the cursor to the image. Be careful when using this program as it had no abort or terminating ability while designating, nor will it check to see if you've uploaded correct formats.

== Modding tools ==

=== [http://dffd.wimbli.com/file.php?id=2068 Custom Workshop Workshop] ===
WYSIWYG editor for designing the raws for a custom workshop.
(Not all raws, just the tiles and colors) Lets you see how it will look at each stage of construction. Comes with the default 16x16 CURSES font built in, but you can load any .BMP formatted DF font you like, keeping in mind that if its bigger than 16x16 it won't fit.

Accommodates up to 32x32 workshops, not that there's any reason for such a large workshop, right?

=== [http://dffd.wimbli.com/file.php?id=1996 Uristmod] ===
A program which uses text files to automatically change/update raw files. Makes installation of mods easier. However at this time, the documentation is a little confusing and makes creating mods harder for beginners. [http://www.bay12forums.com/smf/index.php?topic=53028.0 Forum Thread]

=== [http://dffd.wimbli.com/file.php?id=2088 Accent replacement tool] ===
A small application to remove accented characters from a file. A quick solution if you need the language files for a tileset that has images in place of special characters.
Alternatively, you can use this 20-line perl script: http://github.com/rofl0r/df-mayday/blob/master/charfix.pl

== Raw tile tools ==

=== [[Raw tile selector]] ===

Provides an easy to use graphical interface to select which tiles and colors should be displayed for plants, stones and small creatures.

Made to ease the job of creators of tilesets with edited raws. It will also be useful for users that dislike decisions made by tileset creators or users that could not find the edited raws for a tileset.

[http://dffd.wimbli.com/file.php?id=2113 Download]

Currently for windows only.

=== Raw tile merger ===
Provides an easy to use interface to change the tile and color data of raws to match the data of another set of raw files.

Made to ease the job of creators of tilesets with edited raws when new versions of df are released. The edited raws for your tileset for a new df version can now be created with a few clicks.

[http://dffd.wimbli.com/file.php?id=2178 Download]

== World Map / World Gen Tools ==

=== [http://www.bay12forums.com/smf/index.php?topic=57428 PerfectWorldDF] ===
Very detailed Windows program to help create customize world gens.
 [http://www.bay12forums.com/smf/index.php?topic=57428 Bay 12 forum link]
 [http://dffd.wimbli.com/file.php?id=2354 Dwarf Fortress File Depot link (may be old version)]
 [http://dffd.wimbli.com/who.php?id=1314 Dwarf Fortress File Depot listing for the author]

== Other/miscellaneous ==

=== [http://winmerge.org/ WinMerge] ===
Winmerge allows you to compare the contents of folders or files. It highlights any differences between files and allows you to merge them. It is most useful for modders or users of mods. If you compare modified raw files with unmodified ones you can quickly see any differences.

= Tools under development =

'''The tools listed below are under development for DF 2010, but cannot perform the task they are intended for at this time.'''

=== [[Utility:Obsidian|Obsidian]] ===
''by Skeggox''

Obsidian is a toolset for converting DF maps into a renderable scene, manipulating the result, and displaying it directly in 3D or exporting to 3rd party renderers and raytracers.

Its a modular Lua framework, using Open Scene Graph for rendering and DFHack for talking with Dwarf Fortress.

This [http://www.bay12forums.com/smf/index.php?topic=57920.0 forum thread] has more detail.

v0.31:Utilities

2010-05-31T06:25:50Z

Joelpt: Category-based reorganization of page. Added details on Quickfort and Chromafort.

40d:Macros and keymaps

2009-07-20T02:30:24Z

Joelpt: Added Quickfort

Playing Dwarf Fortress means lots of typing. Although the game has no internal macro/keymap system (except in alpha version 40d12), using an external program can save you a great deal of time when dumping, rewalling, designating, and so forth.

# Go to [[Utilities#AutoHotKey]] and download AutoHotKey. Installation is simple and the program uses few system resources.
# Write macro scripts (file type .ahk), which may contain any number of commands. You activate scripts by double-clicking .ahk files and deactivate them by right-clicking the AutoHotKey icon on the task bar. Both of these can be done at any time - even right in the middle of a game. AutoHotKey also allows for automated activation of scripts.

==Troubleshooting Scripts==
Users may experience some issues in getting scripts to work, particularly when using looping scripts when experiencing low frame-rates.
* If experiencing low frame-rates, try adding delays ("Sleep 100" to pause for 100 milliseconds for example) within loops to allow the interface to keep up. If there are nested loops, sometimes adding a pause at the end of an inner loop is all that is needed to flush the keyboard buffer
* Make sure that Dwarf Fortress maintains focus. IM windows are the enemy! Who needs friends anyhow? You've got Dwarf Fortress.
* This may go without saying, but most macros assume standard key-mappings. If you're using non-standard ones, you may have to edit the macro to get it to work.
* Visiting liaisons can bring up screens that eat keystrokes, throwing a long-looping script out-of-phase with where it expects the game to be. Wait for the farewell screen before running a long script.
* The SendPlay function supports keys that the Send function does not, for example {{key|Shift-Enter}}. According to the AutoHotKey documentation, SendPlay may also be better at preventing dropped keystrokes.

== [http://sun2design.com/quickfort/ Quickfort] ==

Quickfort is an AutoHotkey-based utility for Dwarf Fortress that helps you build fortresses from "blueprint" .CSV files (comma separated values). These files are easily created and edited in an app like Excel. Most building-oriented DF commands are supported through the use of multiple .CSV files to describe the different phases of DF construction (designation, building, stockpiles, and making adjustments). Many of the examples below can be reproduced in Quickfort.

== AutoHotKey Examples ==

===Dumping===
====Stock Screen Dump====
Taken from an old version of [[User:Jackard|Jackard's user page]].

To use, first have your bookeeper do enough desk work so you can view individual items in the stocks listing. Then bring it up and press del to quickly mark stuff. To adjust the key repeat rate, edit the KEY_HOLD_MS value in \data\init\init.txt.

<pre>
del::
IfWinActive Dwarf Fortress
{
send d{down}
return
}
else
{
send {del}
return
}
</pre>

====Designation Dump====
A dumping script by [[User:Dukederek|Dukederek]]:

This script uses a system similar the commands in the designations menu to mark most of the contents of a large area for dumping. [[User:Dukederek|My talk page]] has more detailed instruction.

Essentially you need to create two text files with the following titles and content. When playing DF it is safe to have blockdumpinit running constantly as long as you dont plan on using the ctrl-d combination for something else.

'''blockdumpinit.ahk'''
<pre>
^d::
RunWait, "blockdumpmain.ahk"
Return
</pre>

'''blockdumpmain.ahk'''
<pre>
SetKeyDelay 25
return::
Send k
return
up::
Send w
return
left::
Send a
return
down::
Send s
return
right::
Send d
return
q::
ExitApp
return
shift::
x := 0
y := 1
Loop{
Input, keypress, B, {esc} , w,a,s,d,k,q
if keypress = w
{
y := --y
Send {up}
continue
}else if keypress = s
{
y := ++y
Send {down}
continue
}else if keypress = a
{
x := --x
Send {left}
continue
}else if keypress = d
{
x := ++x
Send {right}
continue
}else if keypress = k
{
break
}else if keypress = q
{
ExitApp
}
}
y := y / 2
z := y
z := Floor(z)
z := y/z
Send d{NumpadAdd}d
If z = 0
{
If x = 0
ExitApp
Else{
Loop %x%{
Send {left}d
}ExitApp
}
}If z <> 1
{
Loop %y%{
Loop %x%{
Send {left}d{NumpadAdd}d
}Send {up}d
Loop %x%{
Send {right}d{NumpadAdd}d
}Send {up}d{NumpadAdd}d
}Loop %x%{
Send {left}d{NumpadAdd}d
}
}Else If z = 1
{
y := y + 0.5
Loop %y%{
Loop %x%{
Send {left}d{NumpadAdd}d
}Send {up}d
Loop %x%{
Send {right}d{NumpadAdd}d
}Send {up}d{NumpadAdd}d
}Send d{NumpadSub}d
}ExitApp
</pre>

===Rewalling ===
Taken from [[User:Valdemar|Valdemar's user page]].

This is a macro to aid with rewalling. To use, copy-paste the script into a new .ahk file and run the script with AutoHotkey. Then, in Dwarf Fortress, press b-C-w, move the cursor to where you want to start the wall, and hold Ctrl-Shift-Arrowkey, using the direction you want to rewall in. To build floors, press b-C-f instead, and use Ctrl-Alt-Arrowkey. To stop, just release the keys.

The script will use the first material in the list. I suggest you create a stockpile near the construction site that only accepts the item you wish to build with and temporarily forbid any nearby materials you don't want to build with.

<pre>
$^+Left:: ProcessEvent("Left","w")
$^+Right:: ProcessEvent("Right","w")
$^+Up:: ProcessEvent("Up","w")
$^+Down:: ProcessEvent("Down","w")

$^!Left:: ProcessEvent("Left","f")
$^!Right:: ProcessEvent("Right","f")
$^!Up:: ProcessEvent("Up","f")
$^!Down:: ProcessEvent("Down","f")

ProcessEvent(direction, type)
{
Send {Enter}
Sleep 100
Send {Enter}
Sleep 100
Send %type%
Sleep 100
Send {%direction%}
Loop
{
if not GetKeyState(direction, "P")
break
Send {Enter}
Sleep 100
Send {Enter}
Sleep 100
Send %type%
Sleep 100
Send {%direction%}
}
}
</pre>

===Grid-by-grid designation===
For easier diagonal and fancy mining. Assumes that DF is active. "^!" means ctrl-alt-direction.

<pre>
^!NumpadEnd::
send {Enter}{Enter}{NumpadEnd}
return
^!NumpadDown::
send {Enter}{Enter}{NumpadDown}
return
^!NumpadPgDn::
send {Enter}{Enter}{NumpadPgDn}
return
^!NumpadLeft::
send {Enter}{Enter}{NumpadLeft}
return
^!NumpadRight::
send {Enter}{Enter}{NumpadRight}
return
^!NumpadHome::
send {Enter}{Enter}{NumpadHome}
return
^!NumpadUp::
send {Enter}{Enter}{NumpadUp}
return
^!NumpadPgUp::
send {Enter}{Enter}{NumpadPgUp}
return
</pre>

===Embark Settings macros===
These macros are used to ease the setup of skills and supplies before you embark.

====Improved Food/Alcohol buying macro====
This macro buys all the cost-2 food (that I have seen), as well as the four types of alcohol. Just press ctrl+f on the Items screen.
It can deal with meat or drink that you already have, or is not currently featured. By [[User:Redfenix|Redfenix]].

<pre>
^f::

send ndwarven{SPACE}ale{RIGHT}{ENTER}{F9}
send ndwarven{SPACE}rum{RIGHT}{ENTER}{F9}
send ndwarven{SPACE}beer{RIGHT}{ENTER}{F9}
send ndwarven{SPACE}wine{RIGHT}{ENTER}{F9}
send ndonkey{SPACE}meat{RIGHT}{ENTER}{F9}
send nchimpanzee{SPACE}meat{RIGHT}{ENTER}{F9}
send ngazelle{SPACE}meat{RIGHT}{ENTER}{F9}
send nbonobo{SPACE}meat{RIGHT}{ENTER}{F9}
send nmule{SPACE}meat{RIGHT}{ENTER}{F9}
send ndeer{SPACE}meat{RIGHT}{ENTER}{F9}
send nraccoon{SPACE}meat{RIGHT}{ENTER}{F9}
send nfox{SPACE}meat{RIGHT}{ENTER}{F9}
send nrhesus{SPACE}macaque{SPACE}meat{RIGHT}{ENTER}{F9}
send nhorse{SPACE}meat{RIGHT}{ENTER}{F9}
send ngroundhog{SPACE}meat{RIGHT}{ENTER}{F9}
send nmountain{SPACE}goat{SPACE}meat{RIGHT}{ENTER}{F9}
send nhoary{SPACE}marmot{SPACE}meat{RIGHT}{ENTER}{F9}
send ngorilla{SPACE}meat{RIGHT}{ENTER}{F9}
send norangutan{SPACE}meat{RIGHT}{ENTER}{F9}
send nsiamang{SPACE}meat{RIGHT}{ENTER}{F9}
send nbilou{SPACE}meat{RIGHT}{ENTER}{F9}
send npileated{SPACE}gibbon{SPACE}meat{RIGHT}{ENTER}{F9}
send nmandrill{SPACE}meat{RIGHT}{ENTER}{F9}
send nturtle{RIGHT}{ENTER}{F9}
</pre>

===='First Fortress' setup====
This macro works with the default setup of DF, and starts you with (almost) the setup suggested in the "Your first fortress" tutorial. The amounts are adjustable with the variables at the top of the macro.
<pre>;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; materialplanner.ahk ;
; this is a ahk script to set up the embark settings roughly as ;
;suggested in the "your first fortress" tutorial. Inventory ;
;can be customized slightly. ;
; use ctrl+shift+e to run ;
; ;
; NOTEs: ;
; change variables to suit your desires ;
; the fourth guy is a Stonecrafter instead of Herbalist ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;;;;;;;;;;;;;
;;VARIABLES;;
;;;;;;;;;;;;;

PICKS = 2 ;number of picks to pack
AXES = 1 ;number of axes to pack
ANVILS = 0 ;number of anvils to pack
MEATS = 7 ;how much meat to take, each buys one of each cheap type (total number depends on locale)
DRINKS = 26 ;how many drinks to take, each one buys 4 drinks, one of each type
SEEDS = 5 ;each increment buys 5 plump helmet spawn, 2 pig tail, and 2 rock nuts

SetKeyDelay, 12 ;Key delay, to keep Dwarf Fortress from being overwhelmed.
;Set higher if you get weird results, or lower to get the
;script to run faster
SLEEPTIME = 12 ;same thing, only used in the repeated key press loops though

;;;;;;;;;;;;
;;The code;;
;;;;;;;;;;;;

^+e::
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;remove all of the items
Send {Tab}

loop 105{
Send {NumpadSub}
Sleep %SLEEPTIME%
}

Send {Tab}

;place the skills
;first guy
;Proficient Miner
Send {right}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;novice appraiser
Send {PgUp}
loop 7{
Send {Up}
Sleep %SLEEPTIME%
}
Send {NumpadAdd}
;novice Judge of Intent
Send {Up}
Send {NumpadAdd}
;competent gem setter
Send {PgUp}
Send {PgUp}
loop 7{
Send {Up}
Sleep %SLEEPTIME%
}
loop 3{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;second guy
Send {Left}
Send {Down}
Send {Right}
Send {PgUp}
;Proficient Miner
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;Proficient Mason
loop 3{
Send {Down}
Sleep %SLEEPTIME%
}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;third guy
Send {Left}
Send {Down}
Send {Right}
;Proficient Carpenter
Send {UP}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;Proficient Wood Cutter
Send {UP}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;fourth guy
Send {Left}
Send {Down}
Send {Right}
;Proficient Grower
Send {PgDn}
Send {Down}
Send {Down}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;Proficient Stone Crafter
loop 9{
Send {Up}
Sleep %SLEEPTIME%
}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;fifth guy
Send {Left}
Send {Down}
Send {Right}
;Proficient Mechanic
loop 5{
Send {Down}
Sleep %SLEEPTIME%
}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;Proficient Building Designer
Send {PgUp}
loop 5{
Send {Down}
Sleep %SLEEPTIME%
}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;sixth guy
Send {Left}
Send {Down}
Send {Right}
;Proficient Weaponsmith
loop 1{
Send {Down}
Sleep %SLEEPTIME%
}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;Proficient Armorsmith
loop 2{
Send {Down}
Sleep %SLEEPTIME%
}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;seventh guy
Send {Left}
Send {Down}
Send {Right}
;Proficient Cook
Send {PgDn}
loop 2{
Send {Up}
Sleep %SLEEPTIME%
}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
;Proficient Brewer
loop 1{
Send {Up}
Sleep %SLEEPTIME%
}
loop 5{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

;do the inventory
Send {Tab}

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
;Meat

if MEATS > 0
{
tmp := MEATS - 1
send ndonkey{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nchimpanzee{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send ngazelle{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nbonobo{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nmule{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send ndeer{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nraccoon{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nfox{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nrhesus{SPACE}macaque{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nhorse{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send ngroundhog{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nmountain{SPACE}goat{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nhoary{SPACE}marmot{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send ngorilla{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send norangutan{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nsiamang{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nbilou{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send npileated{SPACE}gibbon{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nmandrill{SPACE}meat{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}
send nturtle{RIGHT}{ENTER}
loop %tmp%{
Send {NumpadAdd}
}
Send {F9}

}

;copper picks
if PICKS > 0
{
Send {n}copper picks{Right}{Enter}
tmp := PICKS - 1
loop %tmp%{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
}
;Axes
if AXES > 0
{
Send {n}steel axes{Right}{Enter}
tmp := AXES - 1
loop %tmp%{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
}
;Seeds
if SEEDS > 0
{
send {n}Rock nuts{Right}{Enter}
Send {NumpadAdd}
send {n}plump helmet spawn{Right}{Enter}
Send {NumpadAdd}
Send {NumpadAdd}
Send {NumpadAdd}
Send {NumpadAdd}
send {n}Pig tail Seeds{Right}{Enter}
Send {NumpadAdd}

tmp := SEEDS - 1
loop %tmp%{
Send {NumpadAdd}
Send {NumpadAdd}
}
Send {up}
loop %tmp%{
Send {NumpadAdd}
Send {NumpadAdd}
Send {NumpadAdd}
Send {NumpadAdd}
Send {NumpadAdd}
}
Send {up}
loop %tmp%{
Send {NumpadAdd}
Send {NumpadAdd}
}
}

;Anvils
if ANVILS > 0
{
Send {n}iron anvils{Right}{Enter}
tmp := ANVILS - 1
loop %tmp%{
Send {NumpadAdd}
Sleep %SLEEPTIME%
}
}
;Drinks
if DRINKS > 0{
send {n}Dwarven ale{Right}{Enter}
send {n}Dwarven beer{Right}{Enter}
send {n}Dwarven wine{Right}{Enter}
send {n}Dwarven rum{Right}{Enter}

tmp := DRINKS - 1
loop 4{
loop %tmp%{
Send {NumpadAdd}
}
Send {up}
}

return
</pre>

===A more modular approach===
Hit WIN+G to go once you are on the empty item screen

<pre>
#g::
;add an anvil
Additem("iron anvils",1)
;add 31 of the boozes (kind of iffy might end up with dwarven cheese or something if the civilization does not have 4 boozes)
Additem("dw",31)
Additem("dw",31)
Additem("dw",31)
Additem("dw",31)
;adds copper nuggets
Additem("copper n",5)
;adds cassiterite
Additem("cass",5)
;bitumous coal
Additem("coal",5)
;tower cap logs
Additem("logs",11)
return

IsCurrentItemThere()
{
;color of text in the new item screen 0xFFFF00(selected) or 0x808000 (unselected)
;location of text in the new item screen 305, 150
PixelSearch, , , 305, 150, 315, 160, 0x808000, 3,
return !ErrorLevel
}

AddItem(name,amount)
{
Sleep 100
amount -= 1
SetKeyDelay 150
SendInput n
SendInput %name%
;MsgBox Name Check
Sleep 200
if IsCurrentItemThere()
{
Sleep 200
SendInput {Right}
SendInput {Enter}
Sleep 200
Loop
{
if amount <= 0
{
break
}
SendInput {NumpadAdd}
Sleep 10
amount --
}
;MsgBox Done
}
else
{
SendInput {F9}
}
}
</pre>

===Bed Assigning macro===
This will assign bedrooms to your dwarfs. Press F3 followed by a single digit indicating how many beds to assign. Can repeat the action, as the number of beds assigned is stored in a counter. Room size is default, but easily edited into the script. By [[User:Napsterbater|Napsterbater]].

<pre>
bedcounter = 0
F3::
Input, counter, L1
SetKeyDelay, 100
loop %counter% {
loop %bedcounter%
send {Down}
loop % A_Index - 1
send {Down}
send {q}{r}{Enter}{a}
loop %bedcounter%
send {NumPadAdd}
loop % A_Index - 1
send {NumPadAdd}
send {NumPadAdd}{Enter}
send {space}{r}
}
bedcounter += counter
return
</pre>

===Room-designation macros===

====Valdemar's Designator Macro====
This macro can read a spreadsheet and designate rooms according to it. [http://www.bay12games.com/forum/index.php?topic=1428.0 Version 1]

Version 2 of this macro apparently only works in versions up to and including 38c [[verify]], and can be found here: [http://www.bay12games.com/forum/index.php?topic=1890.0 Version 2]

====Fedor's chambered circle====
A circular room with eight equal-sized chambers, suitable for everything from housing to workshops to a mausoleum. 
[http://mkv25.net/dfma/movie-216-room-designationmacro01 See this macro in action] 
[[Macros_and_Keymaps_Examples#Room-designation Macro 01|Macro text]]

====Valdemar's bedroom complex====
A large fractal bedroom/dining complex, with 56 bedrooms and room for 24 tables.

You can press Alt-B to create a bedroom block, or Alt-C to create a full complex with 4 bedroom blocks and a dining block in the center.

Note - the macro is much faster than the demo movie shows, it is done in under a minute.

[http://mkv25.net/dfma/movie-252 Demo Movie]

[http://www.pindi.us/files/fractalbr.zip Download]

====Tulip's room macros====
Based on [[Bedroom_design|the bedroom designs.]]

^g means alt+g, !g means ctrl+g, and so on.
Open up the designations window before using these:
<pre>
; This will make a basic 'x' pattern workshop/room layout
; and will 'land' back on the same tile it starts on each time,
; which happens to be the center.
; It is modified so that you will have 3 staircases, and an extra tile
; because many workshops do not have corner access.
!r::
Send di2{enter}88{enter}4d{enter}4{enter}67{enter}77{enter}66666666
Send {enter}11{enter}1{enter}6{enter}114{enter}4{enter}2{enter}11{enter}
Send 66666666{enter}77{enter}7{enter}6{enter}74
return

; This makes GnomeChomsky's Tessellated Apartments, bedrooms only.
; Your cursor will be over the left staircase.
!g::
Send i999866{enter}{enter}33332{enter}{enter}11114{enter}{enter}
Send d3{enter}22{enter}4{enter}{enter}
Send 78{enter}44{enter}8{enter}{enter}
Send 96{enter}88{enter}6{enter}{enter}
Send 32{enter}66{enter}2{enter}{enter}
Send 96{enter}{enter}6{enter}88{enter}
Send 96{enter}{enter}8{enter}44{enter}
Send 1444{enter}{enter}2{enter}66{enter}
Send 88{enter}88{enter}6{enter}{enter}
Send 78{enter}{enter}8{enter}44{enter}
Send 78{enter}{enter}4{enter}22{enter}
Send 14{enter}{enter}2{enter}66{enter}
Send 66{enter}22{enter}4{enter}{enter}
Send 14{enter}{enter}8{enter}44{enter}
Send 78{enter}{enter}4{enter}22{enter}
Send 14{enter}{enter}2{enter}66{enter}
Send 32{enter}{enter}6{enter}88{enter}7i{enter}{enter}
return

; This makes GnomeChomsky's Tessellated Apartments, bedrooms plus dining.
; Everything above applies.
^g::
Send i{enter}{enter}999866{enter}{enter}33332{enter}{enter}11114{enter}{enter}d
Send 444{enter}{enter}2{enter}66{enter}
Send 32{enter}{enter}6{enter}88{enter}
Send 9966{enter}{enter}6{enter}88{enter}
Send 96{enter}{enter}8{enter}44{enter}
Send 7788{enter}{enter}8{enter}44{enter}
Send 78{enter}{enter}4{enter}22{enter}
Send 1144{enter}{enter}4{enter}22{enter}
Send 14{enter}{enter}2{enter}66{enter}
Send 36{enter}8886666666{enter}
Send 9{enter}4444444{enter}
Send 8{enter}6666{enter}744{enter}{enter}
Send 222222441{enter}6666666{enter}
Send {enter}22{enter}8{enter}4444{enter}
Send 7778
return

; This makes THLawrence's Living Pods (the A is for Arabia).
; Put your cursor where you want the upper left staircase to be.
; Like my other scripts, it recenters on that tile.
; Also, thank you THLawrence, this one was really easy write!
!a::
Send i{enter}{enter}d7{enter}7{enter}666{enter}3{enter}22{enter}1{enter}44{enter}7{enter}
Send 96666666
Send i{enter}{enter}d7{enter}7{enter}666{enter}3{enter}22{enter}1{enter}44{enter}7{enter}
Send 33222
Send i{enter}{enter}d7{enter}7{enter}666{enter}3{enter}22{enter}1{enter}44{enter}7{enter}
Send 7444
Send i{enter}{enter}d7{enter}7{enter}666{enter}3{enter}22{enter}1{enter}44{enter}7{enter}
Send 9988888
return

; This makes the lobby for THLawrence's Living pods.
^a::
Send i{enter}{enter}d7{enter}7{enter}666{enter}3{enter}66{enter}9{enter}66{enter}3{enter}41i{enter}{enter}
Send 36d{enter}1444444{enter}
Send 74{enter}1{enter}22{enter}3{enter}3i{enter}{enter}d1{enter}1{enter}666{enter}9{enter}
Send 66{enter}3{enter}66{enter}9{enter}88{enter}7{enter}74{enter}1144{enter}
Send 36666i{enter}{enter}777777
return
</pre>

====LordGrunt's room macro====
Based on 1 of the fractal [[Bedroom_design| bedroom designs.]]

[http://mkv25.net/dfma/movie-1226-fractalbedrooms Demo Movie]

<pre>
;
; Fractal Apts
; Start script while in 'dig' mode with cursor on desired position of left up staircase
;
; ALT+G to generate,
; CTRL+ALT+G to erase in case of failure
;

!g::
base_cross()
sleep 100
mid_sqr()
sleep 100
corridors()
sleep 100
all_rooms()
return

base_cross()
{
Send i{ENTER}3{ENTER}
Send d1{ENTER}6{SHIFT}+2{SHIFT}+2{SHIFT}+2{SHIFT}+28{ENTER}
Send d{SHIFT}+8{SHIFT}+8{SHIFT}+8{SHIFT}+888{ENTER}4{SHIFT}+8{SHIFT}+8{SHIFT}+8{SHIFT}+82{ENTER}
Send d{SHIFT}+2{SHIFT}+2{SHIFT}+2{SHIFT}+24{ENTER}2{SHIFT}+4{SHIFT}+4{SHIFT}+4{SHIFT}+46{ENTER}
Send d{SHIFT}+6{SHIFT}+6{SHIFT}+6{SHIFT}+666{ENTER}8{SHIFT}+6{SHIFT}+6{SHIFT}+6{SHIFT}+64{ENTER}
Send d{SHIFT}+4{SHIFT}+4{SHIFT}+4{SHIFT}+4474{SHIFT}+8{SHIFT}+888888{ENTER}66666{SHIFT}+2{SHIFT}+2{SHIFT}+2{SHIFT}+2{SHIFT}+2222{ENTER}8
Send d{SHIFT}+8{SHIFT}+88884488888{SHIFT}+6{SHIFT}+6666666{ENTER}22222{SHIFT}+4{SHIFT}+4{SHIFT}+4{SHIFT}+4{SHIFT}+4444{ENTER}6
}
mid_sqr()
{
Send d{SHIFT}+3666
send d{ENTER}{SHIFT}+9{SHIFT}+999999{ENTER}1{ENTER}9999{ENTER}9{ENTER}111{ENTER}
send d{SHIFT}+1{SHIFT}+1{SHIFT}+1{ENTER}999{ENTER}99{ENTER}1111{ENTER}99
send d{SHIFT}+8{SHIFT}+8{SHIFT}+8444{ENTER}333{ENTER}33{ENTER}7777{ENTER}
send d{SHIFT}+3{SHIFT}+3{SHIFT}+37{ENTER}333{ENTER}7{ENTER}7777{ENTER}
}
corridors()
{
send d{SHIFT}+7{SHIFT}+7{SHIFT}+7999{ENTER}{SHIFT}+6{SHIFT}+6{SHIFT}+66{ENTER}
send d333333{ENTER}{SHIFT}+2{SHIFT}+2{SHIFT}+22{ENTER}
send d111111{ENTER}{SHIFT}+4{SHIFT}+4{SHIFT}+44{ENTER}
send d777777{ENTER}{SHIFT}+8{SHIFT}+8{SHIFT}+88{ENTER}
sleep 100
send d3333222{ENTER}{SHIFT}+466{ENTER}
send d{SHIFT}+2{SHIFT}+2888{ENTER}{SHIFT}+644{ENTER}
send d{SHIFT}+9{SHIFT}+9{SHIFT}+6{SHIFT}+6333
send d{ENTER}{SHIFT}+466{ENTER}
send d{SHIFT}+2{SHIFT}+2888{ENTER}{SHIFT}+644{ENTER}
sleep 100
send d{SHIFT}+4{SHIFT}+1966
send d{ENTER}{SHIFT}+288{ENTER}
send d{SHIFT}+4{SHIFT}+4666{ENTER}{SHIFT}+822{ENTER}
sleep 100
send d{SHIFT}+9{SHIFT}+9{SHIFT}+8{SHIFT}+8777
send d{ENTER}{SHIFT}+288{ENTER}
send d{SHIFT}+4{SHIFT}+4666{ENTER}{SHIFT}+822{ENTER}
sleep 100
send d999988{ENTER}{SHIFT}+64{ENTER}
send d{SHIFT}+3{SHIFT}+3{SHIFT}+3777{ENTER}{SHIFT}+28{ENTER}
send d{SHIFT}+1{SHIFT}+1{SHIFT}+1999{ENTER}{SHIFT}+46{ENTER}
send d{SHIFT}+7{SHIFT}+7{SHIFT}+7333{ENTER}{SHIFT}+82{ENTER}
}

rooms_up()
{
send d78{ENTER}96{ENTER}
send d223{ENTER}32{ENTER}
send d44444{ENTER}87{ENTER}
send d63{ENTER}{ENTER}98{ENTER}{ENTER}23{ENTER}{ENTER}7
}
rooms_down()
{
send d32{ENTER}14{ENTER}
send d887{ENTER}78{ENTER}
send d66666{ENTER}32{ENTER}
send d74{ENTER}{ENTER}21{ENTER}{ENTER}78{ENTER}{ENTER}3
}
rooms_left()
{
send d14{ENTER}87{ENTER}
send d996{ENTER}63{ENTER}
send d2222{ENTER}41{ENTER}
send d98{ENTER}{ENTER}47{ENTER}{ENTER}96{ENTER}{ENTER}1
}
rooms_right()
{
send d96{ENTER}32{ENTER}
send d114{ENTER}47{ENTER}
send d8888{ENTER}96{ENTER}
send d21{ENTER}{ENTER}63{ENTER}{ENTER}14{ENTER}{ENTER}9
}
;======= WIDE
rooms_upw()
{
send d78{ENTER}966{ENTER}
send d223{ENTER}32{ENTER}
send d444444{ENTER}87{ENTER}
send d63{ENTER}{ENTER}98{ENTER}6{ENTER}23{ENTER}{ENTER}74
}
rooms_downw()
{
send d32{ENTER}144{ENTER}
send d887{ENTER}78{ENTER}
send d666666{ENTER}32{ENTER}
send d74{ENTER}{ENTER}21{ENTER}4{ENTER}78{ENTER}{ENTER}36
}
rooms_leftw()
{
send d14{ENTER}887{ENTER}
send d996{ENTER}63{ENTER}
send d22222{ENTER}41{ENTER}
send d98{ENTER}{ENTER}47{ENTER}8{ENTER}96{ENTER}{ENTER}12
}
rooms_rightw()
{
send d96{ENTER}322{ENTER}
send d114{ENTER}47{ENTER}
send d88888{ENTER}96{ENTER}
send d21{ENTER}{ENTER}63{ENTER}2{ENTER}14{ENTER}{ENTER}98
}
;============
rooms3up()
{
send d8888888
rooms_up()
send d1111222
rooms_left()
send d66666666
rooms_right()
send d4444
}
rooms3down()
{
send d2222222
rooms_down()
send d7777888
rooms_left()
send d66666666
rooms_right()
send d4444
}
rooms3left()
{
send d4444444
rooms_left()
send d9999666
rooms_up()
send d22222222
rooms_down()
send d8888
}
rooms3right()
{
send d6666666
rooms_right()
send d7777444
rooms_up()
send d22222222
rooms_down()
send d8888
}

;==========
all_rooms()
{
;left wide:
rooms_up()
send d222222222
rooms_down()
send d7777444
rooms_leftw()
;bottom wide:
send d{SHIFT}+3{SHIFT}+3{SHIFT}+3{SHIFT}+378
rooms_downw()
send d9999888
rooms_right()
send d444444444
rooms_left()
;right wide:
send d{SHIFT}+9{SHIFT}+9{SHIFT}+999{SHIFT}+66
rooms_rightw()
send d7777444
rooms_up()
send d222222222
rooms_down()
;top wide
send d{SHIFT}+7{SHIFT}+7{SHIFT}+777{SHIFT}+88
rooms_upw()
send d1111222
rooms_left()
send d666666666
rooms_right()
;remainin 9-room chambers
send d{SHIFT}+26666
rooms3right()
send d{SHIFT}+4{SHIFT}+4666
rooms3left()
send d{SHIFT}+1111
rooms3up()
send d{SHIFT}+2{SHIFT}+2888
rooms3down()
send d{SHIFT}+3333
rooms3left()
send d{SHIFT}+6{SHIFT}+6444
rooms3right()
send d{SHIFT}+9999
rooms3down()
send d{SHIFT}+8{SHIFT}+8222
rooms3up()
;send d{SHIFT}+7777
;rooms3right()
;send d{SHIFT}+2{SHIFT}+4666
;rooms3left()
send d1111144499{ENTER}{SHIFT}+1{SHIFT}+4{SHIFT}+41{ENTER}
send d77444444444{ENTER}8888888{SHIFT}+6{SHIFT}+6{SHIFT}+6{SHIFT}+6{SHIFT}+6666{ENTER}
send d{SHIFT}+7{SHIFT}+487{ENTER}{SHIFT}+1{SHIFT}+2{SHIFT}+21{ENTER}
send d33222222222{ENTER}6666666{SHIFT}+8{SHIFT}+8{SHIFT}+8{SHIFT}+8{SHIFT}+8888{ENTER}
send d{SHIFT}+2{SHIFT}+2221111
send i{ENTER}3{ENTER}7
deco()
}

deco()
{
send x77774{ENTER}{ENTER}9{ENTER}{ENTER}6669{ENTER}6{ENTER}3666{ENTER}{ENTER}3{ENTER}{ENTER}
send x2223{ENTER}2{ENTER}1222{ENTER}{ENTER}1{ENTER}{ENTER}1444{ENTER}4{ENTER}4447
send x{ENTER}{ENTER}7{ENTER}{ENTER}7888{ENTER}8{ENTER}666666
}

; CTRL+ALT+G to erase all
!^g::
send x{SHIFT}+1{SHIFT}+1{SHIFT}+1{SHIFT}+1{SHIFT}+1{ENTER}{SHIFT}+9{SHIFT}+9{SHIFT}+9{SHIFT}+9{SHIFT}+9{SHIFT}+9{SHIFT}+9{SHIFT}+9{SHIFT}+9{SHIFT}+9{ENTER}{SHIFT}+1{SHIFT}+1{SHIFT}+1{SHIFT}+1{SHIFT}+1
return
</pre>

====Pyrofyr's room macro====
Based on Palin88's Apartment design based on Raynard's Fractal Design.

[[File:Pyrofor_room_macro.png]]

<pre>
/*
* Macro by Pyrofyr for Room Design -- Cleaned up by 0x517A5D
* Enter (d)esignate mode, position the cursor where you want the
* middle of the design to be, then press Ctrl+Alt+D to start the Macro.
*/

;Attn Pyrofor: for slash-star style comments, the ending star-slash must
;be the first thing on its line. Otherwise the comment isn't terminated.

#SingleInstance Force
#IfWinActive, Dwarf Fortress
SetKeyDelay 0,, Play

; Ctrl+Alt+D
^!d::
send d{NumPadUp 18}{NumPadLeft 18}
;Attn Pyrofor: note how repeated keystrokes are done in AHK.
;no need for tehLoop().
directions()
send {NumPadRight 18}
directions()
send {NumPadLeft 18}
send {NumPadDown 18}
directions()
send {NumPadRight 18}
directions()
middle()
stairs()
return

directions()
{
;hallway box
send {Enter}{NumPadRight 18}{Enter}
send {Enter}{NumPadDown 18}{Enter}
send {Enter}{NumPadLeft 18}{Enter}
send {Enter}{NumPadUp 18}{Enter}
;indentations on box
send {Enter}{NumPadRight 1}{NumPadDown 2}{Enter}
send {NumPadDown 6}{Enter}{NumPadDown 2}{NumPadRight 1}{Enter}
send {NumPadLeft 1}{NumPadDown 6}{Enter}{NumPadDown 1}{Enter}
send {NumPadRight 6}{Enter}{NumPadRight 4}{Enter}
send {NumPadRight 6}{Enter}{NumPadUp 1}{Enter}
send {NumPadUp 6}{Enter}{NumPadUp 2}{NumPadLeft 1}{Enter}
send {NumPadRight 1}{NumPadUp 6}{Enter}{NumPadUp 1}{Enter}
send {NumPadLeft 6}{Enter}{NumPadLeft 4}{Enter}
; middle hallways
send {NumPadRight 2}{Enter}{NumPadDown 6}{Enter}
send {NumPadRight 1}{Enter}{NumPadDown 4}{NumPadLeft 2}{Enter}
send {NumPadRight 1}{Enter}{NumPadDown 6}{Enter}
send {NumPadUp 8}{NumPadLeft 6}{Enter}{NumPadRight 14}{Enter}
; cross apartments, horizontal segments
send {NumPadDown 4}{Enter}{NumPadLeft 2}{Enter}
send {NumPadDown 1}{NumPadLeft 3}{Enter}{NumPadLeft 6}{Enter}
send {NumPadUp 1}{NumPadLeft 3}{Enter}{NumPadLeft 2}{Enter}
send {NumPadDown 3}{NumPadRight 2}{Enter}{NumPadRight 2}{Enter}
send {NumPadRight 8}{Enter}{NumPadRight 2}{Enter}
send {NumPadUp 5}{NumPadLeft 1}{Enter}{NumPadLeft 2}{Enter}
send {NumPadLeft 6}{Enter}{NumPadLeft 2}{Enter}
send {NumPadUp 4}{Enter}{NumPadRight 2}{Enter}
send {NumPadRight 6}{Enter}{NumPadRight 2}{Enter}
send {NumPadRight 3}{NumPadUp 2}{Enter}{NumPadLeft 2}{Enter}
send {NumPadUp 1}{NumPadLeft 3}{Enter}{NumPadLeft 6}{Enter}
send {NumPadDown 1}{NumPadLeft 3}{Enter}{NumPadLeft 2}{Enter}
send {NumPadUp 3}{NumPadRight 2}{Enter}{NumPadRight 2}{Enter}
send {NumPadRight 8}{Enter}{NumPadRight 2}{Enter}
; cross apartments, vertical segments
send {NumPadRight 1}{NumPadDown 2}{Enter}{NumPadDown 2}{Enter}
send {NumPadDown 6}{Enter}{NumPadDown 2}{Enter}
send {NumPadDown 3}{NumPadLeft 2}{Enter}{NumPadUp 2}{Enter}
send {NumPadLeft 1}{NumPadUp 3}{Enter}{NumPadUp 6}{Enter}
send {NumPadRight 1}{NumPadUp 3}{Enter}{NumPadUp 2}{Enter}
send {NumPadLeft 3}{NumPadDown 2}{Enter}{NumPadDown 2}{Enter}
send {NumPadDown 8}{Enter}{NumPadDown 2}{Enter}
send {NumPadLeft 4}{Enter}{NumPadUp 2}{Enter}
send {NumPadUp 8}{Enter}{NumPadUp 2}{Enter}
send {NumPadUp 2}{NumPadLeft 3}{Enter}{NumPadDown 2}{Enter}
send {NumPadRight 1}{NumPadDown 3}{Enter}{NumPadDown 6}{Enter}
send {NumPadLeft 1}{NumPadDown 3}{Enter}{NumPadDown 2}{Enter}
send {NumPadLeft 2}{NumPadUp 3}{Enter}{NumPadUp 2}{Enter}
send {NumPadUp 6}{Enter}{NumPadUp 2}{Enter}
send {NumPadUp 4}{NumPadLeft 2}
}

middle()
{
send {NumPadUp 10}{NumPadLeft 2}{Enter}{NumPadRight 4}{NumPadDown 20}{Enter}
send {NumPadUp 5}{NumPadRight 1}{Enter}{NumPadUp 10}{NumPadLeft 6}{Enter}
send {NumPadLeft 1}{NumPadDown 1}{Enter}{NumPadDown 8}{NumPadRight 8}{Enter}
send {NumPadUp 2}{NumPadRight 1}{Enter}{NumPadUp 4}{NumPadLeft 10}{Enter}
send {NumPadDown 1}{NumPadLeft 6}{Enter}{NumPadDown 2}{NumPadRight 22}{Enter}
send {NumPadUp 1}{NumPadLeft 11}
}

stairs()
{
send i{NumPadUp 18}{NumPadLeft 9}{Enter 2}
send {NumPadRight 18}{Enter 2}
send {NumPadRight 9}{NumPadDown 9}{Enter 2}
send {NumPadLeft 18}{Enter 2}
send {NumPadLeft 18}{Enter 2}
send {NumPadRight 9}{NumPadDown 9}{Enter 2}
send {NumPadRight 18}{Enter 2}
send {NumPadRight 9}{NumPadDown 9}{Enter 2}
send {NumPadLeft 18}{Enter 2}
send {NumPadLeft 18}{Enter 2}
send {NumPadDown 9}{NumPadRight 9}{Enter 2}
send {NumPadRight 18}{Enter 2}
send {NumPadLeft 9}{NumPadUp 18}
}
</pre>

===Easy Exploration Mining in 2 steps===
This macro will make a 5 row, 11 column UP/DOWN stairway grid (2 empty spaces between each row/column). 
Starting point as indicated (row 3, column 11) 
'''MUST BE IN DESIGNATION MODE WITH CURSOR AT THE ''<-- START HERE'' LOCATION''' 
Link is <ctrl> <windowskey> ` 
Dive is <ctrl> <alt> ` 
<pre>
Link
X--X--X--X--X--X--X--X--X--X--X
| | |
| | |
X--X--X--X--X--X--X--X--X--X--X
| | |
| | |
X--X--X--X--X--X--X--X--X--X--X <-- start here
| | |
| | |
X--X--X--X--X--X--X--X--X--X--X
| | |
| | |
X--X--X--X--X--X--X--X--X--X--X
</pre>
Filename is ExploreMine-Link.ahk
<pre>
;Link
^#`::

send d
send {Enter}
tehLoop(30,"{NumPadLeft}")
send {Enter}
send {Enter}
tehLoop(6,"{NumPadUp}")
send {Enter}
send {Enter}
tehLoop(30,"{NumPadRight}")
send {Enter}
send {Enter}
tehLoop(12,"{NumPadDown}")
send {Enter}
send {Enter}
tehLoop(30,"{NumPadLeft}")
send {Enter}
send {Enter}
tehLoop(9,"{NumPadUp}")
send {Enter}
send {Enter}
tehLoop(30,"{NumPadRight}")
send {Enter}
tehLoop(6,"{NumPadDown}")
send {Enter}
tehLoop(30,"{NumPadLeft}")
send {Enter}
tehLoop(3,"{NumPadDown}")
tehLoop(15,"{NumPadRight}")
send {Enter}
tehLoop(12,"{NumPadUp}")
send {Enter}
tehLoop(15,"{NumPadLeft}")

send i
send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(6,"{NumPadUp}")

tehLoop(tehTimes,tehDir)
{
loop
{
if tehTimes <= 0
{
break
}
send %tehDir%
tehTimes--
}
}

tehOtherLoop(tehOtherDir)
{
loop 4
{
tehLoop(3,tehOtherDir)
send {Enter}{Enter}
}
}
</pre>

<pre>
Dive
X X X X X X X X X X X

X X X X X X X X X X X

X X X X X X X X X X X <-- start here

X X X X X X X X X X X

X X X X X X X X X X X
</pre>

Filename is ExploreMine-Dive.ahk
<pre>
;Dive
^!`::
tehLoop(30,"{NumPadLeft}")
tehLoop(6,"{NumPadUp}")

send i
send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(3,"{NumPadRight}")
send {Enter}{Enter}
tehOtherLoop("{NumPadUp}")
tehLoop(3,"{NumPadRight}")

send {Enter}{Enter}
tehOtherLoop("{NumPadDown}")
tehLoop(6,"{NumPadUp}")

tehLoop(tehTimes,tehDir)
{
loop
{
if tehTimes <= 0
{
break
}
send %tehDir%
tehTimes--
}
}

tehOtherLoop(tehOtherDir)
{
loop 4
{
tehLoop(3,tehOtherDir)
send {Enter}{Enter}
}
}

</pre>

===Fancy Exploration Mining===
This script digs a connected series of mine shafts, as in [[Mineshaft Stitching]]. Start this script in the upper-left corner of the area you want to explore. Set the spacing to a value greater than 1 if you want to look for large clusters. Note that this pattern creates a very long walkway back to the start of the mineshafts. If you do not excavate routinely, consider connecting the top-level paths of areas you have already explored.

<pre>

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; stitching.ahk ;
; this is an ahk script to place exploratory mine shafts. ;
; press d and place the cursor ;
; in the top left corner of the area to be explored ;
; then use ctrl+shift+s to run ;
; to change parameters, use ctrl+shift+c ;
; Increasing spacing will increase some shafts ;
; This version resets it's state so that it can be re-run ;
; without having to reload the script ;
; ;
; NOTE: ;
; Author: Corey Amend ;
; Based on a script by Seth Fogarty, ;
; Which was based on a script by StrawberryBunny ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

x = 4
y = 4
depth = 3
wait = 100
spacing = 1
vdir = +.

DropShaft(vertdir, depth, wait)
{
Send i
Send {Enter}
Send {Enter}
Loop %depth%
{
Send %vertdir%
Send {Enter}
Send {Enter}
Sleep %wait%
}
}

^+c::
inputbox x, Input Length, Vertical pattern length: x-axis
inputbox y, Input Width, Horizontal pattern width: y-axis
inputbox depth, Input Depth, Mineshaft depth: z-axis
inputbox spacing, Input Spacing, Spacing multiplier (1 for complete visiblity)
inputbox wait, Input Delay, Delay in miliseconds (100 recommended)
return

^+s::
shafts := (x * y) -1
i := x-1
hdir = {Down}
next = {Up}

Loop %shafts%
{
DropShaft(vdir, depth, wait)
if (vdir = "+.")
{
vdir = +,
}
else
{
vdir = +.
}
Send d
k := spacing-1
Send %hdir%
Send {Enter}
Loop %k%
{
Send %hdir%
Send {Enter}
Send %hdir%
Send {Enter}
Send %hdir%
Sleep %wait%
}
Send %hdir%
Send {Enter}
Send %hdir%
Sleep %wait%
i--
if (i = 0)
{
if (hdir = "{Down}")
{
hdir = {Right}
next = {Up}
i=1
}
else if (hdir = "{Right}")
{
hdir = %next%
i := x-1
}
else if (hdir = "{Up}")
{
hdir = {Right}
next = {Down}
i=1
}
}
}
DropShaft(vdir, depth, wait)
if (vdir = "+.")
{
Loop %depth%
{
Send +,
}
}
else
{
vdir = +.
}
return

</pre>

===Upstairs Mineshaft Finisher===
This script is used to create a series of up staircases in a pattern for use with mineshaft scripts (like the mineshaft stitching above). Most mineshaft scripts use up/down staircases all the way to the bottom, but the lowest z-level will not allow up/down staircases so you mineshafts will be unfinished. This script allows you to correct this problem and place up stairs where the up/down stairs would be.

<pre>

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; Upstair stitching.ahk ;
; this is an ahk script to place up stairs at regular ;
; intervals (useful for completing mine shafts). ;
; press d and place the cursor ;
; in the top left corner of the area to be explored ;
; then use ctrl+shift+u to run ;
; to change parameters, use ctrl+shift+p ;
; Increasing spacing will increase some shafts ;
; ;
; NOTE: ;
; Author: Corey Amend ;
; Based on a script by Seth Fogarty, ;
; Which was based on a script by StrawberryBunny ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

x = 4
y = 4
wait = 100
spacing = 1
vdir = +.

^+p::
inputbox x, Input Length, Vertical pattern length: x-axis
inputbox y, Input Width, Horizontal pattern width: y-axis
inputbox spacing, Input Spacing, Spacing multiplier (1 for complete visiblity)
inputbox wait, Input Delay, Delay in miliseconds (100 recommended)
return

^+u::
shafts := (x * y) -1
i := x-1
hdir = {Down}
next = {Up}

Loop %shafts%
{
Send u
Send {Enter}
Send {Enter}
Sleep %wait%

k := spacing-1
Send %hdir%
Loop %k%
{
Send %hdir%
Send %hdir%
Send %hdir%
Sleep %wait%
}
Send %hdir%
Send %hdir%
Sleep %wait%
i--
if (i = 0)
{
if (hdir = "{Down}")
{
hdir = {Right}
next = {Up}
i=1
}
else if (hdir = "{Right}")
{
hdir = %next%
i := x-1
}
else if (hdir = "{Up}")
{
hdir = {Right}
next = {Down}
i=1
}
}
}
Send u
Send {Enter}
Send {Enter}
Sleep %wait%

return

</pre>

===Interface Enhancement Scripts===

====The MOUSE control====
For unrivaled mouse control in DF try [http://www.dwarffortresswiki.net/index.php/User:Digger this DF Mouse script]

====Tile Counter or Scrolling Accelerator====
Lack of reference plus slow scroll speed make planning digging area frustrating,so here is the script that shows coordinate and speed scrolling up.
[http://www.dwarffortresswiki.net/index.php/User:Daedalusai ShowXY]

===4-Pour Water Creation script===
For Automating creation of water using Gibbeds Tweak.

<pre>
;
; 4-pour.ahk
; Dwarf fortress water creation script.
;
;Use this script in conjunction with Gibbeds Dwarf Fortress Tweak to create endless amounts of water.;
;
;Directions
;
;1. Have DF running and position the screen such that when you press "K" the X will appear where you

;want the water to appear.
;2. Have Gbbed's Dwarf Fortress tweak running in the background (with the proper process selected)
;3. run the 4-pour script
;4. press alt-p to get Pouring
;
;The script will then begin a cycle that moves the cursor around in a little 2x2 square editing each

;tile to have 7/7 of water, it then pauses for a half a seond to let the water flow a bit, and repeats.

;It does this until you..
;
;5. press and hold <shift> to stop
;
;As always, save before you experiment with this
;I hold no responsibility for what this script ends up doing to your dwarves/fortress/computer/carpet
;Feel free to clean it up, make it more usable, whatever
;
;

#NoEnv ; Recommended for performance and compatibility with future AutoHotkey releases.
SendMode Input ; Recommended for new scripts due to its superior speed and reliability.
SetWorkingDir %A_ScriptDir% ; Ensures a consistent starting directory.

!p::
loop

{
GetKeyState, state, Shift
if state = D
Break

IfWinActive Dwarf Fortress
{
WinActivate
}
send k
sleep 100
send {NumpadRight}

IfWinExist Gibbed's Dwarf Fortress Tweak [1.2.0.0]
{
WinActivate
}

click 38, 184, 2
sleep 100

IfWinExist Tile Edit
{
WinActivate
}
sleep 100
click 63, 448
sleep 100
click 106, 70
sleep 100
click 207, 255
sleep 100
send {backspace}
sleep 100
send 7
sleep 100
click 348, 449
sleep 100
IfWinExist Dwarf Fortress
{
WinActivate
}
sleep 100
send {NumpadDown}

IfWinExist Gibbed's Dwarf Fortress Tweak [1.2.0.0]
{
WinActivate
}

click 38, 184, 2
sleep 100

IfWinExist Tile Edit
{
WinActivate
}
sleep 100
click 63, 448
sleep 100
click 106, 70
sleep 100
click 207, 255
sleep 100
send {backspace}
sleep 100
send 7
sleep 100
click 348, 449
sleep 100
IfWinExist Dwarf Fortress
{
WinActivate
}
sleep 100
send {NumpadLeft}

IfWinExist Gibbed's Dwarf Fortress Tweak [1.2.0.0]
{
WinActivate
}

click 38, 184, 2
sleep 100

IfWinExist Tile Edit
{
WinActivate
}
sleep 100
click 63, 448
sleep 100
click 106, 70
sleep 100
click 207, 255
sleep 100
send {backspace}
sleep 100
send 7
sleep 100
click 348, 449
sleep 100
IfWinExist Dwarf Fortress
{
WinActivate
}
sleep 100
send {NumpadUp}

IfWinExist Gibbed's Dwarf Fortress Tweak [1.2.0.0]
{
WinActivate
}

click 38, 184, 2
sleep 100

IfWinExist Tile Edit
{
WinActivate
}
sleep 100
click 63, 448
sleep 100
click 106, 70
sleep 100
click 207, 255
sleep 100
send {backspace}
sleep 100
send 7
sleep 100
click 348, 449
sleep 100
IfWinExist Dwarf Fortress
{
WinActivate
}
send {space}
sleep 800
}

</pre>

===Tesselated Apartments Builder===

This one is another tesselated apartments script, with some larger areas added. Credit for layout to GnomeChomsky.

<pre>
;
; TessApts.ahk
; Start script while in 'dig' mode with cursor on desired position of leftmost staircase
;
; CTRL+G : Central room, 8 apartments (necessary on at least one z-level)
; ALT+G : No central room, 16 apartments
; CTRL+ALT+G : Four "central room" layouts connected in center (28 apartments)
; CTRL+SHIFT+G : Four "16 apartment" layouts, unconnected in center
;
!g::
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}114444444
return
^g::
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}
Send 7444{ENTER}{ENTER}1114{ENTER}{ENTER}3332{ENTER}{ENTER}9996{ENTER}{ENTER}788{ENTER}11111{ENTER}
return
!^g::
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}
Send 7444{ENTER}{ENTER}1114{ENTER}{ENTER}3332{ENTER}{ENTER}9996{ENTER}{ENTER}788{ENTER}11111{ENTER}88899999999
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}
Send 7444{ENTER}{ENTER}1114{ENTER}{ENTER}3332{ENTER}{ENTER}9996{ENTER}{ENTER}788{ENTER}11111{ENTER}3333332
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}
Send 7444{ENTER}{ENTER}1114{ENTER}{ENTER}3332{ENTER}{ENTER}9996{ENTER}{ENTER}788{ENTER}11111{ENTER}111114444444
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}
Send 7444{ENTER}{ENTER}1114{ENTER}{ENTER}3332{ENTER}{ENTER}9996{ENTER}{ENTER}788{ENTER}11111{ENTER}
Send 9988888888{ENTER}999{ENTER}+444444
return

+^g::
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}888889
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}+221
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}+1+46
Send i{ENTER}{ENTER}33332{ENTER}{ENTER}99996{ENTER}{ENTER}77778{ENTER}{ENTER}
Send d7{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 111{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}
Send 333333{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}32{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}
Send 99999988{ENTER}66{ENTER}2{ENTER}{ENTER}14{ENTER}22{ENTER}4{ENTER}{ENTER}78{ENTER}44{ENTER}8{ENTER}{ENTER}96{ENTER}88{ENTER}6{ENTER}{ENTER}+71144444
</pre>

===File pattern builder===

This is a script to create a macro out of any building pattern you like. If you like tesselated, this script will do it. If you like blocky, this script can do that, too. Just create a text file that contains the pattern you want to use and this macro will create it like nobody's business.

<pre>

;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;
; File Pattern.ahk ;
; this is an ahk script to read a text file and use ;
; the pattern contained inside as a blueprint for digging ;
; press d and place the cursor ;
; in a corner of the area to be explored ;
; then use ctrl+shift+d to run ;
; to change parameters, use ctrl+shift+f ;
; ;
; NOTE: ;
; Author: Corey Amend ;
;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;

filename = C:\pattern.txt
loc = ul
wait = 100

wallsymbol = 1
floorsymbol = 0
updownsymbol = 2
downsymbol = 3
upsymbol = 4
rampsymbol = 5
channelsymbol = 6

digcommand = d
upcommand = u
downcommand = j
updowncommand = i
rampcommand = r
channelcommand = h

hdir = {Right}
vdir = {Down}

upperleft = ul
upperright = ur
lowerleft = ll
lowerright = lr

inrun = 0

^+f::
inputbox filename, Enter Path, Enter the full path to the file that contains the pattern to use
inputbox loc, Enter Cursor Location, Enter the location of the cursor within the pattern (Upper Left = ul`, Lower Right = lr...etc.)
inputbox wait, Enter Delay, Enter the delay to use (default is 100)
return

^+d::

IfExist, %filename%
{
FileRead, contents, %filename%
StringSplit Array, contents, `r, `n

if (loc = upperleft)
{
hdir = {Right}
vdir = {Down}
}
else if (loc = upperright)
{
hdir = {Left}
vdir = {Down}
}
else if (loc = lowerleft)
{
hdir = {Right}
vdir = {Up}
}
else if (loc = lowerright)
{
hdir = {Left}
vdir = {Up}
}
else
{
MsgBox, Invalid cursor location!
return
}

Loop %Array0%
{
if (loc = upperleft || loc = upperright)
{
current_line = %a_index%
}
else if (loc = lowerleft || loc = lowerright)
{
current_line := (Array0 - a_index + 1)
}

current_value := Array%current_line%

len := StrLen(current_value)

if (hdir = "{Left}")
{
new_value =

Loop %len%
{
new_value := new_value . SubStr(current_value, (len - a_index) + 1, 1)
}

current_value := new_value
}

Loop %len%
{
current_char := SubStr(current_value, a_index, 1)

if (current_char != wallsymbol)
{
if (!inrun)
{
if (current_char = floorsymbol)
{
Send %digcommand%
}
else if (current_char = updownsymbol)
{
Send %updowncommand%
}
else if (current_char = downsymbol)
{
Send %downcommand%
}
else if (current_char = upsymbol)
{
Send %upcommand%
}
else if (current_char = rampsymbol)
{
Send %rampcommand%
}
else if (current_char = channelsymbol)
{
Send %channelcommand%
}

Send {Enter}
inrun = 1
}

;;If we're at the end of a line or the next char is different, then end the run
if ((a_index >= len) || (current_char != SubStr(current_value, a_index + 1, 1)))
{
Send {Enter}
inrun = 0
Sleep %wait%
}
}

if (a_index < len)
{
Send %hdir%
}
}

if (a_index < Array0)
{
Send %vdir%

if (hdir = "{Right}")
{
hdir = {Left}
}
else if (hdir = "{Left}")
{
hdir = {Right}
}
}
}
}
else
{
MsgBox File not found
}

</pre>

Sample file to show how this all works:

<pre>

111111
100001
100201
103001
100401
105001
100601
100001
111111

</pre>

This creates a room filled with up/down stairs, a ramp, and a channel.

And finally, here's a sample pattern based on the decentralized workshop:

<pre>

1111111111111111111111111111111111111
1000000000000001000001000000000000001
1000000000000001000001000000000000001
1000000000000000000000000000000000001
1000000000000001000001000000000000001
1000000000000001000001000000000000001
1000111101111111110111111111011110001
1000100000001000100010001000000010001
1000100000001000100010001000000010001
1000100000001000100010001000000010001
1000000000000010000000100000000000001
1000111101111000100010001111011110001
1000100000001000100010001000000010001
1101100010001000100010001000100011011
1000100000001000100010001000000010001
1000111101111111100011111111011110001
1000100000000000030400000000000010001
1010000000000000030400000000000000101
1000100000000000030400000000000010001
1000111101111111100011111111011110001
1000100000001000100010001000000010001
1101100010001000100010001000100011011
1000100000001000100010001000000010001
1000111101111000100010001111011110001
1000000000000010000000100000000000001
1000100000001000100010001000000010001
1000100000001000100010001000000010001
1000100000001000100010001000000010001
1000111101111111110111111111011110001
1000000000000001000001000000000000001
1000000000000001000001000000000000001
1000000000000000000000000000000000001
1000000000000001000001000000000000001
1000000000000001000001000000000000001
1111111111111111111111111111111111111

</pre>

{{Game_Interface FAQ}}
[[Category:ahk scripts]]

40d:Utilities

2009-07-20T02:24:39Z

Joelpt: Added Quickfort, minor reorg

Here are third party applications developed for Dwarf Fortress.
__TOC__
== [http://dffd.wimbli.com/ Dwarf Fortress File Depot] ==
The Dwarf Fortress File Upload Service - an excellent place to store mods, community games, tilesets and other files. Courtesy of [[User:Janus|Janus]]; for files related to Dwarf Fortress only.

== Movies, Screenshots, Map Files ==

=== DF Map Compressor / DF Map Archive ===

*[http://shadowlord13.googlepages.com/dfmap-index.html SL's DF Map Compressor - Website]
*[http://mkv25.net/dfma/ Dwarf Fortress Map Archive]

The DF Map Compressor encodes multiple bitmaps exported from Dwarf Fortress into a single, very compressed, .fdf-map file. The fdf-map file can then be shared with your friends by uploading to the DF Map Archive that features an online viewer (written in Flash).

The map compressor was created by Shadowlord in May 2007. Extract from the website :
:"The '''DF Map Compressor''' is a program I made to encode Dwarf Fortress fortress or world map images into a much smaller format than is possible with normal image formats. Here's a quick summary of how it works: It determines the size of your tiles from your DF font file (or asks you), splits the map up into tiles, identifies duplicate tiles, writes out every unique tile image, and then writes out a list of ID#s for each tile position which points to the tile image for that tile. What it outputs is piped through the LZMA compressor (the one used in 7-zip), to compress it further. The .df-map file which it writes out is usually less than 100 KB in size. (By comparison, a PNG of the same map can exceed 2 megabytes, depending on how well you compress it, whether you change the color depth, and whether you are using a graphical tileset or detailed font)."

Read more about the [[User:Markavian/DF_Map_Archive|DF Map Archive]] on Markavian's User page.

=== [http://www.bay12games.com/forum/index.php?topic=608.0 3Dwarf Visualizer] ===

This is NOT real time! Dwarvis has the ability to be real time, though 3Dwarf is much more recommended. What this does is read the map out of your computer's memory when Dwarf Fortress is running and save it to a file it can read. It can then open that file and show you your fort in glorious 3D. Still in beta, obviously.

=== [http://www.bay12games.com/forum/index.php?topic=34633.0 Khazad] ===

A related fortress viewing engine utilizing memory extraction and saving similar to 3Dwarf, Khazad uses an Isometric perspective reminiscent of SimCity200 & Transport Tycoon while also allowing very free form camera control in a full 3D environment. Khazad is compatible with 40d and 40d11 and entirely open source being licensed under the GPL, source and binary packages are available at [http://sourceforge.net/projects/khazad/ SourceForge]. Development is active and participation is welcome.

=== [http://www.geocities.com/jifodus/CMVPlayer.zip CMVPlayer] ===

First released by Jifodus in April 2007. This application enables playback of the DF movies (.cmv) without starting DF. It also provides some more functionalities, such as :
* Rewind
* Pause
* Play frame per frame

To use, simply unzip the file, and drop and drag the movie on CMVPlayer.exe.

=== [http://dffd.wimbli.com/file.php?id=389 DwarfHeightmap] ===

A utility that imports 24bit greyscale bitmaps into world_gen.txt for use in DF's map generator.

=== Terrain Visualizer ===

View worldmaps in 3D! This utilizes version 0.28.181.39d's built in Legends Mode map exporter and a generic HeightMap terrain visualizer. Nothing super fancy, but neat to look at.
Get the [http://www.alpix.com/3d/TerrainViewer/ 3D Terrain Viewer] here, follow the instructions in the [http://www.bay12games.com/forum/index.php?topic=21468 Bay12Forums Thread] if you need help getting set up.

Or if you want super pretty maps, [http://www.bay12games.com/forum/index.php?topic=21469.0 see this topic], and get [http://www.planetside.co.uk/terragen/download.shtml Terragen]!

==Major Utilities==

=== [[User:Bartavelle/DwarfCompanion|Dwarf Companion]] ===

Created by [[User:Bartavelle|Bartavelle]], the Dwarf Companion is a graphical helper utility for dwarf fortress that aims to fill the gaps in the user interface. It allows for some nefarious cheating. For example, you can now mark your nobles as butcherable, and change possessed dwarves to fey moods.

=== [http://sun2design.com/quickfort/ Quickfort] ===

Quickfort is an AutoHotkey-based utility for Dwarf Fortress that helps you build fortresses from "blueprint" .CSV files (comma separated values). These files are easily created and edited in an app like Excel. Most building-oriented DF commands are supported through the use of multiple .CSV files to describe the different phases of DF construction (designation, building, stockpiles, and making adjustments).

=== [http://dwarfmanager.sourceforge.net/ Dwarf Manager] ===

Dwarf Manager is inspired by Dwarf Foreman (below) and has a similar overall layout, but improved features. You can not only assign jobs to profession groups but also to individual dwarves; you can view their current skill for a given job displayed handily in the job grid; and you can also change their personal and profession names straight from the interface. The program handles social and military skills as well.
In addition the program can be customized and updated by editing the included .xml files.

=== [http://www.pavlovian.net/foreman/ Dwarf Foreman] ===

Makes switching jobs on and off for large numbers of dwarves simple. Dwarves are grouped by their profession, or custom profession if they have one. By clicking on the graph you can enable any job for all dwarves with that profession. Still in alpha for this version of DF, if it doesn't recognize one of the new professions, check the file '''debug.txt''' in the directory you run foreman from.

Though prone to crashing currently, saving and exiting DF, starting foreman and then starting DF again will usually get it working again. Zorba would also appreciate it if you'd email him the crash log located in the Dwarf Foreman directory when this happens (zorba-foremancrash@pavlovian.net).

Dwarf Foreman currently allows you to change the jobs of visiting merchants, outpost liaisons, children, and any other dwarves that aren't normally controllable. It is unsupported but occasionally hilarious, and allows you to finally put those lazy dwarven children to work.

Source code is available.

To make Foreman compatible with '''v0.28.181.40d''', update config file as shown below. Use the [[Talk:Utilities#Dwarf Foreman|talk page]] for previous versions of DF.
<pre>
check=032e4b67
critter_start=01583224
dwarfidpos=0138f690
profession_start=0474
</pre>

'''Note:''' A Dwarf Foreman-like utility, with an expanded feature set, is also available. See Dwarf Manager below.

=== [http://dffd.wimbli.com/file.php?id=695 Mac Foreman] ===

This is a MacOSX 10.5 port of Dwarf Foreman.

Source code is available.

Dwarf Fortress version: '''v0.28.181.40d'''

=== [[User:Rick/Tweak|Gibbed's Dwarf Fortress Tweak]] ===

A toolset with many modules for tweaking / editing Dwarf Fortress memory.

=== [http://www.bay12games.com/forum/index.php?topic=18623.0 Modbase] ===

Modbase is a great tool made by Sean Mirrsen which allows you to freely swap mods and tweak game settings. For version 0.38c.

== Minor Utilities ==

=== DF Log Parser ===

A perl script written by Mephansteras that parses through the logs to show what civs owned what sites, what their overall populations were, and what the overall population levels of cave critters were. The output file makes it pretty easy to see how the various races are doing.

You will see:
Each Civilization, with overall ruler. Each site in that civ, with the local ruler. A summary of every entity in that civ.
A summary of every civ, by race
A listing of every Ruin
A listing of the total populations of cave critters
A listing of the total populations of civilized creatures

[http://dffd.wimbli.com/file.php?id=299 Raw perl script] - requires perl
[http://dffd.wimbli.com/file.php?id=311 Executable version] - does not require perl

=== [http://dffd.wimbli.com/file.php?id=278 DF World Generator] ===

Swiftly written supplement to the command line world generator. Written in Python, so you have to have Python installed to use this. It must be run from the command line and be in the DF Directory to work. Running the program with no parameters will provoke a short help-me dialog which will explain how to run it properly.
Enjoy!

=== [http://www.bay12games.com/forum/index.php?topic=949.0 Dtil] ===

Dtil is a general purpose tool host that supplies a dynamically generated SDK for plugin authors.

=== [http://www.bay12games.com/forum/index.php?topic=21351.0 Embark Anywhere] ===

Code based on 0x517A5D's Regional Prospector (above), allows you to embark ANYWHERE, how well that works depends on where you decide to go. Pure water areas are a suggested no as you can't do anything.

=== [http://dffd.wimbli.com/file.php?id=443 Enable Magma Buildings] ===

You need this utility in the case that you used the reveal utility, and you had not yet discovered any subsurface magma. (If the hide utility is ever updated, you could also hide a few magma tiles and then dig them out. That worked in the old version.) Because there is no actual flag that controls whether magma has been seen (the game searches a list, probably a list of notable events), I had to patch the game's code. This means you need to run the utility every time you start dwarfort.exe.

This utility has been made version-independent. It is expected to work with future releases of Dwarf Fortress.

=== [http://www.geocities.com/jifodus/justdigitout.zip Just dig it out!] ===

A utility by Jifodus. Disables warning messages about damp stone and hot stone. [http://www.bay12games.com/forum/index.php?topic=21892.0 Thread]

=== [http://www.geocities.com/jifodus/nanofortress.zip Nano Fortress] ===

A utility that will allow embarks to 1x1 locations.

=== [http://angband.org/~erasmus/df/teleport22.zip Teleport] ===

Teleport dwarves and other creatures. Version 2.2 is independent of the DF version. (33c)

Note: This utility may not work on versions of DF 40d and later. If it doesn't work for you, try Dwarf Companion.

Caveat: The teleport utility does not correctly set the occupancy flag for map squares. As a results, dwarves will permanently crawl through the square that you teleported them out of. In addition, you cannot build structures in those squares.

=== [http://dffd.wimbli.com/file.php?id=645 Reveal] ===

Old version of reveal (a tool that reveals tiles of a map in fortress mode), with updated memory.ini file for version 0.28.181.40d. It does not require you to install anything (unlike the new version that can be found in Gibbed's Dwarf Fortress Tweak), just unzip both files and run reveal.exe while DF is running.
To reveal entire map designate the entire bottom level to be mined and then remove designation before running reveal. '''Using Reveal has been known to corrupt saved game folders.''' Playing on revealed map might ''(read "will")'' cause some bugs (like not being able to build magma buildings or a tower-cap farm, losing all plants/trees on the map, etc. etc.).

A version of Reveal that works with Vista and Windows 7 is currently in public beta. It can be downloaded at [http://dffd.wimbli.com/file.php?id=1044 Reveal2]. Please report problems in [[User_talk:0x517A5D|0x517A5D's Talk page]].

== Miscellaneous ==

These utilities were never designed with Dwarf Fortress in mind, but have been adapted to its use.

=== [[User:Jackard/Accent_Removal|Accent Removal]] ===

Certain tilesets leave a bunch of funky icons in the names of your dwarves! Replacing accented letters with normal ones in the raws fixes this problem.

=== [http://www.autohotkey.com/ AutoHotKey] ===

AHK lets you define global hotkeys to send a sequence of keystrokes. For example, you can have {{key|alt}}+{{key|w}} replace {{key|b}}-{{key|C}}-{{key|w}}-{{key|Enter}}-{{key|Enter}} to make wall building much easier. See [[Macros and Keymaps]] for a how-to and some example scripts. See [[:Category:ahk scripts]] for a list of user submitted scripts.

=== [http://winmerge.org/ Winmerge] ===

This utility allows you to compare folders or files. It highlights anything that does not fit in with the other file, so that you can see if you want to merge them into one file or not..

== Outdated Utilities ==

These programs are for previous versions of Dwarf Fortress, and have been left untouched for some time.

=== [http://dffd.wimbli.com/file.php?id=108 DFWall] ===

An utility for automation of mass constructions. Features three modes:

1. Rectangle rewalling - quickly build a rectangle of walls/floors using:
a) the same saved material every time ([http://mkv25.net/dfma/movie-495-dfwalldemo DEMO])
b) any material with at least 1/10/99 units

2. Quick reselect (for ANY single unit construction) - save that green glass box and never again have to look for it between all the bags!

3. Pattern construction - make a pattern file and have stuff constructed according to it ([http://mkv25.net/dfma/movie-520-dfwalldemo2 DEMO]).

For more details look here: [http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=2&t=001847 Thread]

=== [http://code.google.com/p/dwarvis/ Dwarvis/MapExtract] ===

This project is meant as a 3rd party utility for the cult-game dwarf fortress. Its purpose is to eventually provide 3-dimensional visualization of static snapshots of the ingame world of a given fortress.

=== [http://www.yourfilehost.com/media.php?cat=other&file=latitudes.zip Latitudes] ===

Latitudes is a utility that, when on the embark map screen, shows the X/Y coordinates of the current region. Until Toady adds [http://www.bay12games.com/cgi-local/ultimatebb.cgi?ubb=get_topic&f=5&t=002191 proper support], this will do the trick. Works in .32a through at least .33g. Technical notes: uses memory injection, so it may be flagged as a suspicious file by anti-virus programs.

=== [http://angband.org/~erasmus/df/lavasquare.exe Lavasquare] ===

Another quick hack to make a 7/7 unit of lava on the currently selected square. Ignore the random text it spams, as it was quickly adapted from a map query tool, and I didn't bother removing the print statements. Only works with version 33e. To hack this executable for a later version of dwarf fortress see the [[Talk:Utilities#Lavasquare|talk page]].

33g version plus autohotkey script: http://www.sendspace.com/file/xsl6gs

=== [http://www.bay12games.com/forum/index.php?topic=1447.0 StartProfile] ===

Jifodus wrote a little utility that lets you maintain profiles of your starting dwarves.

Check the thread on the forums for the latest download link. (Aug 01, 2008)

Incidentally, if you try this utility, please report success/failure in [[Talk:Utilities#StartProfile|the utilities talk page]].

=== [http://angband.org/~erasmus/df/water.exe Water] ===

Quick hack to refill ponds. Run this while your fortress is up, and it'll restore any "murky pool" tiles (i.e. the floor of ponds and lakes) to 7/7 water. If you've tunneled into a pond, it'll still refill but will flow out normally. Only works with version 33e due to its "quick hack" status. Note: If there is lava in a murky pool, it will be raised to depth 7/7.

[[Category:Utilities| ]]