Dwarf Fortress Wiki - User contributions [en]

v0.31:Item quality

2011-04-22T15:15:05Z

Alarion: /* Quality grades */ fixed link for engravings.

{{av}}
{{Quality|Fine}}

== Quality grades ==

All crafted items ({{L|furniture}}, {{L|armor}}, {{L|bolts}}, etc.) – but not intermediate materials ({{L|bar}}s, {{L|block}}s, etc. except {{L|cloth}}, which does have quality levels) – are bracketed by characters that show the quality of their craftsdwarfship. Dyeing also has a quality level, as does Decorating/Encrusting (with gems, leathers, cloth, etc) and {{L|engraving}}s. Prepared foods have quality levels. Alcohol has a hidden quality rating that controls the amount of happiness a dwarf gets from drinking it.

{|
! style="padding-right: 35px;" | '''Designation''' || style="text-align: left;" | '''Description''' || style="padding-right: 20px; padding-left: 15px; text-align: center;" | '''Value <br>Modifier''' || style="text-align: center;" | ''' Weapon To-Hit /<br>Armor Deflect Modifier'''
|-
|  Item Name || style="text-align: center;" | —     || 1x || 1x || style="text-align: center;" | || style="text-align: center;" |
|-
| -Item Name- || Well-crafted || 2x || style="text-align: center;" | || style="text-align: center;" |
|-
| +Item Name+ || Finely-crafted || 3x || style="text-align: center;" | || style="text-align: center;" |
|-
| *Item Name* || Superior quality || 4x ||style="text-align: center;" | || style="text-align: center;" |
|-
| ≡Item Name≡ || Exceptional || 5x || style="text-align: center;" | || style="text-align: center;" |
|-
| ☼Item Name☼ || Masterful || 12x || 2x || style="text-align: center;" | || style="text-align: center;" |
|-
| ''Unique name'' || Artifact || 120x || 3x || style="text-align: center;" |
|}

==Changes to artifact weapons==
Toady gave us a quote on weapon and armor quality, giving the game qualities of an "artifact" in DF2010:
<div style="width: 50em; padding: 0.5em; margin-bottom: 1em; border: 1px solid #ccc; background: #eee;">
#Additional value multiplier of 10 over masterwork, so a total multiplier of 120.
#Cannot be owned (can be equipped, you might have to do it explicitly though).
#Armor deflection roll has *3 roll modifier instead of the masterwork's *2.
#Same for melee attack and archery rolls.
#It looks like the artifact edges are the maximum edge for the material, which is also what a masterwork gets, so beyond a masterwork you'd just be getting the hit roll modifier.
#Things like artifact bone spears will likely be crap against steel, yeah. We don't have actual magical artifacts yet, and that's what would be required.
</div>

v0.31:Item quality

2011-04-22T14:58:01Z

Alarion: added engravings

{{av}}
{{Quality|Fine}}

== Quality grades ==

All crafted items ({{L|furniture}}, {{L|armor}}, {{L|bolts}}, etc.) – but not intermediate materials ({{L|bar}}s, {{L|block}}s, etc. except {{L|cloth}}, which does have quality levels) – are bracketed by characters that show the quality of their craftsdwarfship. Dyeing also has a quality level, as does Decorating/Encrusting (with gems, leathers, cloth, etc) and {{L|engravings}}. Prepared foods have quality levels. Alcohol has a hidden quality rating that controls the amount of happiness a dwarf gets from drinking it.

{|
! style="padding-right: 35px;" | '''Designation''' || style="text-align: left;" | '''Description''' || style="padding-right: 20px; padding-left: 15px; text-align: center;" | '''Value <br>Modifier''' || style="text-align: center;" | ''' Weapon To-Hit /<br>Armor Deflect Modifier'''
|-
|  Item Name || style="text-align: center;" | —     || 1x || 1x || style="text-align: center;" | || style="text-align: center;" |
|-
| -Item Name- || Well-crafted || 2x || style="text-align: center;" | || style="text-align: center;" |
|-
| +Item Name+ || Finely-crafted || 3x || style="text-align: center;" | || style="text-align: center;" |
|-
| *Item Name* || Superior quality || 4x ||style="text-align: center;" | || style="text-align: center;" |
|-
| ≡Item Name≡ || Exceptional || 5x || style="text-align: center;" | || style="text-align: center;" |
|-
| ☼Item Name☼ || Masterful || 12x || 2x || style="text-align: center;" | || style="text-align: center;" |
|-
| ''Unique name'' || Artifact || 120x || 3x || style="text-align: center;" |
|}

