Dwarf Fortress Wiki - User contributions [en]

Utility:Lazy Newb Pack

2017-11-28T11:29:55Z

PeridexisErrant: /* History of packs */ Split first section into chronological order

{{Quality|Exceptional|02:12, 3 November 2014 (UTC)}}
{{uv|DF2014}}

The Lazy Newb Packs or Starter packs are packages to get people started with Dwarf Fortress. Simply download the one for your operating system and start playing Dwarf Fortress with all the best utilities and graphics/tilesets.

Despite the name, the modern packs are ideal for new and veteran players alive. Using a pack lets you focus on playing the game, while still having access to quality of life additions like graphics/tilesets, utilities, and being able to change common settings without editing text files.

Packs also make a great basis to start your own set of modifications from as you don't need to find, configure, compile, install, and update every tool for yourself.

Separate packs are available for Windows, Mac, and Linux. Each platform's version is maintained by different community contributors. These can be found further down this page.

== What is a Pack? ==

A Starter pack or Lazy Newb pack includes all the utilities that a veteran player might want, while configuring everything in such a way that it is still easier for new players. In general, it's safe to simply ignore any option you don't understand and trust that the default settings will be okay.

The packages are built around the idea that newbies will likely have more difficulty with the game than with a package of utilities - which often make the game easier - and that there are many players who are not new but would still prefer an option to get all the extras in one place with a minimum of fiddling. Most include just about everything that still works and could be useful.

It is also important to note that most of the contents of each pack were created by many members of the community and just collected, configured, and redistributed by the maintainer of each pack. Of course there are a few personal touches too, but the vast majority of each is thanks to others - and not least Tarn and Zach for Dwarf Fortress itself.

== Where do I get a Pack? ==

