Dwarf Fortress Wiki - User contributions [en]

v0.31:Controls guide

2011-03-06T10:01:48Z

Shenzahn: /* Civilizations, c */ removed excess ")"

{{quality|Fine|02:55 08 November 2010 (UTC)}}{{av}}
This is a beginner's guide to Fortress Mode interface {{L|controls}}. This page assumes the default {{L|key binding|key bindings}}.

As a beginner it is recommended that you familiarize yourself with the '''(View Unit - Preferences - Labor)''' submenu, the '''Query buildings''' menu, the '''Designate''' menu, and the '''Build''' menu.

==Viewing menus==
There are 5 menus for gaining more information about the map and the creatures that inhabit it. When used a yellow X-shaped cursor appears which you can move around the map using the numberpad to gain information.

===Look Around, k===
The loo{{k|k}} command shows you individual map tiles and what is standing/resting upon them. The menu displays {{L|Creatures}}, Objects, {{L|Building|Buildings}}, {{L|Map tile}}s in that order. You can use the {{k|+}} {{k|-}} keys to browse these things and press {{k|Enter}} to gain more detailed information.

You can also designate an item to be {{L|forbid|forbidden}}, {{L|dump|dumped}}, or {{L|melt|melted}} from this menu, if it is allowed (You can't designate a loaf of bread to be melted, for example!).

===View Units, v===
The {{key|v}}iew command gives detailed information on creatures: a {{L|dwarf}}, an {{L|creature|animal}}, a {{L|goblin}}, etc. You do not need to place the cursor directly over the creature, information is given on the nearest creature. If multiple creatures are the same distance from the cursor (usually due to occupying the same tile), use {{key|v}} to cycle through them.

This command has several different menu views:
* {{key|g}} General - Name, occupation, {{L|attributes}} and {{L|skill|skills}}.
* {{key|i}} Inventory - Shows all the items the creature is carrying. Also shows the bloodstains, mud and goo that accumulates on creatures.
* {{key|w}} {{L|Wound|Wounds}} - Shows the creature's health. Bright white means the body part is unharmed. Effects like "Thirsty" and "Unconscious" are also listed here.
* {{key|p}} Preferences - This menu includes a number of sub-menus:
** {{key|l}} Labor - This lists which types of {{L|job|jobs}} the dwarf will accept. Very important for controlling their behavior.
** {{key|e}} Work Dogs - Assign {{L|Animal training|trained}} {{L|dog|dogs}} to this dwarf.
** {{key|s}} Soldering and Hunting - Change the dwarf's {{L|weapon}} and {{L|armor}} choices.
** {{key|A}} Activate/Deactivate dwarf - Draft the dwarf into the {{L|military}}.
** {{key|z}} View Profile - Views a dwarf's profile. From here, you can view {{L|thought|thoughts}} and {{L|preference|preferences}}, view his {{L|relationships}}, and give him a custom nickname or profession title. (see also {{L|Technical tricks#The look of the game|Technical tricks}}.)
** {{key|R}} Royal Guard - Make the dwarf a {{L|Royal Guard}}, or remove him from the guard if he already is one.
** {{key|C}} Fortress Guard - Make the dwarf a {{L|Fortress Guard}}, or remove him from the guard if he already is one.

===Query Rooms/Buildings, q===
The {{k|q}}uery command allows you to {{k|s}}uspend construction of a room or object, mark it for {{k|r}}emoval, or interact with its specific functionality.
*If you query a {{L|workshop}} you can change what tasks are being worked on, set a particular task to repeat or be suspended, or change who is allowed to use the workshop.
*If you query a piece of {{L|furniture}} you can define a {{L|room}} from it (e.g. a {{L|bed}} into a {{L|bedroom}}, a {{L|chair}} into an {{L|office}}, etc). Depending on the type of furniture there are additional options (e.g. a {{L|door}} can be locked, a {{L|coffin}} can be used for either {{L|pet}} or citizen burial).
*You can also assign a {{L|room}} to belong to a specific dwarf.
*If you query a {{L|farm plot}} you can change what crops are being planted.
*If you query a {{L|stockpile}} you can change what types of objects are stored there, how many {{L|barrel|barrels}} are used, etc.

===View items in buildings, t===
The i{{key|t}}ems command is used to see items that are inside buildings, such as {{L|workshop|workshops}}, {{L|Trade depot|depots}}, and {{L|trap|traps}}.

===Squads, s===
{{k|s}} This command is used to control your military squads. The options are:{{verify}}
*{{k|l}} Lock on squad - Instead of selecting the squad nearest the cursor this squad will remain selected.
*{{k|p}} Add a patrol route - Add a series of points and the squad will walk around them.
*{{k|x}} Delete patrol route - Self-explanatory.
*{{k|s}} Station squad - The squad will congregate around the point you define. This is overridden if they have a patrol route.
*{{k|z}} Zoom to commander - Self-explanatory.
*{{K|+}}/{{K|-}} Lock on another squad - change which squad you have selected.

=Order your Dwarves=

These commands affect what your dwarves do. These also use the cursor.

==Build, b==
Use this command to {{key|b}}uild rooms, place {{L|furniture}}, start {{L|Farm plot|farm}} plots, and such. In addition to a long list of items which can be scrolled through with the {{k|+}}/{{k|-}} keys, there are also a few sub-menus:
*{{key|w}} '''{{L|Workshop|Workshops}}'''
*{{k|e}} '''{{L|Furnace|Furnaces}}'''
*{{key|C}} '''{{L|Construction}}'''
*{{key|T}} '''{{L|Trap|Traps}}'''
*{{key|M}} '''{{L|Machine component|Machine components}}'''

==Designate, d==
{{key|d}} Use this to mark stone to be {{L|mine|mined}} out, trees to be cut, {{L|plant|plants}} to be gathered, walls and floors to be smoothed or {{L|engrave|engraved}}, and so on. You can also {{L|forbid}}, {{L|dump}}, {{L|melt}} or hide items and rooms.

==Stockpile, p==
{{key|p}} Used to create {{L|stockpile|stockpiles}}.

==Zones, i==
{{key|i}} Mark an {{L|activity zone}} for drinking {{L|water}}, {{L|fishing}}, {{L|dump}}, a pit or pond, {{L|meeting hall}} or {{L|sand}} collection. This interface is the reverse of designate and stockpile commands: you mark out the rectangular area first, and define what it does afterward.

=Fortress Information=

These commands take you away from the map, to an informational screen. Some of them also let you give orders.
==Announcements, a==
{{key|a}} This screen logs the announcements that appear at the bottom of the screen. Use it to see any you missed, or scroll up the early history of your fortress.

==Civilizations, c==
{{key|c}} A list of other civilizations that you have personally encountered (and thus within distance for {{L|trade}} or {{L|siege|war}}). Civilizations are marked with a ''P'' if you are at peace with them, or with a ''W'' if you are at war. Pressing {{key|Tab}} lets you check total exports and imports, and standing trade agreements.

==Unit List, u==
{{key|u}} A list of every creature on the map. Dwarves are listed first, then {{L|tame}} animals, then hostile creatures, then wild animals. Even dead creatures are listed here, so you can track your fallen dwarves.
* {{key|c}} '''Zoom to Creature''' This takes you to [[#View_Units.2C_v|View Creature]] mode, with the cursor centered on the selected creature.
* {{key|v}} '''View Profile'''
* {{key|b}} '''Zoom to Building''' Takes you to the {{L|building}} associated with the the dwarf's current task. For hauling tasks, this is the destination {{L|stockpile}}.
* {{key|m}} '''Manager''' Takes you to the {{L|Manager#Setting_up_work_orders|job manager}} screen.

==Military, m==
{{key|m}} This is the completely revamped military screen

''Please fill in the blanks''

==Room List, R==
{{key|R}} Lists all {{L|Room|Rooms}}, {{L|Building|Buildings}}, {{L|Stockpile|Stockpiles}}, and even {{L|Activity zone|Activity zones}} in the fortress. For rooms, it includes the room's quality and the owner's name. It includes quick access to each room's {{k|q}} and {{k|t}} menus.

==Artifacts, l==
{{key|l}} A list of the {{L|artifact|artifacts}} your fortress has produced.

==Nobles & Administrators, n==
{{key|n}} Access the {{L|Nobles screen}}

==Fortress Overview, z==
{{key|z}} This screen is filled with useful information, like your fortress's net worth, and how much food and drink you have left.
* '''Animals''' A list of all tame {{L|creature|animals}} in your fort.
* '''Kitchens''' From here you can specify what {{L|food|foods}} can {{L|cook|cooked}} or {{L|brew|brewed}}.
* '''Stone''' Controls the use of {{L|ore|ores}} and {{L|economic stone|economic stones}}
* '''Stocks''' This is an in-depth listing of every item, down to every rotting rat corpse. The accuracy of the your item count depends on your {{L|bookkeeper}}.
* '''Prices''' The prices of items in the {{L|economy}}
* '''Currency''' The amount of {{L|copper}}, {{L|silver}}, and {{L|gold}} {{L|coin|coins}} you have
* '''Justice''' Shows the details of the dwarven {{L|justice}} system, once you have one.
* '''Health''' Overview of the health status of the fortress.
See {{L|Status}} for more details.

=Miscellaneous=

==Options & Orders, o==
{{key|o}} Access the {{L|Standing orders}}

==Hot keys, h==
{{key|h}} Define or redefine {{L|Hotkeys}}

{{Game Interface FAQ}}

User talk:Emi

2011-03-01T13:31:40Z

Shenzahn: /* Non-User Page Creation */ new section

Please leave new messages by pressing the new section button. It is next to the edit button, and looks like a +. Be sure to sign your message with <nowiki>~~~~</nowiki> so I know who left me the message.

== Captcha ==

The wiki system is set up to autoconfirm a user after 3 days of existence as a registered user. Once that's done, you'll never have to enter a captcha again. (also, it's not possible, even as an admin / bureaucrat to manually add a user to the autoconfirmed group, sorry) --[[User:Briess|Briess]] 07:37, 13 March 2010 (UTC)

== Contact Info ==

I'm on IRC nearly every waking moment. --[[User:Briess|Briess]] 20:13, 16 March 2010 (UTC)

==[[Template:ArticleVersion]]==
''Two dozen'' consecutive edits? "Preview" just not a possibility?--[[User:Albedo|Albedo]] 20:14, 17 March 2010 (UTC)

== cv ==
So, forgive my continuing ignorance, but once the changeover happens, "cv" will then become whatever version 2010 is, right? And if so, how do we then distinguish between redirects appropriate only to the 40d legacy articles (which are currently being "corrected" using CV) and those that should go to the then truly "current version" 2010 articles?--[[User:Albedo|Albedo]] 21:45, 21 March 2010 (UTC)

== search terms and redirects ==

So a redirect chain like Gold bars -> 40d:Gold bars -> 40d:metal is correct, don't change it. Emi
Hi. I'm ''sure'' what you meant was to ask ''"Why did you delete that?"'', and not presume to lecture me about how redirects work. And my response would be - ''"Why did you create it?"'' Because I didn't "change" it, I ''deleted'' it - and there's a difference, and a difference in the reasoning behind each.

"Gold bars" is not really a term to link from, just not appropriate for a page title. It's not a term likely to be typed in to the search window, nor is it a wiki-article title in game terms. [[Gold]] is a perfectly valid (and existing) search term, and [[bars]] are as well, but not in the sense of "gold bars", unless you are [[construction|constructing]] horizontal or vertical bars from a single '''[[bar]]''' of [[gold]] ("bars" of gold being distinct from a "bar" of gold, for better or worse). And it's not usually a policy to create redirects, even Search redirects, based on erroneous understandings of the layout of the wiki. (If so, "silver bars", "copper bars", "bismuth bronze battle axe" and "narrow giant cave spider silk trousers" could all be included by some well meaning user based on one User's example - and that's more work than I want. Or any Admin.) More, "gold bars" is plural, which breaks yet another rule. So why, pray, do we need it in the first place? Lastly, if "gold bars" ''were'' a valid search or redirect term, I would think it should redirect to either "bar", the item (to clarify what a "bar" is, gold or not), or "gold" (the [[material]], to address that aspect), rather than [[metal]], which doesn't address the actual term, but is only a generally related umbrella article - but that confusion gets back to the reason I deleted it in the first place. I didn't even notice it was you that had created that page, but if I had I would have asked you this before deleting it. So... since we're here, why ''did'' you see a need to create it in the first place?

And while we're on the subject, you seem to be fairly enthusiastic about redirecting every game term to cv:game term - even if they are NOT version specific. You may want to slow down before hitting every last one, since things like [[acronym]]s and such will then have to be tracked down and returned to mainspace existence. Several in the long, long list on [[:Category:Obsolete]] seem more than a bit suspect, but I suppose now that it's done only the new version will prove them so or not. --[[User:Albedo|Albedo]] 02:47, 27 March 2010 (UTC)
I agree that it's maybe a silly redirect, however, right now I am making sure
these redirects all work properly
Use some discretion. I saw a page marked N(ew), and it didn't belong. If you recognize it as "silly", then don't go to the trouble to perpetuate it. And allow me to make something else clear that you should understand. Before you replace a page that Admin has deleted, you should ask them "why?" first. Thanks so much for your understanding on that last point.--[[User:Albedo|Albedo]] 03:07, 27 March 2010 (UTC)
Discretion only slows down serializable tasks like the one I was doing. It's much easier to follow the
same pattern over and over and then go back and do all the stuff necessary to remove a silly redirect
So you are going to cover all those "silly" redirects that require it? Reassuring to hear - so long as someone has it covered, no problem then.--[[User:Albedo|Albedo]] 03:18, 27 March 2010 (UTC)
Also, because there's no real reason not to have most of these redirects, it's silly to bother
checking each one before fixing them. If the admins at this wiki are of the "I'm an admin, so my
word is law" attitude, I'm not sure this is a place I want to be.
If that were the case, I would have simply acted high-handed and slapped you and not explained my reasoning - but we both know I didn't, so I'm left wondering why you even mention it. Meanwhile, I'm still waiting for ''your'' reason for replacing the page that an Admin deleted rather than asking them why they did it. Even if you ''were'' Admin, do you think that is a good approach to the situation?--[[User:Albedo|Albedo]] 03:24, 27 March 2010 (UTC)
I didn't notice that you had deleted it until after I had recreated it.
I see.
I ask again if you use either of those other communication methods...
it's much easier to work these things out in real time.
No, sorry. And as Admin of this wiki, I feel it's important to use this format to work these things out. Which (I hope) we've now done. Readya later.--[[User:Albedo|Albedo]] 17:45, 28 March 2010 (UTC)

== Bot edit request ==

Could you change all of the non-namespace-specific article links in template pages to use [[template:L]]? This is going to be a problem soon. [[User:VengefulDonut|VengefulDonut]] 11:43, 2 April 2010 (UTC)

== EmiBot's Standing Orders ==
Will it do that daily/hourly? B/c new pages are flying up without it. I agree it's overly long, and I thought about that, but it'll only be long for these first few days, until the immediate flurry has calmed a bit, then we back off. Right now, it's amateur hour out there, so any help is a good thing in those directions. (No automatic fixes? Urgh -that's a LOT of manual...) :P --[[User:Albedo|Albedo]] 20:08, 2 April 2010 (UTC)<br />
Again, I find myself waiting on an answer to my question while you focus on your own agenda - still waiting, thanks.--[[User:Albedo|Albedo]] 21:06, 2 April 2010 (UTC)

==Deletion Template==
I explained my reasoning on the talk page, but in short: (1)The mod is not at all notable. (I am not willing to claim a notable mod would not deserve a page on its own, but this is a mod that adds 4 creatures and no one talks about - hardly deserving of a page). (2) There is only one relevant piece of information about this mod - where it can be found. (3) The page doesn't even include that information, and is thus useless. (4) A link to the mod on DFFD or its forum thread, and a very short blurb ("adds 4 new mega beasts") should be added to a general mod page if the mod is going to have a presence on the wiki. --[[User:Squirrelloid|Squirrelloid]] 05:43, 5 April 2010 (UTC)
:Ah, sure, i can do that. I honestly just took a stab in the dark that deletion was the right template, and didn't actually know there were options... la la la? --[[User:Squirrelloid|Squirrelloid]] 06:39, 5 April 2010 (UTC)

== [[Template:Alloy3]] ==

I wasn't sure who to mention this to, and I apologize if it has already been noted, but this template is in use on 40d pages while the link built into the template for [[construction]] links to the "2010" namespace. Not sure what the best way to fix it would be, as I assume that the template will continue to be used. --[[User:Soy|Soy]] 16:10, 5 April 2010 (UTC)
:Thanks for looking into that! However, it looks like this is going to be an issue with a lot of the existing templates that are used across both versions. I think I see what your fix does and if I get some free time this evening I would be happy to try to update what I can find unless you can think of any negative impact it would have. -- [[User:Soy|Soy]] 19:32, 5 April 2010 (UTC)

==nm==
Yeah, I spoke before I read his talk page. And I remembered it as CMD. And he's right in that that's how it "should" be - the fact that it's not how it is in-game just an awkward DF reality. Altho', I see it as a style issue, not a coding issue.--[[User:Albedo|Albedo]] 02:36, 8 April 2010 (UTC)
I probably still would have argued for Cmd with a redirect from CMD.
That's not an issue to take up over one page - that's a global style issue, and would change the established, existing guidelines on [[Dwarf_Fortress_Wiki:Community_Portal]]. (Not that I wouldn't mind seeing some change, but (unsurprisingly) mine are style-based critiques.) --[[User:Albedo|Albedo]] 02:39, 8 April 2010 (UTC)

== JS ==

Thanks! :) [[User:Mason11987|Mason]] <sup>([[User talk:Mason11987|T]]-[[Special:Contributions/Mason11987|C]])</sup> 01:39, 9 April 2010 (UTC)
== IRC ==
my firewall is dumb on windows, so I can't get on IRC, and I don't want to spend 3 hours figuring it out :( --[[User:Briess|Briess]] 04:42, 12 April 2010 (UTC)
:It is. It took me about a day to figure out how to unblock port 80 >< --[[User:Briess|Briess]] 06:12, 12 April 2010 (UTC)

== Ban required ==

Please ban [[Special:Contributions/74.222.1.40|74.222.1.40]]<br />
Thank you very much =)<br />
Gretings --[[User:Used|Used]] 08:12, 16 June 2010 (UTC)
:Also [[Special:Contributions/121.205.89.153|121.205.89.153]]. --[[User:Quietust|Quietust]] 16:23, 16 June 2010 (UTC)
::Even better: semi-protect [[Dwarf Fortress Wiki talk:Centralized Discussion‎]] so that only logged-in users can edit it. --[[User:Quietust|Quietust]] 16:25, 16 June 2010 (UTC)

Easiest of all: just go to [[Dwarf Fortress Wiki:Spamreport‎]] and ban all of the bots listed. Whenever another one shows up, I'll let you know. --[[User:Quietust|Quietust]] 21:52, 18 June 2010 (UTC)
:Personally, i would've gone for a template that marks an ip, or user. Maybe like it being called UserReport, or Report, and then people could do the template thing to report a user. Not sure how that could be coded in, but it could allow administrators to be more warned and prepared to provide a look at the ip. To be honest, all these spambots are just strange. Also, deja vu, i could've sworn this happened in the exact same way before. Maybe another wiki... --[[User:Hugna|Hugna]] 22:47, 18 June 2010 (UTC)

== Bug in rate script ==

There's a bug in [[User:Emi/review.js]] - it's always putting the exact same timestamp: "08:00, 22 May 2010 (UTC)". --[[User:Quietust|Quietust]] 23:36, 5 August 2010 (UTC)
:Can't believe I didn't notice that before. It's fixed now. :) [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 21:10, 6 August 2010 (UTC)

The rating script stopped working for me. Could have something to do with maintenance? --[[User:MathFox|MathFox]] 16:49, 22 September 2010 (UTC)
:Specifically, it gets to "Getting token..." and then seems to hang. --[[User:Quietust|Quietust]] 17:44, 22 September 2010 (UTC)
::Oh, API probably wasn't re-enabled. Gotta wait for Briess on this one. [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 19:33, 22 September 2010 (UTC)

== Broken quality tags ==

The quality tags are no longer showing up in the right place - they show up in the upper-left corner of the article body (just below the title) instead of the upper-right corner of the page (aligned with the title). --[[User:Quietust|Quietust]] 23:15, 21 September 2010 (UTC)
:Currently quality tags show up in the upper-right corner for me. --[[User:Another|Another]] 10:57, 22 September 2010 (UTC)
::Yeah, they were stealth-fixed shortly after I posted this comment (and the reply was posted on my own user page rather than here). --[[User:Quietust|Quietust]] 12:39, 22 September 2010 (UTC)

== Confirm e-mail address throwing and error ==

I got the following when trying to confirm my email address:

''Confirm e-mail address

''Dwarf Fortress Wiki could not send your confirmation mail. Please check your e-mail address for invalid characters.

''Mailer returned: mailer error

Thanks for your time and effort. --[[User:Jwest23|Jwest23]] 14:41, 22 September 2010 (UTC)

== Main page is unavailable ==

Does no one uses it?

<s>I'd like to add that changing the version and creating the new Mirrors and Release Information pages don't work and show red links.</s> Nvm, it works now --Dorf2

== The Grimoire of Armok ==

Hey, http://www.bay12forums.com/smf/index.php?topic=77327.0 is the topic this is based on.

essentialy, were going to try make a Grimoire of Armok, and we need an online page for it to be stitched together and to eventualy host the completed version, do you mind if i use the Magma wiki? its a community work in progress, so i hope it can have a place on here.

Best regards: Karakzon
also whats with the 12:03, 15 February 2011 (UTC) thing?

: I'm not completely sure if this is the sort of thing that belongs on dfwiki, let me get back to you on it, okay? Also, if you type exactly four tildes like <nowiki>~~~~</nowiki> it will create a signature that consists of a link to your user page and a timestamp, similar to this -> [[user:Emi|<span style="color:#8a4e4e">Emi</span>]] [[user_talk:Emi|<span style="color:#6a3e4e">[T]</span>]] 04:08, 16 February 2011 (UTC)

== DF2010:Release information/0.31.19 and Template:News/Mirrors/0.31.19 ==

New version! Updated what I could, but that's stuff I can't. --[[User:Gamildum|Gamildum]] 15:16, 16 February 2011 (UTC)

== Rails Project ==

I'm experienced with rails (been using it a few years) and am interested in a dfwiki project

[[User:JimboOmega|JimboOmega]] 19:18, 16 February 2011 (UTC)

== Magmawiki ==

Went there, browsed around - it seems like a rails backed wiki without any real content (and a few of the familliar "something went wrong" rails pages).

What are you looking for...?

== Magmawiki ==

Looks pretty cool. How can I help? My email address is (my user name) @ gmail.com

== User Page Request ==

Posting here to request the creation of my user page, per the Site Announcements, primarily as a persistent workspace. Thanks in advance [[User:Valkyrie|Valkyrie]] 22:05, 22 February 2011 (UTC)

== Dwarven Bathtub ==

I, err, don't play the ANSI version. Only tried it once for about five minutes. Ever since then, I've downloaded versions with the graphics pre-installed. So I'm not sure what a Dwarven Bathtub looks like if you use the default tiles? The image is only used on the {{L|cleaning}} page, so it's not like there's a lot to change, though. The only thing I'm sure about is that the ramps are the same in both. [[User:Uristocrat|Uristocrat]] 09:16, 1 March 2011 (UTC)

== Non-User Page Creation ==

I would like a category created called "Flowchart" so as to categorize pages like http://df.magmawiki.com/index.php/File:MetalIndustry3.jpg or http://df.magmawiki.com/index.php/From_Caravan_to_Happy_Dwarves

Thank you. [[User:Shenzahn|Shenzahn]] 13:31, 1 March 2011 (UTC)

v0.31:Cheating

2011-03-01T13:23:05Z

Shenzahn: /* Raw Editing */

{{quality|Fine|23:58, 11 November 2010 (UTC)}}{{av}}

{{mod}}

'''Cheating''' is altering the game to make dwarf fortress easier. This is distinctly different from [[exploits]]. There are two main ways to alter the game: changing the game's raw source files (which are really just text files), and directly altering the game's memory (which requires special tools).

=Raw Editing=

Raw files are located in the raw/objects directory

The most common use of editing raw files is to get free items, such as gems, adamantine, or flux.

When changing the raw files, you may or may not need to create a new world in order for your changes to be reflected.

Generally speaking, ''modifications'' to an existing entry in a raw file don't require a new world. Altering existing reactions or creatures is an example of this.

However, when adding or deleting entries, you need to create a new world for the changes to take place, and when deleting, it can and probably will render your old world unplayable as attempting to play worlds generated before the deletion will cause an error.

[[Shaostoul%27s Guide]] contains several cut & paste examples for editing raw files specifically for the purpose of cheating.

==Creature Token Modifications==
Modifying creature files does not require the creation of a new world. You can modify the physical attributes of a creature, make animals tamable and trainable, make your dwarves into short little bearded terminators, and much more.

Instructions for use*:

1) Open creature_standard.txt
2) Find dwarven (or other creature) stats, which ought to resemble the sets below.
3) Delete those stats and replace with the new set.
4) Done.

*Notepad++ is recommended for altering raw files.

===Speedy Dwarves===
Getting bored with slow dwarves?

Go into the creature_standard file and add the [SPEED:1] in somewhere in the top section of the entry.(or SPEED:0 if you're up to some psychedelic light speed traveling)

This will make your dwarves do the majority of their actions '''''super''''' fast, including moving, digging and workshop actions.

This may, ironically, lower FPS when a high population is present, but no more than what doing many actions at once would.
To avoid this, add [SPEED:3] instead.
(Warning, editing this in may cause the game to crash or freeze for a few seconds. {{Verify}})

===No Needs Dwarves===

Not wanting to care for your dwarves? simply add [NO_EAT], [NO_SLEEP], and [NO_DRINK] to your dwarves' raws and never care for them again. (Warning when editing [NO_SLEEP], because sometimes dwarves will rest and just never wake up{{Verify}})

As an added bonus, try adding [NOFEAR], [NOBREATHE], [NOSTUN], [NONAUSEA], [NOPAIN], [NO_DIZZINESS], [NO_FEVERS], and [NOEXERT] as well.

(Warning, editing this may cause the game to crash.{{Verify}})

Other potential problems include but are not limited to unhappiness due to never drinking any booze, and insane dwarves with no viable avenues for suicide; not that they can't be [[Unfortunate_accident|assisted in such endeavors]].

* Removing the [ALCOHOL_DEPENDENT] tag should alleviate the problem of unhappiness due to never drinking booze.

===Pets for everyone===
Ever want Cave dragons, Giant cave spiders, or even Helmet snakes for pets?<br />
Simply add [PET] and [COMMON_DOMESTIC] to the creature of your choice then generate a new world. Enjoy killing the local elephant population with your army of Giant cave spiders.
Also if you want them to not be caged, cut out their raw file and transfer it to the bottom part of the creature_domestic.txt file and change the [FANCIFUL] token into the [NATURAL] token

''Note: Pets may be '''expensive'''. '' Which is why you set [PETVALUE:1]

===Tinkering with the Dwarven Soul===
By messing with the soul of a dwarf, you can drastically increase attributes and learning rates. Below is notes and a copy-paste section of text that you can use in the creature_standard.txt file, in which you replace the existing dwarf attributes. You can also utilize this code with the Castes, if you want to specify what parts of your society get what. The most easily adjustable portion of the castes is with the Males and Females.

Please note that in v31.03 of Dwarf Fortress, most of the mental attributes and Skill_Rate's learning speed is broken. This should change after the Merge, since Toady will be able to correct bugs and fully implement the Soul system.

ATT_RANGE dictates the level of effectiveness a being receives in an ability. 5,000 is the max. Please note that the elves get "5,000" in the memory stat, for the entire range. Humans get a default of 1,000, and presumably the same goes for any other creature that doesn't have a specified range.

Below, the ATT_RATES tag basically determines how quickly you gain and lose an attribute. The first value indicates cost. The lower it is, the better. The other values are for dictating the rate of decay, so keeping them at "NONE" basically nullifies that aspect. Don't use "0" for the first value, it crashes the game. Default for the first value is 500. If there is no number, the default will be used. I believe that you can use negative numbers, which further increases the gain of attributes, since the ceiling to the next attribute level is lowered by the negative percentage you use.

ATT_RATES (Default is 500:2:3:2]
* ATTRIBUTE Token
* cost to improve
* unused counter rate
* rust counter rate
* demotion counter rate

[PHYS_ATT_RATES:STRENGTH:-5000:NONE:NONE:NONE]

The game comes pre-stocked with several sets of attribute ranges, some better than others. The signs that come after the numeral ranges indicate what level that range represents, but has no effect in of themselves.

0:0:0:0:0:0:0] unattainable

0:100:200:300:400:450:500] ---

0:400:600:750:800:900:1100] --

150:600:800:900:1000:1100:1500] -

450:950:1150:1250:1350:1550:2250] +

700:1200:1400:1500:1600:1800:2500] ++

1250:1500:1750:2000:2500:3000:5000] +++

5000:5000:5000:5000:5000:5000:5000] max

Skill rates is a tag that grants you a % of skill improvement. The first number is the percentage, while the last three slots indicate decay. Furthermore, I believe that it is capped at 5,000%. Default is 100, but creatures with Slow Learner tag will get half of that. The skill acceleration doesn't work currently, which is believed to be a bug. The information here is a placeholder until that is corrected.

SKILL_RATE (Default is 100:8:8:16]
* % of improvement points you get
* unused counter rate
* rust counter rate
* demotion counter rate

[SKILL_RATES:5000:NONE:NONE:NONE]

PHYS_ATT_CAP_PERC
MENT_ATT_CAP_PERC

The default value is 200% of a dwarf's median+starting stats. This tag caps the amount of improvement to be had in an attribute. Below, I have cranked it up to 5,000%, hoping that it would let all dwarves achieve maximum attributes.

ex
[PHYS_ATT_CAP_PERC:STRENGTH:5000]
[MENT_ATT_CAP_PERC:FOCUS:5000]

<div style="height:200px; overflow:scroll;">
[SKILL_RATES:5000:NONE:NONE:NONE]
[PHYS_ATT_RANGE:STRENGTH:1250:1500:1750:2000:2500:3000:5000] +++
[PHYS_ATT_RATES:STRENGTH:-5000:NONE:NONE:NONE]
[PHYS_ATT_CAP_PERC:STRENGTH:5000:NONE:NONE:NONE]
[PHYS_ATT_RANGE:TOUGHNESS:1250:1500:1750:2000:2500:3000:5000] +++
[PHYS_ATT_RATES:TOUGHNESS:-5000:NONE:NONE:NONE]
[PHYS_ATT_CAP_PERC:TOUGHNESS:5000:NONE:NONE:NONE]
[PHYS_ATT_RANGE:AGILITY:1250:1500:1750:2000:2500:3000:5000] +++
[PHYS_ATT_RATES:AGILITY:-5000:NONE:NONE:NONE]
[PHYS_ATT_CAP_PERC:AGILITY:5000:NONE:NONE:NONE]
[PHYS_ATT_RANGE:ENDURANCE:1250:1500:1750:2000:2500:3000:5000] +++
[PHYS_ATT_RATES:ENDURANCE:-5000:NONE:NONE:NONE]
[PHYS_ATT_CAP_PERC:ENDURANCE:5000]
[PHYS_ATT_RANGE:RECUPERATION:1250:1500:1750:2000:2500:3000:5000] +++
[PHYS_ATT_RATES:RECUPERATION:-5000:NONE:NONE:NONE]
[PHYS_ATT_CAP_PERC:RECUPERATION:5000]
[PHYS_ATT_RANGE:DISEASE_RESISTANCE:1250:1500:1750:2000:2500:3000:5000] +++
[PHYS_ATT_RATES:DISEASE_RESISTANCE:-5000:NONE:NONE:NONE]
[PHYS_ATT_CAP_PERC:DISEASE_RESISTANCE:5000]
[MENT_ATT_RANGE:FOCUS:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:FOCUS:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:FOCUS:5000]
[MENT_ATT_RANGE:CREATIVITY:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:CREATIVITY:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:CREATIVITY:5000]
[MENT_ATT_RANGE:PATIENCE:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:PATIENCE:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:PATIENCE:5000]
[MENT_ATT_RANGE:MEMORY:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:MEMORY:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:MEMORY:5000]
[MENT_ATT_RANGE:SPATIAL_SENSE:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:SPATIAL_SENSE:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:SPATIAL_SENSE:5000]
[MENT_ATT_RANGE:EMPATHY:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:EMPATHY:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:EMPATHY:5000]
[MENT_ATT_RANGE:MUSICALITY:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:MUSICALITY:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:MUSICALITY:5000]
[MENT_ATT_RANGE:ANALYTICAL_ABILITY:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:ANALYTICAL_ABILITY:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:ANALYTICAL_ABILITY:5000]
[MENT_ATT_RANGE:LINGUISTIC_ABILITY:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:LINGUISTIC_ABILITY:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:LINGUISTIC_ABILITY:5000]
[MENT_ATT_RANGE:INTUITION:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:INTUITION:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:INTUITION:5000]
[MENT_ATT_RANGE:WILLPOWER:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:WILLPOWER:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:WILLPOWER:5000]
[MENT_ATT_RANGE:SOCIAL_AWARENESS:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:SOCIAL_AWARENESS:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:SOCIAL_AWARENESS:5000]
[MENT_ATT_RANGE:KINESTHETIC_SENSE:1250:1500:1750:2000:2500:3000:5000] +++
[MENT_ATT_RATES:KINESTHETIC_SENSE:-5000:NONE:NONE:NONE]
[MENT_ATT_CAP_PERC:KINESTHETIC_SENSE:5000]
</div>

===No More skill loss===
Are you tired of your dwarfs having red stats after a few years? If so, try adding this mod by [http://www.bay12forums.com/smf/index.php?topic=61016.0 LordSnow] to df_folder/data/save/region/raw/objects/creature_standard.txt in the "dwarf" section.

<div style="height:200px; overflow:scroll;">
Phys/Ment rate default: 500
[PHYS_ATT_RATES:STRENGTH:50:NONE:NONE:NONE]
[PHYS_ATT_RATES:AGILITY:50:NONE:NONE:NONE]
[PHYS_ATT_RATES:TOUGHNESS:50:NONE:NONE:NONE]
[PHYS_ATT_RATES:ENDURANCE:50:NONE:NONE:NONE]
[PHYS_ATT_RATES:DISEASE_RESISTANCE:50:NONE:NONE:NONE]
[PHYS_ATT_RATES:RECUPERATION:50:NONE:NONE:NONE]

[MENT_ATT_RATES:ANALYTICAL_ABILITY:50:NONE:NONE:NONE]
[MENT_ATT_RATES:CREATIVITY:50:NONE:NONE:NONE]
[MENT_ATT_RATES:EMPATHY:50:NONE:NONE:NONE]
[MENT_ATT_RATES:FOCUS:50:NONE:NONE:NONE]
[MENT_ATT_RATES:INTUITION:50:NONE:NONE:NONE]
[MENT_ATT_RATES:KINESTHETIC_SENSE:50:NONE:NONE:NONE]
[MENT_ATT_RATES:LINGUISTIC_ABILITY:50:NONE:NONE:NONE]
[MENT_ATT_RATES:MUSICALITY:50:NONE:NONE:NONE]
[MENT_ATT_RATES:PATIENCE:50:NONE:NONE:NONE]
[MENT_ATT_RATES:SOCIAL_AWARENESS:50:NONE:NONE:NONE]
[MENT_ATT_RATES:MEMORY:50:NONE:NONE:NONE]
[MENT_ATT_RATES:SPATIAL_SENSE:50:NONE:NONE:NONE]
[MENT_ATT_RATES:WILLPOWER:50:NONE:NONE:NONE]
</div>

===Enemy race dies in a pink cloud===
Causes all creatures of a type to go *poof* in a little pink cloud. Put this under the creature you want to never appear again. Goodbye invasions! [[DF2010:Utilities#Runesmith|Runesmith]] can also remove species easily.

[SELECT_MATERIAL:ALL]
[BOILING_POINT:0]
[STATE_COLOR:ALL:PINK]
[STATE_NAME_ADJ:GAS:poof!]

Warning: As with all cheats that involve the words "[BOILING_POINT:0]", the mist created when the creature boils will be very cold. In fact, 0 DF degrees is many thousands of real-world degrees below absolute zero. Such cold temperatures will rapidly degrade weak items like cloth and leather, and may pose a danger to dwarves caught in the cloud without adequate cold weather clothing. You might have to experiment to find a temperature that will guarantee boiling without posing a danger to your dwarves.

==Reaction Additions==
There are now two reaction files: reaction_smelter and reaction_other. Additions to these lists will not take effect until you generate a new world. Note that if you edit an existing reaction entry (leaving the [REACTION:NAME] line unchanged) rather than add a new one, you will not need to generate a new world. Don't forget to add [PERMITTED_REACTION:(reaction)] under [ENTITY:MOUNTAIN] in entity_default raw.

===Skill Practice Workshops===
A useful application of the new workshop/reaction setup is the Practice Workshop: loaded with no-reagent no-product reactions tied to every quality-based skill, it's an excellent way to get the most out of scarce resources and to train workers who utilize said resources (Jewelers, Craftsdwarves, etc).

Create a new raw called building_practice_workshop in \raw\objects, and within it paste the following (ripped nigh-straight out of Lazureus' Crematorium package):

<div style="height:200px; overflow:scroll;">
<pre>
building_practice_workshop

[OBJECT:BUILDING]

[BUILDING_WORKSHOP:PRACTICE_WORKSHOP]
[NAME:Practice Workshop]
[NAME_COLOR:7:0:1]
[DIM:3:3]
[WORK_LOCATION:2:3]
[BUILD_LABOR:MASON]
[BUILD_KEY:CUSTOM_SHIFT_P]
[BLOCK:1:0:0:0]
[BLOCK:2:0:0:0]
[BLOCK:3:0:0:0]
[TILE:0:1:' ':' ':236]
[TILE:0:2:' ':236:'/']
[TILE:0:3:'|':' ':' ']
[COLOR:0:1:0:0:0:0:0:0:0:0:1]
[COLOR:0:2:0:0:0:0:0:1:6:0:0]
[COLOR:0:3:6:0:0:0:0:0:0:0:0]
[TILE:1:1:236:' ':227]
[TILE:1:2:'|':' ':8]
[TILE:1:3:' ':' ':236]
[COLOR:1:1:0:0:1:0:0:0:0:0:1]
[COLOR:1:2:6:0:0:0:0:0:0:0:1]
[COLOR:1:3:0:0:0:0:0:0:0:0:1]
[TILE:2:1:201:227:187]
[TILE:2:2:200:8:188]
[TILE:2:3:' ':' ':' ']
[COLOR:2:1:0:0:1:0:0:1:0:0:1]
[COLOR:2:2:0:0:1:0:0:1:0:0:1]
[COLOR:2:3:0:0:0:0:0:0:0:0:0]
[TILE:3:1:201:227:187]
[TILE:3:2:200:8:188]
[TILE:3:3:150:210:253]
[COLOR:3:1:0:0:1:0:0:1:0:0:1]
[COLOR:3:2:0:0:1:0:4:1:0:0:1]
[COLOR:3:3:0:0:1:6:0:0:7:0:1]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]
</pre>
</div>

Create a new raw called reaction_practice_workshop, and within it paste the following:
<div style="height:200px; overflow:scroll;">
<pre>
reaction_practice_workshop

[OBJECT:REACTION]

[REACTION:PRACTICE_ARMORSMITHING]
[NAME:practice armorsmithing]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:FORGE_ARMOR]

[REACTION:PRACTICE_BONECARVING]
[NAME:practice bonecarving]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:BONECARVE]

[REACTION:PRACTICE_BONESETTING]
[NAME:practice bonesetting]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:SET_BONE]

[REACTION:PRACTICE_BOWMAKING]
[NAME:practice bowmaking]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:BOWYER]

[REACTION:PRACTICE_CARPENTRY]
[NAME:practice carpentry]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:CARPENTRY]

[REACTION:PRACTICE_CLOTHESMAKING]
[NAME:practice clothesmaking]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:CLOTHESMAKING]

[REACTION:PRACTICE_DIAGNOSIS]
[NAME:practice diagnosis]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:DIAGNOSE]

[REACTION:PRACTICE_DYING]
[NAME:practice dying]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:DYER]

[REACTION:PRACTICE_ENGRAVING]
[NAME:practice engraving]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:DETAILSTONE]

[REACTION:PRACTICE_GEM_CUTTING]
[NAME:practice gem cutting]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:CUTGEM]

[REACTION:PRACTICE_GEM_SETTING]
[NAME:practice gem setting]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:ENCRUSTGEM]

[REACTION:PRACTICE_GLASSMAKING]
[NAME:practice glassmaking]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:GLASSMAKER]

[REACTION:PRACTICE_GROWING]
[NAME:practice growing]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:PLANT]

[REACTION:PRACTICE_HERBALISM]
[NAME:practice herbalism]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:HERBALISM]

[REACTION:PRACTICE_LEATHERWORKING]
[NAME:practice leatherworking]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:LEATHERWORK]

[REACTION:PRACTICE_MASONRY]
[NAME:practice masonry]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:MASONRY]

[REACTION:PRACTICE_MECHANICS]
[NAME:practice mechanics]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:MECHANICS]

[REACTION:PRACTICE_METALCRAFTING]
[NAME:practice metalcrafting]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:METALCRAFT]

[REACTION:PRACTICE_METALSMITHING]
[NAME:practice metalsmithing]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:FORGE_FURNITURE]

[REACTION:PRACTICE_MINING]
[NAME:practice mining]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:MINING]

[REACTION:PRACTICE_SIEGE_ENGINEERING]
[NAME:practice siege engineering]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:SIEGECRAFT]

[REACTION:PRACTICE_SIEGE_OPERATION]
[NAME:practice siege operation]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:SIEGEOPERATE]

[REACTION:PRACTICE_STONECRAFTING]
[NAME:practice stonecrafting]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:STONECRAFT]

[REACTION:PRACTICE_SURGERY]
[NAME:practice surgery]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:SURGERY]

[REACTION:PRACTICE_SUTURING]
[NAME:practice suturing]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:SUTURE]

[REACTION:PRACTICE_WEAPONSMITHING]
[NAME:practice weaponsmithing]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:FORGE_WEAPON]

[REACTION:PRACTICE_WEAVING]
[NAME:practice weaving]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:WEAVING]

[REACTION:PRACTICE_WOODCRAFTING]
[NAME:practice woodcrafting]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:WOODCRAFT]

[REACTION:PRACTICE_WOUND_DRESSING]
[NAME:practice wound dressing]
[BUILDING:PRACTICE_WORKSHOP:NONE]
[PRODUCT:100:0:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[SKILL:DRESS_WOUNDS]
</pre>
</div>

Lastly, paste the following to their respective spots in the dwarf section of entity_default, and you're done:
<div style="height:200px; overflow:scroll;">
<pre>
[PERMITTED_BUILDING:PRACTICE_WORKSHOP]
[PERMITTED_REACTION:PRACTICE_ARMORSMITHING]
[PERMITTED_REACTION:PRACTICE_BONECARVING]
[PERMITTED_REACTION:PRACTICE_BONESETTING]
[PERMITTED_REACTION:PRACTICE_BOWMAKING]
[PERMITTED_REACTION:PRACTICE_CARPENTRY]
[PERMITTED_REACTION:PRACTICE_CLOTHESMAKING]
[PERMITTED_REACTION:PRACTICE_DIAGNOSIS]
[PERMITTED_REACTION:PRACTICE_DYING]
[PERMITTED_REACTION:PRACTICE_ENGRAVING]
[PERMITTED_REACTION:PRACTICE_GEM_CUTTING]
[PERMITTED_REACTION:PRACTICE_GEM_SETTING]
[PERMITTED_REACTION:PRACTICE_GLASSMAKING]
[PERMITTED_REACTION:PRACTICE_GROWING]
[PERMITTED_REACTION:PRACTICE_HERBALISM]
[PERMITTED_REACTION:PRACTICE_LEATHERWORKING]
[PERMITTED_REACTION:PRACTICE_MASONRY]
[PERMITTED_REACTION:PRACTICE_MECHANICS]
[PERMITTED_REACTION:PRACTICE_METALCRAFTING]
[PERMITTED_REACTION:PRACTICE_METALSMITHING]
[PERMITTED_REACTION:PRACTICE_MINING]
[PERMITTED_REACTION:PRACTICE_SIEGE_ENGINEERING]
[PERMITTED_REACTION:PRACTICE_SIEGE_OPERATION]
[PERMITTED_REACTION:PRACTICE_STONECRAFTING]
[PERMITTED_REACTION:PRACTICE_SURGERY]
[PERMITTED_REACTION:PRACTICE_SUTURING]
[PERMITTED_REACTION:PRACTICE_WEAPONSMITHING]
[PERMITTED_REACTION:PRACTICE_WEAVING]
[PERMITTED_REACTION:PRACTICE_WOODCRAFTING]
[PERMITTED_REACTION:PRACTICE_WOUND_DRESSING]
</pre>
</div>

==Easy Entity Editing==

Here is the edited entity_default raw entry. Just copy and paste everything underneath the existing entries.

<div style="height:200px; overflow:scroll;">
<pre>

[PERMITTED_REACTION:FREE_DIAMOND_FY]
[PERMITTED_REACTION:FREE_EMERALD]
[PERMITTED_REACTION:FREE_SAPPHIRE]
[PERMITTED_REACTION:FREE_DIAMOND_CLEAR]
[PERMITTED_REACTION:FREE_DIAMOND_RED]
[PERMITTED_REACTION:FREE_DIAMOND_GREEN]
[PERMITTED_REACTION:FREE_DIAMOND_BLUE]
[PERMITTED_REACTION:FREE_DIAMOND_YELLOW]
[PERMITTED_REACTION:FREE_DIAMOND_BLACK]
[PERMITTED_REACTION:FREE_RUBY_STAR]
[PERMITTED_REACTION:FREE_ADAMANTINE_THREAD]
[PERMITTED_REACTION:FREE_ADAMANTINE_WAFERS]
[PERMITTED_REACTION:FREE_WOOD]
[PERMITTED_REACTION:(reaction)]
[PERMITTED_REACTION:(reaction)]

</pre>
</div>

===Free Gems===
Fill in the name of a gem from the inorganic_stone_gem file and paste this in the reaction_smelter file to make your smelter spew out gems.
<pre>
[REACTION:FREE_(gem name here)]
[NAME:make (gem name here)]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:(gem name {from raws})]
[SKILL:SMELT]
</pre>
Note: You can change the skill used and the workshop, but make sure to keep it in the correct reaction file.
For convenience, here are all the precious gems in the game.
<div style="height:200px; overflow:scroll;">
<pre>
[REACTION:FREE_DIAMOND_LY]
[NAME: make light yellow diamonds]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:DIAMOND_LY]
[SKILL:SMELT]

[REACTION:FREE_DIAMOND_FY]
[NAME: make faint yellow diamonds]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:DIAMOND_FY]
[SKILL:SMELT]

[REACTION:FREE_EMERALD]
[NAME: make emeralds]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:EMERALD]
[SKILL:SMELT]

[REACTION:FREE_RUBY]
[NAME: make rubies]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:RUBY]
[SKILL:SMELT]

[REACTION:FREE_SAPPHIRE]
[NAME: make sapphires]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:SAPPHIRE]
[SKILL:SMELT]

[REACTION:FREE_DIAMOND_CLEAR]
[NAME: make clear diamonds]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:DIAMOND_CLEAR]
[SKILL:SMELT]

[REACTION:FREE_DIAMOND_RED]
[NAME: make red diamonds]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:DIAMOND_RED]
[SKILL:SMELT]

[REACTION:FREE_DIAMOND_GREEN]
[NAME: make green diamond]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:DIAMOND_GREEN]
[SKILL:SMELT]

[REACTION:FREE_DIAMOND_BLUE]
[NAME: make blue diamonds]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:DIAMOND_BLUE]
[SKILL:SMELT]

[REACTION:FREE_DIAMOND_YELLOW]
[NAME: make yellow diamonds]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:DIAMOND_YELLOW]
[SKILL:SMELT]

[REACTION:FREE_DIAMOND_BLACK]
[NAME: make black diamonds]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:DIAMOND_BLACK]
[SKILL:SMELT]

[REACTION:FREE_RUBY_STAR]
[NAME: make star rubies]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:RUBY_STAR]
[SKILL:SMELT]

[REACTION:FREE_SAPPHIRE_STAR]
[NAME: make star sapphires]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:ROUGH:NO_SUBTYPE:STONE:SAPPHIRE_STAR]
[SKILL:SMELT]
</pre>
</div>

===Easy Adamantine===
To get free adamantine wafers, add this to your reaction_smelter.
<pre>
[REACTION:FREE_ADAMANTINE_WAFERS]
[NAME:create adamantine wafers]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:BAR:NO_SUBTYPE:METAL:ADAMANTINE][PRODUCT_DIMENSION:150]
[SKILL:SMELT]
</pre>

For adamantine thread it would be:
<pre>
[REACTION:FREE_ADAMANTINE_THREAD]
[NAME:create adamantine thread]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:1:THREAD:NO_SUBTYPE:METAL:ADAMANTINE][PRODUCT_DIMENSION:15000]
[SKILL:SMELT]
</pre>

===Easy Flux, Sand, and Ore===
Add [REACTION_CLASS:FLUX] to any stone you have to turn it into a flux. This is in inorganic_stone_mineral, or inorganic_stone_layer Or, add [METAL_ORE:{metal name}:100] to turn it into an ore. It also bears noting that the metal can easily be an alloy, like steel or brass. Likewise, open inorganic_stone_soil and add [SOIL_SAND] to any soil to turn it into sand suitable for making glass with.

None of these cheats require creating a new world. Turn peat into glass, basalt into platinum, and combine iron, diorite, and coal to make steel.

===Easy Metal===
Open reaction_smelter and change any reactions you like. Remove the [FUEL] tag.
to make them require no fuel. Remove the line(s) headed with [REAGENT:whatever] to make them require no reagents. You can pick any metal that exists in the game, as long as you pick the right raw name. (For example: IRON, PEWTER_LAY, and NICKEL_SILVER makes iron, lay pewter, and nickle silver respectively.)
<pre>
[REACTION:FREE_(metal name here)]
[NAME:create (metal name here)]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:1:BAR:NO_SUBTYPE:METAL:(metal name {from raws})][PRODUCT_DIMENSION:150]
[SKILL:SMELT]
</pre>
These cheats do not require a new world (because they only modify existing reactions), and allow smelters to create steel and adamantine from nothing.

===Create Wood===
To create wood for free, Add this to reaction_smelter. (don't forget the wood type. Like OAK, PINE, TOWER_CAP, or FUNGIWOOD.)
<pre>
[REACTION:FREE_WOOD]
[NAME:create wood]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:5:WOOD:NO_SUBTYPE:PLANT_MAT:(wood name {from raws}):WOOD][PRODUCT_DIMENSION:150]
[SKILL:SMELT]
</pre>

===Produce Food===
To create food for free, add this to reaction_smelter.
<pre>
[REACTION:FREE_FOOD]
[NAME:produce food]
[BUILDING:SMELTER:NONE]
[PRODUCT:100:10:PLANT:NO_SUBTYPE:PLANT_MAT:(plant name {from raws}):PLANT]
[SKILL:SMELT]
</pre>

=Memory Hacking=
Memory Hacking is much harder than raw editing, and requires [[utilities|special tools]]. At present, tools that have been adapted to DF2010 include [[Utilities#Reveal|Reveal]], which allows you to see the whole map (though be warned- it also releases [[Hidden Fun Stuff]]) and [[Utilities#DFHack|DFhack]], a versatile tool which includes, among other things, a liquids hack that lets you place [[water]] or [[magma]] of a depth you choose into a square and "dfprospector," which tells you what minerals are available on the map.

v0.31:Well guide

2011-03-01T13:19:25Z

Shenzahn: /* Monsters */

{{quality|Exceptional|04:49, 17 October 2010 (UTC)}}{{av}}
''This guide assumes you've read the main article on '''{{L|well}}s''' and are familiar with the basic information found in that article, of what a well does and what is required to build one.''

A well can be vital to any fortress, but deciding that you need one and building one are two different things. Draining water from the surface can flood your fortress if you aren't careful, and building a well only to see the water source dry up or freeze is beyond frustrating. This guide will walk you through a number of different situations, and explain solutions that have been found for these problems.
If you are looking for the step by step guide: [http://df.magmawiki.com/index.php/DF2010:Well_guide#Step_by_Step]

== Why Build a Well? ==

Honestly, not every fortress NEEDS a well. But they all need some form of safe ''water source'' to bring water to patients and prisoners. If they do not have this and you find yourself in a siege with six injured dwarves, you're in for a little bit of [[fun]]... But a hole full of water can be just as good for that as a well.

=== Why You Might Not ===

1. Wells are currently a little wonky, like everything else, but in a not-so-friendly way. There are plenty of opportunities to flood a fortress through a well, and even if you don't, dwarves and animals might still occasionally fall in.

2. They take a lot of time and effort to construct, especially when compared to alternatives.

3. Because of the way wells are, a single hole in a flat ceiling, it makes it more difficult for creatures to get out, should they find themselves in your water source.

4. Technically, a trench full of water can be designated as a water source just as easily as a well, and dwarves will sanely path around such a thing, as well as bathe in it more easily.

5. If you do make a shallow pool as a water source, and have a meeting hall designated therein, unoccupied dwarves will hang out in the water, gaining swiming skill.

=== Why You Might ===

1. While a trench full of water can be used as a water source, a well can draw water from a source that is 30+ levels below. Also, a trench water source can only be one level deep, dwarves will not draw water from any level deeper than that. A well will.

2. Wells can be made to have extraordinarily high value, due to the various skills and materials, each with their own quality levels, which go into it's construction. Thus, as the center piece for a meeting room, even if they have no water, wells can be very handy in making dwarves very happy.

3. As far as the well itself goes, they take up very little space in your actual fortress. With a water-filled channel, the reservoir is equivalent to the floor space occupied.

4. This is a glitch, but wells are the easiest method for making salt water drinkable. Wells will ignore salinity and allow dwarves to drink salt water directly from its source without a glitch. So long as it isn't murky.

== Choosing a Location ==

Once you've decided it's time to construct a well, you need to consider where the well needs to be. It helps if you've been planning for this while building the rest of your fortress, and have made room for it.

You want a well central to your dwarfs, so they'll all get good thoughts from seeing it, and near any {{L|Health_care_(labor)|hospital}} beds you have, but you want it off the main traffic routes. You can have more than one well, which solves that problem, but raises the one of engineering water to feed them all. If it's indoors (or behind walls), then there's little threat from {{L|carp}}, {{L|goblins}}, or {{L|animal}}s, and it can provide a safe source of drinking water during a {{L|siege}}.

Depending on your start location, you may already have a pre-existing water source, such as a flooded cavern, which you can just build a well over. Or, as is usually the case, you may need to transport water from some other location to where you want your well to be. This is where things get complicated.

== Water sources ==

A well needs a water source of at least 3/7 depth, at least 1 {{L|z-level}} somewhere directly below it's opening, with no obstructions between itself and said water. Pre-existing water is safe because it's the most predictable - what you see is what you've got, no surprises. You can instead use dwarven engineering to bring water from a distant source to beneath your well, with a safety factor based on your experience and the complexity of the project. (See {{L|flood}}.)

The important part about the well is to make sure that you don't create a situation where the water will {{L|flood}} your fortress, due to {{L|Water_pressure|pressure}} from a source at a higher level. If the water is stable before you build the well above it, it will be safe (unless your dwarfs change things), but if you are introducing a flow, make sure you understand how pressure works and will not fall victim to its surprises. (See {{L|Water_pressure|pressure}}.)

=== Pre-existing sources ===

A {{L|brook}}, {{L|river}}, {{L|murky pool}}, or {{L|cavern}} lakes can provide water under a well. The surface of a brook tile will have to be channeled out, but it works just fine. Murky pools can dry up in warm seasons, and the well will be useless until they refill from {{L|rain}}. On hot maps, this may never happen - it's quite possible to see your murky pools (which are always full at {{L|embark}}) {{L|evaporate}} away before you ever get a chance to build a well.

Using stagnant water directly from murky pools or brooks is not optimal, as it will give dwarves negative thoughts, "Has complained about the nasty water lately". To avoid this, moving water from these places on to floor tiles that are not identified as riverbeds or ponds, and building a well over ''that'' will work just fine, so long as the final depth is 3/7 or greater.

=== {{L|Aquifer|Aquifers}} ===

If you have an aquifer, just channel a 1x1 square in any open stretch of floor above it and build the well. It will automatically fill and never flood. You'll have other construction projects to worry about.

=== {{L|Ocean|Oceans}} ===

Oceans and aquifers near oceans carry salty water. This is normally unpleasant to dwarves, but for some reason, drinking that water through a well is perfectly fine. This is a bug. But, if you really want to, it is possible to desalinate water by running it through a pump, (This is ''also'' a bug.) BUT, if that water touches any natural surfaces it will turn salty again. The floor, walls and ceiling of the aqueduct and reservoir all need to be constructed.

=== {{L|Reservoir|Reservoirs}} ===

If you need to move water to your well, you need to dig/build a reservoir. A reservoir is basically a big hole intended for the storage of large quantities of water.

When digging a reservoir, you need to consider your needs and the space you have available. Do you really need a 20x20x20 reservoir, holding 56,000 tiles of water, requiring 560,000 uses of the well to fully dry up? Frequently, in well-managed fortresses, wells are really only used for the care of sick or imprisoned dwarves and animals. As a result, it doesn't really need to be anything special, unless it's a meeting hall, in which case dwarves will drink from it at random.

Another consideration is safety. (See Below) Specifically, dwarves can fall into wells. You may wish to place some sort of escape route from the well, should anyone do so. At the least, this just needs to be a staircase going up the side of the well to the surface. The shorter the distance they need to go, the better off they are. Keep in mind, of course, that if any wildlife is able to access your reservoir, and if any of them are able to leave the water, they may wander into your fortress through the escape rout. If they're particularly malicious, they may even path their way in to attack your dwarves.

If you are filling the reservoir by aqueduct, consider the fill point. If you are using only gravity to fill the well, but the water needs to flow up to do so, you may experience problems when it comes time to refill your well. Specifically, water floods upwards into empty space very easily, but for some reason doesn't like to flood through still water. Thus, it may be more appropriate to have the reservoir fill from it's top, though keep in mind that this is a very fast fill method and can flood a bit if you aren't watching and have a small reservoir. (As a side note on that, it is possible to fill a well by pouring water directly through the well opening itself)

Finally, you may find some circumstance where you'd wish to make changes to the well. For example, building a statue in it's reservoir, or recovering a lost loved one who fell in and cracked his skull open. In these instances, you may wish to construct a manual drain. All it requires is a hatch or floodgate at the bottom of the well, connected to a lever, covering a tunnel leading to an appropriate dump site... Like your subterranean farming operation. Or your obsidian factory. Or a room full of captured <s>nobles</s> goblins. If you already have a drain for the aqueduct, you can easily connect the two.

== Filling the Well ==

If you've had to construct a well separate from a pre-existing water source, you need to move that water to the well itself. There's two main ways to go about this.

=== Bucket Filling a Well ===

If you designate your well as a pit/pond and have empty buckets, dwarves will fill the well manually. Keep in mind that this is slow, time-consuming and occupies dwarves who could be doing something else. Of course, for particularly small wells, it may be of no concern. If the walking distance is quite far, (Like STUPIDLY far- your fortress would need to be a truly tangled maze for this to happen) the water may evaporate faster than dwarves can fill the well.

=== Piping water to your reservoir ===

If the water is not where you want to build the well, you can dig a tunnel or channel and/or otherwise create an {{L|aqueduct}} to bring it to where you want it. You should consider adding a door or floodgate somewhere near the water source so that you can dry out your tunnels for future projects, repair, or recovery of lost items.

Channels are open to the sky, and if not done properly, (taking advantage of some weird quirks in game functionality) they are subject to evaporation and freezing. As a result, they aren't normally an optimal method of moving water. Of course, there's nothing stopping you from digging a moat, then filling your well from that. Keep in mind, however, that open water frequently becomes a random hazard, as dwarves can be quite careless at times. If you do have open water set up somewhere, make sure your dwarves have some way out of it. You never know when a random goblin will kick your elite stonecrafter into your moat.

Digging tunnels, then, is generally a better way of moving water from place to place. You need to be careful about how you dig such aqueducts. Water can move through diagonal openings, so be sure to avoid flooding nearby rooms from accidental corner intersections. Make sure that any unnecessary access points to your aqueduct are properly sealed before letting the water flow.

The generally accepted method for digging an aqueduct has five steps.

1. Dig out the reservoir where you want to store the water.

2. From the reservoir, dig a tunnel up to your water source, but leave one space of earth to prevent water from flooding in and killing your dwarf.

3. Build a door or floodgate in the aqueduct, either at the end of the tunnel or at the entrance to the reservoir. Or both if you're fancy. (Doors are better, because the dwarf can walk through it if he builds it from the wrong side)

4. Connect the door/floodgate to a lever, and make sure any dwarves stuck in the tunnel are safely evicted.

5. Channel out the final tile from above, pull the lever. Let the water fill the reservoir, then pull the lever again, sealing the water source.

Keep in mind, when you command the lever to be pulled to end filling, it may take some time for an available dwarf to actually do it. Even then, there is some lag time between the lever pull and the action it causes. Finally, if your plug is at some point in the aqueduct, but not at the entrance of the reservoir, any water in the aqueduct above the water level in the reservoir will continue to pour in.

If you want to empty the aqueduct, use a similar method to build a drain to some reasonable dumping location, like a carvern. Make sure you can control it with levers, however, or it will constantly drain instead of filling your well.

== Safety ==

A well is not an obstructing object. That is to say, it doesn't stop things from passing through it's space. This is why wells can function through other wells, why water will flood out of them, why a (very) few monsters may be able to climb out through them if you're tremendously unlucky, and why dwarves and animals frequently fall in.

=== Flooding ===

More fortresses have fallen at the hands of a flooding well than they have to megabeasts, seiges or demons. If you are going to be shifting water around in any form other than buckets, be prepared for the worst.

There are several solutions to the flooding problem.

1. Overflow Drainage. At the top of a reservoir, dig a tunnel to drain water out the side, and have it dump out into some appropriate sump, like a cavern full of armok-knows-what.

2. Emergency auto-plug. You can make pressure plates sense water. If you set up a pressure plate beside your well, and connect it to a hatch or door blocking your reservoir, it will automatically seal the reservoir off from it's flow source, should the thing flood.

3. No Exits. The safest and easiest way to do it, is to dig out the reservoir, ''but not the opening for the well itself''. This way, you can fill the reservoir completely, and because there's nowhere for it to flood out to, it simply WON'T! Then you can seal off the reservoir at your leisure and dig the opening without concern! (Though not without caution. Make sure you turned the taps off first.)

=== Falling ===

The main problem is that while dwarves will normally walk around random holes in the ground, a well is treated as a "passable" tile. It's what allows them to use the well itself. However, this doesn't stop them from simply walking across it's space and falling through the hole it was built over. And because there's no such thing as buoyancy or water resistance yet, dwarves fall through water at the same rate they would through air. Meaning the deeper your reservoir, the bigger the splatter they make at the bottom. The following are all suggestions which decrease the likelyhood of anyone falling into a well. Keep in mind what you want to use the well for, however. There's little point of making a high value well if nobody will ever see it.

1. Put it somewhere out of the way. If your dwarves don't have any reason to path over it, they won't fall into it.

2. Surround it with restricted traffic control. Then dwarves will be less likely to actually walk over it, even if they do go through that area.

3. Don't make it a meeting hall, or people will throw parties at it, and dwarves don't really care about traffic, when they're on break/partying/nojob, because they aren't trying to find the fastest route to their task, because they don't have a task. Also, animals like to ignore traffic control.

4. For the same reasons, don't put it ''in'' a meeting hall.

5. Don't put it in a barracks, or around other places where dwarves may be fighting for any reason, as dwarves don't look before they leap.

6. Making a well so it's at the end of a hall, with only one tile dwarves can stand on next to it, will dramatically decrease the chances of anything ever falling in. because then the only reason anything could have to go there, is to use the well, which does not involve standing ON the well.

7. Making a well's reservoir shallow, but wide, is also a good idea, I think. A wider reservoir holds a LOT of water, and takes a LONG time to dry out. If a reservoir is shallow, that means a dwarf will only fall one level or so, which can only cause momentary unconsciousness at the worst. That means your dwarves won't fall down the well, break their leg and drown.

8. Making an escape route from a well is probably also a good idea.

=== Monsters ===

You don't need to worry too much about monsters crawling out of your well to gobble down your hairy friends these days, but that doesn't mean it's impossible. It all depends on what beasts may be lurking around- and how you build your well.

First off, if you're bucket-filling a well, you need to make sure that their inital water source is safe. Make sure it isn't full of crocodiles or carp. (Or other dangerous fishy things)

If you are draining water through an aqueduct, and you know there may be dangerous animals (Or even just unwanted regular animals) living in it, there is a way to stop them from wandering in. You can place [[Grate|wall grates]], [[Bar|upright bars]], or [[Fortification|fortifications]] in the aqueduct to act as filters. These allow water to pass through, but animals cannot. It has been observed that in very rare occasions, animal may be pushed through. If you're that concerned about it (Or have HORDES of angry crocodiles in your river) putting two filters in a row pretty much eliminates any chance of this happening. If you plan to use filters in conjuction with [[Floodgate|floodgates]], remember to connect your floodgate to its trigger ''before'' placing the filters.

Even if monsters do get into your well, they're rarely a genuine threat, and at worst can give your dwarves an unhappy thought by scaring them. However, if your reservoir is filled right to the brim, carp and other fish CAN attack your dwarves, just as they would from a river. Also, any amphibious creatures may be able to use an escape passage to make their way into your fortress and make a mess. (Keep in mind, zombified fish are amphibious) And, of course, anyone who falls into a well full of predators is pretty much doomed.

To prevent amphibians from getting out of your well, should they somehow get there, simply put a lockable hatch over the escape rout.

Finally, if you are drawing directly from a cavern lake, and have simply opened a hole in it's ceiling for the well, any flying creatures in the cavern may be able to use the well as an access point to your fortress. You could potentially construct a wall surrounding the pathway of the bucket. This would prevent flying creatures from entering, unless they are also capable of swimming. Do not forget the perils of dwarves falling into a well, however, falling into a cavern lake full of cave crocodiles is quite a dangerous risk.

== Above Ground ==

The previous sections focused mostly on subterranean wells and gravity-filling reservoirs. Now we need to consider the special circumstances of wells built at ground level, above ground level, and simply outdoors.

The main problem is that anything above what was ground level at embark is considered "above ground" and has different behavior, even if enclosed to be indoors. In particular, it will freeze and evaporate according to the temperature. This includes everything on level 0 and -1, unless there is something about them preventing the temperature from removing them, like rivers flowing faster than the water can evaporate out of them.

Enclosing the water, so that it is "indoors" will decrease the rate of evaporation, but there isn't much you can do to prevent water from freezing above ground. (There is a way, but if you're new, you may not enjoy the prospects of actually constructing it. See below in style and design.)

=== Outdoor Wells ===

There are plenty of good reasons to build a well outdoors. First and foremost, to be decorative or thematic. The wells don't necessarily need to be functional if this is your intent. But another use would be as a functional source for an outdoor meeting hall... Or in other words, a vomitorium. Because dwarves will clean themselves in a well, having one in such a vomitorium would just make things more efficient!

Of course, as with any outdoor meeting place, you need to be certain that it is a safe place, where goblins and giant eagles are unlikely to descend upon your sickly party-goers.

=== On The Level ===

Now, about ground level, or specifically, the place where "above ground" and "below ground" meet. Z-levels 0 and -1 on flat maps. If you are on a very cold or very hot map, any water open to the sky on these levels will freeze or evaporate very quickly. As said before, you can minimize this by simply roofing in the water and making it "indoors".

Also keep in mind the floor type. Murky pools, even when roofed over, will behave as though they are open to the sky. This is because murky pools, rivers, oceans, etc. all have a special floor tile which modifies the behavior of any water above it. Simply putting floor tiles on the basin of a murky pool can minimize evaporation, but it will eliminate rain refill.

If you dig a channel down to z-2, the water in it will not evaporate very quickly at all, as it's "under ground".

=== In the Sky ===

And now for the final type of well, and this one is very uncommon, you may wish to build a well high above ground. A well tower may indeed be a cool, though completely non-functional idea. Be aware what the environmental conditions are before you do this, of course, as the only real way of dealing with ice involves pumping magma up the tower as well.

In all honesty, a sky well would be built and function pretty much the same as a subterranean well. The only difference is that it is very difficult to get the water up there. You need to build a pumpstack, lifting the water, level by level, pump by pump, up to your reservoir. And you need to lift the water to the top of your reservoir, as pumps will not pump upward naturally.

== Step by Step ==

A guide explaining the exact processes to go through when building the main well types and their infrastructure.

=== The Well Itself ===

So you're really new, you've read the well page, and you're still a little lost? Well, not to worry! We like our newbies! So we're gonna' show you exactly what needs to be done to just build a well from scratch. Keep in mind that a lot of this can be sped up by buying the materials at embark or from a caravan, rather than making them yourself. This is especially true with the restraint component.

Essentially, the components are: '''Rope | Bucket | Block | Mechanism'''

1. Start digging up stone. You need a dwarf with the miner skill enabled and a pickaxe. You need to dig through stone layers to get stone, as dirt yields nothing. The miner will leave rubble behind him. These are your primary building materials.

2. Start chopping down trees. You need a dwarf with the woodcutter skill enabled and a battle axe to do this. Each tree chopped down leaves a log. You'll need this for other components.

3. Set up an underground farm plot and cover it in water. It only needs a dusting of 1/7. Once it's been covered, drain it. It should now be muddy and will allow you to plant things on it. In order to plant seeds and make the farm plot, you'll need a dwarf with the grower skill enabled. Make sure you have pig tail seeds.

4. The pig tail seeds grow into pig tails, which can be processed into thread and turned into ropes for the well. Alternatively, if you run into metal ore, you can make a chain. But that process is even more complex, and there are plenty better uses for chains, so we'll stick with the rope.

5. Now you need a dwarf with the thresher skill enabled and a farmer's workshop set up. Set it to process plants. He will take any available pig tails and turn them into thread.

6. Next you need a weaver and a loom. The weaver will automatically turn thread into fabric at a loom. Yes, you need to make sheets of fabric into ropes, no it doesn't make much sense.

7. Now you need a dwarf with the clothier skill and a clothier's shop. Have the clothier make ropes. He'll use whatever fabric is available to him.

8. Have a mason make a stone block at the mason's workshop.

9. Have a carpenter make a bucket at the carpenter's workshop.

10. Have a mechanic make a mechanism at the mechanic's workshop.

11. Channel out a one-square hole in the ground. This is an example location, to show how a well is to be oriented to actually be built.

12. Build the well. It needs to be placed on the hole. Not in the hole, not above the hole, but directly on it. A well needs at least one adjacent floor tile, and must be built over empty space. Select your block, bucket, mechanism and rope. (Or chain if you went that rout)

13. Once that's done, the well designation will just sit there. You need a dwarf with the architect skill to design it. Once he's done, the appropriate worker will drop in and finish building the thing.

It takes 10 skilled dwarves and 6 workshops to build the base materials for one well from scratch. Of course, all of it's materials can simply be bought, speeding the process up a fair bit. However, keep in mind that all of it's components have value. Value which can be increased. A gem-encrusted masterpiece bucket with a gem encrusted masterpiece platinum chain, with a gem encrusted masterpiece mechanism, with legendary architectural skill and legendary construction, can be of insanely high value. As a result, you can engineer them to artificially increase the value of your fortress very quickly, once you have the infrastructure to do so.

=== Murky Pools ===

The pitfalls of using murky pools directly. We'll show you how to do it right and keep your dwarves smiling.

=== Brooks ===

Brooks are nice. We'll show you why!

=== Rivers ===

Rivers are different from brooks, in that they have things living in them and are a little more dangerous to be around.

=== Oceans ===

This explains the salinity glitch with oceans again, and discusses how to safely draw water from an ocean.

=== Aquifers ===

This section explains why the only thing aquifers are good for, are wells.

=== Flooded Caverns ===

This will discuss different methods of utilizing water from flooded caverns, specifically for the construction of a well, safely.

=== Water Falls ===

If you have a waterfall on your map, you are truly lucky. You can do so many cool things with waterfalls, it's enough to make a dwarf consider crying, just this once, maybe, if nobody's looking. But, here, we'll show some step-by-step ideas for how to use waterfalls to make awesome wells.

=== Reservoirs ===

So, you've decided you need to store water elsewhere, eh? Well, I can't blame you. Here's some discussion about the traits a reservoir can have, how to build them without trapping your dwarves, safety concerns, escape routs, and a discussion on effective filling methods.

=== Bucket Filling ===

This talks about how to go about bucket filling a well, the benefits of doing so, and the problems therein.

=== Aqueducts ===

This talks about how to build several generic aqueducts, drawing from different types of sources. Specifically, gravity-draining above-ground sources and pumping upward from subterranean sources.

=== Drainage ===

This talks about what drains are used for, why you might want them, and then how to build several types of functional drain mechanisms.

== Style and Design ==

This section discusses purely aesthetic and functional decisions people have made in the past with their wells, as well as advanced designs.

=== Fighting the Ice ===

So you have a frozen well, and you want to know how to keep it liquid do ya? You're going to need to build a heated reservoir.

First, have magma on your map. If you don't, dig deeper and be prepared for demons.

Next, you need some magma-safe materials. You'll need this to build floodgates and pumps.

Now, you need to pipe and pump the magma with the magma-safe pumping equipment. Be sure to use mechanical power for these, as dwarves are too likely to kill themselves.

The magma needs to be piped under your reservoir. That is to say, there needs to be just one floor tile between the two, just enough to keep them from touching and turning into an accidental obsidian factory.

The magma needs to be piped around under your water, it needs to keep on moving or the water will freeze again. That means it needs an infinite, cyclical flow.

And even if you get all of this built and working, it will only melt one level. Which means the reservoir can only be 1 level deep.

That's a lot of work to have an above-ground well in a frozen environment. Probably easier to melt a pool and drain it.

=== Ultimate Party Machine ===

It is possible to pour water through the mouth of a well from above. This frequently causes water to spray out in a mist, which pleases dwarves. If you power it, you could have a pump stack draw water from beneath the well and pour it back in from above, turning your fancy meeting hall into a FANCIER meeting hall! Throw in some platinum statues while you're at it.

=== Well Stacking ===

Have you ever needed to have more than one well on multiple z-levels and disliked the work of setting up multiple reservoirs? Well fret no more!

Because a well can function through the opening of another well, it's possible to stack well openings through z-levels! So long as they're all in a perfectly straight line above each other, and there's at least 3/7 tiles of water somewhere directly below them, they will all be perfectly functional!

Of course, if you go too far, this may become something of a safety concern, as dwarves would plummet mile after mile, through dozens of well openings before finally hitting the bottom.

=== Multitasking Wells ===

Because wells aren't actually USED all that often, and are usually more valuable as decorations, there isn't really any reason to keep it's reservoir completely full all the time. So, what can you do with a giant bucket of water in the middle of your fortress? Well, luckily, there are a few other reasons you could have for piping water around.

First, you need to "irrigate" underground floors before you can actually farm on them. Instead of making a separate, elaborate irrigation system for just one use, (To my knowledge, mud doesn't dry) why not just drain it out of your well?

You could also use your well as a water reservoir for an obsidian factory. Fill a chamber with a single layer of magma, then pour your well's contents over it!

You could use your well to dispose of unwanted life forms, such as siegers, elves, goblins, nobles and other miscellaneous things that wandered into your cage traps. (This only works on non-amphibious creatures)

=== The Dwarven Toilet ===

I built this in an experiment. At the top of the reservoir is a platform with a pressure plate on it. When the pressure plate senses 5/7 water, it triggers, closing the fill pipe, and opening the drain. So, when you pull the lever to fill the thing, it fills up to the top, then drains. Just like a giant toilet. I have not found any functional use for this. In all honesty, it was a simple accident I made, connecting the pressure plate to the drain as well as the plug. But, hey, what the heck, I made a giant toilet. There ya' go. Perhaps you could use this to get rid of the crud that accumulates in a well as dwarves clean themselves in it?