==Changes to artifact weapons==
Toady gave us a quote on weapon and armor quality, giving the game qualities of an "artifact" in DF2010:
<div style="width: 50em; padding: 0.5em; margin-bottom: 1em; border: 1px solid #ccc; background: #eee;">
#Additional value multiplier of 10 over masterwork, so a total multiplier of 120.
#Cannot be owned (can be equipped, you might have to do it explicitly though).
#Armor deflection roll has *3 roll modifier instead of the masterwork's *2.
#Same for melee attack and archery rolls.
#It looks like the artifact edges are the maximum edge for the material, which is also what a masterwork gets, so beyond a masterwork you'd just be getting the hit roll modifier.
#Things like artifact bone spears will likely be crap against steel, yeah. We don't have actual magical artifacts yet, and that's what would be required.
</div>

User:Alarion

2010-12-20T15:59:39Z

Alarion:

{{Dwarfpage
|Title=Alarion Cagithbunem, "Alarion Cry-Soother", Student
|Thoughts=Alarion has been [[cv:Thought|happy]] lately. He was able to rest and recuperate lately. He dined in a good dining room recently. He slept in a very good bedroom recently. He was caught in a snow storm recently. He ate a fine dish lately. He talked with mother recently.
|Worship=He is a casual worshipper of Akatosh, the god of Time and Dragons.
|Citizen=He is a citizen of [http://www.wikipedia.com/wiki/Sweden The Northern Forests]. He is a member of [http://www.wikipedia.com/wiki/Stockholm The Islet of Logs] and [http://www.wikipedia.com/wiki/Uppsala The Upright Halls]. He is a [http://www.wikipedia.com/wiki/Psychologist consoler] of The Upright Halls.
|Age=He is twenty-two years old, born on the [[cv:Calendar|17th of Granite]] in the year 1988.
|Appearance=He is weak and thin. His hair is of medium length. His narrow hazel eyes are set not too far from one another. His hair is brown. His skin is pale pink. <font color="#AAAAAA">His right lower arm bears the mark of old wounds, including a tiny round scar. His lower abdomen bears the mark of old wounds, including a small straight scar. His nose bears the mark of old wounds, including a small bend in the nose.
|PhysicalPositive= He is agile and is almost never sick,
|PhysicalNegative= but he is weak and flimsy.
|Preferences=Alarion likes [http://www.wikipedia.com/wiki/Internet webs], fortresses, [[rose gold]], [[cv:mace|maces]], the [[cv:color|color]] green, [[cv:cat|cats]] for their aloofness and [[elves]] for their haughtiness. When possible, he prefers to consume ginger ale and [[salmon]]. He absolutley detests [[alcohol]].
|MentalPositive=He has awesome intellectual powers, an astonishing memory, very good intuition, a great sense of empathy, good creativity, a natural ability with music and a natural inclination toward language,
|MentalNegative=but he has quite poor focus, a meager kinesthetic sense, a meager ability with social relationships and a questionable spatial sense.
|Character=He occassionally overindulges. He doesn't handle stress well. He genuinely likes others and openly expresses positive feelings. He enjoys being in crowds. He can be very happy and optimistic. He has a fertile imagination. He is put off by authority and tradition. He is very trusting. He finds helping others very rewarding. He dislikes confrontations. He is very willing to compare self favorably with others. He rarely completes tasks and is often overcome by distractions. He doesn't go out of own way to do more work than necessary. He is incredibly compassionate and feels the pain of others. He is confident. He is disorganized. He has a sense of duty.
|Description=A medium-sized [[cv:human|creature]] prone to great ambition.
}}

User:Alarion

2010-12-20T15:55:11Z

Alarion:

{{Dwarfpage
|Title=Alarion Cagithbunem, "Alarion Cry-Soother", Student
|Thoughts=Alarion has been [[cv:Thought|happy]] lately. He was able to rest and recuperate lately. He dined in a good dining room recently. He slept in a very good bedroom recently. He was caught in a snow storm recently. He ate a fine dish lately. He talked with mother recently.
|Worship=He is a casual worshipper of Akatosh, the god of Time and Dragons.
|Citizen=He is a citizen of [http://www.wikipedia.com/wiki/Sweden The Northern Forests]. He is a member of [http://www.wikipedia.com/wiki/Stockholm The Islet of Logs] and [http://www.wikipedia.com/wiki/Uppsala The Upright Halls]. He is a [[http://www.wikipedia.com/wiki/Psychologist consoler]] of The Upright Halls.
|Age=He is twenty-two years old, born on the [[cv:Calendar|17th of Granite]] in the year 1988.
|Appearance=He is weak and thin. His hair is of medium length. His narrow hazel eyes are set not too far from one another. His hair is brown. His skin is pale pink. <font color="#AAAAAA">His right lower arm bears the mark of old wounds, including a tiny round scar. His lower abdomen bears the mark of old wounds, including a small straight scar. His nose bears the mark of old wounds, including a small bend in the nose.
|PhysicalPositive= He is agile and is almost never sick,
|PhysicalNegative= but he is weak and flimsy.
|Preferences=Alarion likes [http://www.wikipedia.com/wiki/Internet webs], fortresses, [[rose gold]], [[cv:mace|maces]], the [[cv:color|color]] green, [[cv:cat|cats]] for their aloofness and [[elves]] for their haughtiness. When possible, he prefers to consume ginger ale and [[salmon]]. He absolutley detests [[alcohol]].
|MentalPositive=He has awesome intellectual powers, an astonishing memory, very good intuition, a great sense of empathy, a natural ability with music and a natural inclination toward language,
|MentalNegative=but he has quite poor focus, a questionable spatial sense, a meager kinesthetic sense and a meager ability with social relationships.
|Character=He occassionally overindulges. He doesn't handle stress well. He genuinely likes others and openly expresses positive feelings. He enjoys being in crowds. He can be very happy and optimistic. He has a fertile imagination. He is put off by authority and tradition. He is very trusting. He finds helping others very rewarding. He dislikes confrontations. He is very willing to compare self favorably with others. He rarely completes tasks and is often overcome by distractions. He doesn't go out of own way to do more work than necessary. He is incredibly compassionate and feels the pain of others. He is confident. He is disorganized. He has a sense of duty.
|Description=A medium-sized [[cv:human|creature]] prone to great ambition.
}}

User:Alarion

2010-12-20T15:53:59Z

Alarion: Created page with '{{Dwarfpage |Title=Alarion Cagithbunem, "Alarion Cry-Soother", Student |Thoughts=Alarion has been happy lately. He was able to rest and recuperate lately. He dined…'

{{Dwarfpage
|Title=Alarion Cagithbunem, "Alarion Cry-Soother", Student
|Thoughts=Alarion has been [[cv:Thought|happy]] lately. He was able to rest and recuperate lately. He dined in a good dining room recently. He slept in a very good bedroom recently. He was caught in a snow storm recently. He ate a fine dish lately. He talked with mother recently.
|Worship=He is a casual worshipper of Akatosh, the god of Time and Dragons.
|Citizen=He is a citizen of [http://www.wikipedia.com/wiki/Sweden The Northern Forests]. He is a member of [http://www.wikipedia.com/wiki/Stockholm The Islet of Logs] and [http://www.wikipedia.com/wiki/Uppsala The Upright Halls]. He is a [[consoler]] of The Upright Halls.
|Age=He is twenty-two years old, born on the [[cv:Calendar|17th of Granite]] in the year 1988.
|Appearance=He is weak and thin. His hair is of medium length. His narrow hazel eyes are set not too far from one another. His hair is brown. His skin is pale pink. <font color="#AAAAAA">His right lower arm bears the mark of old wounds, including a tiny round scar. His lower abdomen bears the mark of old wounds, including a small straight scar. His nose bears the mark of old wounds, including a small bend in the nose.
|PhysicalPositive= He is agile and is almost never sick,
|PhysicalNegative= but he is weak and flimsy.
|Preferences=Alarion likes [http://www.wikipedia.com/wiki/Internet webs], fortresses, [[cv:rose gold]], [[cv:mace|maces]], the [[cv:color|color]] green, [[cv:cat|cats]] for their aloofness and [[elves]] for their haughtiness. When possible, he prefers to consume ginger ale and [[salmon]]. He absolutley detests [[alcohol]].
|MentalPositive=He has awesome intellectual powers, an astonishing memory, very good intuition, a great sense of empathy, a natural ability with music and a natural inclination toward language,
|MentalNegative=but he has quite poor focus, a questionable spatial sense, a meager kinesthetic sense and a meager ability with social relationships.
|Character=He occassionally overindulges. He doesn't handle stress well. He genuinely likes others and openly expresses positive feelings. He enjoys being in crowds. He can be very happy and optimistic. He has a fertile imagination. He is put off by authority and tradition. He is very trusting. He finds helping others very rewarding. He dislikes confrontations. He is very willing to compare self favorably with others. He rarely completes tasks and is often overcome by distractions. He doesn't go out of own way to do more work than necessary. He is incredibly compassionate and feels the pain of others. He is confident. He is disorganized. He has a sense of duty.
|Description=A medium-sized [[cv:human|creature]] prone to great ambition.
}}

v0.31:Reactions

2010-12-07T00:26:42Z

Alarion: /* quantity */ Changed it to work properly

{{quality|Fine|09:41, 6 October 2010 (UTC)}}
{{av}}

Reactions are modular, editable formulas that take specific ingredients, or reagents, and use them to produce a desired item. A lot of reactions are hardcoded - building beds or creating glass, for example -- but a few are freely editable, and it's quite simple to add additional ones.

== Reaction differences between modes ==
In [[Fortress mode]], reactions are linked to specific buildings, and must be added to a civilization's [[Entities|entity file]] to be usable by that civilization. This has the useful effect of limiting new items and materials (such as special [[wood]] or [[metal]]) to civilizations that have the requisite reaction -- so that if you give your custom civilization a reaction to produce star metal or some other custom material, only they will be able to use it.

In [[Adventure mode]], reactions are freely available via x > create, and any adventurer character can make free use of them. Reagents may be held in the hands or dropped on the ground, but cannot be used within a backpack or quiver. As of .10, there are several bugs with Adventure mode reactions, chief of which is the fact that the [HAS_MATERIAL_REACTION_PRODUCT] token is completely ignored, leading to dragon eye tissue tanned hides, among other things.

Prior to version 31.10, a reaction could only result in an object of base [[quality]]. However, in .10 items produced via reactions have been observed to have quality modifiers. The way skill factors into them has yet to be determined.

==Anatomy of a reaction==

Reactions are found within reaction_x files (such as reaction_smelter or reaction_other). Generally speaking they adhere to the following structure:

[REACTION:<identifier>]
[NAME:<name>]
[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
[REAGENT:A:150:BAR:NONE:POTASH:NONE]
[PRODUCT:100:1:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:<SKILL TOKEN>]
[AUTOMATIC]
[ADVENTURE_MODE_ENABLED]
* ''[[#Reaction identifier|identifier]]'': The internal ID of the reaction.
* ''[[#Reaction name|name]]'': The name of the reaction, visible to the player in the Fortress mode or Adventure mode menus.
* ''[[#Building|building]]'': The building ID that the reaction uses, and the relevant keyboard shortcut.
* ''[[#Reagents|...reagents...]]'': Zero or more reagents (ingredients) that are required to be in stock for the reaction to be possible.
* ''[[#Products|...products...]]'': Zero or more products that are created from the reaction.
* ''[[#fuel|fuel]]'': (optional) If present, the reaction requires charcoal, coke or a magma-powered workshop.
* ''[[#skill|skill]]'': (optional) The skill required and trained by the reaction.
* ''[[#automatic|automatic]]'': (optional) If present, the reaction will automatically be enqueued whenever it can possibly be performed.
* ''[[#adventure mode|adventure mode]]'': (optional) If present, the reaction is used by the player in Adventure mode instead.

=== Reaction identifier ===

The reaction identifier may be anything, so long as it is unique within the raw data files. A good habit to get into is to append a short prefix or suffix to each name related to the name of your mod, to ensure nobody else is going to make an identical reaction and thereby mess up the game if their mod is run alongside yours.

=== Reaction name ===

This can be anything at all, and is usually used to describe the reaction. '''Tan a hide''', for example, is the name of the default leather-producing reaction. Generally this should be written as a small descriptive verb phrase, with the first letter capitalised, for consistency with the existing reactions.

=== Building ===

[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
* ''name'': The ID of the building where this reaction will appear in the tasks menu.
* ''key'': The keyboard shortcut used to queue up the reaction.

The BUILDING NAME is the name of the building that will house this reaction, and the building key is the keyboard shortcut that will queue up the reaction. If two reactions have the same key, then one of them will be assigned a different key, the first alphabetically available at the building.

=== Reagents ===
REAGENTs are a little bit complicated. They are the ingredients that the reaction will use. You can define as many as you like within a reaction.

[REAGENT:<name>:<quantity>:<item token>:<item subtype>:<material token>:<material subtype>][...modifiers...]
* ''[[#name|name]]'': The name of the reagent, local to the reaction.
* ''[[#quantity|quantity]]'': The amount of the item that will be used in the reaction.
* ''[[#item_token_.2F_item_subtype|item token]]'': The type of the item you require.
* ''[[#item_token_.2F_item_subtype|item subtype]]'': The unique identifier of the item you require, as it appears in the corresponding raw data file, or NONE for no specific type.
* ''[[#material_token_.2F_material_subtype|material token]]'': The category of the material needed that the item should be made of, or NONE if only the ''item token'' matters.
* ''[[#material_token_.2F_material_subtype|material subtype]]'': The unique identifier of a specific material required within the ''material token'' category, or NONE if any type will do.
* ''[[#Modifiers|...modifiers...]]'': Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

==== name ====
The name field is a small string used to identify the reagent within the reaction. The name is not visible to the player. It is local to the reaction and does not need to be unique across all of the reactions, so you can reuse the same names over and over, although each reagent within the same individual reaction must have a different name.

Most reactions are simply named '''A''', '''B''', and so forth in default reactions, although names such as '''TOOLSTONE''' or '''FLUX''' will also work equally well. The PRODUCT may make reference to this name — for instance, if a container '''B''' is specified as a reagent, PRODUCT_TO_CONTAINER:B specifies that container.

==== quantity ====
The quantity differs between item types. Generally speaking, cloth, thread, powder and globs use numbers representing the size of material within one item, and everything else uses a static quantity. While REAGENT:A:'''''10''''':'''''THREAD''''':NONE:NONE:NONE thread is an extremely tiny portion of a random spool of thread, REAGENT:A:'''''10''''':'''''TOY''''':NONE:NONE:NONE is ten unique, solid toy items.

Sometimes the quantity of product is directly connected with the quantity of reagent; it seems to be 150 / REAGENT <quantity> (rounding down) so that Reagent <quantity> of 3 gives 50 product and a <quantity> of 4 gives 37. (150/4=37.5) [List of item types this applies to? Bars, for instance.]

==== item token / item subtype ====
The item token is the type of item you require; WEAPON, TOY or SKIN_TANNED, for example. A [[item token|full list]] is available.

The item subtype is name of the exact item that you require. Examples are ITEM_WEAPON_SPEAR or ITEM_TOY_PUZZLEBOX. Some items, like quivers or backpacks, or chunks of stone or metal, only require the item token to be filled in, so if you're asking for those you can leave this blank. Subtypes are the entities defined within the local raw data files and their exact names can be referenced by looking at the corresponding file.

==== material token / material subtype ====
The material token and material subtype are frequently related. The first indicates the category of material you want, such as INORGANIC, though it can also specify one of the hardcoded materials (see {{L|material token}} for a list). The second indicates the specific subtype of material you want, such as OBSIDIAN or STEEL.

==== Modifiers ====
Reagents may also have extra tokens added on afterwards, placed just after the REAGENT tag.

A list of them follows:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [PRESERVE_REAGENT]
| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.
|-
| [REACTION_CLASS:X]
| Detailed below the reaction anatomy section.
|-
| [HAS_MATERIAL_REACTION_PRODUCT:X]
| Detailed below the reaction anatomy section.
|-
| [UNROTTEN]
| Reagent must not be rotten, mainly for organic MATGLOSS types.
|-
| [BUILDMAT]
| Reagent is able to be used to build structures (Stone, Wood, Blocks, Bars?).
|-
| [GLASS_MATERIAL]
| Reagent has a one of the glass MATGLOSS types.
|-
| [WORTHLESS_STONE_ONLY]
| The reagent respects allowed and forbidden economic stones from the Stone menu.
|-
| [FIRE_BUILD_SAFE]
| Reagent must be considered fire safe - ie. not wood, and not coal.
|-
| [MAGMA_BUILD_SAFE]
| Reagent must have a melting point greater than the temperature of Magma.
|-
| [CAN_USE_ARTIFACT]
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.
|-
| [ANY_PLANT_MATERIAL]
| Reagent MATGLOSS must be of a plant subtype.
|-
| [ANY_SILK_MATERIAL]
| Reagent MATGLOSS must be of a silk type.
|-
| [ANY_SOAP_MATERIAL]
| Reagent MATGLOSS must be of a soap type.
|-
| [ANY_LEATHER_MATERIAL]
| Reagent MATGLOSS must be of a leather type.
|-
| [ANY_BONE_MATERIAL]
| Reagent MATGLOSS must be of a bone type.
|-
| [ANY_SHELL_MATERIAL]
| Reagent MATGLOSS must be of a shell type.
|-
| [ANY_TOOTH_MATERIAL]
| Reagent MATGLOSS must be of a tooth type.
|-
| [ANY_HORN_MATERIAL]
| Reagent MATGLOSS must be of a horn type.
|-
| [ANY_PEARL_MATERIAL]
| Reagent MATGLOSS must be of a pearl type (Excretion from sea creatures?)
|-
| [USE_BODY_COMPONENT]
| Reagent MATGLOSS must come off a creature's body.
|-
| [METAL_ORE]
| Reagent MATGLOSS must be a metal ore.
|-
| [NOT_WEB]
| States that the material cannot be web (For making only plant/adamantine thread?).
|-
| [WEB_ONLY]
| States that the material has to be web (For making only silk thread?).
|-
| [POTASHABLE]
| The reagent must be able to be turned into pot ash.
|-
| [EMPTY]
| If the reagent is a container, it must be empty.
|-
| [CONTAINS_LYE]
| If the reagent is a container, it must contain LYE.
|-
| [NOT_CONTAIN_BARREL_ITEM]
| If the reagent is a Barrel, it must not contain an item that has to reside in a barrel. Barrel items appear to be lye and milk. Alcohol appears to be covered as part of [EMPTY]. A reaction which places an item in a barrel should probably have both tags.
|-
| [BAG]
| Reagent has to be a bag. Intended to be used with an item type of BOX, to prevent chests, coffers, and other containers from being used instead.
|}

Generally speaking, if you set a field in a reagent to NONE, the reaction won't discriminate when it comes to that particular field. For example, if you require a BOULDER reagent but leave the matgloss fields as NONE:NONE, it will grab any available BOULDER-type item irrespective of matgloss.

===Products===
Products are the end product of the reaction. A reaction can have as many products as it likes.

Products are almost identical to reagents, except that they do not need to be named, can't have fields undefined, and don't use the quantity field to determine the product size. Instead, the token PRODUCT_DIMENSION:X is tacked on after the PRODUCT token, determining the size of the product. Products also don't use tokens like USE_ANY_BONE_MATERIAL.

Products can be produced directly to a container using the [PRODUCT_TO_CONTAINER:<IDENTIFIER>] token, where the IDENTIFIER is the name of a reagent. This requires the reagent to have the PRESERVE_REAGENT token.

===Other tokens===

==== fuel ====
The FUEL token means that the reaction requires coke or charcoal to be performed, or magma in magma workshops.

==== skill ====
The SKILL token determines what [[Skill tokens|skill]] the reaction requires and what skill it trains. Multiple skills can be listed but only one will be used.

==== automatic ====
The AUTOMATIC token means that the reaction will be queued automatically if the reaction reagents are all present.

==== adventure mode enabled ====
The ADVENTURE_MODE_ENABLED token means that this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files.

==Material reaction products and reaction classes==

You can get a certain measure of control over very specific materials using reaction classes and material reaction products - the tokens look like this:

[REACTION_CLASS:FAT]
[HAS_MATERIAL_REACTION_PRODUCT:RENDER_MAT]

Reaction classes represent different classes of material - basically, the matgloss subtype of the reagent must have a REACTION_CLASS the same as the one in the reaction.

Material reaction products are similar, but are generally used more for things like different kinds of creature materials than universal materials like stone. This token is how skin can be tanned into leather, which are two separate materials - the skin material has leather as a MATERIAL_REACTION_PRODUCT.

In short, they require the material to have a token such as
[MATERIAL_REACTION_PRODUCT:X:Y:Z]
...where X is the name of the reaction product that will be referred to in the reaction (RENDER_MAT, in the reaction class example, or TAN_MAT for leather), Y is the matgloss type of the desired product (such as INORGANIC or LOCAL_CREATURE_MAT) and Z is the specific material, like LEATHER or OBSIDIAN.

==Reactions and world generation==

There are several things to keep in mind when you're adding reactions to a game that already exists.

* Most entity changes require a regen, but adding PERMITTED_REACTION tokens for reactions that existed at the time of world generation to the entity file in the save directory do not.
* Adding reactions to the raws in a save directory requires you to regen the world.
* You can alter an existing reaction in any way you like without regenning the world, so long as you don't alter the reaction identifier.

[[Category:DF2010:Modding]]

v0.31:Utilities

2010-10-19T15:28:32Z

Alarion: /* Dwarf Therapist */ updated version number

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

Here are third party applications useful for Dwarf Fortress.
__TOC__

==Dwarf Fortress filesharing services==

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

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

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

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

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

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

== 3D Visualizers ==

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

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

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

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

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

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

== Interface tools ==

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

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

Main article here: [[Dfterm2]].

== Game manipulation tools ==

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

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

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

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

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

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

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

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

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



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

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

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

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

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

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

DFHack is a Dwarf Fortress memory access library and a set of basic tools using this library. The library is a work in progress, so things might change as more tools are written for it. The current (0.4.0.7b) release only supports the new DF 0.31.01, 0.31.02 and 0.31.03 legacy versions and 0.31.04-0.31.12 SDL versions. It consists of some of the more useful DFHack tools.

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

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

==== dfprospector ====
Lists all available minerals on the map and how much of them there is.
==== dfreveal ====
Reveals the whole map. Newly can also hide what it revealed. Use with caution, releases [[HFS]]! Same warnings as to the original Reveal tool apply.

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

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

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

== Fortress layout tools ==

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

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

"Blueprints" can be created using many interfaces, the easier being graphically based. TO design rooms on a website [http://www.irritablegourmet.com/dwarf/index.htm] a web based blueprint maker is the most simple to use.

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

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

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

== Modding tools ==

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

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

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

=== [http://dffd.wimbli.com/file.php?id=2088 Accent replacement tool] ===
A small application to remove accented characters from a file. A quick solution if you need the language files for a tileset that has images in place of special characters.

== Raw tile tools ==

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

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

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

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

Currently for windows only.

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

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

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

== World Map / World Gen Tools ==

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

== Other/miscellaneous ==

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

= Tools under development =

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

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

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

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

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