{{#randorder:
===[http://www.bay12forums.com/smf/index.php?topic=126076 Windows: PeridexisErrant's DF Starter Pack]===

This pack is maintained by PeridexisErrant, and aims to include everything - while ensuring that ignoring any option still works for new players. Contents and a changelog are listed on the forum thread (linked above).
|
===[http://www.bay12forums.com/smf/index.php?topic=163211.0 Linux: Enay's LinuxLNP]===

This package by Enay is a traditional package of compiled utilities, actively maintained and tested on Debian Jessie (64bit). It should work out-of-the-box with Debian-derived (Ubuntu, Mint, etc.) distributions, but support or continuing updates are not guaranteed.
|
===[http://www.bay12forums.com/smf/index.php?topic=158322.0 Mac: Lazy Mac Pack]===

A Lazy Newb Pack for Mac with lots of graphics packs but with not so many utilities.
|}}

== History of packs==

Maintaining a pack is a lot of work and over the years people inevitable lose time or motivation to update their packs. Eventually someone new steps up and releases their own pack.

This section is provided for information, and should not be interpreted as a recommendation for these packs. It may however be interesting to look back at how the LNP/Starter Pack movement evolved.

==== The first Lazy New Pack ====

[[image:Lazy-newb-pack-screenshot.0.31.12.v4.6.png|frame|right|Screenshot of the primary user interface in Lazy Newb Pack v4.6 for DF 0.31.12 from June 2010. Created on Linux in 2017 with wine. ]]
[[image:Lazy-newb-pack-screenshot2.0.31.12.v4.6.png|frame|right|Screenshot of the graphics selection screen in Lazy Newb Pack v4.6 for DF 0.31.12 from June 2010. Created on Linux in 2017 with wine. ]]

The first pack with the name Lazy Newb Pack (LNP) was created by [http://www.bay12forums.com/smf/index.php?action=profile;u=16293 LucasUP] for Windows and DF version 0.31.12 and posted [http://www.bay12forums.com/smf/index.php?topic=59026 | in the bay12forums] on June 11, 2010. Before the LNP, it was becoming common for the community to bundle up their own distributions of Dwarf Fortress with tile sets, graphics, and mods to make them more accessible to players. Other notable packs from this era are [http://www.bay12forums.com/smf/index.php?topic=57557.0 Phoebus graphics] and [http://www.bay12forums.com/smf/index.php?topic=53649.0 Mayday's Graphic Set]. The LNP distinguished itself by providing an interface for changing common DF settings, instead of editing the raw text files included with the game.

The first versions of the LNP included a text-based interface (seen on the right) that only permitted the user to enable/disable [[aquifers]] and choose from the Phoebus, Mayday, and Ironhand graphics packs. They included the utilities [[DFHack]], [[Dwarf Foreman]], [[Dwarf Therapist]], [http://www.bay12forums.com/smf/index.php?topic=57428.0 PerfectWorldDF], [http://www.joelpt.net/quickfort/ Quickfort], [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] , [[Stonesense]].

==== The original launcher with a GUI ====

On December 31, 2010 [http://www.bay12forums.com/smf/index.php?topic=59026.msg1845333#msg1845333 LucasUP released] the first version of the Lazy Newb Pack that contained the graphical interface launcher that is well known today. It became the key component of the pack, which allows easy configuration of the DF installation, choose graphics packs, launching of utilities, and provided one click toggling of settings instead of editing configuration files by hand. The original launcher was built with Visual Basic and .NET 3.5, and for several years this meant that the LNP was only available for Windows systems.

In 2012 Dricus created a [http://www.bay12forums.com/smf/index.php?topic=124613 Java-based launcher], which was cross platform and more flexible, but also required manual configuration. This launcher was never finished and so never achieved wide usage, however some early Mac and Linux packs were available based on this version. It wasn't a complete pack, but just the launcher component that could be used to build platform-specific packs.

<gallery widths=200px>
File:Lnp-gui1.png|The original LNP launcher, Options Tab
File:Lnp-gui2.png|The graphics tab
File:Lnp-gui3.png|The utilities tab
File:Lnp-gui5.png|The advanced tab
</gallery>

==== The End of the First Age ====

In order to elicit help and contributions from the community LucasUP opensourced his graphical interface in February 2013 by releasing [https://github.com/LucasUP/LazyNewbPack/| the source on github] ([http://www.bay12forums.com/smf/index.php?topic=123384.0 forum post]).

By the late autumn of year 2013 the LNP was out of date with new DF releases, and users were clamoring for an update. LucasUP's life had become to busy to focus on the LNP. On November 16, 2013 LucasUP declared his tenure as overseer over, thanked the community for their support and gave his blessings for the successor packs that had appeared on the scene.

<blockquote>
<div style="border: 1px dashed grey; padding: 5px;">
Hello guys. I think I have to apologize for my long absence. :(

Yes it was my intention to let others work on and maybe eventually take over The Lazy Newb pack after I had released it open source. But It was NOT my intention to go dead silent for so long and have it be such a forced/jarring transition. I'm really sorry about that.
Of course other life responsibilities took me away from LNP, but I don't really have great excuses for why I didn't at least give you guys any updates on myself or re-direct you to other versions sooner, other than just my mind has been elsewhere.

Sorry for any frustration this has caused you guys, and I hope I haven't caused too much ill-will. I feel like a jerk and like I've just been trying to avoid confronting that. :(
I've updated the OP to link to the new Windows/Linux/Mac packages. If there's anything else you guys would like to see from me, I am happy to hear from you.
I do read and respond to my PMs too, if you wanted to say/ask me something in private.

Edit:

I just also wanted to say, on a more positive note, that I am really happy and proud to see how many people have cared enough about LNP to want to continue it and work on it. The fact that there is now working and regularly updated Win/Mac/Linux versions is really fantastic, and its something I would have never achieved myself. So, thanks to the DF community! You guys and girls are awesome.
</div>
</blockquote>
-- [http://www.bay12forums.com/smf/index.php?topic=59026.msg4768489#msg4768489 original post]

==== PyLNP: The modern cross platform launcher ====

In mid-2014 Pidgeot released the [http://www.bay12forums.com/smf/index.php?topic=140808 PyLNP launcher] built in Python and compatible with all platforms. As of 2017 the PyLNP is the core launcher of all lazy newb / starter packs available. A number of improvements to the feature set have been made since the original windows-only launcher by LucasUP, including raw merging of graphics to perserve settings, mod management, color schemes, and managing multiple installations of Dwarf Fortress. There are [http://pylnp.birdiesoft.dk/docs/dev/#id5 even more] not mentioned here.

All modern packs since 2014 use the PyLNP launcher. Note that "PyLNP" and "LNP" are not interchangeable - the former refers to the launcher itself, while the latter refers to a pack as a whole.

PyLNP started as a port of LucasUP and tolyK’s Lazy Newb Pack Launcher to Python, with the goal of making a launcher available on all the platforms supported by Dwarf Fortress. Its biggest innovation is the [http://pylnp.birdiesoft.dk/docs/dev/content.html PyLNP content format], a standard for defining manifests for graphics, tilesets, keybinds, utilities, etc that allows a modular and custom pack to be built.

=== Lazy? Newb? Starter Pack? ===

The original pack by LucasUP was named the Lazy Newb Pack, and LucasUP themselves explained the name as "This package is for *Newbs* and those too *Lazy* to put everything together every new version" (emphasis original). Most derivative packs over the years have retained that name more out of brand recognition and as homage to LucasUP's first attempts.

In November 2013 PeridexisErrant, the maintainer of the current pack for the Windows platform, renamed his pack from "PeridexisErrant's LNP" to "PeridexisErrant's Starter Pack". He [https://www.reddit.com/r/dwarffortress/comments/1qt7c1/df_starter_pack_updated_classic_lazy_newb_pack/cdgpqxq/ has said] the primary reason for the renaming was to distinguish the old legacy LNP from his own pack when providing support to players, as often players would have a problem with the pack and ask PeridexisErrant for help only for him to discover they were using an older version of the pack that he didn't publish nor maintain. He changed the name before the [[DF2014:Release_information|big 2014 release]] in order to help steer new players towards his new maintained starter pack, and prevent them from finding and using old unsupported versions of the LNP.

PeridexisErrant has also said that the purview of the pack has expanded over the years and is no longer just for those new to the game (newbs) but also for experienced players, and that he disliked the term "lazy" for derogatorily implying that players are lazy. Given the difficulty and challenges associated with Dwarf Fortress, where to be come proficient one must work hard and expend effort, it is safe to say that its players are not lazy.

The maintainers of the different Mac OSX packs have used different names over the years including MacNewbie, and Lazy Mac Pack. The Linux maintainers have remained with the original LNP moniker.

=== Other historical packs ===

Early on, while there were releases of Dwarf Fortress for Mac and Linux, there were no Lazy Newb Packs offered. The very first batch-script based version of LucasUP's LNP inadvertently worked on Linux via wine, but after the switch to the GUI launcher built with .NET, support for Linux was lost.

The general availability of GUI based launchers (and the packs built around) them for Mac and Linux didn't come about until Dricus' java-based launcher project [http://www.bay12forums.com/smf/index.php?topic=130236.msg4521675#msg4521675 in August 2013].

==== Mac OS X ====
In April 2012, [http://www.bay12forums.com/smf/index.php?action=profile;u=69756 iXen] released [http://www.bay12forums.com/smf/index.php?topic=106790.0 the MacNewbie Pack] as an alternative to the Windows LNP. It was for version r 0.34.07 of Dwarf Fortress. The pack was updated for several months until its final release v0.6 Cyan in May. The pack was notable as it included the first GUI launcher for Mac OS. It was built with Apple's Cocoa technology and included special keybindings to make gameplay easier on Apple Wireless & MacBook Keyboards.

<gallery widths=200px>
File:Macnewbie2.png|Screenshot of the MacNewbie pack v0.6 Cyan for Dwarf Fortress v0.34.11 by iXen.
File:Macnewbie1.png|Screenshot of the MacNewbie pack v0.6 Cyan for Dwarf Fortress v0.34.11 by iXen.
</gallery>

[http://www.bay12forums.com/smf/index.php?action=profile;u=94479 Fricy] released [http://www.bay12forums.com/smf/index.php?topic=128960 his spiritual successor] to the MacNewbie pack on July 10, 2014 for Dwarf Fortress v0.40.01. It was based on Dricus' cross platform java launcher has 26 releases from July 2014 until November 28, 2015. It was last updated in November 2015 in January Dwarf Fortress v0.42.04.

==== Linux ====

The [http://www.bay12forums.com/smf/index.php?topic=130792 Lazy Newb Pack Installer for Linux] created by Andrewd18 in September 2013, was a Linux installer shell script that installed the Dwarf Fortress Lazy Newb Pack. It downloaded and built a DF installation from available source code and binaries, and also checked for the dependencies required by 64-bit systems. The home of this pack was [https://github.com/andrewd18/df-lnp-installer on Github]. It was last updated on June 2014 for Dwarf Fortress v0.34.11.

[http://www.bay12forums.com/smf/index.php?topic=140966 Beautato's Linux Lazy Newb Pack] released in July 2014 was a more traditional package of compiled utilities that was previously maintained and tested on Ubuntu. It was last updated in March 2015 for Dwarf Fortress v0.40.24.

In March 2017 [http://www.bay12forums.com/smf/index.php?action=profile;u=114577 Enay] took up maintainership of the LNP for Linux calling it [http://www.bay12forums.com/smf/index.php?topic=163211.0 LinuxLNP] and released only for 64-bit systems.

== The Making of a Pack ==

There are many people involved in the making of a LNP/Starter pack for Dwarf Fortress, starting from Tarn and Zach releasing DF, to they many tilesets and graphics creators, the creators of the utilities (e.g, Soundsense, Dwarf Therapist), the reverse engineering work down by the [[DFHack]] folks, to the many more who contribute on the forums, help manage bug reports, create and test mods, etc.

Creating a pack is a process of curating a set of tilesets, graphics, and utilities and bundling them together with a launcher as well as the latest Dwarf Fortress release, then, optionally, making this bundle available for download

Over the years the process of making a pack has become more formalized and automated, and a community has formed to make the process easier and provide continuity when someone inevitably retires.

As of 2017, pack maintenance and creation is centered around the following projects:

* The [https://bitbucket.org/Pidgeot/python-lnp PyLNP launcher] is maintained by Pidgeot and is available on bitbucket
* The [https://github.com/Lazy-Newb-Pack LazyNewbPack organization on github] provides a home for shared resources and code
* The [https://github.com/DFgraphics/DFgraphics DFgraphics github repository] is a shared home for graphics and tilesets to ease routine maintenance
* The [https://github.com/PeridexisErrant/starter-pack starter-pack builder] by PeridexisErrant that helps build a pack from scratch

{{Category|Utilities}}

Utility:Lazy Newb Pack

2017-11-28T11:28:14Z

PeridexisErrant: /* The Making of a Pack */ minor grammatical changes

{{Quality|Exceptional|02:12, 3 November 2014 (UTC)}}
{{uv|DF2014}}

The Lazy Newb Packs or Starter packs are packages to get people started with Dwarf Fortress. Simply download the one for your operating system and start playing Dwarf Fortress with all the best utilities and graphics/tilesets.

Despite the name, the modern packs are ideal for new and veteran players alive. Using a pack lets you focus on playing the game, while still having access to quality of life additions like graphics/tilesets, utilities, and being able to change common settings without editing text files.

Packs also make a great basis to start your own set of modifications from as you don't need to find, configure, compile, install, and update every tool for yourself.

Separate packs are available for Windows, Mac, and Linux. Each platform's version is maintained by different community contributors. These can be found further down this page.

== What is a Pack? ==

A Starter pack or Lazy Newb pack includes all the utilities that a veteran player might want, while configuring everything in such a way that it is still easier for new players. In general, it's safe to simply ignore any option you don't understand and trust that the default settings will be okay.

The packages are built around the idea that newbies will likely have more difficulty with the game than with a package of utilities - which often make the game easier - and that there are many players who are not new but would still prefer an option to get all the extras in one place with a minimum of fiddling. Most include just about everything that still works and could be useful.

It is also important to note that most of the contents of each pack were created by many members of the community and just collected, configured, and redistributed by the maintainer of each pack. Of course there are a few personal touches too, but the vast majority of each is thanks to others - and not least Tarn and Zach for Dwarf Fortress itself.

== Where do I get a Pack? ==

{{#randorder:
===[http://www.bay12forums.com/smf/index.php?topic=126076 Windows: PeridexisErrant's DF Starter Pack]===

This pack is maintained by PeridexisErrant, and aims to include everything - while ensuring that ignoring any option still works for new players. Contents and a changelog are listed on the forum thread (linked above).
|
===[http://www.bay12forums.com/smf/index.php?topic=163211.0 Linux: Enay's LinuxLNP]===

This package by Enay is a traditional package of compiled utilities, actively maintained and tested on Debian Jessie (64bit). It should work out-of-the-box with Debian-derived (Ubuntu, Mint, etc.) distributions, but support or continuing updates are not guaranteed.
|
===[http://www.bay12forums.com/smf/index.php?topic=158322.0 Mac: Lazy Mac Pack]===

A Lazy Newb Pack for Mac with lots of graphics packs but with not so many utilities.
|}}

== History of packs==

Maintaining a pack is a lot of work and over the years people inevitable lose time or motivation to update their packs. Eventually someone new steps up and releases their own pack.

This section is provided for information, and should not be interpreted as a recommendation for these packs. It may however be interesting to look back at how the LNP/Starter Pack movement evolved.

==== The first Lazy New Pack ====

[[image:Lazy-newb-pack-screenshot.0.31.12.v4.6.png|frame|right|Screenshot of the primary user interface in Lazy Newb Pack v4.6 for DF 0.31.12 from June 2010. Created on Linux in 2017 with wine. ]]
[[image:Lazy-newb-pack-screenshot2.0.31.12.v4.6.png|frame|right|Screenshot of the graphics selection screen in Lazy Newb Pack v4.6 for DF 0.31.12 from June 2010. Created on Linux in 2017 with wine. ]]

The first pack with the name Lazy Newb Pack (LNP) was created by [http://www.bay12forums.com/smf/index.php?action=profile;u=16293 LucasUP] for Windows and DF version 0.31.12 and posted [http://www.bay12forums.com/smf/index.php?topic=59026 | in the bay12forums] on June 11, 2010. Before the LNP, it was becoming common for the community to bundle up their own distributions of Dwarf Fortress with tile sets, graphics, and mods to make them more accessible to players. Other notable packs from this era are [http://www.bay12forums.com/smf/index.php?topic=57557.0 Phoebus graphics] and [http://www.bay12forums.com/smf/index.php?topic=53649.0 Mayday's Graphic Set]. The LNP distinguished itself by providing an interface for changing common DF settings, instead of editing the raw text files included with the game.

The first versions of the LNP included a text-based interface (seen on the right) that only permitted the user to enable/disable [[aquifers]] and choose from the Phoebus, Mayday, and Ironhand graphics packs. They included the utilities [[DFHack]], [[Dwarf Foreman]], [[Dwarf Therapist]], [http://www.bay12forums.com/smf/index.php?topic=57428.0 PerfectWorldDF], [http://www.joelpt.net/quickfort/ Quickfort], [http://www.bay12forums.com/smf/index.php?topic=59056.0 Runesmith] , [[Stonesense]].

In order to elicit help and contributions from the community LucasUP opensourced his graphical interface in February 2013 by releasing [https://github.com/LucasUP/LazyNewbPack/| the source on github] ([http://www.bay12forums.com/smf/index.php?topic=123384.0 forum post]).

By the late autumn of year 2013 the LNP was out of date with new DF releases, and users were clamoring for an update. LucasUP's life had become to busy to focus on the LNP. On November 16, 2013 LucasUP declared his tenure as overseer over, thanked the community for their support and gave his blessings for the successor packs that had appeared on the scene.

<blockquote>
<div style="border: 1px dashed grey; padding: 5px;">
Hello guys. I think I have to apologize for my long absence. :(

Yes it was my intention to let others work on and maybe eventually take over The Lazy Newb pack after I had released it open source. But It was NOT my intention to go dead silent for so long and have it be such a forced/jarring transition. I'm really sorry about that.
Of course other life responsibilities took me away from LNP, but I don't really have great excuses for why I didn't at least give you guys any updates on myself or re-direct you to other versions sooner, other than just my mind has been elsewhere.

Sorry for any frustration this has caused you guys, and I hope I haven't caused too much ill-will. I feel like a jerk and like I've just been trying to avoid confronting that. :(
I've updated the OP to link to the new Windows/Linux/Mac packages. If there's anything else you guys would like to see from me, I am happy to hear from you.
I do read and respond to my PMs too, if you wanted to say/ask me something in private.

Edit:

I just also wanted to say, on a more positive note, that I am really happy and proud to see how many people have cared enough about LNP to want to continue it and work on it. The fact that there is now working and regularly updated Win/Mac/Linux versions is really fantastic, and its something I would have never achieved myself. So, thanks to the DF community! You guys and girls are awesome.
</div>
</blockquote>
-- [http://www.bay12forums.com/smf/index.php?topic=59026.msg4768489#msg4768489 original post]

==== The original launcher with a GUI ====

On December 31, 2010 [http://www.bay12forums.com/smf/index.php?topic=59026.msg1845333#msg1845333 LucasUP released] the first version of the Lazy Newb Pack that contained the graphical interface launcher that is well known today. It became the key component of the pack, which allows easy configuration of the DF installation, choose graphics packs, launching of utilities, and provided one click toggling of settings instead of editing configuration files by hand. The original launcher was built with Visual Basic and .NET 3.5, and for several years this meant that the LNP was only available for Windows systems.

In 2012 Dricus created a [http://www.bay12forums.com/smf/index.php?topic=124613 Java-based launcher], which was cross platform and more flexible, but also required manual configuration. This launcher was never finished and so never achieved wide usage, however some early Mac and Linux packs were available based on this version. It wasn't a complete pack, but just the launcher component that could be used to build platform-specific packs.

<gallery widths=200px>
File:Lnp-gui1.png|The original LNP launcher, Options Tab
File:Lnp-gui2.png|The graphics tab
File:Lnp-gui3.png|The utilities tab
File:Lnp-gui5.png|The advanced tab
</gallery>

==== PyLNP: The modern cross platform launcher ====

In mid-2014 Pidgeot released the [http://www.bay12forums.com/smf/index.php?topic=140808 PyLNP launcher] built in Python and compatible with all platforms. As of 2017 the PyLNP is the core launcher of all lazy newb / starter packs available. A number of improvements to the feature set have been made since the original windows-only launcher by LucasUP, including raw merging of graphics to perserve settings, mod management, color schemes, and managing multiple installations of Dwarf Fortress. There are [http://pylnp.birdiesoft.dk/docs/dev/#id5 even more] not mentioned here.

All modern packs since 2014 use the PyLNP launcher. Note that "PyLNP" and "LNP" are not interchangeable - the former refers to the launcher itself, while the latter refers to a pack as a whole.

PyLNP started as a port of LucasUP and tolyK’s Lazy Newb Pack Launcher to Python, with the goal of making a launcher available on all the platforms supported by Dwarf Fortress. Its biggest innovation is the [http://pylnp.birdiesoft.dk/docs/dev/content.html PyLNP content format], a standard for defining manifests for graphics, tilesets, keybinds, utilities, etc that allows a modular and custom pack to be built.

=== Lazy? Newb? Starter Pack? ===

The original pack by LucasUP was named the Lazy Newb Pack, and LucasUP themselves explained the name as "This package is for *Newbs* and those too *Lazy* to put everything together every new version" (emphasis original). Most derivative packs over the years have retained that name more out of brand recognition and as homage to LucasUP's first attempts.

In November 2013 PeridexisErrant, the maintainer of the current pack for the Windows platform, renamed his pack from "PeridexisErrant's LNP" to "PeridexisErrant's Starter Pack". He [https://www.reddit.com/r/dwarffortress/comments/1qt7c1/df_starter_pack_updated_classic_lazy_newb_pack/cdgpqxq/ has said] the primary reason for the renaming was to distinguish the old legacy LNP from his own pack when providing support to players, as often players would have a problem with the pack and ask PeridexisErrant for help only for him to discover they were using an older version of the pack that he didn't publish nor maintain. He changed the name before the [[DF2014:Release_information|big 2014 release]] in order to help steer new players towards his new maintained starter pack, and prevent them from finding and using old unsupported versions of the LNP.

PeridexisErrant has also said that the purview of the pack has expanded over the years and is no longer just for those new to the game (newbs) but also for experienced players, and that he disliked the term "lazy" for derogatorily implying that players are lazy. Given the difficulty and challenges associated with Dwarf Fortress, where to be come proficient one must work hard and expend effort, it is safe to say that its players are not lazy.

The maintainers of the different Mac OSX packs have used different names over the years including MacNewbie, and Lazy Mac Pack. The Linux maintainers have remained with the original LNP moniker.

=== Other historical packs ===

Early on, while there were releases of Dwarf Fortress for Mac and Linux, there were no Lazy Newb Packs offered. The very first batch-script based version of LucasUP's LNP inadvertently worked on Linux via wine, but after the switch to the GUI launcher built with .NET, support for Linux was lost.

The general availability of GUI based launchers (and the packs built around) them for Mac and Linux didn't come about until Dricus' java-based launcher project [http://www.bay12forums.com/smf/index.php?topic=130236.msg4521675#msg4521675 in August 2013].

==== Mac OS X ====
In April 2012, [http://www.bay12forums.com/smf/index.php?action=profile;u=69756 iXen] released [http://www.bay12forums.com/smf/index.php?topic=106790.0 the MacNewbie Pack] as an alternative to the Windows LNP. It was for version r 0.34.07 of Dwarf Fortress. The pack was updated for several months until its final release v0.6 Cyan in May. The pack was notable as it included the first GUI launcher for Mac OS. It was built with Apple's Cocoa technology and included special keybindings to make gameplay easier on Apple Wireless & MacBook Keyboards.

<gallery widths=200px>
File:Macnewbie2.png|Screenshot of the MacNewbie pack v0.6 Cyan for Dwarf Fortress v0.34.11 by iXen.
File:Macnewbie1.png|Screenshot of the MacNewbie pack v0.6 Cyan for Dwarf Fortress v0.34.11 by iXen.
</gallery>

[http://www.bay12forums.com/smf/index.php?action=profile;u=94479 Fricy] released [http://www.bay12forums.com/smf/index.php?topic=128960 his spiritual successor] to the MacNewbie pack on July 10, 2014 for Dwarf Fortress v0.40.01. It was based on Dricus' cross platform java launcher has 26 releases from July 2014 until November 28, 2015. It was last updated in November 2015 in January Dwarf Fortress v0.42.04.

==== Linux ====

The [http://www.bay12forums.com/smf/index.php?topic=130792 Lazy Newb Pack Installer for Linux] created by Andrewd18 in September 2013, was a Linux installer shell script that installed the Dwarf Fortress Lazy Newb Pack. It downloaded and built a DF installation from available source code and binaries, and also checked for the dependencies required by 64-bit systems. The home of this pack was [https://github.com/andrewd18/df-lnp-installer on Github]. It was last updated on June 2014 for Dwarf Fortress v0.34.11.

[http://www.bay12forums.com/smf/index.php?topic=140966 Beautato's Linux Lazy Newb Pack] released in July 2014 was a more traditional package of compiled utilities that was previously maintained and tested on Ubuntu. It was last updated in March 2015 for Dwarf Fortress v0.40.24.

In March 2017 [http://www.bay12forums.com/smf/index.php?action=profile;u=114577 Enay] took up maintainership of the LNP for Linux calling it [http://www.bay12forums.com/smf/index.php?topic=163211.0 LinuxLNP] and released only for 64-bit systems.

== The Making of a Pack ==

There are many people involved in the making of a LNP/Starter pack for Dwarf Fortress, starting from Tarn and Zach releasing DF, to they many tilesets and graphics creators, the creators of the utilities (e.g, Soundsense, Dwarf Therapist), the reverse engineering work down by the [[DFHack]] folks, to the many more who contribute on the forums, help manage bug reports, create and test mods, etc.

Creating a pack is a process of curating a set of tilesets, graphics, and utilities and bundling them together with a launcher as well as the latest Dwarf Fortress release, then, optionally, making this bundle available for download

Over the years the process of making a pack has become more formalized and automated, and a community has formed to make the process easier and provide continuity when someone inevitably retires.

As of 2017, pack maintenance and creation is centered around the following projects:

* The [https://bitbucket.org/Pidgeot/python-lnp PyLNP launcher] is maintained by Pidgeot and is available on bitbucket
* The [https://github.com/Lazy-Newb-Pack LazyNewbPack organization on github] provides a home for shared resources and code
* The [https://github.com/DFgraphics/DFgraphics DFgraphics github repository] is a shared home for graphics and tilesets to ease routine maintenance
* The [https://github.com/PeridexisErrant/starter-pack starter-pack builder] by PeridexisErrant that helps build a pack from scratch

{{Category|Utilities}}

Utility:Lazy Newb Pack

2016-03-11T22:21:21Z

PeridexisErrant: Update to add Enay's Linux LNP

{{Quality|Exceptional|02:12, 3 November 2014 (UTC)}}
{{uv|DF2014}}

The Lazy Newb Pack was a pre-configured package for Windows containing Dwarf Fortress, a launcher program, and a small collection of [[graphics]] packs and [[utilities]]. While the original has been discontinued, it has been replaced by similar packs for all three platforms supported by DF (Windows, OS X, and Linux). These can be found at http://lazynewbpack.com or further down this page.

The current packs are ideal for new players, or anyone who doesn't want to find, configure, install, and update everything for themselves.

==General information==

These new packs generally include all the utilities that a veteran player might want on a new computer, while configuring everything in such a way that it is still easier for new players. In general, it's safe to simply ignore any option you don't understand and trust that the default settings will be OK.

The packages are built around the idea that newbies will likely have more difficulty with the game than with a package of utilities - which often make the game easier - and that there are many players who are not new but would still prefer an option to get all the extras in one place with a minimum of fiddling. Most include just about everything that still works and could be useful.

It is also worth noting that most of the contents of each pack were created by the community and just collected, configured, and redistributed by the maintainer of each pack. Of course there are a few personal touches too, but the vast majority of each is thanks to others - not least Toady for Dwarf Fortress itself.

==Current Packs==
All of these packs use the [http://www.bay12forums.com/smf/index.php?topic=140808.0 PyLNP] launcher, maintained by Pidgeot. (Note that "PyLNP" and "LNP" are not interchangeable - the former refers to the launcher itself, while the latter refers to a pack as a whole.)
{{#randorder:
===[http://www.bay12forums.com/smf/index.php?topic=126076 Windows: PeridexisErrant's DF Starter Pack]===

This pack is maintained by PeridexisErrant, and aims to include everything - while ensuring that ignoring any option still works for new players. Contents and a changelog are listed on the forum thread (linked above).
|
===[http://www.bay12forums.com/smf/index.php?topic=128960 Mac OS X: MacNewbie Reborn]===

This pack is an updated version of the old MacNewbie Cyan pack, maintained by Fricy.
|
===[http://www.bay12forums.com/smf/index.php?topic=156011 Linux: Enay's Unofficial Lazy Newb Pack]===

This package by Enay is a traditional package of compiled utilities, actively maintained and tested on Debian Jessie (64bit). It should work out-of-the-box with Debian-derived (Ubuntu, Mint, etc.) distributions, but support or continuing updates are not guaranteed.
}}

==Old, Retired, and Obsolete Packs==

This section is provided for information, and should not be interpreted as a recommendation for these packs. It may however be interesting to look back at how the LNP/Starter Pack movement evolved.

==== The original GUI / Launcher ====

A key component of the LNP is a launcher, which allows easy configuration of the DF install, launches utilities, and generally means that you can simply click a button instead of having to edit configuration files by hand. The original launcher was windows-only, being coded in Visual Basic, and for several years meant that the LNP was only available for Windows computers. In 2012 Dricus created a [http://www.bay12forums.com/smf/index.php?topic=124613 Java-based launcher], which was cross platform and more flexible - but also required manual configuration and it was never finished. Mac and Linux packs were available based on this version. As of mid-2014, both have been replaced by the [http://www.bay12forums.com/smf/index.php?topic=140808 PyLNP launcher] (Python) on all platforms.

==== The First LNP ====

The first Lazy Newb Pack was created in 2010. It was a Windows-only package containing Dwarf Fortress, a launcher program, and a small collection of [[graphics]] packs and [[utilities]]; it was [http://www.bay12forums.com/smf/index.php?topic=59026 officially discontinued] in November 2013 since it had not been updated in over a year.

===[http://www.bay12forums.com/smf/index.php?topic=140966 Beautato's Linux Lazy Newb Pack]===

This package by Beautato is a more traditional package of compiled utilities, actively maintained and tested on Ubuntu. It should work out-of-the-box with Debian-derived (Ubuntu, Mint, etc.) distributions, and contains workarounds for common issues on other distros (for example, zlib/libpng issues such as the "tileset not found" error).

==== [http://www.bay12forums.com/smf/index.php?topic=130792 Lazy Newb Pack Installer for Linux (outdated)] ====

Created by Andrewd18, the Linux installer is a shell script that installs the Dwarf Fortress Lazy Newb Pack. It downloads and builds a DF installation from available source code and binaries, and also checks for the dependencies required by 64-bit systems. The home of this pack is [https://github.com/andrewd18/df-lnp-installer on Github]. Unfortunately, it is unmaintained since June 2014. If Beautato's or Enay's packs don't work on your platform it may be worth trying it anyway.

{{Category|Utilities}}

Utilities

2016-03-11T22:12:21Z

PeridexisErrant: /* Lazy Newb Pack */ Update Linux link, link text

{{Quality|Masterwork|13:28, 28 September 2013 (UTC)}}
{{av}}

'''Utilities''' are third party applications useful for Dwarf Fortress players and modders, and this page serves as a list of them. Dwarf Fortress is a difficult game to play, and any help that can be had in the task is welcome help. This page lists utilities useful for modders and player alike. If you would like to add an article on a ''specific'' game utility to the wiki, please do so under the [http://dwarffortresswiki.org/index.php?title=Special%3AAllPages&from=&to=&namespace=102 Utility] namespace. Not included on this page: [[Main:Tileset repository|tileset repositories]] and [[DF2012:Graphics set repository|graphics set repositories]] have been given their own, separate page. [[Modding|Mods]] have also been listed under their own [http://dwarffortresswiki.org/index.php?title=Special%3AAllPages&from=&to=&namespace=104 Modification] namespace. To avoid namespace clutter websites ''are'' considered utilities, though they really aren't, and have been included.

A [http://www.bay12forums.com/smf/index.php?board=29.0 subsection of the Bay12 forums] is devoted to such third party programs, and contains development threads for most of them.

The [[Utilities#Lazy Newb Pack|Lazy Newb Pack]] is an effort to make Dwarf Fortress more accessible for new players by bundling and configuring utilities, graphics and tilesets, and extras such as reference material or more intuitive controls.

==Launchers==

=== [[Utility:Lazy_Newb_Pack|Lazy Newb Pack]] ===
A commonly-used software bundle with a nice launcher. Allows to start playing DF really quickly on a new machine - no need to download and integrate [[Graphics set repository|tilesets]] and tools like Dwarf Therapist, SoundSense, etc. - or even know what you need to get. The newer packs also include many third-party fixes for common bugs, which work automatically, and a large number of significant user interface improvements. The launcher makes changing settings or graphics options much easier (press button, instead of editing files) and can even remember to launch selected utilities whenever you open a game of Dwarf Fortress. See the [[Utility:Lazy_Newb_Pack|Lazy Newb Pack]] page for more information, or the forum thread for your platform.

*[http://www.bay12forums.com/smf/index.php?topic=126076 PeridexisErrant's Starter Pack] (Windows)
*[http://www.bay12forums.com/smf/index.php?topic=128960 MacNewbie Pack] (OS X)
*[http://www.bay12forums.com/smf/index.php?topic=156011 Unofficial Linux LNP] (Linux)

===[http://www.bay12forums.com/smf/index.php?topic=140808 PyLNP] ===
A cross-platform LNP port, written in Python. The launcher and configuration interface for all of the Lazy Newb Packs. PyLNP is under active development for bugfixes, addition of features pioneered by other launchers, and creation of entirely new features - such as rebuilding the raws of modded saves to change graphics packs.

===[http://www.bay12forums.com/smf/index.php?topic=102316 Manila Launcher] ===
A Java interface that allows easy option toggling, update and devlog checking, and tileset, mod and color scheme switching. Designed for players who prefer vanilla DF to a bundle like the above.

== 3D Visualizers ==

=== [[Utility:Stonesense|Stonesense]] ===
Stonesense is a third party visualizer, implemented as a [[Utility:DFHack|DFHack]] plugin, that lets you view your fortress in a classic isometric perspective. It runs alongside Dwarf Fortress, and can follow the main game's view, updating in real time. It is included in DFHack, and can be opened by typing <code>stonesense</code> or <code>ssense</code> into the console window.

=== [http://www.bay12forums.com/smf/index.php?topic=63484 Fortress Overseer] ===
Fortress Overseer is the only 3D visualizer supporting v0.31. It has been completely rewritten and is currently updated to support v0.34.11 and v0.31.25. Overseer works indirectly, by using [[Utility:DFHack|DFHack]]'s <code>mapexport</code> to export a file which can then be rendered in 3D. DirectX 9 must be installed, though this requirement is not documented. Has not been tested for 0.40.13.

=== [http://www.bay12forums.com/smf/index.php?topic=146473.0 Armok Vision] ===
Armok Vision is a 3D real-time visualizer using Unity for version 0.40.24. It works as a separate program communicating with the game through fast network interfaces.

=== [http://www.bay12forums.com/smf/index.php?topic=70700.0 Isoworld] ===
Isoworld is an isometric world map viewer, which can display each of the detailed maps exported from Legends Mode. It also has a pictographic view which makes finding waterfalls easy.

Isoworld can link with [[Utility:DFHack|DFHack]] to display a game view at full spatial resolution in wider context, including tracking the game view. This is particularly useful for adventure mode.

== Music and Sounds ==

=== [[Utility:SoundSense|SoundSense]] ===

SoundSense is a tool that parses game logs and reacts to game events with sound effects, incidental music and dwarfy comments. You can look it up on the [http://www.bay12forums.com/smf/index.php?topic=60287 forum thread], or directly download it at [http://df.zweistein.cz/soundsense/ the SoundSense homepage]. Due to it being written in Java, Soundsense is portable to all platforms.

Due to development having slowed down, a [https://github.com/calmhorizons/soundsense fork] was released that most notably disables the broken auto-updater and adds the option to minimize Soundsense to the system tray.

Note that older Soundsense users may have different default seasonal soundtracks, which were removed and replaced in early 2011. These are available [http://www.krauselabs.net/dump/music.zip here].

== Game manipulation tools ==

===[[Utility:DFHack|DFHack]]===

[[Utility:DFHack|DFHack]] is an advanced Dwarf Fortress memory access library and a set of tools and scripts using this library, providing direct object-oriented access to Dwarf Fortress's internals as if it were compiled into the game itself. Runs on Windows, Linux, and OS X. The standard configuration enables a variety of included bugfixes and interface upgrades, and provides many useful tools such as "clean all".

DFHack has an [http://www.bay12forums.com/smf/index.php?topic=139553.0 official forum thread]. Code releases are available from the [https://github.com/DFHack/dfhack/downloads Github site], along with [https://github.com/DFHack/dfhack old] and [https://github.com/DFHack/dfhack/releases new binaries].

Falconne's UI plugins are included in DFHack, as are automation tools Autolabor, Workflow, Autobutcher, and many others.

==== User Interface Plugins ====
A collection of DFHack plugins by Falconne that improve the in-game interface with features such as:
* Search function in screens with big lists.
* Ability to place furniture before it's built and have it automatically allocated when available.
* Ability to place constructions with box select (like laying designations), including easier material selection and open space placement (without having to wait till adjacent constructions are built).
* Easier pasturing, live happiness monitor, mouse support, stocks dashboard.

==== Binary patches ====
Binary patches are utilities made by users to fix known bugs that haven't been addressed by the development team yet. DF2014 is in active development, so there are no binary patches yet.

==== Feature plugins ====
These plugins add features to the game.
* [http://www.bay12forums.com/smf/index.php?topic=127116 Digging invaders], a plugin that allows hostiles to dig and deconstruct walls to path to one's fortress.
* [http://www.bay12forums.com/smf/index.php?topic=128487 Rendermax], a plugin that implements a lighting system at the graphics level.
* [http://www.bay12forums.com/smf/index.php?topic=136155 Dwarven Emigration], a plugin that allows unhappy dwarves to emigrate with their families.

==== Interaction plugins ====
[http://www.bay12forums.com/smf/index.php?topic=135597 DFHack scripts designed for modders to use as "spells"] (not in standard package)

==== Miscellaneous plugins ====
[http://www.bay12forums.com/smf/index.php?topic=135506 DFHack script collection] (not in standard package)

==Dwarf Therapist==
===[http://www.bay12forums.com/smf/index.php?topic=122968 Dwarf Therapist]===
Dwarf Therapist gives you an advanced GUI to manage and check dwarf job allocations, military assignments, statistics (such as attributes, personality traits and happiness), sort dwarves by various criteria (e.g. profession, migration wave, happiness, number of assigned jobs etc.) and generally manage the Dwarven Resources of your fortress in a very convenient way. This version contains the "labor optimizer" semi-automatic labor management system.

Splinterz' fork of Dwarf Therapist is the currently updated version, and available for Windows, Mac and GNU + Linux. Besides the Bay12 forum thread, there's more information on the [https://github.com/splintermind/Dwarf-Therapist GitHub project page].

See the [http://www.bay12forums.com/smf/index.php?topic=122968 forum thread] for current downloads.

====[[Utility:Dwarf Therapist/Addons Repository|Dwarf Therapist Addons Repository]]====

A collection of customizations for Dwarf Therapist submitted by the community.

Addons include:

* custom professions
* custom roles
* optimization plans
* filter scripts
* new grid views

== Fortress layout tools ==
<strike>=== [http://www.bay12forums.com/smf/index.php?topic=87731 DF Designator] ===
DF Designator helps you build fortresses from either image files or Quickfort .CSV files. It also has a user interface that allows you to assign hotkeys to blueprints and to combine blueprints in multi z-level designs. Windows, Mac and Linux versions are available. DF Designator uses 'typewriter style' playback, and is thus very slow for large projects.</strike>

=== [http://www.joelpt.net/quickfort/ Quickfort] ===
Quickfort is a 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. Recent versions of Quickfort work by converting the blueprint into a native macro for Dwarf Fortress, then executing the macro. This allows for enormously faster playback compared to early versions or DF Designator.

====[https://www.mediafire.com/folder/u38qsqr1bq6wu/Community_Quickfort_Blueprints_v2 Quickfort Community Blueprints]====

A large collection of blueprints, published to remove the last hint of hassle in creating a fortress. You can download the lot without a paid account [http://www.mediafire.com/download/n6im1ok6z02n8nc/Community_Quickfort_Blueprints_v2.zip here].

===[http://www.bay12forums.com/smf/index.php?topic=55025 ChromaFort]===
Chromafort is a tool designed to complement [[Utilities#Quickfort|Quickfort]], by converting images into quickfort-compatible .csv files. It works with 24-bit bitmap (.bmp) files. There are a number of known issues that can affect any image that is not square, and the size must be an exponent of two (8, 16, 32, 64...); other images may show nonexistent colours and/or come out highly distorted.

===[http://www.bay12forums.com/smf/index.php?topic=138590 Picturefort]===
Picturefort is an attempt to make "Chromafort, but ''better''" - it performs the same function of converting an image to a [[Utilities#Quickfort|Quickfort]]-compatible .csv file. Unlike Chromafort, Picturefort can handle a large number of image formats (though .bmp or .png are recommended); images can be of any shape and within reason size; and while as of May 2014 it is only available on Windows there are plans for a Linux version.

===[http://www.bay12forums.com/smf/index.php?topic=154849.0 Symmetricity]===
A fortress planner with a focus on multiple planes of symmetry. It can output csv for quickfort. It's early in development so it's probably not suitable for serious use cases.

== Modding tools ==

===[http://www.bay12forums.com/smf/index.php?topic=140853.0 Rubble]===

A useful plugin-based modding tool that generates raws and supports easy installation of reactions, tilesets, macros, modding fixes and DFHack scripts. It is a fork of the now abandoned [http://www.bay12forums.com/smf/index.php?topic=125997.0 Blast]. Binaries are available for Linux 32-bits, OS X 32-bits and Windows 64-bits, as well as the source (written in Go with building instructions). As of 4.0, a GUI is available for Windows.

=== [http://www.bay12forums.com/smf/index.php?topic=103360 Raw Explorer] ===
A tree-based raw files browser, editor and manager.

=== [http://www.bay12forums.com/smf/index.php?topic=140645.0 Dwarf Fortress real-life material helper] ===
A python script that generates raws based on custom real-life material values.

=== [http://www.bay12forums.com/smf/index.php?topic=140688.0 Roses' Random Creature Script] ===
A python script that generates random creature raws.

== World Map / World Gen Tools ==
=== [http://dffd.wimbli.com/file.php?id=2354 Perfect World DF] ===
Requires an additional (tiny) download to be functional for current versions (40.#): [http://dffd.wimbli.com/file.php?id=8756 WorldGen.xml] . Easy access to world settings for quick modification to allow highly customized world generation far easier and faster than DF's ingame advanced map maker. [http://www.bay12forums.com/smf/index.php?topic=57428.0 forum thread]

=== [http://pastebin.com/jdVKPzpt Fortress World Generator] ===
A bash script for automating world generation of large numbers of worlds on GNU/Linux.

=== [http://www.bay12forums.com/smf/index.php?topic=73095 Dwarf Map Maker] ===
A photoshop action script which turns legends mode exported maps into a much prettier fantasy map. There is also a version available [http://www.bay12forums.com/smf/index.php?topic=73095.msg2261106#msg2261106 for GIMP].

=== [http://www.bay12forums.com/smf/index.php?topic=137076.msg5085575#msg5085575 Satellite Map Maker] ===
A GIMP script based on the Dwarf Map Maker that creates a satellite image of Dwarf Fortress world maps.

==Legends tools==

=== [http://www.bay12forums.com/smf/index.php?topic=72702 Legends Viewer] ===
[http://www.bay12forums.com/smf/index.php?topic=154617 unofficial branch for 0.42.XX version of DF]

Legends Viewer loads up the legends you can export in a much more usable format than the legends mode of DF itself. Legends viewer can open pages in new tabs, filter information on a wide range of criteria, and displays information on the map as well. Binaries are only available for Windows, as well as the source (written in C#).

It takes four files as input: the legends xml file, the sites and pops text, world history text, and a map image. It can load these separately, but it is recommended to load them as a single compressed archive (folder) - the xml can be multiple GB uncompressed for long histories, and reduce to less than 5% of its size.

If you have played a fortress and then exported legends, you may get an error about unreadable HEX characters. This is caused by Workflow, which saves it's settings as unreadable historical figures. There are several ways to fix this:
* Clear the workflow settings in fortress mode before exporting legends
* Edit the xml by hand, [http://www.bay12forums.com/smf/index.php?topic=72702.msg4629392#msg4629392 as described here] (any platform)
* Use the [http://www.bay12forums.com/smf/index.php?topic=131307 Legends Processing script] (windows only), which fixes the xml and also creates a compressed folder as described above

=== [http://www.bay12forums.com/smf/index.php?topic=128932.0 World Viewer] ===
An alternative to Legends Viewer that most specifically features a timeline of historical events. Binaries are only available for Windows, as well as the source (written in C#).

=== [http://www.uristmaps.org Uristmaps] ===
A web-based interface that displays worlds in the way of an interactive map complete with features and structures.

=== [http://www.bay12forums.com/smf/index.php?topic=155307.0 LegendsBrowser] ===
A browser based multi-platform (Win, Linux, OSX) Viewer. Supports legends_plus.xml generated via DFHack.

== Remote playing tools ==

=== [[Utility:Dfterm3|dfterm]]===

[[Utility:Dfterm3|Dfterm3]] is a remote Dwarf Fortress playing software for multiple users through a web interface. DFterm3 enables play through a web interface, and games can also be viewed on modern - or even played if a bluetooth keyboard is attached. The web interface should work with Chrome or Firefox browsers, and there are known problems using Internet Explorer. DFTerm3 functions via a DFHack plugin, and is thus dependent on each version of DFHack.

It is a successor to [[Utility:dfterm2|dfterm2]], which functions similarly using telnet instead of a web browser.

=== [http://www.bay12forums.com/smf/index.php?topic=139167.0 Webfort] ===

A newer alternative to dfterm3 that functions similarly, but players must wait in a queue before assuming control for a given period of time. It also functions via a DFHack plugin. Binaries are available for Windows, as well as the source (written in C++).

=== [http://www.bay12forums.com/smf/index.php?topic=140892.0 DorfServer] ===
A remote SSH-based Dwarf Fortress host software.

=== [http://www.bay12forums.com/smf/index.php?topic=139975.0 DFEverywhere] ===

The latest remote browser-based playing software.

==Language tools==

===[http://www.bay12forums.com/smf/index.php?topic=47332.0 DFLang]===
A language creating tool.

===[http://www.bay12forums.com/smf/index.php?topic=136098.0 Toadese Language Utility]===
A language editing and translating tool.

===[http://www.bay12forums.com/smf/index.php?topic=140432.0 DFlangOpt]===
A little tool meant to prevent redundancy when importing or updating language files.

===[http://dffd.wimbli.com/file.php?id=8288 Python language extraction and injection script]===
This simple script will extract words from language files and put them a word per line, for easy automatic translation or treatment. It can also read that list and put the translated words back in their place.

==Announcement tools==

===[http://www.bay12forums.com/smf/index.php?topic=130590 DFMon] ===

An announcement monitoring/filtering program, useful to hide some types of job cancellation spam or other more advanced filtering. Note that you can set the game to announce no job cancellations ''without'' any utilities or mods from the {{k|o}}rders menu, with {{k|x}}.

===[http://www.bay12forums.com/smf/index.php?topic=130030 DF Announcement Filter]===

An alternative to DFMon written in Java (and thus portable to Linux and OS X).

===[http://www.bay12forums.com/smf/index.php?topic=153777 Announcement Window+]===

Announcement Window+ is a python application that interfaces with Dwarf Fortress to print announcements and combat reports to a separate window. It was written to fix some annoying bugs that are present in DF Announcement Filter, which is no longer being updated.

==Filesharing websites==

=== [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/ Dwarf Fortress Map Archive] ===
{{main|Utility:Dwarf Fortress Map Archive}}

The Dwarf Fortress Map Archive is a large collection of user-submitted maps and videos 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; videos are stored in a compressed version of Toady One's own video-recording format.

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

== Other/miscellaneous ==

=== [http://shadowlord13.googlepages.com/dfmap-index.html DF Map Compressor] ===

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).

=== [http://www.mindwerks.net/projects/exita/ Exita] ===
Exita is a python program that takes your DF world map exports and dump them into several different text outputs.

===[http://www.bay12forums.com/smf/index.php?topic=132153.0 DwarfFamily]===
A tool that lets you import your legends XML file and converts all dwarf entries to a .GED file, which you can use in Family Tree programs like MyHeritage to display a family tree for the dwarfs.

===[https://www.dropbox.com/s/dea50wrs557w283/kobold.py Kobold name generator]===
A python script that generates random names in the way of kobold utterances

=== [http://www.bay12forums.com/smf/index.php?topic=717.0 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.

===[https://play.google.com/store/apps/details?id=dae.dfnews Dwarf Fortress News - Android App]===
Watches the Dwarf Fortress devblog. Receives Push Notifications on new updates.

Quickfort Community Blueprints

2015-11-29T13:24:17Z

PeridexisErrant: New version 2.3; on DFFD with all the extra blueprints I could find.

The Quickfort Community Blueprints pack is a collection of blueprints for use with Quickfort, drawn from all over the community.[http://dffd.bay12games.com/file.php?id=8185 The most recent version of the pack (v2.3)] comes with images to help visualise most designs. It is included in the [[Utility:Lazy Newb Pack|Lazy Newb Pack]].

If you want to share your designs: blueprint sets can be packaged as a .zip file and uploaded to a file host, [http://dffd.wimbli.com the DFFD] is preferred, and you can add a link to this page!

==Previous Blueprint Repositories==

[http://dffd.bay12games.com/file.php?id=8185 The latest (v2.3) pack], maintained by PeridexisErrant.

[http://www.mediafire.com/download/2x40cv93i9gd1r0/Community_Quickfort_Blueprints_v2.2.zip (v2.2) collated pack]

[http://www.mediafire.com/download/5fp46epm3fe1z8b/Community_Quickfort_Blueprints_v2.1.zip (v2.1) collated pack]

[https://www.mediafire.com/folder/u38qsqr1bq6wu/Community_Quickfort_Blueprints_v2 (v2.0) collated pack, unzipped], and a [http://www.mediafire.com/download/n6im1ok6z02n8nc/Community_Quickfort_Blueprints_v2.zip zipped version of it] (otherwise requires paid account to download all at once).

Version one of the collated package is available [http://www.mediafire.com/df_qfcommunity here].

The remainder of the page is a set of simple Quickfort-compatible blueprints to give you a sense of what can be done.

== Circle Pack ==
=== 11-tile circle ===
#dig start(6;6;Center tile) 11-tile circle
`,`,`,`,d,d,d,`,`,`,`,#
`,`,d,d,d,d,d,d,d,`,`,#
`,d,d,d,d,d,d,d,d,d,`,#
`,d,d,d,d,d,d,d,d,d,`,#
d,d,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,d,d,#
`,d,d,d,d,d,d,d,d,d,`,#
`,d,d,d,d,d,d,d,d,d,`,#
`,`,d,d,d,d,d,d,d,`,`,#
`,`,`,`,d,d,d,`,`,`,`,#

=== 13-tile circle ===
#dig start(7;7;Center tile) 13-tile circle
`,`,`,`,`,d,d,d,`,`,`,`,`,#
`,`,`,d,d,d,d,d,d,d,`,`,`,#
`,`,d,d,d,d,d,d,d,d,d,`,`,#
`,d,d,d,d,d,d,d,d,d,d,d,`,#
`,d,d,d,d,d,d,d,d,d,d,d,`,#
d,d,d,d,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,d,d,d,d,#
`,d,d,d,d,d,d,d,d,d,d,d,`,#
`,d,d,d,d,d,d,d,d,d,d,d,`,#
`,`,d,d,d,d,d,d,d,d,d,`,`,#
`,`,`,d,d,d,d,d,d,d,`,`,`,#
`,`,`,`,`,d,d,d,`,`,`,`,`,#

=== 15-tile circle ===
#dig start(8;8;Center tile) 15-tile circle
`,`,`,`,`,d,d,d,d,d,`,`,`,`,`,#
`,`,`,d,d,d,d,d,d,d,d,d,`,`,`,#
`,`,d,d,d,d,d,d,d,d,d,d,d,`,`,#
`,d,d,d,d,d,d,d,d,d,d,d,d,d,`,#
`,d,d,d,d,d,d,d,d,d,d,d,d,d,`,#
d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,#
`,d,d,d,d,d,d,d,d,d,d,d,d,d,`,#
`,d,d,d,d,d,d,d,d,d,d,d,d,d,`,#
`,`,d,d,d,d,d,d,d,d,d,d,d,`,`,#
`,`,`,d,d,d,d,d,d,d,d,d,`,`,`,#
`,`,`,`,`,d,d,d,d,d,`,`,`,`,`,#

== General ==
=== Simple Spiral Staircase ===
#dig A simple spiral staircase.,,
j,u,#
u,j,#
#>,#,#
u,j,#
j,u,#
#,#,#
=== Slightly larger spiral ===
#dig A simple spiral staircase.,,
j,d,u
d,d,d
u,d,j
#>
u,d,j
d,d,d
j,d,u
== Bedrooms ==
=== Modified Windmill Villas ===
This has a central single up/down stair tile that has room for a 3x3 shaft. I don't usually do 3x3. See [[Bedroom Design#Modified Windmill Villas]]
#dig start(11;11)
`,`,`,`,`,`,d,`,`,`,`,`,d,`,`,`,`,`,`,`,`,
`,`,`,`,`,`,d,`,`,`,`,`,d,`,`,`,`,`,`,`,`,
`,`,`,`,d,`,d,`,d,`,d,`,d,`,d,`,`,`,`,`,`,
`,`,`,`,d,`,d,`,d,`,d,`,d,`,d,`,`,`,`,`,`,
`,`,`,`,d,d,d,d,d,`,d,d,d,`,d,`,d,d,d,`,`,
`,`,`,`,`,`,d,`,`,`,`,`,d,d,`,`,d,`,`,`,`,
`,`,d,d,d,`,d,`,d,d,d,`,d,d,d,d,d,d,d,d,d,
`,`,`,`,`,d,d,`,`,`,d,`,d,`,`,`,d,`,`,`,`,
d,d,d,d,d,d,d,d,d,d,d,d,d,`,d,`,d,d,d,`,`,
`,`,`,`,d,`,`,`,d,d,d,d,d,`,d,`,`,`,`,`,`,
`,`,d,d,d,`,d,d,d,d,i,d,d,d,d,`,d,d,d,`,`,
`,`,`,`,`,`,d,`,d,d,d,d,d,`,`,`,d,`,`,`,`,
`,`,d,d,d,`,d,`,d,d,d,d,d,d,d,d,d,d,d,d,d,
`,`,`,`,d,`,`,`,d,`,d,`,`,`,d,d,`,`,`,`,`,
d,d,d,d,d,d,d,d,d,`,d,d,d,`,d,`,d,d,d,`,`,
`,`,`,`,d,`,`,d,d,`,`,`,`,`,d,`,`,`,`,`,`,
`,`,d,d,d,`,d,`,d,d,d,`,d,d,d,d,d,`,`,`,`,
`,`,`,`,`,`,d,`,d,`,d,`,d,`,d,`,d,`,`,`,`,
`,`,`,`,`,`,d,`,d,`,d,`,d,`,d,`,d,`,`,`,`,
`,`,`,`,`,`,`,`,d,`,`,`,`,`,d,`,`,`,`,`,`,
`,`,`,`,`,`,`,`,d,`,`,`,`,`,d,`,`,`,`,`,`,

===Simple tileable cross design===
It allows ample space for movement and decoration.
#dig Bedroom complex
`,`,`,`,`,`,`,`,`,d,d,`,`,`,`,`,`,`,`,`,#
`,d,d,d,`,d,d,d,`,d,d,`,d,d,d,`,d,d,d,`,#
`,d,d,d,`,d,d,d,`,d,d,`,d,d,d,`,d,d,d,`,#
`,`,`,d,`,d,`,`,`,d,d,`,`,`,d,`,d,`,`,`,#
d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,#
`,`,`,d,`,d,`,`,`,d,d,`,`,`,d,`,d,`,`,`,#
`,d,d,d,`,d,d,d,`,d,d,`,d,d,d,`,d,d,d,`,#
`,d,d,d,`,d,d,d,`,d,d,`,d,d,d,`,d,d,d,`,#
`,`,`,`,`,`,`,`,`,d,d,`,`,`,`,`,`,`,`,`,#
d,d,d,d,d,d,`,`,d,d,d,d,`,`,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,i,i,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,d,d,d,i,i,d,d,d,d,d,d,d,d,d,#
d,d,d,d,d,d,`,`,d,d,d,d,`,`,d,d,d,d,d,d,#
`,`,`,`,`,`,`,`,`,d,d,`,`,`,`,`,`,`,`,`,#
`,d,d,d,`,d,d,d,`,d,d,`,d,d,d,`,d,d,d,`,#
`,d,d,d,`,d,d,d,`,d,d,`,d,d,d,`,d,d,d,`,#
`,`,`,d,`,d,`,`,`,d,d,`,`,`,d,`,d,`,`,`,#
d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,d,#
`,`,`,d,`,d,`,`,`,d,d,`,`,`,d,`,d,`,`,`,#
`,d,d,d,`,d,d,d,`,d,d,`,d,d,d,`,d,d,d,`,#
`,d,d,d,`,d,d,d,`,d,d,`,d,d,d,`,d,d,d,`,#
`,`,`,`,`,`,`,`,`,d,d,`,`,`,`,`,`,`,`,`,#
#,#,#,#,#,#,#,#,#,#,#,#,#,#,#,#,#,#,#,#,#

===11x11 12-room Apartment Block
Features 11 4-tile rooms and one 3-tile room (or it makes a good office), needing only 5 doors. Quite modular.
If you use small meeting locations you can knock out the walls between the two narrow halls for a meeting area surrounded by 10 rooms, which would be very handy if all the rooms were full of families.

#dig
d,d,`,d,d,`,d,d,`,d,d,#
d,d,`,d,d,`,d,d,`,d,d,#
`,`,d,`,`,`,`,`,d,`,`,#
d,d,`,d,`,d,`,d,`,d,d,#
d,d,`,d,`,d,`,d,`,d,d,#
`,`,`,d,`,d,`,d,`,`,`,#
d,d,`,d,`,d,`,d,`,d,d,#
d,d,`,d,`,`,d,d,`,d,d,#
`,`,d,d,`,d,`,d,d,`,`,#
d,d,`,d,`,d,`,d,`,d,d,#
d,d,`,d,`,d,`,d,`,d,d,#
`,`,`,d,`,`,`,d,`,`,`,#

Utility:Stonesense/Content repository

2015-11-08T23:50:15Z

PeridexisErrant: Note inclusion in default ssense, suggest checking times

Note that most of the content below has either been added to Stonesense, or fallen out of date with later updates to DF. Check the history of this page for edit times!

== Vegetation ==

=== Seuss's Tweaked Vegetation ===
{{StonesenseContentPack|
|image=[[File:STV1.png]]
|download link=[http://dffd.wimbli.com/file.php?id=1699 DFFD File]
|author=Seuss
|installation=Replace vegetation folder in your stonesense directory with this one and make sure the line "vegetation/index.txt" is above "terrain/index.txt" in the main index file.
|comments=These are the vegetation files I use. I edit and change stuff as I play so this may be more updated than the official vegetation files.

An Important note:
There is a small fix to the terrain under vegetation but it will only work if in your main index.txt file you have "vegetation/index.txt" above "terrain/index.txt".
This is not necessary but it does improve visual quality.
}}

=== Belannaer's Underground trees ===
{{StonesenseContentPack|
|image=[[File:underground_trees.png]]
|download link=[http://dffd.wimbli.com/file.php?id=1980 DFFD File]
|author=Belannaer
|installation=Extract files into Stonesense/Vegetation and add underground_trees.xml to the index.txt.
|comments=New underground trees. From left to right: black cap, nether cap, goblin cap, tunnel tube, spore tree, blood thorn, fungiwood. Fungiwood graphic is from the original trees.png in Stonesense.
|included in=Slate 2.2
}}

=== Therahedwig's darker grass ===
{{StonesenseContentPack|
|image=http://img.ie/164bc.png
|download link=[http://dffd.wimbli.com/file.php?id=3617 DFFD File]
|author=TheraHedwig
|installation=Just unzip the file inside the stonesense directory and add GD/index.txt to the index file, above all the other entries.
|comments=If you don't like the ramps, go into the GD directory, delete SSGDramps1.png and rename SSGDramps2.png into SSGDramps1.png.
}}

== Creatures ==

=== Beefmo's Subterranean Animal Pack ===
{{StonesenseContentPack|
|image=[[File:Beefmo sub.gif‎]]
|download link=[http://dffd.wimbli.com/file.php?id=1698 DFFD File]
|author=Beefmo
|installation=Extract files into Stonesense/Creatures and add beefmo_subterranean.xml to the index.txt
|comments=Animated Subterranean Animal pack that does not include the animal men yet.
|included in=Slate 2.2
}}

=== Beefmo's Large Ocean Animal Pack (WIP)===
{{StonesenseContentPack|
|image=[[File:Beefmo ocean title.gif‎]]
|download link=[http://dffd.wimbli.com/file.php?id=1736 DFFD File]
|author=Beefmo
|installation=Extract files into Stonesense/Creatures and add beefmo_large_ocean.xml to the index.txt
|comments=WIP Sprite sheet for the large_ocean set of creatures.
|included in=Slate 2.2
}}

=== Beefmo's Common domestic animal pack===
{{StonesenseContentPack|
|image=[[File:Background_common.gif‎]]
|download link=[http://dffd.wimbli.com/file.php?id=1931 DFFD File]
|author=Beefmo
|installation=Extract files into Stonesense/Creatures and add beefmo_domestics.xml to the index.txt
|comments=Sprite sheet for Common Domestic animals 
<nowiki>***</nowiki> This appears to be an older version. A larger Beefmo's Domestic graphics file is included with Stonesense.
|included in=Slate 2.2
}}

=== Crash2455's Easily Distinguishable Soldiers ===
{{StonesenseContentPack|
|image=[[File:Soldiers.png]]
|download link=[http://dffd.wimbli.com/file.php?id=1801 DFFD File]
|author=Crash2455
|installation=Place into your creatures directory. You may want to back up your default "dwarves.png"
|comments=Color-coded soldiers make a return in this tileset.
}}

=== Caldfir's Dwarves ===
{{StonesenseContentPack|
|image=[[File:Caldwarf2.jpg‎]]
|download link=[http://dffd.wimbli.com/file.php?id=4804 Colour] [http://dffd.wimbli.com/file.php?id=1839 Original]
|author=Caldfir
|installation=Extract files into Stonesense/Creatures (remember to backup the original versions before overwriting!)
|comments=WIP Sprite sheet that expands the number of different dwarf sprites significantly.
}}

=== Belannaer's Goblin Pack ===
{{StonesenseContentPack|
|image=[[File:goblin_shot.png]]
|download link=[http://dffd.wimbli.com/file.php?id=1972 DFFD File]
|author=Belannaer
|installation=Extract files into Stonesense/Creatures and add goblins.xml to the index.txt
|comments=Sprite sheet for nearly all goblin jobs and positions.
|included in=Slate 2.2
}}

=== Greiger's Dracon Race Pack ===
{{StonesenseContentPack|
|image=[[File:GreigerDracon.png]]
|download link=[http://dffd.wimbli.com/file.php?id=1696 DFFD File]
|author=Greiger
|installation=Simply extract into Stonesense/Creatures and add Dracon.xml to the index file.
|comments=A set of sprites for custom dragonman races. Not useful for vanilla, but folks with a dragonman race could use these sprites to have fewer ? icons around. Updated for Stonesense slate on 5/5/2010.
}}

=== Jordix's Wild Animals ===
{{StonesenseContentPack|
|image=[[File:wild_animals.png‎]]
|download link=[http://dffd.wimbli.com/file.php?id=2594 DFFD File]
|author=Jordix
|installation=Extract into Stonesense/creatures and add wild_animals.xml to the index.txt; see also the Readme.
|comments=Graphics for some above-ground wild animals. No animations or separate graphics for children yet.
|included in=Slate 2.2
}}

=== HugoLuman's Daleks ===
{{StonesenseContentPack|]
|image=[[File:DalekSpriteScreenie.png]]
|download link=[http://dffd.wimbli.com/file.php?id=6046 DFFD File]
|author=HugoLuman
|installation=Open dfDaleks.rar and find StonesenseDalekSprites.rar. Extract that into Stonesense/creatures and add daleks.xml to the index.txt
|comments=A sprite for Daleks from my Dalek mod.
}}

== Buildings ==

=== Alternate well ===
{{StonesenseContentPack|
|image=[[File:TundraStonesenseAltWell.png]]
|download link=[http://dffd.wimbli.com/file.php?id=1725 DFFD File]
|author=Dark_Tundra
|installation=Extract files into Stonesense/buildings and add TundraAltWell.xml to the top of /buildings/index.txt
|comments=A round well for Stonesense
(also first time using a wiki.)
}}

== Terrain ==

=== Additional Ramps ===
{{StonesenseContentPack|
|image=[[File:Stoneramps.png]]
|download link=[http://dffd.wimbli.com/file.php?id=1717 DFFD File]
|author=kaypy
|installation=Extract files into Stonesense/terrain and add UpdatedRamps.xml to the top of /terrain/index.txt
|comments=Additional ramps. I will try to keep this updated as I get around to adding more.

Stone

Stone Brick (thanks Dark_Tundra)

Glass x 2

Ice

Wood (v2)

Dirt
}}

=== Directional Walls ===
{{StonesenseContentPack|
|image=[[File:TundraDirectionalWalls.png]]
|download link=[http://dffd.wimbli.com/file.php?id=1913 DFFD File]
|author=Dark_Tundra
|installation=Extract files into Stonesense/terrain and add DirectionalWalls.xml to the top of /terrain/index.txt
|comments=Walls with angled corners. Smoothed stone and constructed.
}}

=== Stonesense Grim Dark ===
{{StonesenseContentPack|
|image=Available on DFFD
|download link=[http://dffd.wimbli.com/file.php?id=3842 DFFD File]
|author=TheraHedwig
|installation=Just put this in the stonesense folder and add "Grim Dark/index.txt" to the top of the index file.
|comments=This mod replaced some of the stone-tiles of stonesense with more detailed ones.

Get the darker grass here: http://dffd.wimbli.com/file.php?id=3617

May have a few bugs.}}

== How do I add my Content Pack to this page? ==

Follow the template below :
=== Name of Pack ===
{{StonesenseContentPack|
|image=
|download link=''Link to download''
|author=''Your user name''
|installation=''Instructions on how to install your content pack''
|comments=''Description of your content pack''
}}
[[Category:Stonesense]]

== How do I create my own content? ==

See http://dwarffortresswiki.org/index.php/Utility:Stonesense/Adding_Content

Utility:Stonesense/Adding Content

2015-11-08T23:02:34Z

PeridexisErrant: /* Creating Distributable Content Files */ Fix link

{{Quality|Superior|06:39, 4 October 2013 (UTC)}}
=Basics=

===Creating Distributable Content Files===
The default way of distributing content for [[Stonesense]] is to create an archive of the XML configs and the image files. Upload this archive together with a description to the [[Utility:Stonesense/Content_repository]] page, in much the same way tilesets and graphic packs are distributed for Dwarf Fortress, see the [[Tileset repository]] for reference.

Keep in mind that users installing your content pack will need to place the files in the correct content folder (creatures buildings, etc) and add the XML files to their index.txt file.

===Multiple Definition Files===

Stonesense searches for images in the order that they are found top to bottom in the index file, then in the definition files. So if you are adding a custom set of sprites for something already in the system, you need to add it to the *top* of the index file.

===Tips and Tricks===

While simple creature definitions arent much use without a sheetIndex attribute, it can be useful to define variants without giving the base creature a sprite. This would cause the game to keep looking for creature definitions, allowing you to, for example, define custom professions in one file while still using the basic definitions.

==Understanding Sprites==
Understanding how Stonesense deals with sprites is central to anyone who wishes to modify the content. The scheme is not very complicated, and this guide will give a short introduction to how they work. The way sprites are loaded is fairly generalized. With the exception of floors, which we will discuss later, all sprites are 32x32 pixels big and come in groups known as ''Sprite Sheets''. There are no alpha values yet, so partial transparency is not supported. RGB 255,0,255 (Magenta pink) is considered fully transparent. All sprites are loaded and rendered in 32bit fullcolor pngs.

Here's an example of a typical Stonesense sprite: 
[[File:Stonesene_sprite_sample.png]]

Note that, in order not to conflict with neighboring sprites, a sprite must actually be within a smaller area than its 32x32 block. A template for the area used by most sprites is: 
[[File:Stonesene_sprite_template.png]]

The solid area is the floor space taken up by a sprite, while the dotted box indicates the volume above this area corresponding to one z-level.

===Sprite Sheets===
There can be an arbitrary number of sprite sheets configured for Stonesense, yet some are always present as they contain default sprites (see further down). Most of the content XML files allow users to specify sprite sheets, and this is done by adding a '''file''' attribute to the content nodes. By convention sprite sheets should be placed in their appropriate folder, with creature sprite sheets in the ''creatures'' folder etc. For more information on this, see the specific pages on content configuration.

'''A very helpful tips for modders:''' Pressing '''F10''' in Stonesense will bring up a screen where one can cycle through all the loaded sprite sheets, with sprite indexes superimposed.

===Sprite Index===
Sprite Index (sometimes referred to as Sheet Index) is a concept for referring to a specific sprite on a sheet. The index starts with the upper left sprite which has index zero. It then increments to the right. Stonesense is hardcoded to 20 sprites wide sheets, this means that the last sprite to the right in the first row has Sprite Index 19. The first sprite on the second row has index 20. This boundary is hardcoded and changing the size of the sheet will not affect it.

This image shows how sprites are indexed. Note: Grid added for readability. 
[[File:Stonesene_indexed_sprites.png]]

===Specific Sprite Sheets===

'''objects.png''' is the default sheet for buildings and vegetation. Also used for all hard-coded content, like default plants, the cursor, default walls and liquid.

'''creatures.png''' is the default sprite sheet for creatures. If no file is specified in a creature node, this is the sheet it will use.

'''floors.png''' holds all the Stonesense floors. Unlike the other sprite sheet, this sheet is hard-coded with sprite dimensions of 32x20 pixels.

Stonesense is fully configurable in the way it renders creatures. No information is hardcoded, but rather loaded from the creature databases found in the creatures directory.

=Creatures=

==index.txt==

The first thing the game does when loading the creature configuration is to look in the creatures/index.txt file. It uses this file to tell it what configuration files are available, and in what order to load them (this becomes important later).
The format of the file very straight forward; each line specifies the path of a file to be loaded. The paths are relative to index.txt.

==Creature XML files==

Stonesense is fully configurable in the way it renders creatures. No information is hardcoded, but rather loaded from the creature databases found in the creatures directory.

===Simple configuration===
In it's simplest from, a creature configuration file might look like this:

<pre>
<?xml version="1.0"?>
<creatures>
<creature gameID="MACAQUE_RHESUS" sheetIndex="2" />
<creature gameID="MUSKOX" sheetIndex="25" />
<creature gameID="COW" sheetIndex="5" />
</creatures>
</pre>

As you probably guess, this defines three creatures by their ID: A rhesus monkey, a muskox and a cow. The three animals use the sprites numbered 2, 25 and 5 respectively. No special sprite sheet is specified, so the default creature sheet will be used, ''creatures.png''. More on this later.

As you can see, each creature is identified by a '''gameID''' attribute. This has to match one of the known creature types in Dwarf Fortress, as defined in the '''[CREATURE:critter_name]''' part of the raws. This gameID tag is case sensitive. If Stonesense is unable to match your gameID with one from Dwarf Fortress, a log message will be written to ''Stonesense.log'' upon loading a map.

===Professions===
The <creature> tag can be quite a bit more advanced than what we've seen so far. One thing it is often relevant to distinguish is creature professions. A creature's profession is set by the game, and examples might include "WOODCRAFTER", "ADMINISTRATOR" or "MACEMAN". A complete list of creature professions can be found [[Unit type token|here]]. Also note that all races have the same creature strings, meaning a dwarf swordsman will still be a "SWORDS''MAN''".

To separate creatures on their professions, we first need to add a <variant> node to the base creature node.
By adding a '''prof''' attribute to this node, we can display different sprites for different creature professions.

'''Note:''' The game always picks the ''first'' <variant> node that matches.

Let's have a look at a typical creature configuration that includes professions:
<pre>
<creature gameID="DWARF" sheetIndex="0" file="creatures/dwarves.png">
<variant prof="MINER" sheetIndex="1" />
<variant prof="CLERK" sheetIndex="2" />
<variant prof="AXEMAN" sheetIndex="3" />
</creature>
</pre>

Here we see three professions defined. Notice how the <creature> node now has been expanded.

Also note that the <creature> node still contains a sheetIndex attribute. This is the default creature sprite, meaning that if a dwarf does not match any of the <variant> nodes, it will be shown as this sprite index (in this case 0).
The corresponding sprite sheet (here called ''dwarves.png'') would look something like this:

[[File:Stonesene_dwarf_prof.png]]

===Children and babies===
Children and babies always have the professions "CHILD" and "BABY", and these can be used to have indicate creature ages. Consider the following example for cats and kittens:
<pre>
<creature gameID="CAT" sheetIndex="20">
<variant prof="CHILD" sheetIndex="21" />
</creature>
</pre>
Here the cat sprite would be at index 20, and kittens at 21.

===Creature Genders===
Each <variant> node can be extended with a ''sex'' attribute to add an additional condition for creature gender.
For most races. dwarfs included, the attribute can have one of two values, "M" for male or "F" for female. However, if the creature has more than two castes, a number must be used, starting from "1", and continuing in order that the castes are listed in the rawfile. As of Stonesense Felsite v3.1, castes can be specified by name such as caste="WARRIOR".
Again a simple example would be beneficial:
<pre>
<creature gameID="HUMAN" sheetIndex="100">
<variant prof="BOWMAN" sex="M" sheetIndex="106" />
<variant prof="BOWMAN" sex="F" sheetIndex="107" />
<variant sex="F" sheetIndex="101" />
</creature>
</pre>

This simplified human config shows two different sprites used for bowmen. Male bowmen will use sprite index 106 and female bow-women will use 107.
Another very important thing to note here is the last entry, which only specifies a gender, and no profession. This means the only criteria for this node is that the creature is Human, and it's female. Hence 101 is the default sprite for human females. Together with the default sprite defined in the <creature> node itself (sheetIndex = 100), it allows us to have separate default sprites for men and women.

===Special Creatures===

Sometimes creatures appear as zombies, or skeletons. To tell these creatures apart from normal ones, you can use the '''special''' attribute to the <variant> node.
It accepts three types of arguments, ''Normal'', ''Zombie'' or ''Skeleton'',
and is used in the exact same way as the '''sex''' attribute.

===Coloring creatures===
As of Stonesense Slate RC2, creatures can be automatically colored by numerous factors, using the ''color'' attribute. Valid values are:

''profession'': The sprite is colored according to the creature's current profession. this works the same way as in Dwarf Fortress.

''bodypart'': The sprite is colored according to one of the creatures body part colors. this requires an additional ''bodypart'' attribute that describes which body part to get the color from.

''material'': The sprite is colored according to the floor it is standing on. this probably not very useful, unless you have a chameleon creature.

''vein'': Same as above, but the color comes from the ore veins, disregarding constructions.

''layer'': Same as above, but the color comes from the rock layer, disregarding veins and constructions.

''xml'': Manually specify a color in the creature definition, requires additional ''red'', ''green'', and ''blue'' attributes.

''none'': No color is used.

An example:

<pre>
<creature gameID="HUMAN" sheetIndex="0">
<variant sex="M" sheetIndex="4" color="profession" />
<variant sex="F" sheetIndex="4" color="bodypart" bodypart="skin" />
<variant sex="F" job="AXEMAN" sheetIndex="4" color="xml" red="123" green="0" blue="255" />
</creature>
</pre>

===Subsprites===

Each creature definition can also have any number of subsprites that are layered onto it like a paper doll. each subsprite can be colored differently, so you can have, say, a dwarf with a base sprite, a hair sprite, that's colored according to the hair-color of the dwarf, and a skin sprite, that's colored according to the skin-color of the dwarf.

An example should help:

[[File:japa_gobbos.png]]

<pre>
<?xml version="1.0"?>
<creatures>
<creature gameID="GOBLIN" sheetIndex="0" file="gobbos.png" color="bodypart" bodypart="skin">
<subsprite sheetIndex="1" color="bodypart" bodypart="hair" />
<subsprite sheetIndex="2" />
<subsprite sheetIndex="3" color="profession" />
<variant sex="F" sheetIndex="4" color="bodypart" bodypart="skin">
<subsprite sheetIndex="5" color="bodypart" bodypart="hair" />
<subsprite sheetIndex="6" />
<subsprite sheetIndex="7" color="profession" />
</variant>
</creature>
</creatures>
</pre>

Here, we have a main goblin sprite, that is colored according to the skin color of the individual goblin (usually a shade of green) this is the goblin's body. Then a second sprite is layered over it, which is the hair sprite, and is colored according to the hair. The third layer has no color change, and contains things like claws and eyes, that we don't want to be colored. The final layer contains the clothes, which are colored according to the goblin's profession. this will give us the following completed sprite:

[[File:Japa_gobbo.png]]

===Animating Creatures===

Adding animations to creatures is really quite simple. But before we dive into it, it makes sense to look at how Stonesense animations work.

Currently, the game cycles through six frames at a steady pace. The speed at which these frames are cycles can be specified in the init file, but it global and shared between all sprites.

To add animations to a creature, we add another condition attribute, ''frames'', to the <variant> node, like this:
<pre>
<variant sheetIndex = 7 frames = "012" />
</pre>

Here frames is set to the value "012". This means that this variant node is valid at frames 0, 1 and 2. It is NOT valid, at frames 3, 4 and 5. Remember there are six frames in total, from 0 to 5.
The value of the frames attribute is treated as a string, not as a number. This is important to note, as "frames=354" has the same effect as ''frames=453'', and indeed also ''frames="3 5, 4"'' or ''frames="3x5@ .4"''. The invalid characters are simply ignored.

An example
Let's make an animated Giant Bat, using this awesome sprite sheet made by Beefmo:

[[File:beefmo_giantbat.png]]

Now, to configure up a basic animation for a giant bat, we could add something like this to Wildlife.xml:
<pre>
<creature gameID="BAT_GIANT" sheetIndex = 0 file="giantbat.png" >
<variant sheetIndex = 2 frames = "345"/>
</creature>
</pre>
This will create a simple 2-frame animation. Each frame is used for the same length of time, since the default is used for frames 0, 1 and 2, and the overriding variant is used for frames 3, 4 and 5.
Hint: If you want the bat to flap its wings faster, change the frames for the variant to "024".

But Beefmo's giant bat sheet has three frames, so let's add them all for a complete animation:
<pre>
<creature gameID="BAT_GIANT" sheetIndex = 0 file="giantbat.png" >
<variant sheetIndex = 0 frames = "05"/>
<variant sheetIndex = 1 frames = "14"/>
<variant sheetIndex = 2 frames = "23"/>
</creature>
</pre>
Notice how the frames are used twice, to make a nice cyclic animation.
The indexed sprites will be drawn in order 0 1 2 2 1 0.

=Vegetation=

Vegetation content can be found in the ''vegetation'' folder of Stonesense.

Just like with all the other configurable content, the active plant and shrub XML files are outlined in an ''index.txt'' file.

The buildup of these XML files is very simple. Take a look at this example config file for trees:
<pre>
<?xml version="1.0" ?>
<trees file="vegetation/trees.png">
<plant gameID = "ACACIA" sheetIndex = 0 />
<plant gameID = "ALDER" sheetIndex = 1 />
<plant gameID = "ASH" sheetIndex = 2 />
<plant gameID = "BIRCH" sheetIndex = 31 />
</trees>
</pre>
And this one for shrubs:
<pre>
<?xml version="1.0" ?>
<shrubs file="vegetation/shrubs.png">
<plant gameID = "MUSHROOM_HELMET_PLUMP" sheetIndex = 0 />
<plant gameID = "GRASS_TAIL_PIG" sheetIndex = 1 />
<plant gameID = "GRASS_WHEAT_CAVE" sheetIndex = 2 />
<plant gameID = "POD_SWEET" sheetIndex = 3 />
</shrubs>
</pre>

Note that the only difference is the root node, both of which contain <plant> nodes.
The plant nodes should be rather straight forward; it only has two attributes:
*gameID: the name of the shrub or tree, as defined by the DF raw files. See here [[Talk:Stonesense:Adding_Vegetation|for a complete list]].
*[[Stonesense:Sprites#Sprite_Index|sheetIndex]]: the index of the sprite to be drawn for this plant.

Which sprite sheet the sheetIndex attributes refers to is specified by the file attribute in the root node.
The examples above uses "trees.png" and "shrubs.png" respectively.
If no file is specified, it will use the Objects.png in the Stonesense root folder.

Tree saplings and dead trees can be defined as well by adding the appropriate keywords to their plant entry:
<pre>
<plant gameID = "ALDER" dead="true" sapling="true" sheetIndex = 31 />
</pre>
There is no support for young shrubs, so the "sapling" keyword does nothing for shrubbery.
At present, (in Stonsense Granite) the value of the "dead" and "sapling" keywords is ignored, so:
<pre>
<plant gameID = "ALDER" dead="false" sapling="true" sheetIndex = 31 />
</pre>
... will still select for dead saplings.

=Buildings=
Building content can be found in the ''buildings'' folder of Stonesense.

As with other content, the content is outlined with an ''index.txt'' file, but unlike other content, the included content is very complex and difficult to follow.

Each tile in a workshop has a PositionIndex, starting at 0 for the northwest corner as shown in the 3x3 examples below:

[[file:SimpleWorkshopExample.png]]

This workshop was generated from the simplest possible code, to serve as an example for basic workshop construction. Far more advanced processing is possible, as can be seen from the content included with Stonesense.

<pre>
<?xml version="1.0" ?>

<building name="Example Building" game_type="Workshop" game_subtype="Custom" game_custom="TEST" file="TEST.png">

<if>
<PositionIndex value=0 />
<sprite index=0 />
</if>
<if>
<PositionIndex value=1 />
<sprite index=1 />
</if>
<if>
<PositionIndex value=2 />
<sprite index=2 />
</if>
<if>
<PositionIndex value=3 />
<sprite index=3 />
</if>
<if>
<PositionIndex value=4 />
<sprite index=4 />
</if>
<if>
<PositionIndex value=5 />
<sprite index=5 />
</if>
<if>
<PositionIndex value=6 />
<sprite index=6 />
</if>
<if>
<PositionIndex value=7 />
<sprite index=7 />
</if>
<if>
<PositionIndex value=8 />
<sprite index=8 />
</if>

</building>
</pre>

The above XML code and this graphic produced the example seen above. Note that only the "floor" of each tile was defined in this spritesheet. Actual workshops would likely include taller images.

[[File:SimpleSpritesheetExample.png]]

[[Category:Stonesense]]

Tutorials

2015-10-05T12:08:19Z

PeridexisErrant: /* Recommended tutorials and wiki articles */ Add PeridexisErrant's walkthrough and tutorials

{{av}}

[[File:NoFunAllowed.jpg|thumb|right|Of course, instead of trial and error you could also just read the wiki...]]
Dwarf Fortress started as a pretty complex game back in the days when it was 2D and barely had a quarter of the features it has now. It's easy to get overwhelmed when you first fire it up. Don't worry though, following a tutorial is a very easy way to learn the basics of the game in an afternoon.

Don't worry if you don't understand why you do things on your first run, even after reading the tutorial's explanation. If one particular thing bugs you, try starting a new fort and skipping it, then seeing what goes wrong! Especially in the current version, trial and error is great way of having lots of [[fun]].

== Installing and Running the Game ==

If you have not installed the game yet see [[Installation]].

== Learning Fortress Mode ==

Most of the tutorials were written for the older (40d) version of Dwarf Fortress. But nonetheless, they are still helpful. If you get stuck within a specific aspect of the game then [[Special:Search|search]] the wiki and don't hesitate to ask questions in the [http://www.bay12forums.com/smf/index.php?board=7.0 forum].

The following tutorials will walk you through world generation, embarking with your 7 dwarves, game basics, and building a full-fledged fortress.

=== Recommended tutorials and wiki articles===
[[File:FlowchartDF.png|thumb|right|200px|[[::From Caravan to Happy Dwarves|From Caravan to Happy Dwarves]] - This is a flowchart showing approximately what sequence of actions players usually take when starting up a new fort.]]
'''For v0.40:'''
*[[Quickstart guide|The Fortress Mode Quickstart Guide]]
*[http://dffd.bay12games.com/file.php?id=10552 Captain Duck's updated play along tutorial]
*[https://df-walkthrough.rtfd.org PeridexisErrant's DF walkthrough and tutorials]
*[https://www.youtube.com/playlist?list=PL_4titxTj-2v4tg_QisHa5os5qraDpTLZ Ongoing German tutorial series by konni.tv]
'''For v0.34:''' (the previous version)
*[https://www.youtube.com/watch?v=AI9Dy-4slVw&list=PLwWlb_jkC2UmyKmTWqD711j2QYX_Zmw-x A Noob's Guide to Dwarf Fortress] A tutorial series dedicated to beginners.
*[[::From Caravan to Happy Dwarves|From Caravan to Happy Dwarves]]. A minimalistic, but great, diagram (maybe for players with a bit more experience).
*[[User:Calite/Gloss Guide|Jumping Into Fortress Mode]]. An outline of main concepts, though it lacks any technical help.
*[http://www.youtube.com/watch?v=QmkPbGrH7VA&feature=plcp A beginner's tutorial to dwarf fortress.] Look here for a wide variety of guides on how to play fortress mode.
*[http://www.youtube.com/playlist?list=PL2C4E18093853E338 Let's Play/Tutorial Dwarf Fortress by Gerugon] A German video series that will teach you all you need to know to create your own fort.
* [https://www.dropbox.com/sh/8akafeuqfsxth7t/U-zOsO7pNr A quick reference guide on fortress mode] (Credit to spongemandan on reddit.com)

'''For the old versions:''' (but still really great for beginners)
*[http://dftutorial.wordpress.com/ I Play Dwarf Fortress - (And You Can Too!)] Play-Along Beginner's Guide With Pictures
*[[::Bentgirder|Bentgirder]]. A good, mostly-complete tutorial.
*[[40d:Video_tutorials|The legendary video tutorials by Captain Duck]].
*[http://afteractionreporter.com/2009/02/09/the-complete-and-utter-newby-tutorial-for-dwarf-fortress-part-1-wtf/ The Complete and Utter Newby Tutorial for Dwarf Fortress] with lots of screenshots ([http://www.bay12forums.com/smf/index.php?topic=31928.0 forum thread])
*[[40d:Indecisive's illustrated fortress mode tutorial|Indecisive's illustrated fortress mode tutorial]].
*[[40d:Quickstart_guide|A quickstart guide]]
*[[40d:What should I build first|"What should I build first?"]]

=== Specific Elements ===

These are not necessarily tutorials, but they can help out with specific parts of the game.

*'''[[Important advice|Important Advice]]''' - Disregard at your own risk.

=== Basics of World Generation ===

*[[World generation]]
*[[Map legend]]

=== Basics of Embarking ===

*[[Embark]]
*[[Location]]
*[[Biome]]
*[[Surroundings]]

=== Feeding Dwarves ===

There are several ways to [[Food|feed]] your dwarves. Your initial supplies will run out, but [[fishing]] and [[plant gathering]] are easy ways to get additional food in a starting fortress. The default embark group starts with a [[fisherdwarf]]; you'll need a [[fishery]] workshop to clean the fish your fisherdwarf catches, to make them edible.

It is very important to have enough [[alcohol]] for your dwarves, so building a [[still]] is almost a requirement during the first year. [[trading|Caravans]] bring some drinks, but not enough.

To ensure sustenance when the fortress grows, [[farming]] is the most reliable way. Above-ground farm plots are easy to set up (if you have soil on your map), but require [[seed]]s that can be obtained from gathered plants or by trading with humans or elves.

Buying food from [[trading|caravans]] is a good way to prevent shortages.

See:
*[[Farming]]
*[[Meat industry]]
*[[Fishing]]
*[[Herbalist|Gathering plants]]
*[[Trading|Trading for food]]
*And not to forget: [[Alcohol]]

=== Mining and Minerals ===

*[[The Non-Dwarf's Guide to Rock]] - A primer, explaining geology in so far as it is implemented in Dwarf Fortress. Note that DF geology is actually quite realistic, so knowledge of real world geology could make much of the game seem very familiar to you.

=== Defending Against Enemies ===

This is one of the most challenging aspects of the game, so if you feel confused even after reading all of this then you are not alone.

*[[Military quickstart]]
*[[Military]] - or for a complete explanation and walkthrough of the military menu (advisable to look at first) the [[Military interface]]
*[[Armor]] and [[Weapon]]s
*[[Sparring]]
*[[Trap]]s

==Adventure Mode==

Currently the only tutorial for [[Adventurer mode|Adventure Mode]] is the [[Adventure mode quick start]] guide. Adventure mode is significantly less complex than Fortress Mode though, so that guide will probably be enough to get you started.

Also see the [[Adventurer mode|Adventure Mode Reference Guide]].

{{Getting Started}}

User talk:Lethosor

2015-09-27T13:39:24Z

PeridexisErrant: /* CSS for new DFHack docs */ Worked it out.

{{User:Lethosor/header}}
{{Archive|
* [[/archive1|Archive 1 (February-August 2013)]]
* [[/archive2|Archive 2 (Sept. 2013 - May 2014)]]
}}
__TOC__
{{clear}}

==Bot requests==
<div style="" class="plainlinks">
[{{fullurl:User talk:Lethosor|action=edit&section=1&editintro={{urlencode:User:Lethosor/edit intro/bot}}}} '''Add a new request''']
</div>

=== Underpopulated categories ===

Many categories in the DF2014 namespace don't list some of the pages that have the category link. An empty edit on a page (well, any edit) will correct this, but only for that page. This sounds like a job for a bot. [[User:VengefulDonut|VengefulDonut]] ([[User talk:VengefulDonut|talk]]) 19:00, 21 July 2014 (UTC)
:I'm pretty sure that's a cache problem, so I'll try rebuilding link tables on the server side and see if that helps (it would probably be a lot faster than sending a bot around to null-edit every page). —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:41, 21 July 2014 (UTC)
::This has been fixed. The problem was that the server that actually runs the job queue was still using the old configuration (without the DF2014 namespace). —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:17, 8 November 2014 (UTC)

== Diagram ==

Take a look over [[DF talk:diagram|here]]. [[User:VengefulDonut|VengefulDonut]] ([[User talk:VengefulDonut|talk]]) 15:45, 26 July 2014 (UTC)

== Ceramic Industry page assistance. ==

(Message here) --[[User:DorfyDave|DorfyDave]] ([[User talk:DorfyDave|talk]]) 04:16, 24 August 2014 (UTC)
Thanks for the help with the ceramic industry stuff.

I see what you are doing with the thumbnail workflows on other pages, so if you would rather it be small and let the reader expand it, that would be fine.

I was thinking that the pages looked better with the intro section before the regular content, keeping it separate from the auto TOC / Header listed content, but if you prefer that everything follow the layered header format, that's fine.

:My primary concern was the wrapping caused by inserting the full-size flowchart next to a section. It looks like you've addressed that by splitting up the flowchart, which looks good to me. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 15:48, 25 August 2014 (UTC)

== Removing/restoring [[Main:Fruit]] ==

Not that I am protesting it, but why exactly did you remove and then restore the [[Main:Fruit]] page? Because to me, all that happened now is that the creation entry on the page's history is gone, which isn't really anything notable either.
--{{User:Latias1290/Sig/src|13:03|August 26, 2014}} 13:03, 26 August 2014 (UTC)
:I deleted it at first because I didn't realize AutoRedirect wasn't handling section redirects properly, then restored it when I noticed it was broken. That article's [http://dwarffortresswiki.org/index.php?title=Fruit&action=history history] still shows your revision, so I'm not sure what you mean - is it missing from [[Special:RecentChanges]]? —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 13:07, 26 August 2014 (UTC)
::The creation entry I was talking about was actually the first entry, and the entry that is now the only one was the second before you removed it. When I created the page I first had it directly redirect to [[cv:Tree#Fruit]], which after testing didn't work. I usually save the page when the preview doesn't show a red link and the link is correct, and after saving I test it, This time, however, the link in the preview was blue and correct, but actually following the redirect only led to [[cv:Tree]] instead of [[cv:Tree#Fruit]]. The entry you are seeing now is the result of fixing this by making it into a double redirect through [[cv:Fruit]].
:::It looks to me like your first edit was to [[DF2014:Fruit]] - when [[Main:Fruit]] didn't exist, it would have automatically redirected to [[DF2014:Fruit]], so it might have appeared to exist when it didn't. (The problem here is that I made AutoRedirect follow redirect chains internally, since Mediawiki's maximum-redirect setting is buggy, so a nonexistent [[Main:Fruit]] would actually redirect to what [[cv:Fruit]] redirects to - the problem is that it ignores sections at the moment, so section redirects will need to be manually created until I can fix that.) —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 13:18, 26 August 2014 (UTC)

== settings-manager ==

I don't know where to put it because I don't have a github account and don't know if you have a personal thread for your scripts like the others, but couldn't you add a TEXT mode entry in line 116 of your settings-manager script?
--[[Special:Contributions/78.250.50.116|78.250.50.116]] 04:40, 18 September 2014 (UTC)
:I originally excluded it because it only works on Linux, but I'll add it back for Linux users. Thanks! —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 19:44, 18 September 2014 (UTC)

== Interesting glitch with redirects ==

I went to see what "Candy" was by going to a page named "Candy", and I found out that it meant Adamantine. But I saw that I got redirected to [[v0.34:Adamantine]], which shouldn't happen seeing as mainspace redirects should always go to the cv namespace. So I went back to fix it, and I saw that [[main:Candy]] redirected to [[main:Adamantine]], so I went there to fix it. But that page redirected properly to [[DF2014:Adamantine]]. This is where it gets interesting.

So when you go to [[main:Candy]], you get redirected to [[main:Adamantine]] which in turn redirects to [[DF2014:Adamantine]]. But - for some reason, you don't get sent to [[DF2014:Adamantine]], but to [[v0.34:Adamantine]]. Going to [[main:Adamantine]] in the first place redirects you to [[DF2014:Adamantine]] properly.

I have no idea how this happens, and since you maintain most of the wiki, I think you would be the right person to tell this to.
--{{User:Latias1290/Sig/src|13:42|November 01, 2014}} 13:42, 1 November 2014 (UTC)

:My best guess is that the [[Main:Candy]] redirect is cached and still points to [[v0.34:Adamantine]]. Our [[DF:REDIR|new policy]] is to keep redirects in versioned namespaces, so feel free to tag any broken redirects (in the main namespace) that you find with {{tl|bad redirect}} and I'll delete them. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 14:48, 1 November 2014 (UTC)

:I just saw a redlink on the exploratory tunnels page(redlink to [[DF2014:Break]]) and went to create it, when I discovered that the pages for Break existed for 23a and 40d, but not for 34.11 and 40.x. I went to check those to import content, and they turned out to be redirects. So I just redirected [[DF2014:Break]] to [[DF2014:On break]] and when I went to create additional redirects in the mainspace, I found that [[main:Break]] redirects to [[main:On break]] which redirects to [[cv:On break]]. But, again, it ultimately did not redirect to cv:On break but to v0.34:Break. I think that if it is indeed a cache problem we should rebuild redirect caches. {{User:Latias1290/Sig/src|12:08|November 02, 2014}}
:PS: Or just batch-delete all of this kind of redirects. {{User:Latias1290/Sig/src|12:09|November 02, 2014}}
:I don't like "bumping" this message like this, but since it's rather annoying, and ten days have been since I told you, almost all of these redirects are broken. Take a look at [[main:Aluminium]] for example, it goes to its 34.11 page. I think that it goes like this; when a page in the mainspace redirects to another page in the mainspace, which in turn goes to a cv space page, it goes to 0.34 instead of the current version. Going to the main>cv redirect initially does not cause this glitch. {{User:Latias1290/Sig/src|12:46|November 12, 2014}}
::It would be helpful if you could add {{tl|bad redirect}} to those pages (preferably before the "#REDIRECT" line) so I can delete them. I'm not sure what's causing the problem, but I'll see if I can override broken redirects with the AutoRedirect extension as well. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 20:18, 12 November 2014 (UTC)

== Migrated citations ==

As seen on [[DF2014:Dragonfire]], migrated citations can become confused, pointing to non-existent pages. I'm not sure how to fix it, but in general citations shouldn't automatically change what they are pointing at.--[[User:Loci|Loci]] ([[User talk:Loci|talk]]) 18:26, 14 November 2014 (UTC)

== <nowiki>{{ArticleVersion}}</nowiki> bug ==

I just found another very strange bug regarding the articleversion template. The more research I did on it, the weirder it got. The bug is that when you are not logged in, and you visit a non-DF2014 page with an av template, the latest version shows as v0.40.16 instead of v0.40.18. {{User:Latias1290/Sig/src|10:17|November 25, 2014}}
PS: This bug does not replicate when you are logged in. {{User:Latias1290/Sig/src|10:19|November 25, 2014}}
:This is because pages are cached for logged-out users. You can refresh individual pages by adding "?action=purge" to the end of the URL (or possibly by null-editing them). It appears to occur in DF2014 pages as well - [[DF2014:Hemp]], for example. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 23:49, 25 November 2014 (UTC)

== Lost password request ==

Sorry about the difficulty, but thank you very much.

== Redirects ==

Thank you for the correction. I felt I might be doing it wrong but couldn't find an example of it done right to copy. Now I know. :) [[User:Volatar|Volatar]] ([[User talk:Volatar|talk]]) 16:02, 30 July 2015 (UTC)

User talk:Lethosor

2015-09-27T10:45:47Z

PeridexisErrant: /* CSS for new DFHack docs */ new section

User talk:Vjek

2015-09-04T07:22:14Z

PeridexisErrant: /* Scripts */ Are proposed for inclusion in DFHack

Created page. --[[User:Briess|Briess]] 17:59, 28 June 2012 (UTC) 
First version --[[User:Vjek|Vjek]] 20:26, 28 June 2012 (UTC)

== Scripts ==

So far, I've only tried 2 of your scripts: make_legendary and armoks_blessing. The make_legendary is working fine, but armoks_blessing broke when it tried to do what I'm guessing was the elevate_mental and/or elevate_physical part. The trace said line 72. I'm not complaining. I'm just letting you know that the new 34.11 version of DFHack is out and some of your scripts still work. :) --[[User:Zackman0010|Zackman0010]] 05:35, 1 July 2012 (UTC)

To make installation and maintenance easier for users, I've proposed to include the scripts in the standard DFHack distribution. See that [https://github.com/DFHack/dfhack/pull/679 on GitHub], or just comment here. [[User:PeridexisErrant|PeridexisErrant]] ([[User talk:PeridexisErrant|talk]]) 07:22, 4 September 2015 (UTC)

== Update ==
Updated & tested all scripts for 34.11, everything appears ok.

[[User:Vjek|Vjek]] 02:50, 4 July 2012 (UTC)

==Pref_adjust==
Taking a brief look at this script, it is not necessary to set all of item_type, creature_id, color_id, shape_id, and plant_id - they're all in a union, so it should be enough to just set one of them. Additionally, your logic for clearing preferences really should be removing them from the list, not just zeroing out their fields. In case you're curious, the "unk" field is actually just a random number seed which is used to consistently select a random prefstring (df-structures has since been updated to reflect this). --[[User:Quietust|Quietust]] 16:56, 26 July 2012 (UTC)

== Material prefs ==

Is there any way to mod what materials dwarves like? nice to have a smith that likes steel. ;)

vjek says: Yep, you can. From my notes, type 0 (zero) appears to be materials like bronze. This type field I'm referring to is found under unit.status.current_soul.preferences within each particular preference per dwarf. If that's not clear, reply, PM or email me.

== 34.11r2 Update ==
Updated & tested all scripts for 34.11r2, everything appears ok.

[[User:Vjek|Vjek]] 21:30, 23 January 2013 (UTC)

== 34.11r3 Update ==
I've tested all the scripts with DFHack 34.11r3 and vanilla DF 34.11 and everything appears ok. If anyone has any problems with using the scripts with r3, PM me on the forums or message me via the wiki.

[[User:Vjek|Vjek]] 21:11, 20 March 2013 (UTC)

== Help ==
Which one of the values in the make legendary script controls the amount of levels raised, and which values correspond to which levels? Thanks!
[[User:Someone12345|Someone12345]] ([[User talk:Someone12345|talk]]) 21:59, 1 January 2014 (UTC)

(Answered on [http://www.bay12forums.com/smf/index.php?topic=135069.0 forums]) --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 22:14, 2 January 2014 (UTC)

== possible bug with rejuvenate ==

From anonymous user: twice now ive had major lag spikes about a year and a half after using rejuvenate. its about a second of lag every 3 to 4 seconds. seems to get worse over time.

From vjek: If you can email me a link to a save where you observed this behavior, I'll take a look. It is extremely unlikely, given rejuvenate sets exactly three variables, that it is the cause of any frame-rate lag for DF.
Keep in mind: rejuvenate is meant to be run once, not continuously, and for use with dfhack r2/r3 ONLY. It has also only been tested with vanilla DF 34.11, not with other mods.
[[User:Vjek|Vjek]] ([[User talk:Vjek|talk]]) 00:41, 18 February 2014 (UTC)

Mouse control

2015-05-19T04:38:23Z

PeridexisErrant: Changed quality rating from "Tattered" to "Fine" using the rating script

{{Quality|Fine|04:38, 19 May 2015 (UTC)}}
{{av}}
Mouse controls are a feature that the player will sporadically come across. Current mouse controls are as follows:
*Left-click to select an option. This includes list items, tabs, map tiles and various controls.
*Right-click to scroll a list downward (in some cases to cycle tabs) or to move the cursor.
*Right-click on map border to move view.
Double-left click currently only selects all items in a tab on the "Move Goods to Depot"-screen.

Menus that support mouse controls are:
*Advanced world generation/Advanced parameter settings
*Creature creation screen in the object testing arena
*Sound menu
*Local image export menu
*Designations menu (but not sub-menus)
*Burrows
*Nobles screen
*Military screen
*Custom stockpile settings
*Health screen (both individual and in the status screen)
*Economic stone settings
*"Move goods to Depot"-screen

Note: All information on this page is true as of vanilla 0.40.19. All earlier versions may have to be verified independently. Mods such as DFHack may provide you with full mouse-clicky goodness.
[[Category:DF2014:Game mechanics]]
{{Category|Interface}}

DF2014:Tax collector

2015-05-19T04:37:08Z

PeridexisErrant: expanded history.

{{Quality|Fine|23:37, 17 May 2015 (UTC)}}
{{av}}

The '''Tax collector''' does not exist in this version of Dwarf Fortress.

Prior to DF v0.31.01, the arrival of the Tax collector (along with the Baron) would signal the beginning of the Dwarven economy. Toady One has stated that the Dwarven economy may return after sweeping changes are made. The Tax Collector would sometimes collect taxes from the dwarves. These taxes were supposed to go to the nobles, as the Tax Collector gets a happy thought for pleasing a noble when doing so. They were usually escorted by two Royal guards.

Genetics

2015-05-19T04:31:16Z

PeridexisErrant: Changed quality rating from "Tattered" to "Fine" using the rating script

{{Quality|Fine|04:31, 19 May 2015 (UTC)}}
{{av}}

V0.31.01 introduced a system of inheritance and genetics to go along with the [[v0.31:Release_information#Appearances|appearance modifiers]], allowing children to inherit those from their parents. Apart from appearance modifiers, attributes can also be inherited, according to [[Main:Dwarf Fortress Talk|Dwarf Fortress Talk]] [http://www.bay12games.com/media/df_talk_8_transcript.html #8].

Genetic information is saved for every historical figure, from which each culture derives a number of tissue colors and other appearance modifiers that are likely to be found on any given member of that culture. It is currently unknown whether the abstract entity populations have any impact on the entity's genetic profile, or if only the historical figures do.

In tissue colors, whether a color is dominant or recessive is determined by the color's position in the list of possible colors for that tissue. The first colors listed are dominant over the colors below them. Whether genes besides color have dominance and recessiveness is unknown at this time.

{{Category|World}}

User talk:PeridexisErrant

2015-05-19T04:29:24Z

PeridexisErrant: /* "Melt item" rating */

== Category links ==

The problem you likely ran across at [[Utility:Stonesense/Tutorials]] is solved by adding a colon in front of the link, like this: [[:Category:Stonesense]]. --[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 19:43, 4 October 2013 (UTC)

== Re: Old pages ==

I've added [[User:Lethosor/outdated_warning.js|this script]] to your [[User:PeridexisErrant/common.js|common.js]] page. Can you test it out and let me know if there are any problems with it? —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 17:16, 4 May 2014 (UTC)

It's working perfectly so far! [[User:PeridexisErrant|PeridexisErrant]] ([[User talk:PeridexisErrant|talk]]) 01:28, 5 May 2014 (UTC)

Wait, too soon. It also shows the banner on pages not in one of the old release namespaces, eg [https://dwarffortresswiki.org/index.php/ASCII_Art_Reward here]. [[User:PeridexisErrant|PeridexisErrant]] ([[User talk:PeridexisErrant|talk]]) 07:16, 5 May 2014 (UTC)

:Fixed. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 18:56, 5 May 2014 (UTC)

== "Melt item" rating ==

Could you explain why you rated [[DF2014:Melt item]] as "tattered"? —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 21:00, 18 May 2015 (UTC)

I think the rating script is suggesting that rating because of the number of {{tl|verify}} tags - taking the rest of the article into account, I'm not sure it deserves that rating. —[[User:Lethosor|Lethosor]] ([[User talk:Lethosor|talk]]) 03:10, 19 May 2015 (UTC)

That was it. Since you think they should be discounted here, I've re-rated it as Superior.

Melt item

2015-05-19T04:29:11Z

PeridexisErrant: Re-rated page

{{Quality|Superior|23:44, 17 May 2015 (UTC)}}
{{av}}
You can '''melt''' items at a [[smelter]], using the [[furnace operator]] labor, to recover some of the [[metal]] they were made of. [[Decoration]]s in a different metal are not recovered or considered; the metal recovered is the specific metal that basic item was listed as being made from. The % return is predictable and consistent for each item type, and ranges from 10%-150%, depending on the item. Higher skill levels in furnace operator speed up the process, but have no effect on the % return.

Items that yield more than 100% can be used to increase the amount of a metal you have available by producing those items and then melting them down again as many times as required. This is generally considered to be an [[Exploit#Infinite_Adamantine_.2F_Metals|exploit]] of an error in the game mechanics. However, using a dwarf with a high skill level to make the items will result in him throwing severe tantrums when you start melting all his ☼masterwork☼ items, so you will need to disable your legendary armorer/weaponsmith while using the exploit, and make sure the skill levels don't get too high on the dwarfs making the items, to avoid creating masterwork items, or you will have tantrum spirals, fist fights, and/or lots of <s>useless junk</s> valuable trade goods lying around.

*Caution:(Needs Verification) In the latest version melting ☼masterwork☼ crafts may cause the Dwarf to still throw tantrums even if his skills are disabled at the time.

Recovered metal is measured in 1/10th's, and 1/10ths of bars of each metal are saved at the smelter where the item was melted. Fractional bars are not "shared" between smelters, nor do they exist as usable objects as is. When 10/10ths of a type of metal are accumulated at the same smelter, 1 bar of that metal is produced. If the smelter is torn down or destroyed, all fractions are lost.

:''Example:'' If two items of the same metal worth .4 bars each are melted at the same smelter, that smelter has .8 bars worth waiting in it.
:If a similar item of a ''different'' metal is then melted there, that smelter would have .8 bars of the first metal and .4 bars of the second.
:If a similar item of the first metal is then melted at a ''different'' smelter, that smelter will have .4 of that metal, and have no connection to the fractions in the first smelter.
:If (finally!), a 3rd, similar item of the first metal is melted at the first smelter, adding another 4/10ths, and giving a total of 12/10ths of that type of metal, 1 bar of that metal is produced, and 2/10th's are waiting (plus the 4/10 of the second metal, also waiting).

So, it makes sense to designate one smelter as "melting" smelter (or for one metal type), to guarantee that fractions will add up effectively.

==Designating items to melt==
You can designate metal items for melting from any interface that allows you to view the object's description screen, such as from the [[Stocks]] page or the Loo{{k|k}} interface.

To bring up an individual object description screen when the object is:
:* On the '''ground''': Type {{k|k}}, scroll to the object, select it from the list, and type {{k|Enter}}.
:* In a '''workshop''': Type {{k|t}}, highlight the workshop, select the object from the list, and type {{k|Enter}}.
:* '''Held''' by a dwarf: Type {{k|v}}, highlight the dwarf, type {{k|i}} to show his inventory, select the object from the list, and type {{k|Enter}}.
:* Inside another object: Display the container's object description screen, navigate to the specific object you wish to see, and type {{k|Enter}}.
:* In the '''stocks''' menu: Type {{k|z}}, hit right-direction a few times to select "stocks" and press return. Scroll to the type of object you wish to melt, type {{k|Tab}} to show individual items (You have to have an exact number or this won't work. See [[Bookkeeper]] for how to get this), scroll to the specific object, and type {{k|v}} to view.

To designate the item, simply type {{k|m}} to mark the object for melting. If the item is designated for melting and [[forbidden]] then the item will '''not''' be melted.

However, this only marks which items you want to be melted - you still have to place the job-order in a smelter...

==Melting the items==
Items designated to be melted will be left alone until you queue a "Melt a metal object" job {{k|o}} at a [[Smelter]]. Melting down an object requires the [[Furnace operator]] labor (and consumes a unit of [[fuel]] for a non-magma smelter).

The job gives the same experience to the [[furnace operator]] skill regardless of % yield of the item melted.

If there are items in a container that you are melting, the items will be placed inside the smelter when the container is destroyed.

==Yield==
Testing is incomplete, but preliminary results show a yield of 0.3 bars times the object's material size for anything that has a material size, or 1 bar for most furniture (regardless of size).

Note that the Efficiency column is only accurate for ordinary metals - when using [[adamantine]], the number of wafers required comes from the "Material size" column instead of "Bars to make", so if that number is larger, the efficiency will be reduced accordingly.

{| style="margin:1em 1em 1em 0;background:#F9F9F9;border:1px #AAA solid;border-collapse:collapse;" class="wikitable sortable"
! Item !! Material size !! Bars to make !! Bars returned !! Efficiency
|-
! colspan="5"|[[weapon|Weapons]] (made by Weaponsmith)
|-
| Crossbow || 3 || 1 || 0.9 || 90%
|-
| Mace || 3 || 1 || 0.9 || 90%
|-
| Spear || 3 || 1 || 0.9 || 90%
|-
| Short sword || 3 || 1 || 0.9 || 90%
|-
| War hammer || 3 || 1 || 0.9 || 90%
|-
| Battle axe || 4 || 1 || 1.2 || '''120%'''
|-
| Pick || 4 || 1 || 1.2 || '''120%'''
|-
| Ammo (stack of 25) || (1) || 1 || 0.3{{verify}} || 30%
|-
| Ammo (stack of 1) || (1) || 1/25 || 0.1{{verify}} || '''''250%'''''
|-
! colspan="5"|Siege Equipment (Weaponsmith)
|-
| Ballista arrow || (4) || 3 || 0.5{{verify}} || 17%
|-
| Ballista arrow head || (4) || 3 || 0.5{{verify}} || 17%
|-
! colspan="5"|[[trap_component|Trap Components]] (Weaponsmith)
|-
| Giant Axe Blade|| 5 || 1 || 1.5 || '''''150%'''''
|-
| Enormous Corkscrew|| 5 || 1 || 1.5 || '''''150%'''''
|-
| Spiked Ball|| 4 || 1 || 1.2 || '''120%'''
|-
| Large Serrated Disc|| 4 || 1 || 1.2{{verify}} || '''120%'''
|-
| Menacing Spike|| 5 || 1 || 1.5{{verify}} || '''''150%'''''
|-
! colspan="5"|[[trap_component|Trap Components]] (Mechanic)
|-
| Mechanisms || (3) || 1 || 0.5 || 50%
|-
! colspan="5"|[[Armor]] (Armorsmith)
|-
| Cap || 1 || 1 || 0.3 || 30%
|-
| Helm || 2 || 1 || 0.6 || 60%
|-
| Gauntlet || 2 || 0.5 || 0.6 || '''120%'''
|-
| Leggings || 5 || 1 || 1.5 || '''''150%'''''
|-
| Greaves || 6 || 2 || 1.8 || 90%
|-
| Low boot || 1 || 0.5 || 0.3 || 60%
|-
| High boot || 2 || 0.5 || 0.6 || '''120%'''
|-
| Buckler || 2 || 1 || 0.6 || 60%
|-
| Shield || 4 || 1 || 1.2 || '''120%'''
|-
| Mail shirt || 6 || 2 || 1.8 || 90%
|-
| Breastplate || 9 || 3 || 2.7 || 90%
|-
! colspan="5"|[[tool|Tools]] (Metalcrafter)
|-
| Nest box || 1 || 1 || 0.3 || 30%
|-
| Jug || 1 || 1 || 0.3 || 30%
|-
| Pot || 1 || 1 || 0.3 || 30%
|-
| Hive || 1 || 1 || 0.3 || 30%
|-
| Minecart || 6 || 2 || 1.8 || 90%
|-
| Wheelbarrow || 6 || 2 || 1.8 || 90%
|-
! colspan="5"|[[Furniture]] (Blacksmith)
|-
| Anvil || (9) || 3 || 1 || 33%
|-
| Armor stand || (9) || 3 || 1{{verify}} || 33%
|-
| Barrel || (9) || 3 || 1 || 33%
|-
| Bin || (9) || 3 || 1{{verify}} || 33%
|-
| Blocks || (4) || 1 || 0.5 || 50%
|-
| Bucket || (3) || 1 || 1 || '''100%'''
|-
| Cabinet || (9) || 3 || 1{{verify}} || 33%
|-
| Cage || (6) || 3 || 1 || 33%
|-
| Chair || (9) || 3 || 1{{verify}} || 33%
|-
| Chest || (9) || 3 || 1{{verify}} || 33%
|-
| Coffin || (9) || 3 || 1{{verify}} || 33%
|-
| Crutch || (3) || 3 || 0.5 || 17%
|-
| Door || (9) || 3 || 1{{verify}} || 33%
|-
| Floodgate || (9) || 3 || 1{{verify}} || 33%
|-
| Grate || (9) || 3 || 1{{verify}} || 33%
|-
| Hatch cover || (9) || 3 || 1{{verify}} || 33%
|-
| Pipe section || (9) || 3 || 1 || 33%
|-
| Splint || (2) || 3 || 0.5 || 17%
|-
| Statue || (9) || 3 || 1{{verify}} || 33%
|-
| Table || (9) || 3 || 1{{verify}} || 33%
|-
| Traction bench || (9) || 3 || 1{{verify}} || 33%
|-
| Weapon rack || (9) || 3 || 1{{verify}} || 33%
|-
! colspan="5"|[[Furniture]] (Metalcrafter)
|-
| Chain || (4) || 1 || 1 || '''100%'''
|-
! colspan="5"|[[Furniture]] (Trapper)
|-
| Animal trap || (3) || 1 || 1 || '''100%'''
|-
! colspan="5"|Other objects (Metalcrafter)
|-
| Amulet || (1/3 to 1) || 1/3 to 1 || 0.1{{verify}} || 10% to 30%
|-
| Bracelet || (1/3 to 1) || 1/3 to 1 || 0.1{{verify}} || 10% to 30%
|-
| Coins (stack of 500) || (1) || 1 || 1.1 || '''''110%'''''
|-
| Coins (stack of 1) || (1) || 1/500 || 0.1 || '''''5000%'''''
|-
| Crown || (1/3 to 1) || 1/3 to 1 || 0.1{{verify}} || 10% to 30%
|-
| Earring || (1/3 to 1) || 1/3 to 1 || 0.1{{verify}} || 10% to 30%
|-
| Flask || (1/3) || 1/3 || 0.2 || 60%
|-
| Figurine || (1/3 to 1) || 1/3 to 1 || 0.2 || 20% to 60%
|-
| Goblet || (1/3) || 1/3 || 0.2 || 60%
|-
| Instrument || (1) || 1 || 1 || '''100%'''
|-
| Toy || (1) || 1 || 0.2{{verify}} || 20%
|-
| Ring || (1/3 to 1) || 1/3 to 1 || 0.1 || 10% to 30%
|-
| Scepter || (1/3 to 1) || 1/3 to 1 || 0.2{{verify}} || 20% to 60%
|}

All melting yields for items ''not'' specified in the raws (weapons, armor, tools, etc.) are hardcoded.

Metal bars are able to be melted and remade into half a bar at a smelter. (Melt 1 tin bar, return as 0.5 tin bar + experience.)

==Bugs==
*A number of items produce more metal when melted than they cost to produce.{{bug|6027}}
*Designating items to be melted from the [[stocks]] screen can cause a crash.{{bug|6431}}

{{Category|Jobs}}
{{Category|Items}}

Weapon token

2015-05-18T11:50:25Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:50, 18 May 2015 (UTC)}}
{{av}}

These tokens can only be placed within an ITEM_WEAPON object definition, most do not function in armor objects.
{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Arguments
! Description
! Works in armor

|-
| {{text anchor|NAME}}
|
*singular
*plural
| Name of the weapon. Required.
| {{y}}

|-
| {{text anchor|ADJECTIVE}}
|
*adjective
| Adjective of the weapon, e.g. the "large" in "large copper dagger".

|-
| {{text anchor|SIZE}} / {{text anchor|WEIGHT}}
|
*size
| Volume of weapon in mL or cubic cm. Defaults to 100.

|-
| {{text anchor|SHOOT_FORCE}}
|
*value
| The amount of force used when firing projectiles - velocity is presumably determined by the projectile's mass. Defaults to 0.

|-
| {{text anchor|SHOOT_MAXVEL}}
|
*value
| The maximum speed a fired projectile can have.

|-
| {{text anchor|SKILL}}
|
*[[Skill token]]
| The skill to determine effectiveness in melee with this weapon. Defaults to MACE. Skill of AXE will allow it to be used to chop down trees. Skill of MINER will allow it to be used for mining. Outsider adventurers (or regular ones with no points in offensive skills) will receive a weapon with the SPEAR skill, selected at random if multiple ones have been [[modding|modded]] in. All adventurers will also start with a weapon using the DAGGER skill, again selected at random if multiple such weapons exist.

|-
| {{text anchor|RANGED}}
|
*[[Skill token]]
*Ammo class
| Makes this a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.

|-
| {{text anchor|TWO_HANDED}}
|
*size
| Creatures under this size (in cm^3) must use the weapon two-handed. Defaults to 50000.

|-
| {{text anchor|MINIMUM_SIZE}}
|
*size
| Minimum body size (in cm^3) to use the weapon at all (multigrasp required until TWO_HANDED value). Defaults to 40000.

|-
| {{text anchor|CAN_STONE}}
|
| Allows the weapon to be made at a [[craftsdwarf's workshop]] from a sharp ([MAX_EDGE:10000] or higher) stone (e.g. [[obsidian]]) plus a wood log.

|-
| {{text anchor|TRAINING}}
|
| Restricts this weapon to being made of wood.

|-
| {{text anchor|MATERIAL_SIZE}}
|
*value
| Number of bar units needed for forging, as well as the amount gained from melting. Required.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
|
| Multiple strikes with this attack can be performed with no penalty.

|-
| {{text anchor|ATTACK}}
|
*attacktype:BLUNT or EDGE
*contact_area:value
*penetration_size:value
*verb2nd:string
*verb3rd:string
*noun:string
*velocity_multiplier:value
| You can have many ATTACK tags and one will be randomly selected for each attack, with EDGE attacks 100 times more common than BLUNT attacks. Contact area is usually high for slashing and low for bludgeoning, piercing, and poking. Penetration value tends to be low for slashing and high for stabbing. Penetration is ignored if attack is BLUNT. Required.

|}

{{Category|Modding}}
{{Category|Tokens}}

Weasel man

2015-05-18T11:50:13Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

40d:Manager

2015-05-18T11:24:20Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:24, 18 May 2015 (UTC)}}
{{Noble
| noble=Manager
| office=Meager Office
| arrival=
* None, manually appointed
| function=
* Manage bulk job orders
}}{{av}}

The '''Manager''' is an appointed [[noble]] position. To do his/her work he/she uses the [[Organizer]] skill.

When chosing a dwarf for the position the following skills are also listed as relevant:

* [[Comedian]]
* [[Consoler]]
* [[Flatterer]]
* [[Intimidator]]
* [[Judge of intent]]
* [[Liar]]
* [[Negotiator]]
* [[Pacifier]]
* [[Persuader]]

If this position is left vacant, the Manager screen at {{K|j}} -> {{K|m}} says "A manager is required to coordinate work orders", which seems to imply that they will not be performed. Without a manager the 'Workshop {{K|P}}rofile' option won't be available on workshops.

== Changing name ==
The Manager is named according to the rank of your [[fortress]], starting at Outpost Manager and proceeding to Hamlet Manager, Village Manager, Town Manager, City Manager, Metropolis Manager, and finally Mountainhome Manager once the [[King]] arrives.

== Setting up work orders ==

The Manager screen ({{k|u}}{{k|m}} or {{k|j}}{{k|m}}) allows you to set up work orders. This can be handy if you want to specify a precise number of items to be created, more than the few that will fit in a workshop's queue, but not just an indefinite amount, as you'd get by specifying a workshop task as a repeating task. It can also be useful because, although work orders will still be canceled if the raw materials aren't currently available, they will be added back to the workshop queue regularly until the order is finished.

You can add an amount of 30 items maximum to the queue, but you can add twice the order or even more, if you want to mass produce something.

== Approval of work orders ==

When the Manager presides over an Outpost that has less than 20 dwarves, the {{K|j}}ob {{K|m}}anager screen allows all orders to be assigned automatically; the game simply abstracts out the order management and the Manager probably just discusses the jobs while everyone is downing their [[dwarven ale|ale]].

However, upon becoming a Hamlet Manager, the Manager must personally verify each and every task on the manager screen; by that time, the population has grown significantly enough that the Manager must devote at least some of his time to bureaucracy. The Manager then requires an [[Office]] to perform his or her duties.

The manager screen displays the tasks the Manager has approved with a green check mark, and displays the tasks the Manager has not yet approved with a red X. Approving these tasks occurs in the Manager's Office: the Manager receives a task automatically and, after spending a short amount of time scribbling furiously, the order is approved and the craftsdwarves can get to work! Naturally, the Manager cannot be otherwise busy or else he won't be able to approve the orders. The time taken to approve the order is dependent on the Manager's [[Organizer]] skill.

== Room requirements and consolidating nobles ==

* While this noble does not require a dining room, they may eat at the chair in their office, and if so will receive a negative [[thought]] about the lack of tables. For this reason, it may be advisable to assign them a small, personal dining room, or just build a table in their office by the chair.
* The manager has the same room and furniture requirements as the [[broker]] and [[bookkeeper]]. Because all three of these nobles tend to have periodic idle time, it may be possible to have one dwarf serve all three functions, especially in the early years of a fortress.
* A dwarf will receive a negative thought if they have to conduct a meeting in a [[bedroom]] or dining room, so make sure they have an appropriate office.

{{nobles}}

40d:Macros and Keymaps Examples

2015-05-18T11:23:57Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:23, 18 May 2015 (UTC)}}
{{av}}
This page contains example scripts for the page [[Macros and Keymaps]] and is expected to get fairly lengthy. Put macros in their own section and link to that section.

==Room-designation Macro 01==
Designates an eight-chambered circular room.

<pre>
F1::
send d{Enter}+{NumpadPgUp}+{NumpadPgUp}{NumpadEnd}{NumpadEnd}{Enter}+{NumpadEnd}{NumpadPgUp}x{Enter}{Enter}
Sleep 100
send x{NumpadRight}{NumpadRight}{NumpadRight}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
Sleep 50
send {NumpadDown}{NumpadDown}{NumpadDown}{NumpadDown}{NumpadDown}{NumpadDown}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
Sleep 50
send {NumpadEnd}{NumpadEnd}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{Enter}{Enter}
Sleep 50
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
Sleep 100
send {NumpadHome}{NumpadHome}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
Sleep 50
send {NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
Sleep 50
send {NumpadPgUp}{NumpadPgUp}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{NumpadRight}{NumpadRight}{NumpadRight}{NumpadRight}{NumpadRight}{Enter}{Enter}
Sleep 50
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumPadLeft}{Enter}{Enter}
Sleep 100
send {NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadRight}{NumpadRight}{NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
Sleep 50
send {NumpadDown}{NumpadDown}{NumpadDown}{NumpadDown}{NumpadDown}{NumpadDown}{NumpadDown}{NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadDown}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
Sleep 50
send {NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadLeft}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
Sleep 50
send {NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadUp}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
send {NumpadRight}{Enter}{Enter}
Sleep 100
send {NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{Enter}
send {NumpadPgDn}{NumpadPgDn}{Enter}
send +{NumpadRight}{NumpadRight}{NumpadRight}{NumpadRight}{NumpadRight}{Enter}
send {NumpadPgUp}{NumpadPgUp}{Enter}
send +{NumpadDown}+{NumpadDown}{NumpadUp}{NumpadUp}{Enter}
send {NumpadHome}{NumpadHome}{Enter}
send +{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{NumpadLeft}{Enter}
send {NumpadEnd}{NumpadEnd}{Enter}
send +{NumpadPgUp}{NumpadEnd}
return
</pre>

[[Category:Guides]]

40d:Macros and keymaps

2015-05-18T11:05:37Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:05, 18 May 2015 (UTC)}}
{{av}}
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
* Another way to add delay during and after each simulated key press is to put SetKeyDelay, 40, 40 at the start of the macro.
* 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.

== Built-in Macros ==

With the release of df_28_181_40d13, Dwarf Fortress supports macros without any outside program. They can be created by hitting escape to access the options menu and choosing the Key Bindings section. Once in the Key Bindings menu hit Shift+Tab to open the macro screen. The macros you create here are saved in the file "\data\init\interface.txt". Adding the following to the end of that file will create a macro that selects every item on the trade screen when you hit the tilde key (`).

<pre>
[BIND:MACRO0]
[SYM:`]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
[MACRO:SELECT:1]
[MACRO:STANDARDSCROLL_DOWN:1]
</pre>

Performance can be increased by changing the macro pause, MACRO_MS, from the default 150ms per command to zero. Most dig macros can be created using combinations of the following:
<pre>
[MACRO:CURSOR_UP:1]
[MACRO:CURSOR_DOWN:1]
[MACRO:CURSOR_LEFT:1]
[MACRO:CURSOR_RIGHT:1]
[MACRO:SELECT:1]
[MACRO:DESIGNATE_DIG:1]
[MACRO:DESIGNATE_UNDO:1]
[MACRO:CURSOR_UP_FAST:1]
[MACRO:CURSOR_DOWN_FAST:1]
[MACRO:CURSOR_LEFT_FAST:1]
[MACRO:CURSOR_RIGHT_FAST:1]
[MACRO:MACRO123:1]
</pre>
Most of these should be self-explanatory. Each command is followed with a quantity. To call other macros, use <pre>[MACRO:MACRO###:1]</pre> Each new macro begins with a bind command, consisting of BIND, the macro number, and a description:
<pre>[BIND:MACRO11:dig_round_room]</pre> Spaces are not allowed in the description{{verify}}. To bind this macro to a key, SYM is used.<pre>[SYM:Ctrl+Right]</pre> Ctrl, Alt, and Shift combinations are allowed, but not chords with more than one{{verify}}, like Ctrl+Shift+Right. Also, the windows, or meta key, does not appear to be supported{{verify}}. Macros appear to only be terminated by the start of a new macro (BIND command) or the end of the interface.txt file.

Visit this [http://www.bay12games.com/forum/index.php?topic=40751.0 forum post] for additional macros, and discussion on macro creation.

== AutoHotKey Examples ==

===Dumping===

====[[GuiDumper.ahk]]====
This script allows the user to specify a range of squares to dump.

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

To use, first have your bookkeeper 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 [[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.
[[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>

=== jokermatt999's pump stack builder ===

Just a simple macro to place one mined level of a pump stack room, as illustrated in the pump stack page on this wiki. It's recommended you exit out after finishing up with it, as the macro is just assigned to p. Hit/Hold down p for multiple layers.

<pre>
p::Send i{Enter}{Enter}{Right}d{Enter}{Right}{Right}{Down}{Down}{Enter}h{Enter}{Enter}{Up}{Left}x{Enter}{Enter}{Left}{Left}{Down}h{Enter}{Enter}{Up}{Up}{Shift Down}.{Shift Up}
</pre>

<pre>
p::
Send i{Enter 2}
Send d6{Enter}33{Enter}
Send h{Enter 2}
Send x7{Enter 2}
Send h14{Enter 2}
Send 88{Shift Down}.{Shift Up}
return
</pre>

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

40d:Map legend

2015-05-18T11:05:02Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:04, 18 May 2015 (UTC)}}
{{av}}
==Tile Colors==
The [[color]]s of a map tile may give information about that region's predominant [[biome]]: its temperature, alignment, and other handy things. Cyan or blue means the area is "good" aligned. Purple and grey/red areas have "evil" alignment. Light grey, brown, and yellow areas usually are dry and have sparse vegetation. Green tiles have vegetation and are usually moist. White tiles indicate snow.

==Legend==

Tiles are listed in by alignment, with regular tiles first, then haunted, then good aligned tiles, and then evil tiles.

{|
! Name
! Regular
! Good
! Evil
|-
| '''''Forests'''''
|-
|'''[[Broadleaf]] [[Forest]]'''
Broadleaf forests change tiles with the seasons.
||
{|
|{{Biome|♠|♣|#00FF00|#00FF00}}
|{{Biome|♠|♣|#FFFF00|#FF0000}}
|{{Biome|╞|╡|#808000|#808000}}
|{{Biome|♠|♣|#FFFFFF|#FFFFFF}}
|{{Biome|♠|♣|#800000|#808080}}
|}
||
{|
|{{Biome|♠|♣|#00FFFF|#00FF00}}
|}
||
{|
|{{Biome|♠|♣|#800080|#FF00FF}}
|}
|-
|'''[[Tropical]] [[Broadleaf]] [[Rainforest]]'''
||
{|
|{{Biome|♠|Γ|#00FF00|#00FF00}}
|{{Biome|♠|Γ|#800000|#808080}}
|}
||
{|
|{{Biome|♠|Γ|#00FF00|#00FFFF}}
|}
||
{|
|{{Biome|♠|Γ|#800080|#FF00FF}}
|}
|-
|'''[[Coniferous]] [[Forest]]'''
||
{|
|{{Biome|↑|↨|#00FF00|#00FF00}}
|{{Biome|↑|↨|#800000|#808080}}
|}
||
{|
|{{Biome|↑|↨|#00FFFF|#008080}}
|}
||
{|
|{{Biome|↑|↨|#800080|#FF00FF}}
|}
|-
|'''''[[Mountains]]'''''
|-
|'''[[Hills]]'''
||
{|
|{{Biome|n|∩|#00FF00|#00FF00}}
|}
||
{|
|{{Biome|n|∩|#00FFFF|#008080}}
|}
||
{|
|{{Biome|n|∩|#800080|#FF00FF}}
|}
|-
|'''[[Low Mountain]]'''
||
{|
|{{Biome|⌂|⌂|#808080|#808080}}
|{{Biome|⌂|⌂|#FFFFFF|#FFFFFF}}
|}
||
{|
|{{Biome|⌂|⌂|#FFFF00|#FFFF00}}
|}
||
{|
|{{Biome|⌂|⌂|#800080|#FF00FF}}
|}
|-
|'''[[Mountain]]'''
||
{|
|{{Biome|▲|▲|#808080|#808080}}
|{{Biome|▲|▲|#FFFFFF|#FFFFFF}}
|}
||
{|
|{{Biome|▲|▲|#FFFF00|#FFFF00}}
|}
||
{|
|{{Biome|▲|▲|#800080|#FF00FF}}
|}
|-
|'''[[High Mountain]]'''
||
{|
|{{Biome|▲|▲|#C0C0C0|#C0C0C0}}
|{{Biome|▲|▲|#00FFFF|#00FFFF}}
|}
||
{|
|{{Biome|▲|▲|#FFFF00|#FFFF00}}
|}
||
{|
|{{Biome|▲|▲|#800080|#FF00FF}}
|}
|-
|'''[[Peak]]'''
||
{|
|{{Raw Tile|^|#808080|#000000}}
|{{Raw Tile|^|#FFFFFF|#000000}}
|}
||
{|
|{{Raw Tile|^|#FFFF00|#000000}}
|}
||
{|
|{{Raw Tile|^|#FF00FF|#000000}}
|{{Raw Tile|^|#800080|#000000}}
|}
|-
|'''[[Volcano]]'''
||
{|
|{{Raw Tile|^|#FF0000|#000000}}
|}
|-
|'''''Plains'''''
|-
|'''[[Grassland]]'''
||
{|
|{{Biome|.|ⁿ|#00FF00|#00FF00}}
|{{Biome|.|ⁿ|#FFFF00|#FFFF00}}
|{{Biome|.|ⁿ|#808080|#FF0000}}
|}
||
{|
|{{Biome|.|ⁿ|#00FFFF|#00FFFF}}
|}
||
{|
|{{Biome|.|ⁿ|#800080|#FF00FF}}
|}
|-
|'''[[Savanna]]'''
||
{|
|{{Biome|"|ⁿ|#00FF00|#00FF00}}
|{{Biome|"|ⁿ|#FFFF00|#FFFF00}}
|{{Biome|"|ⁿ|#808080|#FF0000}}
|}
||
{|
|{{Biome|"|ⁿ|#00FFFF|#00FFFF}}
|}
||
{|
|{{Biome|"|ⁿ|#800080|#FF00FF}}
|}
|-
|'''[[Shrubland]]'''
||
{|
|{{Biome|"|τ|#00FF00|#00FF00}}
|{{Biome|"|τ|#FFFF00|#FFFF00}}
|{{Biome|"|τ|#808080|#FF0000}}
|}
||
{|
|{{Biome|"|τ|#008080|#00FFFF}}
|}
||
{|
|{{Biome|"|τ|#800080|#FF00FF}}
|}
|-
|'''''Deserts'''''
|-
|'''[[Sand desert|Sand Desert]]'''
||
{|
|{{Biome|~|≈|#FFFF00|#FFFF00}}
|}
||
{|
|{{Biome|~|≈|#008080|#008080}}
|}
||
{|
|{{Biome|~|≈|#800000|#808080}}
|}
|-
|'''[[Rocky wasteland|Rocky Wasteland]]'''
||
{|
|{{Biome|,|´|#808000|#808080}}
|}
||
{|
|{{Biome|,|´|#00FFFF|#008080}}
|}
||
{|
|{{Biome|,|´|#800000|#808080}}
|}
|-
|'''[[Badlands]]'''
||
{|
|{{Biome|V|√|#808000|#808000}}
|{{Biome|n|∩|#808080|#808000}}
|}
||
{|
|{{Biome|V|√|#00FFFF|#008080}}
|}
||
{|
|{{Biome|V|√|#800000|#808080}}
|}
|-
|'''''Wetlands'''''
|-
|'''[[Swamp]]'''
||
{|
|{{Biome|"|⌠|#008000|#008000}}
|}
||
{|
|{{Biome|"|⌠|#0000FF|#0000FF}}
|}
||
{|
|{{Biome|"|⌠|#800080|#FF00FF}}
|}
|-
|'''[[Marsh]]'''
||
{|
|{{Biome|"|ⁿ|#00FF00|#00FF00}}
|}
||
{|
|{{Biome|"|ⁿ|#0000FF|#0000FF}}
|}
||
{|
|{{Biome|"|ⁿ|#800080|#FF00FF}}
|}
|-
|'''''Ice Biomes'''''
|-
|'''[[Tundra]]'''
||
{|
|{{Biome|∙|·|#008080|#008080}}
|}
||
{|
|{{Biome|∙|·|#00FFFF|#00FFFF}}
|}
||
{|
|{{Biome|∙|·|#800080|#800080}}
|}
|-
|'''[[Glacier]]'''
||
{|
|{{Biome|▒|░|#00FFFF|#00FFFF}}
|}
||
{|
|{{Biome|▒|▓|#00FFFF|#00FFFF}}
|}
||
{|
|{{Biome|▒|▓|#800080|#800080}}
|}
|-
|'''''Water'''''
|-
|'''[[River]]'''
||
{|
|style="border-spacing: 0; background: black; padding: 0.2em; border: 1px solid white;"|{{Raw Tile|─┐|#0000FF|#000000}}
{{Raw Tile|┌┘|#0000FF|#000000}}
|}
||
{|
|style="border-spacing: 0; background: black; padding: 0.2em; border: 1px solid white;"|{{Raw Tile|─┐|#00FFFF|#000000}}
{{Raw Tile|┌┘|#00FFFF|#000000}}
|}
||
{|
|style="border-spacing: 0; background: black; padding: 0.2em; border: 1px solid white;"|{{Raw Tile|─┐|#FF0000|#000000}}
{{Raw Tile|┌┘|#808000|#000000}}
|}
|-
|'''[[Ocean]]'''
||
{|
|{{Biome|≈|≈|#000080|#000080}}
|}
||
{|
|{{Biome|≈|≈|#00FFFF|#00FFFF}}
|}
||
{|
|{{Biome|≈|≈|#800000|#808000}}
|}
|-
|'''[[Lake]]'''
||
{|
|{{Biome|~|~|#0000FF|#0000FF}}
|}
|-
|'''Delta'''
||
{|
|{{Raw Tile|≈─|#0000FF|#000000}}
|}
|}

=== Subterranean Features===
Must be set to 'ALWAYS' in init.txt to be visible

{|
|'''[[Underground_river|Underground river]]'''
||
{|
|{{Raw Tile|≈|#0000FF|#000000}}
|}
|-
|'''[[Underground_pool|Underground pool]]'''
||
{|
|{{Raw Tile|~|#0000FF|#000000}}
|}
|-
|'''[[Magma#Magma_sources|Magma pool]]'''
||
{|
|{{Raw Tile|~|#FF0000|#000000}}
|}
|-
|'''[[Magma#Magma_sources|Magma pipe]]'''
||
{|
|{{Raw Tile|≈|#FF0000|#000000}}
|}
|-
|'''[[Chasm]]'''
||
{|
|{{Raw Tile|#|#808080|#000000}}
|}
|-
|'''[[Chasm|Bottomless Pit]]'''
||
{|
|{{Raw Tile|○|#808080|#000000}}
|}
|-
|'''Other Features'''
||
{|
|{{Raw Tile|£|#00FFFF|#000000}}
|}
|}

=== Sites ===

{|
|'''[[Elf|Elven]] retreat'''
||
{|
|{{Raw Tile|î|#FFFF00|#000000}}
|{{Raw Tile|¶|#FFFF00|#000000}}
|}
|-
|'''[[Human]] cities and towns'''
||
{|
|{{Raw Tile|+|#808080|#000000}}
|{{Raw Tile|*|#808080|#000000}}
|{{Raw Tile|#|#808080|#000000}}
|{{Raw Tile|☼|#FFFFFF|#000000}}
|}
|-
|'''[[Dwarf|Dwarven]] mountainhomes and fortresses'''
Lighter colored fortresses and towns are more populous.
||
{|
|{{Raw Tile|Ω|#808080|#000000}}
|{{Raw Tile|Ω|#C0C0C0|#000000}}
|{{Raw Tile|Ω|#FFFFFF|#000000}}
|}
|-
|'''[[Goblin]] fortresses'''
Pink ones are more heavily populated than the gray ones.
||
{|
|{{Raw Tile|Π|#808080|#000000}}
|{{Raw Tile|Π|#FF00FF|#000000}}
|}
|-
|'''[[Cave]]'''
||
{|
|{{Raw Tile|•|#808080|#000000}}
|}
|-
|'''[[Ruins]]'''
||
{|
|{{Raw Tile|μ|#808080|#000000}}
|}
|}

=== Other ===
'''[[Migrants]]'''
{|
|{{Raw Tile|-|#808080|#000000}}
|}

{{World}}

40d:Meeting

2015-05-18T11:04:37Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:04, 18 May 2015 (UTC)}}
{{av}}
[[Noble]] [[Dwarf|dwarves]] need to schedule occasional '''meetings''' with [[liaison|representatives]] from the homelands and foreign [[diplomat]]s. Meetings generally begin when the seasonal [[caravan]] arrives; merchants and traders usually have a diplomat accompanying them. Diplomats will meet with the [[expedition leader]], [[mayor]], [[baron]], [[count]], [[duke]], or [[king]], whichever is of highest rank, while guild representatives will meet with your [[broker]] to discuss [[trade]] agreements. The foreigner will follow the relevant [[dwarf]] around the [[fortress]] until the meeting is finished; if your nobles have a lot of labors turned on, the meeting might take several [[calendar|months]] to conclude.

If the dwarf has an [[office]], the meeting will take place there; a high-quality office will give the dwarf who scheduled the meeting a happy [[thought]], while a poor office will upset the dwarf. If the dwarf does not have an office, the meeting will take place in a [[meeting hall]], which is to say a [[dining room]] that has the "Meeting Hall" option turned on. Meeting in public sometimes embarrasses the dwarf, who receives an unhappy thought from having to conduct a meeting in such circumstances. Also, if your leader is taken by a [[strange mood]] during the meeting, the [[diplomat]] will leave unhappy.

Unhappy civilians sometimes schedule their own meetings with the [[Leader]] in order to yell at him or her. The leader will use a social [[Skill]], such as [[Consoler]], to calm the unhappy dwarf with results depending on the leader's skill level. This process is a bit buggy -- if the leader is interrupted during the meeting, the civilian will sometimes get stuck in the "Conduct Meeting" labor. Drafting and undrafting the civilian might help snap them out of it.

Non-[[legendary]] dwarves, if left idle for long period of time, will periodically meet with the [[manager]] to complain about job scarcity.

----

'''See also:''' [[Leader]]
{{Category|Nobles}}
{{Category|Fortress mode}}

40d:Meeting hall

2015-05-18T11:04:27Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:04, 18 May 2015 (UTC)}}
{{av}}
The '''Meeting Hall''', also known as the ''Great Hall'', is among the most vital parts of any fortress. It is a designation like a [[Activity zone#Meeting Area|Meeting Area]] where idle dwarves gather, [[Party|parties]] are held (until a [[statue garden]] is built), and [[stray]] [[domestic animal]]s congregate. It is a good idea to site this heavily-trafficked area someplace both safe and convenient to get to.

To have a [[dining room]] double as a meeting hall; type {{k|q}} -> {{k|h}} on any dining room table.

'''See also:''' [[Activity zone#Meeting Area|Meeting Area]]

{{buildings}}
{{Category|Rooms}}

40d:Megabeast

2015-05-18T11:04:14Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:04, 18 May 2015 (UTC)}}
{{av}}
Mighty creatures that attack your fortress. When one enters your area, the game will announce its presence and its name.

Megabeasts will not arrive until you have a population of 80, 100,000☼ created wealth, and 10,000☼ exported wealth. At most one megabeast attack can happen during any given season, its arrival date determined ahead of time (and restricted from being during the first or last week of the season). Force-quitting and loading a fortress from a few days before a megabeast attack may result in a different one arriving on the same day, depending on what has survived [[world generation]].

Included in this [[:Category:Megabeasts|category]] are the [[Bronze colossus]], [[Dragon]], [[Hydra]], and [[Titan]].

Occasionally, worlds may be generated in which no megabeasts survive, making the game considerably less [[fun]]. A common method of avoiding this problem is to make megabeasts significantly stronger during world generation (by increasing their SIZE or DAMBLOCK) so that more of them survive; however, this may result in them being just as strong when encountered, even if the modifications are later undone.

==See also==
:* [[Creature]]
:* [[Sphere]]s
:* [[Fanciful]]
:* [[Siege#Megabeasts|Siege]]

40d:Memory editing

2015-05-18T11:04:00Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:04, 18 May 2015 (UTC)}}
{{av}}
{| style="width: 100%; background: #ddd; border: 1px solid #777; border-left-color:#bbb; border-top-color:#bbb;"
|+ style="color: #fff; background: #999; border: 1px solid #777; border-left-color:#bbb; border-top-color:#bbb; padding: 0.2em 0.5em; text-align: center" | '''Links'''
|-
! style="text-align: left; padding: 0.1em 0.5em" | Various Memory Editing/Hacking Tools:
| [http://wpepro.net/index.php?categoryid=9&p13_sectionid=1&p13_fileid=79?&category=3 WPE Pro/PermEdit/Tsearch], [http://www.artmoney.ru/?threadid=2669677 ARTMONEY], [http://cheatengine.org/?t=38984 Cheat Engine], [http://www.dogcows.com/ The Cheat (for Macs)]
|}

== Memory Editing ==

''[[40d:Memory hacking|For Advanced and Expert Uses of Memory Editing See: Memory Hacking]]''

''Note: As of version 0.28.181.40d, the following memory editing does not work.''

Memory Editing can be used for [[:Cheating|cheating]] and otherwise modifying Dwarf Fortress as it runs.
Memory Editors find the particular memory address where a specific value is located and change it for the better. Most of these programs search for a Hex address with the terms set by the user and display and offers modification of the found data.

----

=== Basic Cheating Tutorial With Memory Editors (Using Artmoney) ===

Warning: This is a good way to crash windows or otherwise mess up your computer. Only attempt memory editing if you are relaxed and don't mind this kind of thing too much.

'''Step 1'''

Open Both Dwarf Fortress and Art Money and start a new fortress.
When asked choose to prepare for the journey.

Notice that all of your dwarfs have 10 points to use for their skills.

'''Step 2'''

In the Select Process bar in Art Money choose Dwarf Fortress.

'''Step 3'''

Press Search and enter the value 10.

'''Step 4'''

After the search has finished go into DF and change all of the dwarves skill points to another number, such as 6.
[[Image:Artmoney1.JPG]]

'''Step 5'''

Press FILTER this time and enter the new number, such as 6.
Continue with this until you have only 7 (the number of dwarves) memory address values left. You can see the number of values in the left window in art money.

'''Step 6'''

Press the blue arrow in the middle bar to move them over to the right window.

Check the boxes under the designation F (for freeze).

'''Step 7'''

Repeat all of this for your points value and max out everything as much as you wish.
[[Image:Memoryeditortutorial2.JPG]]

'''Step 8'''

Before you start the game it may be wise to uncheck (unfreeze) all of the boxes. The memory addresses may be used for something else.
[[Category:Guides]]

== Starting with Legendary Skills ==

There is a rather time-intensive way to give dwarfs legendary skills with Artmoney. Set a skill level for one dwarf (eg. "Skilled"), search for a number corresponding to that skill level (0 for dabbling - 15 for legendary; 4 for skilled in this case) and then change that skill level while filtering results until you've narrowed down your one memory value. Just set this value to 15 and you have a legendary Miner, Armor User etc.

40d:Memory hacking

2015-05-18T11:03:51Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:03, 18 May 2015 (UTC)}}
{{av}}
== Versions ==
See the following subpages for version specific information
* '''[[Memory hacking/v0.27.169.33g|v0.27.169.33g]]'''
* [[Memory hacking/v0.27.169.33f|v0.27.169.33f]]
* [[Memory hacking/v0.27.169.33e|v0.27.169.33e]]
* [[Memory hacking/v0.27.169.33d|v0.27.169.33d]]
* [[Memory hacking/v0.27.169.33c|v0.27.169.33c]]
* [[Memory hacking/v0.27.169.33b|v0.27.169.33b]]
* [[Memory hacking/v0.27.169.33a|v0.27.169.33a]]
* [[Memory hacking/v0.28.181.40d16|v0.28.181.40d16]]
* [[Memory hacking/v0.28.181.40d17|v0.28.181.40d17]]
* [[Memory hacking/v0.28.181.40d18|v0.28.181.40d18]]
* [[Memory hacking/v0.28.181.40d19|v0.28.181.40d19]]

== Data Types ==
=== String ===

{| border="1" cellpadding="2" width="100%"
| Offset || Size || Type || Description
|-
| 0x00 || 4 || Junk || Junk data that exists due to a curious artifact in the C++ standard. Technically it's the allocator - in reality, the default allocator has no data associated with it.
|-
| 0x04 || 16 || Character buffer || Holds the string data if capacity < 16
|-
| 0x04 || 4 || Character pointer || Points to the string data if capacity >= 16
|-
| 0x14 || 4 || Length || Current length of the string
|-
| 0x18 || 4 || Capacity || Current capacity of the string buffer (also indicates which mode the string is in)
|}

Yes, the second two items overlap. This is correct. This is the MSVC Express string format - Toady appears to be using standard C++ structures pretty much everywhere.

=== Vector ===

{| border="1" cellpadding="2" width="100%"
| Offset || Size || Type || Description
|-
| 0x00 || 4 || Junk || Junk data that exists due to a curious artifact in the C++ standard. Technically it's the allocator - in reality, the default allocator has no data associated with it.
|-
| 0x04 || 4 || Array start
|-
| 0x08 || 4 || Array end || (End - Start)/4 = # of elements (if pointers)
|-
| 0x0C || 4 || Array allocated end || (Allocated End - Start)/4 = capacity (if pointers)
|}

== Type ID list ==

Most likely incomplete, but this was all that could be found so far.

{| border="1" cellpadding="2" width="100%"
| ID || Meaning
|-
| <code>0x00</code> || Miner
|-
| <code>0x01</code> || Woodworker
|-
| <code>0x02</code> || Carpenter
|-
| <code>0x03</code> || Bowyer
|-
| <code>0x04</code> || Woodcutter
|-
| <code>0x05</code> || Stoneworker
|-
| <code>0x06</code> || Engraver
|-
| <code>0x07</code> || Mason
|-
| <code>0x08</code> || Ranger
|-
| <code>0x09</code> || Animal Caretaker
|-
| <code>0x0A</code> || Animal Trainer
|-
| <code>0x0B</code> || Hunter
|-
| <code>0x0C</code> || Trapper
|-
| <code>0x0D</code> || Animal Dissector
|-
| <code>0x0E</code> || Metalsmith
|-
| <code>0x0F</code> || Furnace Operator
|-
| <code>0x10</code> || Weaponsmith
|-
| <code>0x11</code> || Armorer
|-
| <code>0x12</code> || Blacksmith
|-
| <code>0x13</code> || Metalcrafter
|-
| <code>0x14</code> || Jeweler
|-
| <code>0x15</code> || Gem Cutter
|-
| <code>0x16</code> || Gem Setter
|-
| <code>0x17</code> || Craftsman
|-
| <code>0x18</code> || Woodcrafter
|-
| <code>0x19</code> || Stonecrafter
|-
| <code>0x1A</code> || Leatherworker
|-
| <code>0x1B</code> || Bone Carver
|-
| <code>0x1C</code> || Weaver
|-
| <code>0x1D</code> || Clothier
|-
| <code>0x1E</code> || Glassmaker
|-
| <code>0x1F</code> || Strand Extractor
|-
| <code>0x20</code> || Queen
|-
| <code>0x21</code> || Queen Consort
|-
| <code>0x22</code> || Fishery Worker
|-
| <code>0x23</code> || Fisherman
|-
| <code>0x24</code> || Fish Dissector
|-
| <code>0x25</code> || Fish Cleaner
|-
| <code>0x26</code> || Farmer
|-
| <code>0x27</code> || Cheese Maker
|-
| <code>0x28</code> || Milker
|-
| <code>0x29</code> || Cook
|-
| <code>0x2A</code> || Thresher
|-
| <code>0x2B</code> || Miller
|-
| <code>0x2C</code> || Butcher
|-
| <code>0x2D</code> || Tanner
|-
| <code>0x2E</code> || Dyer
|-
| <code>0x2F</code> || Planter
|-
| <code>0x30</code> || Herbalist
|-
| <code>0x31</code> || Brewer
|-
| <code>0x32</code> || Soap Maker
|-
| <code>0x33</code> || Potash Maker
|-
| <code>0x34</code> || Lye Maker
|-
| <code>0x35</code> || Wood Burner
|-
| <code>0x36</code> || Engineer
|-
| <code>0x37</code> || Mechanic
|-
| <code>0x38</code> || Siege Engineer
|-
| <code>0x39</code> || Siege Operator
|-
| <code>0x3A</code> || Pump Operator
|-
| <code>0x3B</code> || Clerk
|-
| <code>0x3C</code> || Administrator
|-
| <code>0x3D</code> || Trader
|-
| <code>0x3E</code> || Architect
|-
| <code>0x3F</code> || Alchemist
|-
| <code>0x40</code> || Tax Collector
|-
| <code>0x41</code> || Hammerer
|-
| <code>0x42</code> || Baroness
|-
| <code>0x43</code> || Countess
|-
| <code>0x44</code> || Duchess
|-
| <code>0x45</code> || Baroness Consort
|-
| <code>0x46</code> || Countess Consort
|-
| <code>0x47</code> || Duchness Consort
|-
| <code>0x48</code> || Philosopher
|-
| <code>0x49</code> || Advisor
|-
| <code>0x4A</code> || Dungeon Master
|-
| <code>0x4B</code> || Merchant
|-
| <code>0x4C</code> || Diplomat
|-
| <code>0x4D</code> || Guild Representative
|-
| <code>0x4E</code> || Merchant Baroness
|-
| <code>0x4F</code> || Merchant Princess
|-
| <code>0x50</code> || Outpost Liaison
|-
| <code>0x51</code> || Druid
|-
| <code>0x52</code> || Champion
|-
| <code>0x53</code> || Hammerman
|-
| <code>0x54</code> || Hammer Lord
|-
| <code>0x55</code> || Spearman
|-
| <code>0x56</code> || Spearmaster
|-
| <code>0x57</code> || Crossbowman
|-
| <code>0x58</code> || Elite Crossbowman
|-
| <code>0x59</code> || Wrestler
|-
| <code>0x5A</code> || Elite Wrestler
|-
| <code>0x5B</code> || Axeman
|-
| <code>0x5C</code> || Axe Lord
|-
| <code>0x5D</code> || Swordsman
|-
| <code>0x5E</code> || Swordmaster
|-
| <code>0x5F</code> || Maceman
|-
| <code>0x60</code> || Mace Lord
|-
| <code>0x61</code> || Pikeman
|-
| <code>0x62</code> || Pikemaster
|-
| <code>0x63</code> || Bowman
|-
| <code>0x64</code> || Elite Bowman
|-
| <code>0x65</code> || Blowgunner
|-
| <code>0x66</code> || Elite Blowgunner
|-
| <code>0x67</code> || Recruit
|-
| <code>0x68</code> || Hunting creature
|-
| <code>0x69</code> || War creature
|-
| <code>0x6A</code> || Master Thief
|-
| <code>0x6B</code> || Thief
|-
| <code>0x6C</code> || Peasant or creature
|-
| <code>0x6D</code> || Child
|-
| <code>0x6E</code> || Baby
|-
| <code>0x6F</code> || Drunk
|-
| <code>0x70</code> || Lasher
|-
| <code>0x71</code> || Master Lasher
|}

== Profession list ==
PROFESSION_MINE,
PROFESSION_HAUL_STONE,
PROFESSION_HAUL_WOOD,
PROFESSION_HAUL_BODY,
PROFESSION_HAUL_FOOD,
PROFESSION_HAUL_REFUSE,
PROFESSION_HAUL_ITEM,
PROFESSION_HAUL_FURNITURE,
PROFESSION_HAUL_ANIMALS,
PROFESSION_CLEAN,
PROFESSION_CUTWOOD,
PROFESSION_CARPENTER,
PROFESSION_DETAIL,
PROFESSION_MASON,
PROFESSION_ARCHITECT,
PROFESSION_ANIMALTRAIN,
PROFESSION_ANIMALCARE,
PROFESSION_HEALTHCARE,
PROFESSION_BUTCHER,
PROFESSION_TRAPPER,
PROFESSION_DISSECT_VERMIN,
PROFESSION_LEATHER,
PROFESSION_TANNER,
PROFESSION_BREWER,
PROFESSION_ALCHEMIST,
PROFESSION_SOAP_MAKER,
PROFESSION_WEAVER,
PROFESSION_CLOTHESMAKER,
PROFESSION_MILLER,
PROFESSION_PROCESS_PLANT,
PROFESSION_MAKE_CHEESE,
PROFESSION_MILK,
PROFESSION_COOK,
PROFESSION_PLANT,
PROFESSION_HERBALIST,
PROFESSION_FISH,
PROFESSION_CLEAN_FISH,
PROFESSION_DISSECT_FISH,
PROFESSION_HUNT,
PROFESSION_SMELT,
PROFESSION_FORGE_WEAPON,
PROFESSION_FORGE_ARMOR,
PROFESSION_FORGE_FURNITURE,
PROFESSION_METAL_CRAFT,
PROFESSION_CUT_GEM,
PROFESSION_ENCRUST_GEM,
PROFESSION_WOOD_CRAFT,
PROFESSION_STONE_CRAFT,
PROFESSION_BONE_CARVE,
PROFESSION_GLASSMAKER,
PROFESSION_EXTRACT_STRAND,
PROFESSION_AXE,
PROFESSION_SWORD,
PROFESSION_MACE,
PROFESSION_HAMMER,
PROFESSION_SPEAR,
PROFESSION_DAGGER,
PROFESSION_CROSSBOW,
PROFESSION_BOW,
PROFESSION_BLOWGUN,
PROFESSION_PIKE,
PROFESSION_WHIP,
PROFESSION_SHIELDLEVEL,
PROFESSION_ARMORLEVEL,
PROFESSION_SIEGECRAFT,
PROFESSION_SIEGEOPERATE,
PROFESSION_BOWYER,
PROFESSION_MECHANIC,
PROFESSION_WEAPONNUMBER,
PROFESSION_POTASH_MAKING,
PROFESSION_LYE_MAKING,
PROFESSION_DYER,
PROFESSION_BURN_WOOD,
PROFESSION_OPERATE_PUMP,
PROFESSION_UNUSED_3,
PROFESSION_UNUSED_4,
PROFESSION_UNUSED_5,
PROFESSION_UNUSED_6,
PROFESSION_UNUSED_7,
PROFESSION_UNUSED_8,
PROFESSION_UNUSED_9,
PROFESSION_UNUSED_10,
PROFESSION_UNUSED_11,
PROFESSION_UNUSED_12,
PROFESSION_UNUSED_13,
PROFESSION_UNUSED_14,
PROFESSION_UNUSED_15,
PROFESSION_UNUSED_16,
PROFESSION_UNUSED_17,
PROFESSION_UNUSED_18,
PROFESSION_UNUSED_19,
PROFESSION_UNUSED_20,
PROFESSION_UNUSED_21,
PROFESSION_UNUSED_22,
PROFESSION_UNUSED_23,
PROFESSION_UNUSED_24,
PROFESSION_UNUSED_25,
PROFESSION_UNUSED_26,
PROFESSION_UNUSED_27,
PROFESSION_UNUSED_28,
PROFESSION_UNUSED_29,
PROFESSION_UNUSED_30,
PROFESSIONNUM,
[[Category:Guides]] [[Category:Hacking]]

40d:Metal profit

2015-05-18T11:03:36Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:03, 18 May 2015 (UTC)}}
{{av}}
This article is intended to show the value, costs, steps required, and ultimately the profit of smelting and making something with each bar. It will be especially useful for things like determining if it would be more profitable to smelt an alloy for crafts or use it's component metals for crafts instead. '''This article is a stub.'''

{| class="wikitable" border="1"
|-
! Metal
! Steps to make
! Material Value * Item Value - Coal/flux cost
!Item Value to Break Even
|-
|[[Copper]]||1||2i - 20||10
|-
|[[Bronze]]||1||5i - 20||4
|-
|[[Iron]]||1||10i - 20||2
|-
|[[Pig iron]]||2||10i - 32||3.2
|-
|[[Steel]]||3||30i - 34||1.1333
|}

The value of a bar of [[coal]] is 10. For the examples I've given it's assumed that you'll use 1 bar of coal to smelt the metal, and another to make something of it. I'm bad with tables and wikis in general, so excuse the weird table.

{{Expand Topic}}

40d:Military design

2015-05-18T11:03:24Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:03, 18 May 2015 (UTC)}}
{{av}}
This page is one of several inter-related articles on the broader topic of defending your fortress and your dwarves. This page will focus on the training, organization and deployment of your military, the soldiers that will use your defenses for the greater glory blah blah blah, yadda yadda yadda.

See the [[Defense guide|Defense Guide]] for a general overview of threats and considerations for fortress defense.

For specific suggestions on the physical defenses that will defend your military, see [[Defense design|Defense Design]].

Many defenses rely on complex traps as a central part, that are, essentially, the defense themselves. For complex traps that are '''not''' a minor/optional part of a larger defensive plan, (but might be adapted or plugged into one) see [[Trap design|Trap Design]].

=Military=
The role of a military force in fortress defense can be central or non-existent, depending on the player's overall approach and strategy. Their one advantage is mobility - they can go where no static defenses exist, to rescue or support other dwarves, or escort a caravan through unknown or deadly threats. Only military can take the fight to the enemy (doomsday devices excepted.)

==Training==
Training [[soldier]]s up is actually fairly quick - less than a season for [[wrestling]], and again for a weapon skill. [[Shield user]] and [[armor user]] take longer, so getting on it asap, at least with some of your first [[migrant]]s (if not with your starting seven) is recommended if you want to go the military route.

One of the important parts of a military is to have dwarves with high [[attributes]], and that requires training them up. See [[cross-training]] for suggestions on various attribute training plans.

===Daylight training room===
Put a [[weapon rack]] on the surface near your entrance and make it a training room. Training dwarves will be in position if there's trouble. This also helps prevent [[cave adaptation]] in your military. You can use an [[archery target]] this way, too.

==Organization==
Archers are deadly, but vulnerable to melee - crossbows as clubs just aren't the best, but you can't have [[Defense_design#Simple_5x5_Archer's_Tower|archer towers]] every 15 tiles across the map - sometimes you want to take it to the enemy. Beyond that, mixing or matching is largely up to you.

===Small squads/individual soldiers===
Manipulating large numbers of soldiers is easiest when grouped in a few squads, no doubt. But if the leader of that squad decides to go for a drink, on break, to eat or sleep, the entire squad follows. What's more, if placed behind a wall, some members of a large squad might decide their best location is on the ''other side'' of that wall. Keeping squads small, in 2's or 3's, or even as individual soldiers, requires more management but returns much higher tactical results.

If trained to (near-)Legendary in [[shield user]], [[wrestling]] and a weapon of choice, and armored up with adamantine, one lone [[Champion#Heroes_and_Champions|champion]] can take out several squads of goblins without a scratch. But combat always has a random element - DF happens.

==Strategy & Tactics==
===Roughing it===
Always have your soldiers carry food. They will each need a [[backpack]] to carry it. This keeps your soldiers from wandering off to eat. You can also have them carry [[water]] in [[waterskin]]s or [[flask]]s, but this isn't recommended for the long term, as it keeps your soldiers from drinking [[alcohol]]. For an around the clock guard, have them sleep on the ground while on duty. Hopefully the sounds of combat will wake them up before they get killed. Sleeping on the floor causes unhappy [[thought]]s.

===Wait for my signal...===
When ganging up on dangerous creatures (such as megabeasts), turning off "Chase wild animals" is preferable until all units are in position. Getting all your units into position, pausing the game, and then turning them loose at once, can achieve the desired advantage of numbers against formidable opponents.

Likewise, often champions will rush out on their own to do battle with an overwhelming force of siegers. Keep the entire squad far back from the exit until they are all armed and armored, and ready to roll as a unit. (Having a good lockable front gate will also avoid this.)

==Militia & Armed civilians==
Besides professional, full time military, it's quite useful to incorporate part-time soldiers or armed civilians into the mix.

* See also '''[[Cross-training]]''' for suggestions on training attributes & civilian/military mixes.

====Training: self-sorting migrants====
When you get a new wave of 10 or 30 migrants, especially early on, what jobs do you give them? If they have obvious [[Preference|likes or dislikes]], you can go with those - if they like "steel", they'll be a [[weaponsmith]] or [[armorsmith]], if they like aluminum or platinum, maybe a [[metal crafter]], and so on. But for those who have no such special talents, you may want a bunch to become military, both weaponsdwarves and marksdwarves, and some to become haulers - who's who?

The answer is - let ''them'' decide, by what [[attribute]]s they gain. Haulers need some Strength if they're hauling stone (and [[furnace operator]]s are not hurt by it either). Toughness is not immediately useful to anyone out of combat, but is critical to survive military training and surviving and healing from combat injuries. Agility helps anyone, giving more actions/time spent, which includes a faster movement across distances. So put any migrants who are not obviously ear-marked into a quick training program - have them [[mining|mine]] soil for a season, or work on [[pump]]s, or assign them as your [[bookkeeper]] or [[stone detailing|smoothing stone]], whatever works for you. After a few attribute gains (you'll see 5 before they hit Legendary, 6 not long after - up to you when they're "ready"*), see where they are - send your Toughest into sparring for weaponry, your most Agile into hauling, your Strong/Agile into crossbow training, and so on. (Note - metal crossbows plus bolts weigh much more than a hand-weapon, as much as half the armor itself!) Agile makes anyone "faster", both walking and many tasks, so that is up to you to place where you want it most.

:''(* A Very Strong dwarf can carry most any single stone, though it takes a Mighty dwarf to carry platinum or gold ore without slowing down. A full suit of plate layered over chain armor weighs a staggering amount, but [[Armor user]] can negate part or even (at Legendary) all of that. A metal crossbow, metal bolts and backup quiver can be lugged by any unarmored dwarf, but don't allow much margin for additional armor. See [[Speed#Encumbrance|Speed/Encumbrance]] & [[Equipment and encumbrance]].)''

Remember that the three attributes are chosen at random, and a dwarf will gain more with military or any additional training ("Hauling" doesn't give any experience). Also, [[soldier]]s that have any full rank in a civilian skill don't get bad thoughts when de-Activated, are more useful when there is no threat. Similarly, civilians who have a full rank in a combat skill get no bad thoughts when suddenly Activated when the need arises. This can be used to create civilian "reservists" who can be called upon when needed, military with a civilian application, or in a quick-and-dirty program, civilians who can better defend themselves when necessary - wood cutters with some [[Axedwarf]], or miners with extra [[Wrestling]] for when their picks get stuck in a [[goblin]] - even a few ranks can make a big difference in an [[ambush]]. There is a reason Sparta had so many citizen-soldiers.

====Gobbo season open!====
It can be a fairly decent idea to keep mass numbers of cheaply-made crossbows (or your lower-quality rejects) and bone/wood bolts on hand, and all expendable dwarves in one mass military squad set to use crossbows (and leather armor, if you have enough). What [[skill|dabbling]] marksdwarves lack in speed and accuracy, they more than make up for with incredible enthusiasm, as a hailstorm of pathetically-aimed bolts will tear over anything stupid enough to move. Not nearly as effective or useful as properly-emplaced marksdwarves with high skill and proper equipment, but a good emergency measure, especially if you keep your [[craftsdwarf|craftsdwarves]] busy churning out cheap ammo from spare bones from the [[kitchen]]s and cheap crossbows from fishbones from the [[dining hall]].

====Non-hunting hunters====
Sometime you will embark in an area devoid of (huntable) wildlife. In that case, you can turn on the [[Hunting]] skill for all civilians and use the {{key|m}}ilitary menu to arm (and more importantly, armor and shield) them. Normally turning on hunting will cause dwarves to wander outside looking for wildlife, and turning it on on all your dwarves would delay your economy greatly - but without wildlife, no hunting jobs are generated, and they go about their business armed and armored. Note that if X number of hunt-able animals do appear on the map, that many dwarves will then go hunt them. Do note that hunters will sleep on the ground when they are tired instead of walking to a bed, which will result in unhappy thoughts.

====Woodcutters ftw====
Any dwarf with the Woodcutting labor designated will carry an axe, even when they are not cutting wood. If one (or more) of your starting seven have one rank or more of [[axedwarf]], no unhappy [[thought]]s will be generated if they are drafted into active service. This dwarf might serve to fill several or all above-ground activities, such as Plant Gathering, Architecture and Masonry for bridges and defensive walls, above ground farming, and any hauling, as well as wood cutting. Later, a squad of dedicated woodcutters, possibly with some training in axedwarf, masonry and other skills, can respond en masse to orders to cut trees, providing mutual support and finishing off a large section of trees and getting back to safety that much faster. Actually training them in axedwarf is optional, but certainly helps.

Note that so long as you have no tree {{k|d}}esignated for cutting (or have no [[path]] to those trees), the woodcutters will not respond. However, if you do, as many woodcutters as trees will respond to those locations - it's recommended that if/when you do, you centralize the designations to allow them to more fully support each other.

===Miners ftw===
The above tactic can also be used with Miners. When you activate a miner with a [[pick]] into the military with "unarmed" weapon designated, they fight with the pick they are holding and their skill is their [[mining]] - and it's not hard for a miner to gain legendary miner skill quite quickly. Parallel problems arise when designating areas to be mined, but careful use of locked doors or hatches on mineshafts can prevent too many from responding to an area to be excavated.

A dwarf will hold ''either'' an axe or a pick, depending on which labor is activated - it's not possible to activate both at once, the game does not allow it.

==Siege operators==
There are 4 important things to remember about siege operators:

# They are civilians. This means that when manning (dwarving?) their stations, they will flee if enemy units approach too close. Doesn't matter if there is no actual path, it's the mere distance that triggers it. On the plus side, they don't get unhappy thoughts from being "Activated" for the military - it's just another civilian job.
# Training siege operation is slooooow. Start early.
# Siege engines do not fire quickly, so you want high skill to make the few shots you get ''count''.
# Once trained (some years later), they can be trained up in other civilian skills that are useful whenever they're not at their stations. (See [[cross-training]] for suggestions.)

==A guide for siege engine operations==

Please bear in mind that this is VERY long term stuff (10 years). Only by having highly trained siege operators and high quality siege weapons can you shoot accurately.

* Download LabourDF from here:
::http://dwarf.lendemaindeveille.com/index.php/Utilities#LabourDF

* Start off with two [[miner]]s and a [[woodcutter]] trained to proficient siege engineer status

* After your fortress has about 50 dwarves, build a siege workshop, place it at the front of your fort near the battlements and designate a custom [[stockpile]] within the battlements that can take only ballista arrows. Designate another custom stockpile that can take only regular stone.

* Make sure only one of your dwarves is set to have siege engineering as an active labor. Change that dwarf's orders to have nothing but siege engineering enabled. It may help to give that dwarf a custom profession title (such as SIEGE) to distinguish that dwarf from others. When new [[Mechanic]] or [[Siege engineer]] dwarves arrive, make sure to disable siege engineering for them.

* You'll need [[wood]], lots of wood.

* Get the siege engineer dwarf to build 18 catapult parts, place them inside behind fortifications (which catapults CAN shoot through), designate a custom stockpile of regular stone within the battlements.

* Train six dwarves to legendary status with mining or another fast-training skill: their high attributes are absolutely necessary for siege operating. All operators should have no job orders other than their stat-training and siege operating. When there is no mining to be done, set six catapults to "fire at will"

* After the catapult parts are done, get the siege engineer dwarf to build about 100 wooden ballista arrows. Don't bother with metal arrowheads as they'll use 3 pieces of metal each, and that certainly adds up.

* Now that his or her skill is at a high level, your siege engineer dwarf should be able to build superior quality (*) siege engine parts with about a 75% success rate. Build about 40 catapult parts and 40 ballista parts.

* Build ten catapults and ten ballistas with a MINIMUM of superior quality (*) components in an alternating sequence along your well stocked battlements. Dump any inferior components.

* By this point your miners/operators should be at a high level of skill, possibly legendary. This gives your superior quality weapons a devastatingly high rate of fire and awesome accuracy.

==An alternate training program==

This works well if you have a secure above-ground enclosure, a statue garden or farm plots with a surrounding wall, or a privatized plateau, as it can avoid cave adaptation while training (and the engines could be placed where they also have a useful field of fire). At a minimum, a wall with an interior area of 6x6 is barely adequate for two practice engines, stairs up and recovery trench, but a training facility could be built entirely underground.

Embark with a Proficient Siege Engineer. (Training takes far too long, and it's not a moodable skill.)

After the first caravan departs and your fortress begins to settle in, build your Siege Workshop near access to the topside if possible - parts are heavy, and [[clutter]] a workshop quicker than other finished goods. Manufacture a half-dozen or a dozen (or more) of one type of siege weapon part, enough for 2-3 decent engines - higher overall quality is better, if you have the logs and time to spare. Choice between ballista/catapult is up to you, but don't worry about building up ammo supplies - you will have some stone lying around, and one ballistae arrow per engine is enough for training. No rush, don't have to be done until your operators are actually ready to practice.

If possible, build theses close to the dining hall and barracks/bedrooms - not too close (see [[noise]]), but close enough to reduce travel time. Dig a channel (double-wide if for ballistae ammo) on one side that can catch ammo, and add a wall (or drawbridge) behind that, plus a ramp or stairs down behind the engines to access the fallen ammo in the trench. (If ballistae, take precautions against accidental friendly fire accidents.) If the location allows the engine to be turned and used when needed, so much the better, but this is mainly for training for now.

<pre>Side view

ss> | ss> = siege engine (fires to right) | = wall or drawbridge backstop
X...__ X = stairs/ramp ... = access tunnel to trench
__ = bottom of channel for ammo catching </pre>

Once your first wave of immigrants shows up (first Winter or second Spring or so), pick a bunch to become "military" - don't decide who will become what, not quite yet.

Put them to training on [[pump]]s, mining through soil and/or [[Bookkeeper|bookkeeping]] to improve [[attributes]]. "Tough" recruits chase more attributes and go into military training, where sparring will be dangerous and injuries expected - "Very Strong" recruits, with no other attributes, become siege operators, for lugging heavy ammo (and to avoid hurting each other during sparring). ''(Agility is universally beneficial, dealer's choice.)''

Set your chosen few to firing the siege weapons into the wall asap, as soon as they have some useful attribute increases - you aren't looking for uber-dwarves, just something above peasant level. If you want, use [[cross-training]] to allow them to become useful masons when the need arises, though this delays their siege training. (This can be done sooner if you have a lot of urgent building projects, or later once they have achieved acceptable levels of siege operator.)

If you want to manufacture more ammo, you can set a stockpile adjacent to the engines and designate some haulers, and that will speed training some, but the walk down to retrieve ammo is not a long one.

Add more trainees and training engines as your work-pool grows. Final numbers depend on your needs, defensive plan and environment.

Once they've trained to Legendary (some few years?), they can be fully cross-trained to be productive while not firing the engine. Give them beds near their final stations, and don't forget to train replacements before accidents happen.

==Animals==

[[Dog|War dogs]] can also be assigned to dwarves who go outside frequently, whether military or civilian. Then when the dwarf encounters danger, the war dog runs at the danger while the dwarf runs away from it. Unfortunately, war dogs are slower than dwarves with high [[attribute|Agility]], and do not shadow the dwarf perfectly. Also, dogs can't be reassigned once they are assigned, To get around this, have the dwarf you want to be guarded train the dog. (Dogs follow the one who trained them until they are assigned.)

Also, once a dwarf reaches Hero status, they cannot be assigned dogs (due to that menu being unavailable), so assign any before this happens or not at all.

----

'''See Also:'''
:*[[Defense design]]
:*[[cross-training#Army corps of engineers]]



{{Category|Guides}}
{{Category|Fortress defense| }}
{{Category|Design}}

40d:Mineshaft stitching

2015-05-18T11:03:03Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:03, 18 May 2015 (UTC)}}
{{av}}
When using [[Exploratory mining#Mine shafts|mine shafts]], dwarves will prefer to dig all of one level before moving on to the next. This can result in a lot of time spent moving, as miners go up and down mine shafts. If you have a large number of relatively unskilled miners, this is unlikely to be a problem: digging time will dominate in any case. If you have one or two legendary miners, this is quite annoying. As a solution, you can creating a single path that forces your dwarf to finish one shaft before moving on to the next. To do so, connect shafts alternately at the top and bottom layers, so the shaft snakes through the area. For example, the top, middle, and bottom layers could look like:

<pre style="font:bold 20px/1 'Courier New';color:#ccc;background:black;width:auto;padding:5px;float:left">
▒▒▒▒▒▒▒▒▒
.X▒▒X..X▒
▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒▒
▒X..X▒▒X▒
▒▒▒▒▒▒▒▒▒

</pre>
{{-}}
<pre style="font:bold 20px/1 'Courier New';color:#ccc;background:black;width:auto;padding:5px;float:left">
▒▒▒▒▒▒▒▒▒
▒X▒▒X▒▒X▒
▒▒▒▒▒▒▒▒▒
▒▒▒▒▒▒▒▒▒
▒X▒▒X▒▒X▒
▒▒▒▒▒▒▒▒▒
</pre>
{{-}}
<pre style="font:bold 20px/1 'Courier New';color:#ccc;background:black;width:auto;padding:5px;float:left">
▒▒▒▒▒▒▒▒▒
▒X▒▒X▒▒X▒
▒.▒▒.▒▒.▒
▒.▒▒.▒▒.▒
▒X▒▒X▒▒X▒
▒▒▒▒▒▒▒▒▒
</pre>
{{-}}

Clearly you can repeat the middle layer as often as you want: I recommend at least 5-10 levels to really make this worthwhile. 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.

=== AHK script ===
An AHK script to construct such a pattern is provided below, based on [[User:StrawberryBunny/Mineshaft.ahk|this script]], but using many fewer keystrokes.

There is an alternate version [[User:Jondan/stitch.ahk|here]].

<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
; ;
; NOTE: ;
; Author: Seth Fogarty ;
; 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 +,
}
}
return

</pre>

[[Category:Ahk scripts]]
[[Category:FAQ - Mining]]
[[Category:Guides]]

40d:Pool

2015-05-18T11:02:48Z

PeridexisErrant:

{{quality|Fine}}{{av}}
'''Pool''' may refer to:

*[[Murky pool]], a small area on the surface of maps that tends to collect rainwater.
*[[Underground pool]], a medium-sized reservoir of water that is usually hidden beneath the surface and is home to a handful of hostile creatures.
*A [[Magma#Magma_sources|magma pool]], one of the two common sources of magma 

{{disambig}}
{{Category|World}}

40d:Pike

2015-05-18T11:02:36Z

PeridexisErrant:

{{quality|Fine}}{{av}}
'''Pike''' can refer to:

* [[Pike (fish)]]
* [[Other weapon#Pike|Pike (weapon)]]

{{disambig}}

40d:Pet

2015-05-18T11:02:03Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:02, 18 May 2015 (UTC)}}
{{av}}
'''Pets''' are [[tame]] [[animal]]s that have been adopted by a [[dwarf]].

On the animals screen ({{K|z}}-Animals), you can mark most animals as Available/Unavailable by selecting them and pressing {{K|Enter}}.
Available large animals may be adopted by any [[dwarf]], but tame [[vermin]] will only be adopted by dwarves who explicitly like that animal.

Once an animal has been adopted as a pet, it will be given a name, and can no longer be slaughtered. It will also mostly stop hanging out in meeting area [[zone]]s and [[room]]s, preferring instead to follow their owner. If a '''pet''' dies, its corpse can not be processed; it cannot be butchered, its meat and skin can not be salvaged. Even when the corpse rots away, its bones and skull can not be used to make objects.

[[Cat]]s are shown as "Uninterested", because cats choose their owners. They will not choose an owner if kept in a [[cage]], although they might choose one in the midst of being transferred to the cage. Another way to keep the fort from being littered with pet cats is to turn them into [[kitchen|+Kitten Tallow Biscuits+]].

[[Dog]]s can be trained at the [[kennel]] as either war dogs or hunting dogs. Trained dogs can be assigned to a specific dwarf via that dwarf's [[preference]] menu ({{k|v}}-{{k|p}}-{{k|e}}, "Assign trained animal"). Trained dogs will follow their trainer around until they are assigned to someone else (or are caged or chained).

[[Immigrant]]s often arrive with one or more pet animals (limited to dogs, cats, [[cow]]s, [[horse]]s, [[mule]]s, or [[donkey]]s). The offspring of pets are always tame but not themselves pets. However, they will follow their mother's owner around until they are trained, become someone else's pet, or are caged or chained.

Pets, like other animals, will die of old age eventually, although this usually takes over a decade.

===Advantages/disadvantages===
* Unhappy dwarves can be "comforted by a pet" and become happier.
* The pet will follow their owner everywhere, and cannot be assigned to a [[cage]] or [[restraint]].
* Death of a pet makes its owner unhappy, though less so than death of a friend or family member.
* Dead pets should be buried in a [[coffin]], or the owner will be even more upset.
* Pets can't be eaten unless the owner dies; the animal keeps its name but is no longer a pet.

===Effects on performance===
Depending on the computer, having a lot of pets can make an impact on [[FPS]]. This is one of the greatest dangers posed by a catsplosion, but tests have shown that killing a relatively small number of pets can significantly affect performance.

===Oddities===
* Chained or restrained animals marked as Available will be released when they are adopted, though [[cat]]s which adopt an owner while being chained/caged will not be released, resulting in a negative [[thought]].
* If an animal is marked as Available and it dies before it is adopted, it will be buried in a coffin as if it were a pet.
* Cats which adopt owners will not be buried in coffins, instead being hauled to refuse stockpiles and left to rot, resulting in a negative thought. Cats which arrive with [[migrant]]s are buried properly when they die.
* Pet vermin can still be assigned to cages, resulting in the amusing scene of one dwarf trying to put his pet on his shoulder and the other constantly removing it and putting it back into the cage.

==Value==
These are the prices you pay when you trade for caged tame animals and the amounts dwarfs have to spend to claim [[Pet|pets]] after the dwarven economy has started. An animal's [[Item value|value]] as a pet is independent of its [[Animal material multiplier|material multiplier]].

{| class="wikitable" border=1
|-
! Pet value
! Pet name
|-
|10000||[[Dragon]], [[Hydra]]
|-
|2500||[[Giant cave spider]], [[Giant desert scorpion]]
|-
|1000||[[Basking shark]], [[Whale]], [[Whale shark]]
|-
|750||[[Cave crocodile]], [[Giant bat]], [[Giant olm]], [[Giant toad]], [[Polar bear]]
|-
|700||[[Giant cave swallow]], [[Giant eagle]], [[Saltwater crocodile]]
|-
|650||[[Alligator]]
|-
|500||[[Bilou]], [[Black-crested gibbon]], [[Black-handed gibbon]], [[Bonobo]], [[Bull shark]], [[Chimpanzee]], [[Elephant]], [[Frill shark]], [[Giant rat]], [[Gorilla]], [[Gray gibbon]], [[Great white shark]], [[Grizzly bear]], [[Hammerhead shark]], [[Longfin mako shark]], [[Manta ray]], [[Marlin]], [[Ocean sunfish]], [[One-humped camel]], [[Orangutan]], [[Pileated gibbon]], [[Shortfin mako shark]], [[Siamang]], [[Silvery gibbon]], [[Swordfish]], [[Tiger shark]], [[Two-humped camel]], [[White-browed gibbon]], [[White-handed gibbon]]
|-
|400||[[Blue shark]], [[Conger eel]], [[Hippo]], [[Walrus]]
|-
|350||[[Naked mole dog]], [[Giant mole]]
|-
|300||[[Black bear]], [[Cow]], [[Muskox]], [[Nurse shark]], [[Sturgeon]]
|-
|250||[[Large rat]]
|-
|200||[[Angelshark]], [[Blacktip reef shark]], [[Bluefin tuna]], [[Bluefish]], [[Cheetah]], [[Cod]], [[Coelacanth]], [[Common skate]], [[Donkey]], [[Giant cheetah]], [[Giant grouper]], [[Giant lion]], [[Giant tiger]], [[Great barracuda]], [[Halibut]], [[Horse]], [[Lion]], [[Longnose gar]], [[Mule]], [[Opah]], [[Pike (fish)|Pike]], [[Sea lamprey]], [[Spiny dogfish]], [[Spotted wobbegong]], [[Stingray]], [[Tiger]], [[Tigerfish]], [[Whitetip reef shark]]
|-
|100||[[Cougar]], [[Elk]], [[Fox squirrel]], [[Giant jaguar]], [[Giant leopard]], [[Jaguar]], [[Knuckle worm]], [[Leopard]], [[Warthog]]
|-
|50||[[Carp]], [[Deer]], [[Gazelle]], [[Groundhog]], [[Hoary marmot]], [[Mandrill]], [[Milkfish]], [[Mountain goat]], [[Rhesus macaque]], [[Wolf]]
|-
|30||[[Bat]], [[Blue jay]], [[Cardinal]], [[Cat]], [[Cave swallow]], [[Dog]], [[Grackle]], [[Oriole]], [[Red-winged blackbird]]
|-
|25||[[Fox]], [[Raccoon]]
|-
|20||[[Demon rat]], [[Fluffy wambler]], [[Moghopper]], [[Two-legged rhino lizard]]
|-
|10||[[Chipmunk]], [[Gray squirrel]], [[Hedgehog]], [[Lizard]], [[Rat]], [[Red squirrel]], [[Toad]], [[Turtle]]
|-
|5||[[Large roach]]
|-
|1||[[Cave spider]], [[Fire snake]], [[Gremlin]], [[Olm]], [[Phantom spider]], [[Purring maggot]]
|}

==See Also==
* [[Item value]]
* [[Animal material multiplier]]

{{Category|Creatures}}

40d:Pregenerated worlds

2015-05-18T11:01:21Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:01, 18 May 2015 (UTC)}}
{{av}}
'''Pregenerated worlds''' are worlds that have been created and uploaded for use by others, so they may skip world generation, and are independent of version{{v|0.27.169.33g}}. '''Seeds''' are numbers that tell the world generator which world to create. These are usually given for particularly good [[location]]s, or for quick generating time. Below is a list of worlds and seeds that users have made, along with any interesting locations, and parameters for [[world generation]]. Feel free to share and add to the list.

== World generation changes ==

Versions 0.27.169.33f and 0.27.169.33g changed the way world generation works slightly, so seeds from earlier versions will generate different worlds; these are archived at [[Main:Seed archive|Seed archive]]. Random and custom names do not affect world generation. However, modifications to your raw files before world generation could cause a different world to be generated.

Version 0.27.173.38a (with the army arc work) has changed world generation again, so that seeds from earlier versions do not create the same worlds.

Version 0.27.176.38a has changed world generation (cave changes) once again.

Version 0.27.176.38b seems to have changed, possibly due to the new [[Advanced world generation|parameter options]].

== Downloadable worlds ==

Downloadable worlds are worlds which have been generated and then compressed into a single archive file for sharing over the internet. Download the file then extract the folder inside the archive into your /data/save folder in order to use it.

=== Zaludoram, The Future World ===

'''[http://dffd.wimbli.com/file.php?id=49 Download it here]''' 
Seed: 4252958254 {{v|0.27.176.38c}} (2 rejects) 
World size: 65x65 (Small) 
Made in Dwarf Fortress v0.27.176.38c, created with a Core 2 Duo processor in Windows XP. Found using the wonderful [[Utilities#Regional_Prospector|Regional Prospector]].

[[Image:Zaludoram-location.png|thumb|500px]]

This is a loaded 4x7 fortress location with plenty of every major resource. Location has fairly mild cliffs, and the surroundings are Warm and Untamed Wilds. 
While sufficient trees are available (a few hundred), you can expand north to make it a 5x7 area with more trees than you should ever need. There is unfortunately no extra obsidian beyond that surrounding the magma.

* '''Adamantine''': just southeast of the middle.
* '''Magma''': underground magma pool, located on layers 150-147 in the southwest corner.
* '''River''': a small curve of it in the lower right corner.
* '''Trees''': A few hundred of them.
* '''Sand''': Plenty of white sand.
* '''Iron''': Plenty of magnetite patches along with some hematite and limonite veins.
* '''Flux''': Plenty of chalk.
* '''Fuel''': Many veins of bituminous coal and lignite.
* '''Bauxite''': Many (20+) patches all over the place.

* '''Neighboring Civs''': All.

=== Ewèlina, The Enchanted Land ===

'''[http://dffd.wimbli.com/file.php?id=106 Download it here]''' 
Seed: 2736869902 {{v|0.27.176.38c}} 
World size: 17x17 (Pocket) 

[[Image:Ew%C3%A8lina_Location_Screen.PNG|thumb|500px]]

This is a 2x3 fortress location with plenty of every major resource, located in a pocket world. It contains numerous lakes and has no cliffs. 

* '''Adamantine''': Northwest under the rock which extrudes to the surface.
* '''Magma''': Volcano in the southeast corner.
* '''Brook''': A small curve of it in the northeast corner.
* '''Trees''': All over the place. If you desire more you can easily expand westwards to make a 3x3 location.
* '''Sand''': Heaps of red sand one z-level down.
* '''Iron''': Numerous limonite veins and a hematite vein not far below the surface and a patch of magnetite southeast of the volcano.
* '''Flux''': None. You'll have to import it.
* '''Fuel''': Numerous veins of bituminous coal and lignite.
* '''Metals''': Some native platinum, a little native aluminium, some native silver, lots of cassiterite, lots of galena, a little bismuthinite, some tetrahedrite (deep), some garnierite (deep)
* '''Bauxite''': None
* '''Aquifier''': None
* '''Chasm''': None

* '''Neighboring Civs''': All.

=== The Absolute Planet of Dawns ===

Direct download available here: [http://rapidshare.com/files/83977216/The_Absolute_Planet_of_Dawns.zip The Absolute Planet of Dawns] 
Wold offers a wide range of fortress locations, from mountain canyons to haunted glaciers to resource-rich forests, each with (non-spoily) description and location map. 

(version v0.27.169.33g, seed 2664204674, provided by Fedor)

===Incredibly Resource Rich Starting Location===

Embark on the magma pipe near the center, and enjoy adamantite, magma, gold, flux, and much more!

[SEED:340187300]
[HISTORY_SEED:3924664033]
[NAME_SEED:186848708]

=== Lathondur Minbaz ===

Direct download available here: [http://morlark.uwcs.co.uk/misc/region1.tar.gz Lathondur Minbaz]. Be warned that this was created in DF v0.27.169.32a and exhibits several glitches in version 40d, such as being able to request soil/sand "stones" from Dwarven caravans and purchase them during embark.

=== The Legendary Ever-Realm ===
'''Download:''' http://hyperfileshare.com/d/f91fae26

[[Image:4265985437.PNG|thumb|500px]]

Has pretty much every feature in a small 4x5 area. 
'''Features:''' 
- Magma on lower left 
- Small cave river on lower left 
- Edge of chasm on far upper left corner 
- Pits & Adamantine on upper left 
- Sand and trees on far right green tile 
- Plenty of flux and iron for steel production 
- Representatives of all four major rock types: 
1. sedimentary - dolomite, claystone 
2. igneous extrusive - andesite 
3. igneous intrusive - granite, gabbro 
4. metamorphic - marble, schist 

=== Smata Sagus, The Realms Of Dawn ===

'''[http://dffd.wimbli.com/file.php?id=5 Download it here]'''
Seed: 324316224 {{v|0.27.169.33g}} (6 rejects) 
Made in Dwarf Fortress v0.27.169.33g, created with a Core 2 Duo processor in Windows XP. Found using the wonderful [[Utilities#Regional_Prospector|Regional Prospector]].

[[Image:Smata_Sagus_location.png|thumb|500px]]

This is a loaded 3x6 location with basically every major resource. No chasm, cliffs are no taller than 2, surroundings are Temperate and Mirthful. 
If you don't need a river, you can trim it to 3x5 by taking off the bottom edge and still get everything else.

* '''Adamantine''': towards the bottom left.
* '''Magma''': underground, located on layers 140-143.
* '''River''': a small curve of it in the lower right corner.
* '''Trees''': More than you'll ever use.
* '''Sand''': Yep.
* '''Soil''': Yep.
* '''Iron''': Magnetite patches near the surface, along with an occasional hematite and limonite vein.
* '''Flux''': More than you'll ever use.
* '''Fuel''': Plenty.
* '''Bauxite''': Several patches near the magma.
* '''Obsidian''': Available on the left side.

* '''Neighboring Civs''': All.

=== Ruspospazmon, The Eternal Windy Planes ===

'''[http://dffd.wimbli.com/file.php?id=3 Download it here]''' 
Seed: 2851906008 {{v|0.27.169.33g}} (11 rejects) 
Made in Dwarf Fortress v0.27.169.33g, created with a Core 2 Duo processor in WinXP. Found using the wonderful [[Utilities#Regional_Prospector|Regional Prospector]].

[[Image:Ruspospazmon_location.png|thumb|500px]]

This is a 4x3 location with most major resources. No chasm, cliffs are very tall (6-9), surroundings are Scorching and Calm. There is a small spot of aquifer, just enough to be potentially useful while still out of the way. 
If you need a river, you can expand the selection north to include some river fingers and possibly west to also include a stretch of normal river. This will likely include more aquifer though.

* '''Adamantine''': towards the bottom left.
* '''Magma''': underground, located on layers 140-143.
* '''River''': only if you expand the area slightly.
* '''Aquifer''': There's a tiny area of it towards the top left on a few levels.
* '''Trees''': Yep.
* '''Sand''': Yep.
* '''Soil''': Yep.
* '''Iron''': Yes, towards the top and middle.
* '''Flux''': Yep.
* '''Fuel''': Yep.

* '''Neighboring Civs''': All.

=== Emeecamo Ametha, The Eternal Universe of Wind ===

'''[http://dffd.wimbli.com/file.php?id=4 Download it here]''' 
Seed: 2135737780 {{v|0.27.169.33g}} (6 rejects) 
Made in Dwarf Fortress v0.27.169.33g, created with a Core 2 Duo processor in WinXP. Found using the wonderful [[Utilities#Regional_Prospector|Regional Prospector]].

[[Image:Emeecamo_Ametha_location.png|thumb|500px]]

This is a nice 3x3 (or potentially 2x2) location with almost all major resources. No chasm or sand available, cliffs are no higher than 1 (!), surroundings are Scorching and Untamed Wilds. The brook has a semi-waterfall where it drops 1 Z-level, causing a somewhat odd scene. 
If you don't need a river or as many trees, you could actually make it a 2x2 area instead with all other resources by cutting off the bottom and right edges.

* '''Adamantine''': in the middle.
* '''Magma''': Upper left corner, the top is fully open to the ground.
* '''River''': Yes, with a waterfall.
* '''Trees''': Limited, but enough to make do.
* '''Soil''': Yep.
* '''Iron''': Plenty.
* '''Flux''': More chalk than you could ever need.
* '''Fuel''': Plenty.
* '''Bauxite''': Some, check bottom middle of map one level below the lone hill.

* '''Neighboring Civs''': All.
 
[[Image:Emeecamo_Ametha_location2.png|thumb|500px]]

This is another nice location in this world. It is 5x3 with almost all major resources. No chasm, bauxite, or sand available. Cliffs progress up a few levels from left to right, surroundings are Warm and Calm. The magma vent is underground but only 2 levels deep. 
There is so much iron here (many many magnetite clusters) that you'll practically get sick of it. There seem to be more diamonds scattered around here than normal as well.

* '''Adamantine''': upper right corner.
* '''Magma''': lower right corner, underground. Only on levels 148-149, so unfortunately very shallow.
* '''River''': Yes, a small river bend in the upper left corner.
* '''Trees''': Not overabundant, but not scarce either.
* '''Soil''': Yep.
* '''Iron''': Massive amounts; good luck making a dent in it.
* '''Flux''': Take your pick between dolomite and chalk, tons of each.
* '''Fuel''': Limited amounts of lignite, mostly in the upper levels on the left side.
* '''Obsidian''': Plenty of it in the upper left corner at the higher z-levels.

* '''Neighboring Civs''': All.

== Seeds ==
'''{{edit|{{PAGENAME}}/{{current/version}}|Click here to add a seed!}}'''
Seeded worlds are special "codes" which tell the game's pseudo-random number generator (a sophisticated mathematical function which produces numbers that seem random) where to begin generating a world. Because the random number generator is actually just a mathematical function and thus always produces the same result when given a certain input, you can "seed" the generator to produce an entire series of random numbers on another computer that are exactly the same as they were originally produced on the first computer.

However modifications to your raw files can affect worldgen so please state what mods you are using if you post a seed with a non default DF.

To use a seeded world, select ''Create a New World'' during the main menu, then hit {{key|s}} to specify a seed. Type in the seed and hit {{key|Enter}}, then hit {{key|Enter}} one more time to begin generation. It will still take the normal amount of time to generate the world, and you will still have rejects before the world is produced.

Mineral content is determined at the time it is allocated, (essentially when you dig near it). Accordingly the map seed determines the layers and therefore the probability of certain rocks/ores, but the ore veins themselves will vary.

A further warning: there may be other things that affect world generation, such as your operating system. If you generate a world different from one described here, with exactly the same seed, please mention it with the relevant details (operating system including any service packs, processor type, and game version) on the [[Talk:Pregenerated worlds|talk page]].

Here are seeds generated in older versions. They may not generate the same world if you are using a newer version:
*[[Main:Seed archive|Seed archive]] (pre 0.27.173.38a)
*[[Pregenerated worlds/0.28.181.40d|v0.28.181.40d]]

== World Generation Parameter Sets ==

With the release of 0.28.181.39a, ''Design New World With Paramaters'' gained a slew of new features, detailed at [[Advanced world generation]]. Almost any parameter that would be associated with a world can now be given start values, end values, limits, and more. Players can create their own parameter sets to generate worlds with specific features. Sets can also set specific seeds to generate a specific world.

Parameter sets are stored in ''world_gen.txt'' in the ''\data\init'' folder. You can copy and paste other player's sets of parameters into your ''world_gen.txt'' to use their parameter sets. [[World token]]s are the individual parameter representations.

One place to find parameter sets for world generation is the [http://www.bay12games.com/forum/index.php?topic=20638.0 Worldgen cookbook] thread on the official forums.

40d:Reclaim

2015-05-18T11:00:52Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:00, 18 May 2015 (UTC)}}
{{av}}
:''Are you looking to reclaim a lost fort? You may want to look at [[Reclaim fortress mode]].''

'''Reclaim''' is the opposite of [[forbid]]. Allows an item to be used by your [[Dwarves]] that has been forbidden, whether it's going to be hauled or used in construction. It's needed to use items found when you reclaim a fortress or build a fort near an existing settlement, as all items are auto-forbid. It is also used for recovering other automatically forbidden items, such as those dropped by dead goblins. To reclaim, press {{k|k}} to view the item and {{k|f}} to toggle forbid status. You may also use the reclaim [[designation]] to reclaim simultaneously all of the items dumped by using {{key|d}} then {{key|b}} then {{key|c}} and tracing the designation over top of the objects.

{{Category|Designations}}

40d:Refined coal

2015-05-18T11:00:40Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:00, 18 May 2015 (UTC)}}
{{av}}
:''(Disambiguation: In Dwarf Fortress, "coal" is not the same as [[bituminous coal]] - see that article if desired.)''

'''Refined coal''', '''coal fuel''', and just '''coal''' are three in-game terms that refer the same thing, any unit of charcoal or coke, the two fuels used to power high-temperature industries, namely metalworking and glassworking. One unit of either of these fuels is required for every task at a conventional (non-magma) [[smelter]], [[forge]], [[kiln]], or [[glass furnace]]. Magma versions of these facilities do not need fuel, and in fact cannot use conventional fuel to power them if their magma sources fail. Refined coal is also needed as part of the pig iron and steel ''reactions'' (see below).

''(Note that [[Bituminous coal]] is '''not''' "refined coal", "coal fuel", or "coal", though it is directly related.)''

== "Fuel" ==

Though not seen in-game, the single word "fuel" is sometimes used informally in the forums and in various wiki articles in place of the in-game terms "refined coal", "coal fuel" or just "coal". Since some understandable confusion can arise over the usage of the various terms "'''refined coal'''", "'''coal fuel'''", "'''coal'''", "'''charcoal'''" and "'''coke'''" (and also "[[bituminous coal]]", which is ''not'' a fuel), the simple umbrella term "fuel" will be used in the explanations in this article.

The two sub-types of fuel are ''charcoal'' and ''coke'', and they are nearly identical for in-game purposes, even if they come from different sources and have different in-game names. Whenever you see "coal fuel" or "refined coal" or "coal" in-game, those refer to ''either'' charcoal or coke - they are interchangeable, and either one will serve the same purpose, as fuel for the desired activity. (Bituminous coal is not the same as "coal", and does ''not'' refer to fuel, but can be used to create fuel at a smelter.)

Both charcoal and coke come in [[bar]]s, and are stockpiled in Bars/Block [[stockpile]]s if the "coal" entry is selected within the "Bars" section. There is currently no way (or need) to distinguish between the two when designating stockpiles.

At the risk of repetition, but to be perfectly clear - ''despite the different names, there is no distinction between charcoal and coke for any workshop-related activities.'' Both are "refined coal" or "coal fuel" or "coal", or just "fuel". The only actual difference between charcoal and coke has to do with [[Elf|Elven]] traders - selling them charcoal will offend them, but coke will not.

Charcoal and coke are ''not'' [[fire-safe]] building materials.

Bituminous coal [[block]]s and lignite blocks (sometimes offered by traders) can neither be used as fuel nor converted into fuel or back into stones in any way. They can only be used for building purposes and [[strange mood|moody]] dwarves may sometimes use them in artifacts and they can also be utilized for certain forms of [[bin#Thermonuclear_Reaction|fun]].

== In-game usage ==

At a conventional (non-magma) [[smelter]], if you try to add a smelting task and have no fuel, you will see the message:

<blockquote>"'''Must have coal fuel'''"</blockquote>

You will not be allowed to add any tasks to any conventional smelter until you have at least one unit of either charcoal or coke.

If you have queued up several tasks and then run out of fuel, you will get an announcement similar to:

<blockquote>"'''[[Main:Urist|Urist McFuelUser]] cancels job: Needs refined coal.'''"</blockquote>

Note that a forge or glass furnace ''will'' let you add tasks if you have no fuel, and only once a dwarf arrives and finds they cannot complete that task will you get the announcement to that effect. You will get one announcement for each un-fueled task that is unable to be completed. Jobs are canceled when there is no fuel.

When you get either of these messages, you need more fuel - either charcoal or coke will serve equally well.

'''Coal''' is the generic term used in the [[stockpile]] menu. It refers to a [[bar]] of either charcoal or coke.

To place bars of fuel in a stockpile, create a Bars/Blocks stockpile, or a [[Stockpile#Custom_stockpiles|custom stockpile]] with {{k|e}}nabled and permit "coal" (found in the "Bars" sub-category).

== The two sub-types of fuel ==

There are 2 sub-types of conventional fuel - [[charcoal]] and [[coke]]. Charcoal and coke are identical in use - a single unit of either one powers one activity at a conventional smelter, forge, kiln or glass furnace, or can serve as the ingredient to make [[pig iron]] or [[steel]]. They are completely interchangeable, the only difference is their source.

[[Wood]] does not burn hot enough to fuel these activities or facilities, and (in Dwarf Fortress) you cannot burn raw [[bituminous coal]] or [[lignite]] (although they are flammable).

=== Charcoal, from wood===

:Charcoal is created at a [[wood furnace]] using one [[wood]] log by a [[dwarf]] with the [[Wood burner|Wood burning]] [[labor]] enabled. [[Skill|Skill levels]] in the [[Wood burner]] [[skill]] are not required but reduce the time required for this activity.

::* Required Building - [[Wood furnace]]
::* Required Labor enabled - [[Wood burning]]
::* Required Material - [[Wood]]

===Coke, from bituminous coal or lignite===

:Coke is a type of refined coal, and is identical to charcoal for all game purposes. It is created at a [[smelter]] using one unit of fuel by a [[dwarf]] with the [[Furnace operating|Furnace Operating]] labor enabled. [[skill|Skill levels]] in the [[Furnace operator]] skill are not required but reduce the time required for this activity.

:Coke can be created from [[bituminous coal]], producing 3 coke (net gain of 2 fuel), or [[lignite]], producing 2 coke (net gain of 1 fuel). Magma smelters do not require conventional fuel for this process, and so the net yield for each is effectively +1 greater.

::*Required Building - [[Smelter]] or [[Magma smelter]]
::*Required Labor enabled - [[Furnace operating]]
::*Required Material - [[Bituminous coal]] or [[lignite]]
::::::: - ''plus'' one unit of fuel per unit smelted, if at a conventional smelter

== Magma facilities ==

Magma replaces conventional fuel for [[magma smelter]]s, [[magma forge]]s, [[magma kiln]]s and [[magma glass furnace]]s. No fuel is needed, nor can it be used, for activities at these facilities. Note that you will still need charcoal or coke for smelting bars of [[pig iron]] and [[steel]]. (And see next section.)

== Pig iron and steel production ==

Note that when [[smelting]] [[pig iron]] or [[steel]] at any location, one unit of either charcoal or coke is required in the reaction. Again, there is no distinction - both charcoal and coke serve equally well in the production of [[bar]]s of either. That same one unit can simultaneously serve as the fuel for the activity at conventional (non-magma) smelters, so there is no savings at [[magma smelter]]s in producing these two materials - one (and only one) charcoal or coke is consumed each time, either way. See those articles for more information.

----
'''See Also:'''
:* [[Smelting]]

{{Category|Physics}}
{{Category|Materials}}

40d:Region features

2015-05-18T11:00:26Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|11:00, 18 May 2015 (UTC)}}
{{av}}
Picking a starting region to build your dwarf [[fortress]] is a delicate work. Take a look at the list below and consider what you might need in your fort.

== Visible features ==

=== Forest ===

'''Pros:''' [[Forest]]s have plenty [[wood]] and [[plant|plants]] for outdoor [[farming]].

'''Cons:''' [[Trading#Caravans|Trade wagons]] can have a hard time navigating thick forest. Evil and untamed forests can have dangerous [[creature|creatures]].

=== Desert/Beach ===

'''Pros:''' [[Sand]] for [[glass|glassware]], easily navigated by trade [[wagon|wagons]]

'''Cons:''' Little wood or [[stone]].

=== Aquifer ===

'''Pros:''' Infinite source of [[water]] anywhere on the map

'''Cons:''' Difficult to get under to access [[stone]] and minerals

=== River/Brook ===

'''Pros:''' [[Fishing]], [[water]] for farming and drinking

'''Cons:''' Some dangerous [[river]] creatures

=== Lake ===

Small lakes are present in pretty much every other tile of the world.

=== Ocean ===

'''Pros:''' Mist makes dwarves [[thought|happier]], source of driftwood, [[siege|sieges]] can't attack from that side (yet)

'''Cons:''' Saltwater is not normally drinkable

=== Open [[Volcano|volcano]] vent ===

'''Pros:''' [[Magma forge|Magma forges]], [[obsidian]], [[Trap_design#Magma_traps|magma defense]]

'''Cons:''' Magma monsters, [[strange mood]] crafters -demand- magma forges

=== Cliff ===

'''Pros:''' Don't want something? [[Activity zone#Garbage Dump|Drop it off]] the side of the [[cliff]]!

'''Cons:''' May tax the system slightly

== Hidden features ==

=== [[Chasm]]/[[bottomless pit]] ===

'''Pros:''' Provides an easy way to delete items and drain liquid. May also contain cave spiders.

'''Cons:''' Often contains monsters, and sometimes the dreaded [[giant cave spider]].

=== [[Underground river]] ===

'''Pros:''' An infinite source of water. Discovering this lets you grow [[tower-cap|tower-caps]] on subterranean mud, and also provides a decent fishing location. May contain cave spiders.

'''Cons:''' Discovered early enough, it will usually contain monsters. As with all infinite water sources, one mistake could end up permanently flooding half your fortress.

=== [[Underground pool]] ===

'''Pros:''' Discovering this lets you grow tower-caps on subterranean mud, and also provides a decent fishing location. May contain cave spiders.

'''Cons:''' Will always have monsters. As with all large bodies of water, one mistake could end up temporarily flooding half your fort.

=== [[Magma]] pipe/pool ===

'''Pros:''' A magma pipe is an infinite source of magma, which can be used to perform most metalsmithing operations without the use of coal. Magma pools are not an infinite source, but still contain magma.

'''Cons:''' Magma pipes and pools are home to deadly [[fire imp|fire imps]], [[magma man|magma men]], [[fire man|fire men]], and lava is an extremely dangerous substance. Flooding your fort with magma is the ''last'' thing you want to do.

=== [[Glowing pit]] and [[Adamantine]] ===

'''Pros:''' Adamantine is the best material in the game.

'''<del>Cons</del> Pros:''' Breach the glowing pits and all hell will break loose. For more details, check the [[Demon]] article.

{{Category|World}}

40d:Remove

2015-05-18T11:00:13Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|11:00, 18 May 2015 (UTC)}}
{{av}}
It seems that half the time in [[Fortress mode]], when you aren't building something, you're '''removing''' something. Whether that's [[dig|digging]] away part of the landscape, tearing down a [[wall]], ripping up a [[bridge]], or just rearranging the [[furniture]], if it needs to get done then it needs to get done.

Although every specific article should have an explanation of how to remove that specific item or feature, if you're here you may need a more basic "how to".

Here's how to remove...

==Dirt/stone==
:''Main article: [[Mining]]''

[[Digging]] may be the most basic action in Dwarf Fortress. All you need is a dwarf with the [[mining]] [[labor]] activated, and access to a [[pick]].

Then, designate an area to be mined. Do this by hitting the {{k|d}}esignate {{k|d}}ig keys. Then either left-click an area on the same z-level with the mouse, or use the cursor and {{k|Enter}} to establish one point, and move the cursor and repeat to select a rectangle to be dug out.

If you want (or need, to get up/down) to create [[stairs]] or [[ramp|ramps]] instead of tunnel, it works similarly but with some additional concerns - read those articles for details and command keys.

===Dug ramps/stairs===
Similar to the above, but to designate the removal of carved [[ramp|ramps]] or natural [[slope|slopes]] (same thing), or carved [[stair|stairs]], use the {{k|d}}, {{k|z}} keys.

===A digging "designation"===
"Oops"?! Didn't mean to mark that? If the action hasn't been completed yet, don't panic. Use {{k|d}}, {{k|x}} as above and click over the part you don't want marked.

==Constructed walls, stairs, etc==
:''Main Article: [[Construction]]''

If you're trying to remove anything that is a [[construction]] (that is, anything that was built with the {{k|b}}, {{k|C}} keys), that's another designation, use {{k|d}} {{k|n}}, and mark the construction. Any dwarf will respond and (eventually) tear it down - which takes longer than it took to build.

Construction orders that are not yet constructed can be removed with {{k|q}}, {{k|x}}, just like the finished buildings.

===Bridges===
There are two types of [[bridge|bridges]] - a retracting bridge / drawbridge, and just a long [[floor]] or a [[wall]] permanently spanning a gap.

If it's the movable type, remove as you would furniture, with {{k|q}}, {{k|x}}.

The latter is just a construction - remove the same as for a construction, above. Be sure, if it's a long floor or wall, that your dwarves won't be standing on one part while a critical part is removed - see [[cave in]].

===A "remove construction" order===
"Oops"?! Cancel that removal the same as you would any designation, with {{k|d}}, {{k|x}}.

== Furniture ==
:''Main Article: [[Furniture]]''

Use {{k|q}} (or {{k|t}}), move the cursor over the piece of furniture to be removed, and then hit {{k|x}}. You'll also need a dwarf with the [[furniture hauling]] [[labor]] activated, and then the patience to wait for one to respond.

==Workshops==
:''Main Article: [[Workshop]]''

Similar to furniture, use {{k|q}} (or {{k|t}}), and then hit {{k|x}}. You'll need a dwarf with an appropriate [[labor]], depending on the exact workshop - this can be seen via {{k|q}} once the workshop has been marked for dismantling.

===A "destroy" order for furniture or workshops===
Oops?! Cancel an order to remove furniture or a workshop by using {{k|q}} (or {{k|t}}) then {{k|s}}top.

==Trash==
:''Main Articles: [[Stockpile]], [[Zone]], [[Refuse]]''

This is trickier, and there are 2 different approaches.

One is to create a [[refuse stockpile]] for that class of item ''(usually remains of [[vermin]] killed by a [[cat]], or items left after [[butcher|butchering]], but other items are possible)'', and wait for a dwarf with the [[refuse hauling]] [[labor]] to find the free time to respond.

A more aggressive and specific method is to create a [[garbage dump]] (using the {{k|i}} menu) and then mark the items for [[dump|dumping]]. Again, this requires refuse hauling, but it can create a [[Exploit#Quantum_stockpiles|quantum dump]] for any type of item. ([[Stone]] is a popular choice.)

==Stockpiles==
:''Main Article: [[Stockpile]]''

Stockpiles can be removed by pressing {{k|p}}, {{k|x}} and using the cursor keys and Enter to select the area where you don't want the stockpile to be anymore.

==Activity zones==
:''Main Article: [[Zone]]''

Activity zones can be removed by pressing {{k|i}}, {{k|x}} and using the cursor keys and Enter to select the area where you don't want the activity zone to be anymore.

==Stones==
Stones are automatically removed by dwarves with the Stone Hauling labor activated, and placed in the stone stockpiles, or your garbage dump if so designated. 

==Water==
:''Main Article: [[Water]]''

Depending on the quantity and nature of the water in question and the surroundings of your fort, removing water can be performed in a number of ways:

:The most direct method is to either drain it into a lower space, or [[pump]] it elsewhere.
:In hot environments, standing water is likely to [[evaporation|evaporate]], especially in the summer.
:Similarly, in [[Climate|freezing]] areas you may be able to wait for water to [[Ice|freeze]] and then [[mine]] it out.
:Water in ponds or cisterns will evaporate if it reaches a [[Water#Water depth|depth]] of only 1/7 units. Spread it around by channeling a larger area for it to flow into.
:With careful (and rather [[labour]]-intensive) use of water source and [[pond]] [[Zone|zones]] with [[Bucket|buckets]] you can have your dwarves move water from one location to another, out of your way.
:If you've got a renewable source of water (a [[river]], for example), you'll have to get creative with engineering to [[dam]] or divert the flow.
:An advanced method, with the potential for lots of [[Fun]], is to combine [[magma]] with your water. You can get a lot of valuable [[Obsidian|obsidian]] this way, though - see [[Obsidian farming]] for more information.

'''Note:''' [[Murky pool|Murky pools]] will refill when it rains; you may need to take steps to prevent this if you want rid of a body of water permanently.

===muddy floor===
After an area has water on it and dries, it will become [[mud|muddy]]. The best way to remove this is to have a dwarf with the [[stone detailing]] [[labour]] activated, and [[designate]] the muddy area for "smoothing", via {{k|d}} + {{k|s}}.

If the stone is already smooth (or if you don't want it to be smooth in the first place), simply place a piece of furniture (such as an [[armor stand]], [[statue]], or [[animal trap]]) on top of each muddy tile and the mud will be removed.

==Magma==
Magma is a very dangerous liquid, but it will [[evaporate]] exactly like water once it drains down to a depth of 1/7.

Alternately, the addition of water to the magma, even if only at a depth of 1/7, will create [[obsidian]].

==Bodies==
Bodies of your dwarves, and their body parts, or bones, will be put into your [[graveyard]], or into individual [[Tomb|tombs]] if that dwarf was assigned to it. Built [[Coffin|coffins]] which have been set to 'Use for burial' will This requires the Burial labor enabled on a living dwarf.

Bodies of everything else, from [[vermin]] to [[Titan|Titans]], will be placed in the Refuse Stockpile, by a dwarf with Refuse Hauling. If these corpses are unrotten and butcherable, dwarves with Butchery enabled will take them to the Butcher's workshop and cut them into meat, fat, bones, a skull, and chunks. The fat and meat will be used as food, and delivered to that stockpile, and everything else becomes refuse. [[Bone|Bones]] and, to a lesser extent, [[Skull|skulls]] can be made use of after this.

==Miasma==
Miasma are the gaseous fumes that are emitted from a rotten corpse. They cause nearby dwarves to become very depressed. If exposed to miasma long enough a dwarf will commit suicide.

==!!Fire!!==
Good luck removing [[fire]]. Water will only remove flames if the object is completely immersed in 7/7 water. Obviously, this is problematic if a dwarf is burning. Your best bet is to isolate the burning substances (clothing, dwarves, beer, etc) and prevent any dwarves or animals from accessing the banned areas until all the flames burn out.

Creating a [[cave-in]] can destroy the burning item completely, which is no loss since it's already burning. (Read up on cave-ins before doing this to avoid worse problems.)

==Stuff via the init.txt file==

===Cave ins===

===Temperature===

==Announcements==

40d:Remove designation

2015-05-18T10:59:53Z

PeridexisErrant: Changed quality rating from "Unrated" to "Tattered" using the rating script

{{Quality|Tattered|10:59, 18 May 2015 (UTC)}}
{{av}}
Accessed with {{K|x}} from the {{K|d}}esignations menu. Allows a previously placed [[designation]] to be canceled. Handy if a designation was made erroneously or the situation has changed.

{{Category|Designations}}

40d:Reservoir

2015-05-18T10:59:44Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|10:59, 18 May 2015 (UTC)}}
{{projects}}{{av}}
A '''reservoir''' or '''cistern''' is merely a holding area for storing water needed for drinking or [[trap design#Water traps|other purposes]]*. This lets you take advantage of lakes without tapping all of it at once, or to get water from a [[river]] without flooding the whole fortress. You can get water from the [[ocean]], but it's not drinkable without either a [[well]] or [[Pump#Desalinization|desalinization]].

:''(* Technically, a cistern is constructed, while a reservoir is either constructed or merely dug, but with the exception of [[Pump#Desalinization|desalinized water]] there is no functional difference.)

Producing a reservoir does not involve constructing a specific building, but rather by hollowing out a great underground chamber, routing [[water]] to it, and ideally capping it with a [[well]] for easy access.

==Why do I need one?==

There are many reason to build a reservoir. Water which is "inside" does not freeze in winter. This means that your [[well]] will continue to function, providing water to your injured dwarves, and backup hydration should you run low of [[alcohol]]. Same with a [[Zone#Fishing|fishing zone]].

Other possible uses include...

* (re-)[[Irrigation]]
* [[Trap_design#Water_traps|Flooding traps]]
* [[Death chamber]]
* Controlled [[waterfall]]
* [[Swimming pool]]
* [[Obsidian]] farm

Finally, one may simply rest easier knowing that you have a ten years supply of fresh water to match your ten years pile of [[quarry bush]] leaves, and will live on even if the forces of darkness somehow block your river.

''(Also, it has been suggested that in the future, [[brewing]] will require [[water]].)''

=Operation=

Open the outer [[floodgate]] to fill the reservoir. Close it once there's enough water inside. Open the inner floodgate to release the water. Never have both open at once!

=Making a reservoir=

==Planning==

Plan carefully where you want the water come from, and where you want it to go. Building next to a body of water is easiest. You can have the water flow down a staircase, or make channels for the water. Block off any corridors that connect to the water output. A simple [[door]] right next to flow will prevent water from pooling in the corridor.

Also, you need to place two [[lever|levers]] to control the flow of water. It is easy to forget which lever connects to what. You might want to build a lever room nearby. Build levers parallel to the floodgates.

==Digging==

Mine out an area like this, one level below the ground. The diagonal kink is important! The area above it will be the reservoir proper. It can be any size you like, but make sure it only connects to the rest of your fortress through that diagonal opening. Water will flow out from below that kink, so make sure there's no hallways below that you don't want flooded.

{{diagram|wwww
####
#+##
#+##
#+##
#+##
#+##
##+#
##+#
##+#
##>#
####}}

==Floodgates==

Build the upper floodgate at the very end of the reservoir chamber. Once it's in place, connect it to a lever.

{{diagram|wwww
####
#X##
#+##
#+##
#+##
#+##
##+#
##+#
##+#
##>#
####}}

Once the first floodgate has been connected, build the other floodgate just behind the kink. Dwarves don't build on the diagonal, so this keeps your dwarves from trapping themselves. Connect it to another lever.

{{diagram|wwww
####
#X##
#+##
#+##
#+##
#+##
##X#
##+#
##+#
##>#
####}}

==Input channel==

From above, channel into the water source.

{{diagram|wwww
#w##
#X##
#+##
#+##
#+##
#+##
##X#
##.#
##+#
##>#
####}}

==Output channel==

You can have the water just flow down the stairs, or dig a channel just outside the outer floodgate. This cuts off access to the reservoir, so you can't re-jigger the floodgates. Hopefully, you will not need to, but you can build a horizontal [[grate]] or [[bars|floor bars]] to make the channel walkable but still allow water to flow through.

{{diagram|wwww
####
#X##
#+##
#+##
#+##
#+##
##X#
##W#
##+#
##>#
####}}

=Variations=

==Deeper reservoir==

If for some reason you need to build a reservoir deeper underground, or further from the water source, you can connect the water source to the first floodgate by a stairway or tunnel. Add another kink before the first floodgate to avoid trapped dwarves.

{{diagram|wwww
####
##>#
####}}

{{diagram|####
##<#
#X##
#+##
#+##
#+##
#+##
##X#
##+#
##+#
##>#
####}}

==Customization==

While the basics of a cistern are very plain, one can apply a great deal of personalization to your cistern. It can be completely cube shaped, rectangular, or circular. You can have a floodgate or hatchcover leading to a drain, perhaps a [[chasm]], to allow you to drain and maintain your cistern. You may also want to [[road|pave]] the floor in case you have uncovered an [[underground river]] or pool, in order to prevent the growth of [[tower-cap|tower-caps]]. Finally, you might want to use [[pressure plate|pressure plates]] to automate the intake floodgate, keeping the cistern full (but not overflowing).

For detailed instructions on setting up a working well, see the [[well guide]].

===Fish-proofing===

Draining from a large body of water can allow large and potentially dangerous aquatic creatures into your fortress. Installing a [[grate]] or [[bars]] across the water flow can keep them out. Note that bars will allow [[vermin]]-size creatures though, and grates do not. You can use [[fortification|fortifications]] too, but this slows down the flow of water.

===Re-directing water flows===

It's possible to re-configure a reservoir to channel water in a new direction. You can construct walls and floors to block water, or place [[door|doors]] and [[hatch|hatches]].

====Doors vs floodgates vs drawbridges====

You can use [[door|doors]] and [[floodgate|floodgates]] interchangeably. Drawbridges work as well - when they're raised, they block any passage they sit in front of, and this includes the passage of fluids. (This is expected to change in the future, so your doors might start leaking in the future.)

==Magma Reservoirs==

You can move [[magma]] around using the same basic principles. [[Construction|Constructions]] (walls, ramps, etc) do not need to be [[magma safe]], nor do pumps (so long as they are not submerged) - glass or wooden walls and pump components (blocks, pipes and screws) are fine*. Any [[furniture]] (specifically including doors, floodgates, and hatch covers) and [[mechanism|mechanisms]] that will be submerged or "opened" to magma flow must be of [[magma proof]] materials.

:''(* Or usually are - it has been reported that long exposure to the heat of magma, from being directly adjacent to a large pool of it, will damage screw pumps to the point that they deconstruct. Not all players observe this, so more research is required.)''

40d:Rest

2015-05-18T10:59:02Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|10:59, 18 May 2015 (UTC)}}
{{av}}
The '''Rest''' job is activated when a dwarf cannot do most normal tasks. (Like walking around) The dwarf with the rest job is either rescued and put in a bed, or moves very slowly to the bed leaving a very annoying trail of blood. In most cases the dwarf will stay in the bed until the injuries are fully healed. Notable exception is the situation, when bed is located aboveground, dwarf is capable of walking (has both legs uninjured) and ''dwarves stay indoors'' order is issued.

===See also===
* [[Wound]]

{{Category|Jobs}}

40d:Severed body part

2015-05-18T10:58:53Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|10:58, 18 May 2015 (UTC)}}
{{av}}
In combat, bladed [[weapon]]s or good old-fashioned blunt trauma can sever body parts, often quite dramatically. In fortress mode, these are collected by your [[dwarves]] as [[refuse]] and deposited in an appropriate [[stockpile]], where they are left to [[rot]] (or are [[butcher]]ed, if you so allow) and produce bones. While there's nothing like a rotting pile of dismembered limbs to brighten your day, the glut of refuse [[hauling]] jobs may distract your dwarves from more important tasks. It is recommended that you [[forbid]] any severed body part that is not the [[corpse]] when butchering dismembered bodies of edible [[creatures|wild animals]], and unforbid them once the proper corpses have been processed.

{{Category|Items}}

40d:Shield user

2015-05-18T10:58:39Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|10:58, 18 May 2015 (UTC)}}
{{av}}
'''Shield User''' is the skill associated with the use of [[shield]]s and [[buckler]]s in combat. The skill is gained every time a block roll is attempted, and presumably increases the chance of higher block rolls. If the block roll succeeds the attack is blocked completely.

At [[legendary]] or near-legendary levels, this skill provides ''huge'' amounts of protection, allowing a [[dwarf]] with a decent shield to block many [[crossbow]] [[bolt]]s, or even [[Dragon|Dragonfire]].

{{Skills}}
{{Category|Skills}}
{{Category|Military}}
{{Category|Combat Skills}}

40d:Site map

2015-05-18T10:58:24Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|10:58, 18 May 2015 (UTC)}}
{{av}}
The site map or location map is one of the possible modes in the [[Adventurer mode]].

== General Information ==

The site map is the most detailed mode available. In other words, its tiles do not represent a larger number of tiles in another map, even though an individual tile may contain several objects and/or [[creature]]s stacked on top of one another.

The exact size of the tiles is not defined and the flexible physics of the game make it difficult to pin down any size. However, it should be noted that each [[chair]], [[table]], [[bed]], or other item of [[furniture]] requires a single tile for itself in order to be placed correctly.

While the adventurer explores the game in site map mode, they will over time grow [[Adventurer mode#Basic Needs|thirsty]] and [[Adventurer mode#Basic Needs|hungry]].

== Screen Structure ==

[[image:ExploredTownAtNight.png]]

=== Central Area ===

The central area of the screen shows the player character and the surrounding area.

Depending on the lighting, not the entire area may be visible. During the night or inside [[cave]]s, only a limited area is currently visible. In addition, obstacles like [[tree]]s or [[wall]]s will also impede visiblity.

Tiles which are unknown and currently invisible will be completely black. Tiles which have been seen before (either during the current visit to the area or during a previous visit), will show their usual character, but will be greyed out. If there had been a [[creature]] on a tile when the character last saw the tile, that is, the last turn the tile was visible, the [[creature]]'s symbol will be shown in black on a purple background. It will remain there, until the tile becomes visible again.
[[image:BearInvisible.png|left|thumb|A bear hidden by a tree]][[image:BearVisible.png|center|thumb|The bear visible again]] 

=== Message Line ===

At the bottom of the site map there is the message line where messages will be displayed, deducting one line from the central area. Usually, it is a single line. However, in certain situations where many things happen simultaneously (or rather between two moves of the player character), as in [[combat]], it may turn into several lines covering major parts of the screen.

[[image:NormalMessageLine.png|left|thumb|A normal message line]][[image:MassiveMessageLine.png|center|thumb|A message line overflow]] 
You can clear it by pressing the {{k|space}} key.

=== Bottom Line Information ===

The two bottom lines contain several pieces of information.

On the first line on the left hand side, the character name will be displayed.

On the second line on the left hand side, the name of the current location will be displayed. If the character is inside a named building, that building's name will be displayed. When inside a [[Site|town]] or other [[site]], that location's name will be displayed and only if none of these applies will the name of the region (that is, the local region the current travel map tile belongs to) be chosen.

On the first line, in the center, 'W:' is followed by the name of the current [[weapon]].

On the second line, in the center, 'A:' is followed by the name of the current torso [[armor]].

On the first line, on the right hand side, 'Speed:' shows the [[speed]] value of the character. The higher the value, the faster the character moves and acts and the basic value for [[human]]s is 1,000.

=== Upper Left ===

The upper left corner of the screen features a site compass. It lists the nearby [[site]]s of interests closest to the location you are currently at.

Each line lists one [[site]], starting with the [[site]] you are currently at.

The first item in each line is the symbol for the [[site]] as seen on the travel map.

This is then followed either by compass directions or a line of white minusses '---'.

The '---' mean that the player character is currently at the specified [[site]].

If a compass direction is shown, it refers to the direction in which the [[site]] is as seen from the player character's current tile. Compass directions can be simple, like 'N', but can also be more extensive like 'WSW', so they are fairly accurate. The color of the compass direction indicates how far the character is away from the site. Light green means the character is the closest beyond being at a location. Brown means nearby and dark grey indicates any distance beyond that.

There is one special appliance for the compass: If you are currently on a [[quest]] and have reached the [[quest]] location on the travel map, the compass on the site map will not show the white '---' until you have reached the precise [[quest]] location, like for instance the actual entrance to a [[cave]]. Instead, you will have light green compass directions pointing the way towards the [[quest]] location. Note that this is only the [[cave]] entrance or such. The location of a [[quest]] opponent is not given by the compass and needs to be figured through searching the [[quest]] location.

There is one more item a line may contain. That is a cyan 'TSK' marking a [[quest]] destination location. A character is on a [[quest]] for the entire time from accepting the [[quest]] until reporting the success to the [[quest]] giver. While the [[quest]] is not fulfilled yet (i.e. the [[quest]] monster has not been slain yet), the [[site]] of the [[quest]] (where the [[quest]] monster resides) will be marked with the 'TSK'. Once the [[quest]] has been fulfilled (i.e. the [[quest]] monster has been slain), the 'TSK' is moved to the town where the [[quest]] giver resides. Only once the [[quest]] is ended by reporting the success to the [[quest]] giver will the 'TSK' be removed completely.

=== Lower Left ===

The lower left area may contain a mini map if it is available.

The minimap is only available if you are in a [[Site|town]] or when you are directly at a special/[[quest]] location, like for instance inside a [[cave]]. The minimap is not available on normal terrain maps or on [[cave]] location site maps themselves (that is the site map where the entrance to the [[cave]] is located).

In [[cave]]s, the minimap currently seems to mark only the player character position as a light green '@' ([[image:PlayerIcon.png]]) and the position of the [[cave]] entrance as a yellow 'X'. It does not show tunnels or [[creature]]s or any other features, so it only helps with basic orientation.

In [[Site|towns]], the minimap shows the buildings you have either heard about or visited as well as the position of your character. Other creatures or features are not shown on the map and [[z-level]] differences are also not shown.

* In the town map, your own character is again the light green '@' ([[image:PlayerIcon.png]]).
* A black 'H' on a brown background ([[image:HouseIcon.png]]) marks housing, be it hovels or appartment buildings.
* A blue 'M' on dark blue ([[image:MayorIcon.png]]) marks the town hall where the mayor can be found.
* A grey rectangle of 2x2 tiles size with a white 'T' on a red background in the upper left corner ([[image:TempleIcon.png]]) marks a [[temple]].
* A grey rectangle of 3x3 tiles size with a cyan 'K' on a blue background in the middle ([[image:KeepIcon.png]]) marks a keep.
* Yellow icons on a brown background depict stores:
** Armory : [[image:ArmoryIcon.png]]
** Clothier : [[image:TraderIcon.png]]
** Grocery : [[image:GroceryIcon.png]]
** Weapon Smith : [[image:WeaponSmithieIcon.png]]
** Jeweler : [[image:TrinketIcon.png]]

=== Right Side ===

On the right hand side, neighboring [[z-axis|z-levels]] may be shown.

Their displayal works basically like that of the central area as far as visibility is concerned.

These visuals only pop up once the character moves within range of an area where the character can either see onto a different [[z-level]] or where the character has previously seen the different [[z-level]] (the latter is very common during [[cave]] explorations where the surface [[z-level]] may show up on the right hand side).

These displays are framed and in the middle of the bottom or top frame, an arrow and a number will indicate the relative depth: A downward arrow in the bottom frame indicates that the [[z-level]] displayed is lower than where the character is currently located, while an upward arrow in the top frame indicates that the [[z-level]] is above the character. The number next to the arrow indicates the number of [[z-axis|levels]] difference. So, seeing down a single-level [[slope]] would result in a down arrow next to the number '1', while seeing the roof of a 2-story building would generate an up arrow and the number '2'. In addition, arrow and number are light blue when displaying a [[z-level]] above the character's current position and brown when the extra [[z-level]] is below.

If there is a [[creature]] visible in the extra-display, the frame will be yellow.

== Game Play Function ==

While the travel map allows for quick travel between locations, the site map is actually the location of the main interaction of the game. As such, you can only view your inventory or interact with it while in site map mode. In addition, [[creature]] encounters also only take place on site maps; if you come across a [[creature]] while travelling, you will have to switch into site map mode (by pressing {{k|>}}) - if it is not a random encounter, in which case you will automatically be forced into site map mode.

As was noted above, the character will grow [[Adventurer mode#Basic Needs|hungry]] and [[Adventurer mode#Basic Needs|thirsty]] while on a site map. However, site maps are the only location where you actually can obtain [[Adventurer mode#Basic Needs|food]] and [[Adventurer mode#Basic Needs|water]] as the travel map does not offer interaction with any game objects.

Time passes more slowly than on the travel map, but it is subject to day and night, as well as [[weather]] effects like rain.

In [[Site|towns]], the site map allows you to explore the [[Site|town]] and speak with the inhabitants (using {{k|k}}). This way you can gather information for your [[legends]] registry, also learn about nearby [[site]]s and their inhabitants, get [[quest]]s from the mayor, and trade for better equipment or food.

When facing special [[site]]s like [[cave]]s or [[goblin]] towers, the site map effectively resembles the normal gameplay of a rogue-like.

[[Category:Adventurer mode]]

40d:Smoke

2015-05-18T10:58:11Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|10:58, 18 May 2015 (UTC)}}
{{av}}
Where there's '''smoke''', there's [[fire]].

When items burn, they release smoke into the surrounding area. The presence of smoke means that it is reasonably close to a source of fire, which can cause [[Losing|fun]] times. If you see smoke, you have (or very recently had) a fire burning somewhere nearby and should take action. ''(Since fire is deadly and can easily spread, this is bad enough by itself.)''

[[Dwarves]] that inhale smoke will get unhappy [[thought]]s. They also may get internal injuries or become [[unconscious]].

Smoke will not go through closed doors, but it is apparently thick enough to hold doors open if it gets through. Like [[miasma]], smoke can easily cross [[z-level]]s up or down through openings.

{{Category|Fortress mode}}
{{Category|Thoughts}}
{{Category|Physics}}

40d:Soap industry

2015-05-18T10:58:04Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|10:58, 18 May 2015 (UTC)}}
{{av}}
[[Soap]] is produced by a [[soaper]] in an [[Alchemist's laboratory]].

Soapmaking is a high-technology tertiary industry. Creating soap requires [[lye]] and [[tallow]], both of which are manufactured items. Building the Alchemist's laboratory requires the components of a functioning [[glass industry]] to create the 3 clear [[glass]] [[vial]]s, which in turn requires [[sand]] (on a map which actually contains it), a [[bag]] (made from [[cloth]] or [[leather]]) and [[pearlash]] (made from burned wood).

As [[lye]] is one of the necessary ingredients, creating soap will require burning large quantities of wood, so a soap industry is best established in a heavily wooded area or a mountainous region with an underground [[lake|pool]] or [[river]] for growing [[tower-cap]]s.

==Alchemist's laboratory==
Soap is made in an Alchemist's laboratory.
* [[tallow]] + [[lye]] = [[soap]] - profession: [[alchemist]]

===Lye===
Inputs: [[tree]]s plus an [[axe]].
* cut down [[tree]]s to obtain [[wood]] - profession: [[wood cutter]]
* burn wood at a [[wood furnace]] to make [[ash]] - profession: [[furnace operator]]
* use ash to make [[lye]] at an [[ashery]] - profession: [[lye maker]]

===Tallow===
Inputs: butcherable [[animals|creature]]s
* breed livestock or [[hunt]] butcherable wild animals- profession: [[hunter]]
* slaughter the animal at a [[butcher's shop]] to obtain [[fat]] - profession: [[butcher]]
* render the fat at a [[kitchen]] to produce [[tallow]] - profession: [[cook]]

* Create 3 x [[glass]] [[vial]]s - requires a [[glass industry]]

===Clear glass===
* [[cloth]] or [[leather]] [[bag]]
* construct a [[glass furnace]] or [[magma glass furnace]]
* collect [[sand]]
* obtain [[pearlash]] (trade or see below)
* sand + pearlash at glass furnace produces [[clear glass]] - profession: [[glassmaker]]

====Bags====
Large amounts of animal fat are required to make soap. Slaughtered animals are the only input requied for producing [[bag]]s from [[leather]].
Inputs: butcherable animals
* breed livestock or [[hunt]] butcherable wild animals- profession: [[hunter]]
* slaughter the animal at a [[butcher's shop]] to obtain [[skin]] - profession: [[butcher]]
:: Note:these two steps are shared below in producing [[tallow]])
* tan the skin at a [[tanner's shop]] - profession: [[tanner]]
* use 2 pieces of leather to produce 1 bag at a [[leather works]] - profession: [[leatherworker]]

====Sand====
Use the bags from above.
* construct a [[glass furnace]] or [[magma glass furnace]]
* issue the '''collect sand''' task from the furnace

====Pearlash====
Pearlash is required in creating the glass vials used to build an Alchemist's laboratory.
Inputs: Ash or lye from above.
* Produce [[potash]] from [[ash]]es or [[lye]] at the [[ashery]] - profession: [[potash maker]]
* use [[potash]] to make [[pearlash]] at a [[kiln]] or [[magma kiln]] - profession: [[furnace operator]]

{{Category|Industry}}

40d:Social skill

2015-05-18T10:57:45Z

PeridexisErrant: Changed quality rating from "Unrated" to "Superior" using the rating script

{{Quality|Superior|10:57, 18 May 2015 (UTC)}}
{{av}}
'''Social skills''' are used mainly by the [[Expedition leader]], [[Manager]] and [[Broker]]. They are used in interactions between the dwarves in your fortress as well as when talking with [[liaison]]s and [[merchant]]s. Social skills are acquired at embarking, while performing the above administrative tasks or while attending parties.

The following list is based on the skills listed in the nobles screen when replacing a [[noble]].

==List of Social Skills==
=== Miscellaneous conversational skills ===
It is unknown what specific circumstances make one or another of these useful; most of them are trained by parties, conversation between two or more idle dwarves, and trading. The latter fact implies that they are useful in trading, perhaps to get a better deal. They are also listed as mayor skills.
* Conversationalist
* Comedian
* Flatterer
* [[Broker skills#Judge of intent|Judge of intent]]
* Liar
* [[Intimidator]]
* Persuader
* Negotiator

===Broker skills===
:''See [[Broker skills]]''
All of the conversational skills listed above are trained by (and thus, presumably, used in) trading, possibly to get a better deal. It is believed that which skills are used may depend on the dwarf's personality. Note that the [[Appraiser]] skill, which is not a social skill, is also used in trading.

===Mayor Skills===
*All of the above conversational skills
*[[Consoler]]
*[[Pacifier]]

Dwarves with these two skills can reduce the likelihood of tantrums by being complained at or cried on (which creates a happy thought for the other dwarf). These skills are also all listed as relevant for the [[manager]].

==Gaining Social Skills==
Dwarves train their social skills when idling in meeting areas or attending parties ''and'' they are standing near another dwarf. All social skills seem to train at roughly the same rate, though their [[personality trait|personality traits]] will determine ''which'' skills they train - for example, a very self-conscious dwarf will not gain Comedian skill.

{{Category|Skills}}

40d:Soldier

2015-05-18T10:57:38Z

PeridexisErrant: Changed quality rating from "Unrated" to "Exceptional" using the rating script

{{Quality|Exceptional|10:57, 18 May 2015 (UTC)}}
{{av}}
Dwarves in your [[military]] will be one of the following types of '''soldiers'''. What type of soldier they are will be determined by whichever [[weapon]] they are most [[skill|skilled]] at using. All soldiers can carry [[shield|shields]], regardless of what weapon they use. Weapon, armor, and squad choices are controlled from the Military screen ({{key|m}}). The dwarven military is organized via use of the [[squad]] system.

==Weapon & Military Skills==

In Fortress mode, any dwarf can be assigned any weapon and try to use it, with or without the skill - but the better the skill, the better the soldier. If a dwarf's highest skill is a weapons skill, that will determine the dwarf's [[profession]]. It's quite possible to order an axedwarf, or any untrained peasant, to pick up a short sword and order them to fight - they just won't be as good.

:* [[Axedwarf]]
:* [[Hammerdwarf]]
:* [[Macedwarf]]
:* [[Marksdwarf]]
:* [[Speardwarf]]
:* [[Swordsdwarf]]
:* [[Wrestler]]

:* [[Armor user]]
:* [[Shield user]]

Note that in Fortress Mode, dwarfs cannot wield knives or larger versions of the above weapons, nor can they learn the skills to do so.

== Training ==

Soldiers will train when not on duty. Marksdwarves will shoot at [[archery target|archery targets]] if they are correctly set up and you have wood or bone [[bolt|bolts]] available. Melee dwarves (including wrestlers) will [[sparring|spar]] with their weapons in a [[barracks]] if you have built one. For full information, see the article on [[sparring]].

== Squads ==

You may organize your dwarves into squads of troops through the {{k|m}}ilitary menu. Select the squad commander, then press {{k|Enter}}. Select another dwarf, and press {{k|Enter}} to add this dwarf to the first soldier's squad. When you are finished adding to a particular squad, use the {{k|Spacebar}} to end the assignments. Adding an unenlisted dwarf to a currently active squad will activate this new soldier. Adding dwarves to an inactive squad will not activate the squad.

You may also select sub-commanders in this manner, creating an established chain of command.

Active squads will stay close to the leader of their squad. If he takes a break to Eat or Drink, his squad will follow him. They will also follow him back to his bed if he goes to rest or heal. If a squad leader is hospitalized, the dwarves under his command will do nothing useful until he is healed, or a different leader is assigned. Squads will work towards a single goal -- if attacking a group of hostiles that scatter in several directions, the entire squad will follow one hostile.{{verify}}

=== Duty Roster ===

You must activate and deactivate your squads through the {{k|m}}ilitary menu's "{{k|v}}iew squad" sub-menu. Some dwarves will grow unhappy if left on patrol duty too long, and they will not have a chance to improve their skills. A squad that is off-duty will spar in a [[barracks]] or train at [[archery target|archery targets]] with wooden or bone bolts.

You may wish to design outdoor training areas so that your soldiers do not fall prey to [[Cave adaptation]].

=== Rations ===

You may also specify if the squad should carry food and water, using [[backpack|backpacks]] and [[waterskin|waterskins]] respectively, using the military menu.

== Soldier professions ==

Every weapon has an associated skill. Soldiers will have professions according to what [[Weapon|weapon]] they are most skilled at using, as long as they are at least a novice rank in one. Thus a soldier whose highest weapon skill is with a spear will be known as a Speardwarf, even if the soldier has been reassigned to train with an axe instead.

=== [[Axeman|Axedwarves]] ===

Axedwarves, thought by some to be the only true dwarven soldier, specialize in [[slash]] damage, also known as the fine art of mangling and severing limbs. This damage type is useful for taking away opponents' mobility and means of attack while eventually causing them to bleed to death on the ground. Battle axes move slower than swords but do more damage per stroke.

=== [[Hammerman|Hammerdwarves]] ===

Hammerdwarves, the other true dwarven soldiers, specialize in [[bludgeon]] damage, which breaks the bones of the enemy and will often repel the enemy some distance, causing extra damage if they are bashed into a wall.

Human Hammermen use a two-handed maul instead of a war hammer. More powerful, mauls focus on breaking bones rather than mangling limbs, though that does also happen on the occasion. They have a greater chance to knock back an opponent than a mace does but comes at the cost of speed. Also should someone be knocked back into an obstacle, they'll take extra damage.

=== [[Maceman|Macedwarves]] ===

Macedwarves are exactly like hammerdwarves, but use a weapon with a different name and skill, though exactly the same in game terms. Assuming none of your weaponsmiths have a preference for maces, hammers are slightly better, since the hammer skill is also used by a marksman who has run out of bolts or finds an opponent in his face (he bashes enemies with his crossbow. This is the only time when it's good to have a metal crossbow, by the way.)

=== [[Spearman|Speardwarves]] ===

Speardwarves specialize in [[pierce]] damage and will puncture an enemy's organs quickly and critically once in range. The spear doesn't hit as hard as an axe, but it has a higher chance of piercing organs, making it a better choice against large, living creatures like demons or dragons.

=== [[Swordsman|Swordsdwarves]] ===

Swordsdwaves deal [[slash]] damage. Swords can cut off limbs, like an axe, but also reasonably good at hitting internal organs, like a spear.

=== [[Marksman|Marksdwarves]] ===

Marksdwarves, thought of as the wimpiest soldiers, are armed with [[crossbow|crossbows]] and deal [[pierce]] damage from afar. A [[bolt]] does a fine job at destroying the internal organs of a creature while also doing some damage to outside parts. This is of limited use against creatures without organs, such as [[Magma man|magma men]]. Occasionally a bolt will get stuck in a target. The only known use for this is that a [[wrestling]] dwarf may grab the bolt and twist it in the [[wound]].

A Marksdwarf who is forced into melee will use the [[hammer]] skill to bash enemies with their crossbow, so you may consider crosstraining them as hammerdwarves.

Immigrating [[Trapper|Trappers]] often arrive with a Novice Marksdwarf skill.

=== [[Wrestler|Wrestlers]] ===

Wrestlers focus on tying the opponent into knots, choking them, and breaking limbs. Creatures tied up in [[wrestling]] will do nothing else and remain immobile, perfect for a marksdwarf to pick off the creature at a range or an armed dwarf to carve into bite-sized pieces. Also note that this skill determines how much a dwarf will evade/dodge attacks, so it can be useful even for a dwarf with a weapon equipped. Wrestlers are much weaker than any other soldier type, but forcing powerful opponents to wrestle can exhaust them and make them easy prey for other soldiers.

Wrestler skill will be improved somewhat even while practicing with a weapon.

=== Recruits ===

Any dwarf without at least one of the above skills at [[skill|Novice]] level or higher will be classified as recruits. If you keep them off duty, they will train at their selected weapon until they reach Novice skill in it, at which point they will turn into one of the above weaponsdwarves.

== Heroes and Champions ==
[[Image:Champions.png|thumb|left|Melee goblins are no match for a champion Axedwarf.]]
Once soldiers reach ''great'' [[skill]] level ''(the 11th above "no skill")'' in any weapon (or wrestling), they will become '''heroes''', will be called Lord/Master/Elite, have a different color shade and can no longer be removed from the military. Their "Pref" menu will be replaced by the text "This hero need not work", and you will not be able to deactivate them (make them civilians again), transfer them into or out of the [[Fortress guard|Guard]], or assign work [[dog|dogs]] to them. Note that armor user skill and shield user skills ''do not'' make a hero.

You can still change their weapon and armor settings via the {{key|m}}ilitary screen ({{key|w}}eapons), and to change their soldiering orders ({{key|v}}iew squad). Heroes in either the Fortress or Royal Guard cannot be given military orders via the Squads screen ({{key|x}}) and will become permanently useless. If you have any Expert, Professional, or Accomplished soldiers in the Guard, and don't wish them to be locked into the military, transfer them out. Alternatively, a dwarf on the verge of becoming a hero in one weapon skill can be assigned another weapon and will continue training there; the attribute bonuses from gaining each weapon skill do stack. This is one method of making a legendary shield user/armor user without making a hero. Heroes cannot trade, so it is advisable for your trader not to be given military training.

Upon reaching [[Legendary|legendary]] skill level in any weapon, a hero will become a '''champion''', with the following [[announcement]]: <tt>"''<dwarfname>'' has become a legendary champion! Hail ''<dwarfname>''!"</tt>. Champions behave the same as heroes, although they are additionally exempt from the [[dwarven economy]], like all legendary dwarves. Champions cannot serve under heroes or normal soldiers, but willingly serve under other Champions.

:'''''Exception:''''' From observed behavior, it seems that if a dwarf gains Great skill (or above) in a weapons skill while a civilian (as a [[Hunter]]), they will not become a Hero (or Champion), not even when Activated ''as'' military. To become a Hero or Champion, some experience over the limit must be gained ''while'' activated as a soldier. Weapon skills can only be improved as a civilian while [[Hunting]], depending on the weapon assigned to the dwarf. If the dwarf is then activated as military and gains any experience in a weapon that is at rank 15 or better, the dwarf becomes a Champion or Hero as usual and cannot then be de-activated.

Heroes will gain a special job title related to their weapon proficiency (Hammer Lord, Axe Lord, etc.) Champions will use Champion as their job title regardless of weapon proficiency.

Once a dwarf becomes a Hero, his profession cannot change to become a hero of another weapon type and will not become a Champion until the original weapon skill reaches Legendary - for example, a Hammer Lord can train to become a Legendary Marksdwarf but will remain a Hammer Lord, only becoming a Champion once the Hammerdwarf skill is also trained to Legendary.

Only Heroes and Champions can wear [[artifact]] weapons and armor (and once they do, they will '''never''' unequip them).

----

'''See Also:'''

:* [[Weapons]]
:* [[Armor]]

{{Military FAQ}}

{{Category|Dwarves}}
{{Category|Military}}

40d:SPEC HEAT

2015-05-18T10:57:26Z

PeridexisErrant: Changed quality rating from "Unknown" to "Fine" using the rating script

{{Quality|Fine|10:57, 18 May 2015 (UTC)}}
{{av}}
This determines how long it takes the material to heat up or cool down. A material with a high specific heat capacity will hold more heat and affect its surroundings more before cooling down or heating up to equilibrium.

40d:Sphere

2015-05-18T10:57:15Z

PeridexisErrant: Changed quality rating from "Unrated" to "Fine" using the rating script

{{Quality|Fine|10:57, 18 May 2015 (UTC)}}
{{av}}
[[deity|Deities]], [[demon]]s, and [[megabeast]]s are aligned in spheres. A '''sphere''' is an aspect where a being has influence. [[Civilization]]s have sphere alignments as well.

=== Understanding spheres ===

A being such as a deity, demon and occasionally megabeast may come to represent or epitomize certain things like emotions, qualities, terrain, and items. They are called "spheres". As an example from real-world mythology, the Greek goddess [http://en.wikipedia.org/wiki/Athena Athena] is goddess in the "spheres" of wisdom, warfare, handicrafts and reason. She is therefore the goddess of wisdom.

Dwarves and other creatures will come to worship certain "powerful beings" and as such will follow that religion, and have a relationship with that "deity"

The following is according to Toady:

:''Spheres have a parent/child list, a friend list, and a preclude list. A deity has either one or two base spheres, and then they pick friends of those spheres, while never choosing a precluded or parent/child sphere of any of the spheres they already have. I tried to be pretty lax with the preclude list so that interesting relationships could pop up. There will obviously be problems and omissions and things here, since I had to match 100+ spheres together several times and no doubt made mistakes. Feel free to discuss.''

Parent/child relationships (note that a sphere can have more than one parent):
SPHERE_NATURE
SPHERE_ANIMALS
SPHERE_FISH
SPHERE_PLANTS
SPHERE_TREES
SPHERE_ART
SPHERE_DANCE
SPHERE_MUSIC
SPHERE_PAINTING
SPHERE_POETRY
SPHERE_SONG
SPHERE_BOUNDARIES
SPHERE_COASTS
SPHERE_COURAGE
SPHERE_VALOR
SPHERE_EARTH
SPHERE_METALS
SPHERE_MINERALS
SPHERE_SALT
SPHERE_WATER
SPHERE_LAKES
SPHERE_OCEANS
SPHERE_RIVERS
SPHERE_RAIN
SPHERE_WEATHER
SPHERE_LIGHTNING
SPHERE_RAIN
SPHERE_RAINBOWS
SPHERE_STORMS
SPHERE_THUNDER
SPHERE_WIND

Friend relationships:
SPHERE_AGRICULTURE
SPHERE_FOOD
SPHERE_FERTILITY
SPHERE_RAIN
SPHERE_ANIMALS
SPHERE_PLANTS
SPHERE_ART
SPHERE_INSPIRATION
SPHERE_BEAUTY
SPHERE_BEAUTY
SPHERE_ART
SPHERE_BIRTH
SPHERE_CHILDREN
SPHERE_CREATION
SPHERE_FAMILY
SPHERE_MARRIAGE
SPHERE_PREGNANCY
SPHERE_REBIRTH
SPHERE_YOUTH
SPHERE_BLIGHT
SPHERE_DISEASE
SPHERE_DEATH
SPHERE_CAVERNS
SPHERE_MOUNTAINS
SPHERE_EARTH
SPHERE_CHAOS
SPHERE_WAR
SPHERE_CHARITY
SPHERE_GENEROSITY
SPHERE_SACRIFICE
SPHERE_CHILDREN
SPHERE_BIRTH
SPHERE_FAMILY
SPHERE_YOUTH
SPHERE_PREGNANCY
SPHERE_COASTS
SPHERE_LAKES
SPHERE_OCEANS
SPHERE_CRAFTS
SPHERE_CREATION
SPHERE_LABOR
SPHERE_METALS
SPHERE_CREATION
SPHERE_CRAFTS
SPHERE_BIRTH
SPHERE_PREGNANCY
SPHERE_REBIRTH
SPHERE_DANCE
SPHERE_FESTIVALS
SPHERE_MUSIC
SPHERE_REVELRY
SPHERE_DARKNESS
SPHERE_NIGHT
SPHERE_DAWN
SPHERE_SUN
SPHERE_TWILIGHT
SPHERE_DAY
SPHERE_LIGHT
SPHERE_SUN
SPHERE_DEATH
SPHERE_BLIGHT
SPHERE_DISEASE
SPHERE_MURDER
SPHERE_REBIRTH
SPHERE_SUICIDE
SPHERE_WAR
SPHERE_DEFORMITY
SPHERE_DISEASE
SPHERE_DEPRAVITY
SPHERE_LUST
SPHERE_DISCIPLINE
SPHERE_LAWS
SPHERE_ORDER
SPHERE_DISEASE
SPHERE_BLIGHT
SPHERE_DEATH
SPHERE_DEFORMITY
SPHERE_DREAMS
SPHERE_NIGHT
SPHERE_NIGHTMARES
SPHERE_DUSK
SPHERE_TWILIGHT
SPHERE_DUTY
SPHERE_ORDER
SPHERE_EARTH
SPHERE_CAVERNS
SPHERE_MOUNTAINS
SPHERE_VOLCANOS
SPHERE_FAMILY
SPHERE_BIRTH
SPHERE_CHILDREN
SPHERE_MARRIAGE
SPHERE_PREGNANCY
SPHERE_FAME
SPHERE_RUMORS
SPHERE_FERTILITY
SPHERE_AGRICULTURE
SPHERE_FOOD
SPHERE_RAIN
SPHERE_FESTIVALS
SPHERE_DANCE
SPHERE_MUSIC
SPHERE_REVELRY
SPHERE_SONG
SPHERE_FIRE
SPHERE_METALS
SPHERE_SUN
SPHERE_VOLCANOS
SPHERE_FISH
SPHERE_OCEANS
SPHERE_LAKES
SPHERE_RIVERS
SPHERE_WATER
SPHERE_FISHING
SPHERE_FISHING
SPHERE_FISH
SPHERE_HUNTING
SPHERE_FOOD
SPHERE_AGRICULTURE
SPHERE_FERTILITY
SPHERE_FORGIVENESS
SPHERE_MERCY
SPHERE_FORTRESSES
SPHERE_WAR
SPHERE_GAMBLING
SPHERE_GAMES
SPHERE_LUCK
SPHERE_GAMES
SPHERE_GAMBLING
SPHERE_LUCK
SPHERE_GENEROSITY
SPHERE_CHARITY
SPHERE_SACRIFICE
SPHERE_HAPPINESS
SPHERE_REVELRY
SPHERE_HUNTING
SPHERE_FISHING
SPHERE_INSPIRATION
SPHERE_ART
SPHERE_PAINTING
SPHERE_POETRY
SPHERE_JEWELS
SPHERE_MINERALS
SPHERE_WEALTH
SPHERE_JUSTICE
SPHERE_LAWS
SPHERE_LABOR
SPHERE_CRAFTS
SPHERE_LAKES
SPHERE_COASTS
SPHERE_FISH
SPHERE_OCEANS
SPHERE_RIVERS
SPHERE_LAWS
SPHERE_DISCIPLINE
SPHERE_JUSTICE
SPHERE_OATHS
SPHERE_ORDER
SPHERE_LIES
SPHERE_TREACHERY
SPHERE_TRICKERY
SPHERE_LIGHT
SPHERE_DAY
SPHERE_RAINBOWS
SPHERE_SUN
SPHERE_LIGHTNING
SPHERE_RAIN
SPHERE_STORMS
SPHERE_THUNDER
SPHERE_LONGEVITY
SPHERE_YOUTH
SPHERE_LOYALTY
SPHERE_OATHS
SPHERE_LUCK
SPHERE_GAMBLING
SPHERE_GAMES
SPHERE_LUST
SPHERE_DEPRAVITY
SPHERE_MARRIAGE
SPHERE_BIRTH
SPHERE_FAMILY
SPHERE_OATHS
SPHERE_PREGNANCY
SPHERE_MERCY
SPHERE_FORGIVENESS
SPHERE_METALS
SPHERE_CRAFTS
SPHERE_FIRE
SPHERE_MINERALS
SPHERE_MINERALS
SPHERE_JEWELS
SPHERE_METALS
SPHERE_MISERY
SPHERE_TORTURE
SPHERE_MOON
SPHERE_NIGHT
SPHERE_SKY
SPHERE_MOUNTAINS
SPHERE_CAVERNS
SPHERE_EARTH
SPHERE_VOLCANOS
SPHERE_MURDER
SPHERE_DEATH
SPHERE_MUSIC
SPHERE_DANCE
SPHERE_FESTIVALS
SPHERE_REVELRY
SPHERE_SONG
SPHERE_NATURE
SPHERE_RAIN
SPHERE_SUN
SPHERE_WATER
SPHERE_WEATHER
SPHERE_NIGHT
SPHERE_DARKNESS
SPHERE_DREAMS
SPHERE_MOON
SPHERE_NIGHTMARES
SPHERE_STARS
SPHERE_NIGHTMARES
SPHERE_DREAMS
SPHERE_NIGHT
SPHERE_OATHS
SPHERE_LAWS
SPHERE_LOYALTY
SPHERE_MARRIAGE
SPHERE_OCEANS
SPHERE_COASTS
SPHERE_FISH
SPHERE_LAKES
SPHERE_RIVERS
SPHERE_SALT
SPHERE_ORDER
SPHERE_DISCIPLINE
SPHERE_DUTY
SPHERE_LAWS
SPHERE_PAINTING
SPHERE_INSPIRATION
SPHERE_PERSUASION
SPHERE_POETRY
SPHERE_SPEECH
SPHERE_PLANTS
SPHERE_ANIMALS
SPHERE_RAIN
SPHERE_POETRY
SPHERE_INSPIRATION
SPHERE_PERSUASION
SPHERE_SONG
SPHERE_WRITING
SPHERE_PREGNANCY
SPHERE_BIRTH
SPHERE_CHILDREN
SPHERE_CREATION
SPHERE_FAMILY
SPHERE_MARRIAGE
SPHERE_RAIN
SPHERE_AGRICULTURE
SPHERE_FERTILITY
SPHERE_LIGHTNING
SPHERE_NATURE
SPHERE_PLANTS
SPHERE_RAINBOWS
SPHERE_STORMS
SPHERE_THUNDER
SPHERE_TREES
SPHERE_RAINBOWS
SPHERE_LIGHT
SPHERE_RAIN
SPHERE_SKY
SPHERE_REBIRTH
SPHERE_BIRTH
SPHERE_CREATION
SPHERE_DEATH
SPHERE_REVELRY
SPHERE_DANCE
SPHERE_FESTIVALS
SPHERE_HAPPINESS
SPHERE_MUSIC
SPHERE_SONG
SPHERE_RIVERS
SPHERE_FISH
SPHERE_LAKES
SPHERE_OCEANS
SPHERE_RUMORS
SPHERE_FAME
SPHERE_SACRIFICE
SPHERE_CHARITY
SPHERE_GENEROSITY
SPHERE_SALT
SPHERE_OCEANS
SPHERE_SCHOLARSHIP
SPHERE_WISDOM
SPHERE_WRITING
SPHERE_SKY
SPHERE_MOON
SPHERE_RAINBOWS
SPHERE_SUN
SPHERE_STARS
SPHERE_WEATHER
SPHERE_WIND
SPHERE_SONG
SPHERE_FESTIVALS
SPHERE_MUSIC
SPHERE_POETRY
SPHERE_REVELRY
SPHERE_SPEECH
SPHERE_PERSUASION
SPHERE_STARS
SPHERE_NIGHT
SPHERE_SKY
SPHERE_STORMS
SPHERE_LIGHTNING
SPHERE_RAIN
SPHERE_THUNDER
SPHERE_SUICIDE
SPHERE_DEATH
SPHERE_SUN
SPHERE_DAWN
SPHERE_DAY
SPHERE_FIRE
SPHERE_LIGHT
SPHERE_NATURE
SPHERE_SKY
SPHERE_THUNDER
SPHERE_LIGHTNING
SPHERE_RAIN
SPHERE_STORMS
SPHERE_TORTURE
SPHERE_MISERY
SPHERE_TRADE
SPHERE_WEALTH
SPHERE_TREACHERY
SPHERE_LIES
SPHERE_TRICKERY
SPHERE_TREES
SPHERE_RAIN
SPHERE_TRICKERY
SPHERE_LIES
SPHERE_TREACHERY
SPHERE_TWILIGHT
SPHERE_DAWN
SPHERE_DUSK
SPHERE_VALOR
SPHERE_WAR
SPHERE_VICTORY
SPHERE_WAR
SPHERE_VOLCANOS
SPHERE_EARTH
SPHERE_FIRE
SPHERE_MOUNTAINS
SPHERE_WAR
SPHERE_CHAOS
SPHERE_DEATH
SPHERE_FORTRESSES
SPHERE_VALOR
SPHERE_VICTORY
SPHERE_WATER
SPHERE_FISH
SPHERE_NATURE
SPHERE_WEALTH
SPHERE_JEWELS
SPHERE_TRADE
SPHERE_WEATHER
SPHERE_NATURE
SPHERE_SKY
SPHERE_WIND
SPHERE_SKY
SPHERE_WISDOM
SPHERE_SCHOLARSHIP
SPHERE_WRITING
SPHERE_POETRY
SPHERE_SCHOLARSHIP
SPHERE_YOUTH
SPHERE_BIRTH
SPHERE_CHILDREN
SPHERE_LONGEVITY

Preclude relationships:
SPHERE_BEAUTY
SPHERE_BLIGHT
SPHERE_DEFORMITY
SPHERE_DISEASE
SPHERE_MUCK
SPHERE_BLIGHT
SPHERE_BEAUTY
SPHERE_FOOD
SPHERE_FERTILITY
SPHERE_HEALING
SPHERE_CHAOS
SPHERE_DISCIPLINE
SPHERE_ORDER
SPHERE_LAWS
SPHERE_CHARITY
SPHERE_JEALOUSY
SPHERE_CONSOLATION
SPHERE_MISERY
SPHERE_DARKNESS
SPHERE_DAWN
SPHERE_DAY
SPHERE_LIGHT
SPHERE_TWILIGHT
SPHERE_SUN
SPHERE_DAWN
SPHERE_NIGHT
SPHERE_DAY
SPHERE_DARKNESS
SPHERE_DAY
SPHERE_DARKNESS
SPHERE_NIGHT
SPHERE_DAWN
SPHERE_DUSK
SPHERE_DREAMS
SPHERE_NIGHTMARES
SPHERE_TWILIGHT
SPHERE_DEATH
SPHERE_HEALING
SPHERE_LONGEVITY
SPHERE_YOUTH
SPHERE_DEFORMITY
SPHERE_BEAUTY
SPHERE_DEPRAVITY
SPHERE_LAWS
SPHERE_DISCIPLINE
SPHERE_CHAOS
SPHERE_DISEASE
SPHERE_BEAUTY
SPHERE_HEALING
SPHERE_DREAMS
SPHERE_DAY
SPHERE_DUSK
SPHERE_NIGHT
SPHERE_DAY
SPHERE_FAME
SPHERE_SILENCE
SPHERE_FATE
SPHERE_LUCK
SPHERE_FERTILITY
SPHERE_BLIGHT
SPHERE_FESTIVALS
SPHERE_MISERY
SPHERE_FIRE
SPHERE_WATER
SPHERE_OCEANS
SPHERE_LAKES
SPHERE_RIVERS
SPHERE_FOOD
SPHERE_BLIGHT
SPHERE_FORGIVENESS
SPHERE_REVENGE
SPHERE_FREEDOM
SPHERE_ORDER
SPHERE_HAPPINESS
SPHERE_MISERY
SPHERE_HEALING
SPHERE_DISEASE
SPHERE_BLIGHT
SPHERE_DEATH
SPHERE_JEALOUSY
SPHERE_CHARITY
SPHERE_LAKES
SPHERE_FIRE
SPHERE_LAWS
SPHERE_CHAOS
SPHERE_DEPRAVITY
SPHERE_MURDER
SPHERE_THEFT
SPHERE_LIES
SPHERE_TRUTH
SPHERE_LIGHT
SPHERE_DARKNESS
SPHERE_TWILIGHT
SPHERE_LONGEVITY
SPHERE_DEATH
SPHERE_LOYALTY
SPHERE_TREACHERY
SPHERE_LUCK
SPHERE_FATE
SPHERE_MERCY
SPHERE_REVENGE
SPHERE_MISERY
SPHERE_CONSOLATION
SPHERE_FESTIVALS
SPHERE_REVELRY
SPHERE_HAPPINESS
SPHERE_MUCK
SPHERE_BEAUTY
SPHERE_MURDER
SPHERE_LAWS
SPHERE_MUSIC
SPHERE_SILENCE
SPHERE_NIGHT
SPHERE_DAY
SPHERE_DAWN
SPHERE_DUSK
SPHERE_TWILIGHT
SPHERE_NIGHTMARES
SPHERE_DAY
SPHERE_OATHS
SPHERE_TREACHERY
SPHERE_OCEANS
SPHERE_FIRE
SPHERE_ORDER
SPHERE_CHAOS
SPHERE_FREEDOM
SPHERE_REVELRY
SPHERE_MISERY
SPHERE_REVENGE
SPHERE_FORGIVENESS
SPHERE_MERCY
SPHERE_RIVERS
SPHERE_FIRE
SPHERE_SACRIFICE
SPHERE_WEALTH
SPHERE_SILENCE
SPHERE_FAME
SPHERE_MUSIC
SPHERE_SUN
SPHERE_DARKNESS
SPHERE_THEFT
SPHERE_LAWS
SPHERE_TRADE
SPHERE_TRADE
SPHERE_THEFT
SPHERE_TREACHERY
SPHERE_LOYALTY
SPHERE_OATHS
SPHERE_TRICKERY
SPHERE_TRUTH
SPHERE_TRUTH
SPHERE_LIES
SPHERE_TRICKERY
SPHERE_TWILIGHT
SPHERE_LIGHT
SPHERE_DARKNESS
SPHERE_DAY
SPHERE_NIGHT
SPHERE_WATER
SPHERE_FIRE
SPHERE_WEALTH
SPHERE_SACRIFICE
SPHERE_YOUTH
SPHERE_DEATH

=== Basic list of Sphere tokens ===

AGRICULTURE
ANIMALS
ART
BALANCE
BEAUTY
BIRTH
BLIGHT
BOUNDARIES
CAVERNS
CHAOS
CHARITY
CHILDREN
COASTS
CONSOLATION
COURAGE
CRAFTS
CREATION
DANCE
DARKNESS
DAWN
DAY
DEATH
DEFORMITY
DEPRAVITY
DISCIPLINE
DISEASE
DREAMS
DUSK
DUTY
EARTH
FAMILY
FAME
FATE
FERTILITY
FESTIVALS
FIRE
FISH
FISHING
FOOD
FORGIVENESS
FORTRESSES
FREEDOM
GAMBLING
GAMES
GENEROSITY
HAPPINESS
HEALING
HOSPITALITY
HUNTING
INSPIRATION
JEALOUSY
JEWELS
JUSTICE
LABOR
LAKES
LAWS
LIES
LIGHT
LIGHTNING
LONGEVITY
LOVE
LOYALTY
LUCK
LUST
MARRIAGE
MERCY
METALS
MINERALS
MISERY
MIST
MOON
MOUNTAINS
MUCK
MURDER
MUSIC
NATURE
NIGHT
NIGHTMARES
OATHS
OCEANS
ORDER
PAINTING
PEACE
PERSUASION
PLANTS
POETRY
PREGNANCY
RAIN
RAINBOWS
REBIRTH
REVELRY
REVENGE
RIVERS
RULERSHIP
RUMOR
SACRIFICE
SALT
SCHOLARSHIP
SEASONS
SILENCE
SKY
SONG
SPEECH
STARS
STORMS
STRENGTH
SUICIDE
SUN
THEFT
THRALLDOM
THUNDER
TORTURE
TRADE
TRAVELERS
TREACHERY
TREES
TRICKERY
TRUTH
TWILIGHT
VALOR
VICTORY
VOLCANOS[sic]
WAR
WATER
WEALTH
WEATHER
WIND
WISDOM
WRITING
YOUTH

{{Category|Modding}}