Dwarf Fortress Wiki - User contributions [en]

Modding

2016-05-23T13:19:30Z

StrikaAmaru: actually fix link.

{{Quality|Exceptional|14:13, 7 November 2013 (UTC)}}
{{av}}
This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of editing creatures, entities, materials ''et al'', and creating their own.

Generally, breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on [[40d:Modding guide|Teldin's guide]], originally created for version 0.27.176.39c. Per wiki tradition, it has been updated through all the major releases since then; hopefully it reflects current knowledge.

'''See also:''' [[:Category:DF2014:Modding]]

= Modding Guide =

== Token reference ==

It's always good to refer to tokens on the wiki. Even experienced modders have to look up tokens! A list of articles about tokens can be found [http://dwarffortresswiki.org/index.php/Token here].

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert [[Graphics set repository|graphics sets]]), and "objects", which contains all the data for generally everything in the game that is not hardcoded.

Within the \raw\objects folder are a large number of text files - these are the [[raw file|raw files]], and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. For example if you open creature_standard.txt it should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file comprises a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an identifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Try to avoid modifying the existing raw files when adding objects. It makes removing mods far easier.
* When adding files, all you need to include to ensure proper references are maintained is the token identifiers. The game will load up all *.txt files in the raw folder, and searches through them by tokens. For example, you can add a new pair of leather boots and not even have to add it to the item_shoes.txt file, but rather make your own file, say item_shoes_new.txt and ensure you have the token listed, ex. [ITEM_SHOES:ITEM_SHOES_BOOTS_NEW].

* If you want to edit an already-existing creature, always back up the files you plan on editing to a different location. Since v0.31.22, the game no longer loads backup files with an extension other than ".txt", but duplicate entries are still a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a world that's already been generated, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilizations (entities) ==

Entities - the objects that determine how civilizations work - are stored in entity_default.txt (though, like all other files, you may add more). They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect; later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with us until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelled. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelihood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If one were to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:5]
[BIOME_SUPPORT:SAVANNA:10]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens [[entity token|here]]. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aforementioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The things that haven't already been dealt with (hence the "REMAINING") - such as site names, kingdom names, the names of individuals, and such - will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's perceived personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found [[position token|here]]; they don't require a great deal of explanation.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens [[creature token|here]]. But before you start creating your own creatures, you'll want to learn how the tissues system works.

=== Creature materials and tissues ===

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file, and we'll talk about them later. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between bodyparts, tissues, and materials. We're going to show you part of the creature entry for a bronze colossus (bear with us):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With us so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument defines if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_TYPE), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in all categories, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there are detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say we wanted our dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that [[Temperature|on this page]]. We're also referencing material tokens, which we haven't gone over yet - we'll talk about making your own materials later.

=== Creature castes ===

Another potentially extremely powerful part of the creature raws is the caste system. The caste system handles both true biological castes and lesser variations, such as sexes.

To understand the true potential of the caste system, we only need to take a look at the raws for antmen, found in creature_subterrenean.txt:

...
[CASTE:WORKER]
[CASTE_NAME:worker ant woman:worker ant women:worker ant woman]
Female, but non-breeding.
[POP_RATIO:10000]
[CASTE:SOLDIER]
[CASTE_NAME:soldier ant woman:soldier ant women:soldier ant woman]
Female, but non-breeding.
[POP_RATIO:1000]
[CASTE:DRONE]
[MALE]
[CASTE_NAME:drone ant man:drone ant men:drone ant man]
[POP_RATIO:5]
[CASTE:QUEEN]
[FEMALE]
[CASTE_NAME:queen ant woman:queen ant women:queen ant woman]
[POP_RATIO:1]
[SELECT_CASTE:WORKER]
[SELECT_ADDITIONAL_CASTE:SOLDIER]
[SELECT_ADDITIONAL_CASTE:QUEEN]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[SELECT_CASTE:DRONE]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH:2WINGS]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[FLIER]
[SELECT_CASTE:ALL]
[BODY_DETAIL_PLAN:CHITIN_MATERIALS]
[BODY_DETAIL_PLAN:CHITIN_TISSUES]
[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:CHITIN:FAT:MUSCLE]
[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS]
[ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP]
[ATTACK_SKILL:GRASP_STRIKE]
[ATTACK_VERB:punch:punches]
...

It's evident that the process of creating and editing castes is comparable to the modifications we were making to tissues and materials earlier: A caste is declared, and modifications to the base creature are made. Declared castes can be selected and subsequently modified, again, just like tissues and materials.

In this case, each caste is declared, given its own name, and a POP_RATIO, which determines how commonly a birth results in that caste - for every 10000 workers born, there'll be an average of 1000 soldiers, 5 drones and one queen. You've probably also noticed that the DRONE and QUEEN castes have the MALE and FEMALE tokens respectively - these tokens determine how breeding works. A creature without both a MALE caste and a FEMALE caste will be unable to breed (no asexual creatures yet, unfortunately). As they lack FEMALE, the workers and soldiers are unable to breed with the male drones.

After this, there are some modifications to bodyparts. In this case, the drones have wings and the FLIER token, which the other castes lack. It's entirely possible for creatures of different castes to have completely different body stuctures, even to the extent that they don't resemble each other at all. If you read the section of this guide that dealt with entities, you may remember a passing mention of multi-creature civilisations and how they don't quite work as you may think they would. The castes system is your workaround. You could create a caste that is, for all intents and purposes, a human, and another caste of the same creature that acts exactly like a giant cave spider, put the creature in a civ, and get a human-spider civ. The only flaw in this approach is that the castes will interbreed.

That's the most complex components of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least not as well as the other object types), but you should be able to figure out most things by way of our explanations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found [[skill token|on this page]]. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explanation. The first value determines the contact area of the weapon's attack; this should be high for slashing weapons and low for bludgeoning, piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the nouns and verb used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explanation.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Let's say you added a whole new species. Sure, you could just swipe one of the existing translation files and steal their language for your species, but that's the lazy way! If you want to create a whole new language, it is very simple.

First, you'd need a whole new language_RACE file, such as language_LIZARDMAN.txt, along with "language_LIZARDMAN" at the top of the file proceeded by [OBJECT:LANGUAGE] and [TRANSLATION:LIZARDMAN]. After that, it's just a matter of copy-pasting one of the existing language lists and editing the finished 'translated' word. That's it! Then just add the translation link to your civ in entity_default.txt and it'll be added to the game on worldgen.

(Note that the name of the file doesn't actually matter; however, it's good form to name the file after a creature if only that creature speaks the language.)

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the, very simple, format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain ''type'' of bodypart, while CON means it's connected to a ''specific'' one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found [[body token|here]].

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

"BODYGLOSS" entries, which you can sometimes find applied to creature entries, are simply replacement words for specific part name strings in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in body_default.txt; you can then use this in a creature via "[BODYGLOSS:CLAW_HAND]" and it'll replace all instances of "hand" with "claw" in that creature. Be warned, however—if you were to, say make a bodygloss [BODYGLOSS:EARSTALK:ear:stalk:ears:stalk], it would not only change "ear" and "ears" to "stalk" and "stalks", it would also change "h'''ear'''t" to "h'''stalk'''t"! For all intents and purposes the body part will still function as the proper part, though.

== Modding plants ==

Plants are, again, not unlike creatures. With what you've learned so far in regard to tokens and the materials system, running through the notes included in plant_standard.txt should explain most things. [[Plant token|Here's the list of plant-specific tokens]].

Below is the [[plump helmet]] raw description:

[PLANT:MUSHROOM_HELMET_PLUMP]
[NAME:plump helmet][NAME_PLURAL:plump helmets][ADJ:plump helmet]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PICKED_TILE:161][PICKED_COLOR:6:13:0]
[GROWDUR:300][VALUE:2]
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen dwarven wine]
[STATE_NAME_ADJ:LIQUID:dwarven wine]
[STATE_NAME_ADJ:GAS:boiling dwarven wine]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:5:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]

[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[EDIBLE_COOKED]
[SEED:plump helmet spawn:plump helmet spawn:4:0:1:LOCAL_PLANT_MAT:SEED]
[SPRING][SUMMER][AUTUMN][WINTER]
[FREQUENCY:100]
[CLUSTERSIZE:5]
[PREFSTRING:rounded tops]
[WET][DRY]
[BIOME:SUBTERRANEAN_WATER]
[UNDERGROUND_DEPTH:1:3]
[SHRUB_TILE:142]
[DEAD_SHRUB_TILE:28]
[SHRUB_COLOR:5:13:0]
[DEAD_SHRUB_COLOR:5:6:0]

Let's look at this line by line: 
First, we define its file name. In this case it's MUSHROOM_HELMET_PLUMP. Next we define its in-game name (plump helmet) and its adjective for if you were to craft with it (e.g. plump helmet earrings).

[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]

This defines the structure and material of the plant. It references STRUCTURAL_PLANT_TEMPLATE in the first line, so if you were to say, add wings to the template, the plump helmet plant would be winged. This is for the plant itself, not the end plump helmets.

After that we get our edible tokens. These say that vermin can eat the plant, and it can be eaten raw or cooked by your dwarves. So if you wanted a plant vermin would leave alone, you'd remove the [EDIBLE_VERMIN] token.

[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]

Next, [PICKED_TILE:161] is the character (161 in this case) shown when the crop is harvested. See [[Main:Character table|character table]] for a table of usable tiles. [PICKED_COLOR:6:13:0] is the color used for the crop's tile when harvested. It's in a foreground:background:brightness format. See [[color]] for the colors usable.

[PICKED_TILE:161][PICKED_COLOR:6:13:0]

[GROWDUR:300] is how long it takes for your crop to grow. There are 1008 growdur units in a season. 
[VALUE:2] Is the value of harvested plant (default 1). Appears to have no effect in version 0.31.

[GROWDUR:300][VALUE:2]

This defines the plant's alcohol states. [STATE_NAME_ADJ:ALL_SOLID:] is the frozen name, followed is the actual drink name, and then its boiling name. These are achieved by either Scorching or Freezing climates. [DISPLAY_COLOR] is, of course, color, and [EDIBLE_RAW] and [EDIBLE_COOKED] are saying you can drink the alcohol raw or cooked.

[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen dwarven wine]
[STATE_NAME_ADJ:LIQUID:dwarven wine]
[STATE_NAME_ADJ:GAS:boiling dwarven wine]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:5:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]

After that we get our seed template:

[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[EDIBLE_COOKED]
[SEED:plump helmet spawn:plump helmet spawn:4:0:1:LOCAL_PLANT_MAT:SEED]

And all this says is that the seeds may be eaten by vermin or cooked. Then it gives the name of our plant's seed, its plural name, its foreground, background, and brightness colors, followed by its seed material; said material should have [SEED_MAT] to permit proper stockpiling.

And finally for the last chunk we have this:

[SPRING][SUMMER][AUTUMN][WINTER]
[FREQUENCY:100]
[CLUSTERSIZE:5]
[PREFSTRING:rounded tops]
[WET][DRY]
[BIOME:SUBTERRANEAN_WATER]
[UNDERGROUND_DEPTH:1:3]
[SHRUB_TILE:142]
[DEAD_SHRUB_TILE:28]
[SHRUB_COLOR:5:13:0]
[DEAD_SHRUB_COLOR:5:6:0]

First we define what season(s) the plant may grow in, then we define how frequently this plant is generated in a particular area, followed by how many harvested crop items may come from 1 plant. [PREFSTRING:] is what your dwarves like about the plant, which in this case is the rounded tops. [WET][DRY] are the conditions under which the plant can grow. Wet means it can grow close to water, dry means it can grow away from water. This does not mean you can grow the plant on dry stone however. It is just for natural spawning of the plant. 
[BIOME] Is what biome the plant grows in. [UNDERGROUND_DEPTH:Minimum:Maximum] Is the highest and lowest cavern levels that the plant can appear in if its biome is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1. Defaults to 0:0 (surface only). 
Lastly, [SHRUB_TILE] is the character used for the naturally spawning shrub of this plant, [DEAD_SHRUB] is the dead shrub character. [SHRUB_COLOR] Is the shrub's color, and [DEAD_SHRUB_COLOR] is, of course, the dead shrub's color.

While this may or may not look like a lot of tokens, it's very easy. Just copy an existing plant and edit it to your new plant. 
For the rest of the tokens, see [[plant token]].

== Workshops ==

Workshops are raw-designed pretty differently from everything else in the game, being buildable structures rather than items or methods to gain items. However, they are fairly simple. For example, here's the raw for the [[soap maker's workshop]]:

[BUILDING_WORKSHOP:SOAP_MAKER]
[NAME:Soap Maker's Workshop]
[NAME_COLOR:7:0:1]
[DIM:3:3]
[WORK_LOCATION:2:2]
[BUILD_LABOR:SOAP_MAKER]
[BUILD_KEY:CUSTOM_SHIFT_S]
[BLOCK:1:0:0:1]
[BLOCK:2:0:0:1]
[BLOCK:3:0:0:0]
[TILE:0:1:' ':' ':150]
[TILE:0:2:' ':' ':'/']
[TILE:0:3:'-':' ':' ']
[COLOR:0:1:0:0:0:0:0:0:6:0:0]
[COLOR:0:2:0:0:0:0:0:0:6:0:0]
[COLOR:0:3:6:0:0:0:0:0:0:0:0]
[TILE:1:1:' ':' ':'=']
[TILE:1:2:'-':' ':8]
[TILE:1:3:' ':' ':150]
[COLOR:1:1:0:0:0:0:0:0:6:0:0]
[COLOR:1:2:6:0:0:0:0:0:6:0:0]
[COLOR:1:3:0:0:0:0:0:0:6:0:0]
[TILE:2:1:'-':' ':8]
[TILE:2:2:' ':' ':8]
[TILE:2:3:' ':150:' ']
[COLOR:2:1:6:0:0:0:0:0:6:0:0]
[COLOR:2:2:0:0:0:0:0:0:6:0:0]
[COLOR:2:3:0:0:0:6:0:0:0:0:0]
[TILE:3:1:150:' ':8]
[TILE:3:2:' ':' ':8]
[TILE:3:3:' ':240:' ']
[COLOR:3:1:6:0:0:0:0:0:6:7:0]
[COLOR:3:2:0:0:0:0:0:0:6:7:0]
[COLOR:3:3:0:0:0:7:0:1:0:0:0]
[BUILD_ITEM:1:BUCKET:NONE:NONE:NONE][EMPTY][CAN_USE_ARTIFACT]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]

A line-by-line breakdown:

[NAME:Soap Maker's Workshop]
[NAME_COLOR:7:0:1]

These are the name of the workshop ("Soap Maker's Workshop") and [[color]] of the workshop's name when examined with 'q' (White with a black background).

[DIM:3:3]
[WORK_LOCATION:2:2]

DIM refers to how large the workshop will be, in this case 3 wide, 3 tall. WORK_LOCATION tells where the creature using it (usually a dwarf) will work, numbered from the top right--in this case, 2:2, or the middle. Multiple work locations can be defined, even outside the dim.

[BUILD_LABOR:SOAP_MAKER]
[BUILD_KEY:CUSTOM_SHIFT_S]

These refer to the worker required to build it (soap maker) and the key used to build it in the workshop menu (capital S).

[BLOCK:1:0:0:1]
...
This is a bit more complex, and is where we get to the meaty part of workshop making--the tiles' properties. BLOCK refers to which tiles will be untraversable--1 means blocked, 0 means unblocked. The first number refers to row, and the next 3 refer to column, so 1:0:0:1 means that, on the first row, the first two tiles will be unblocked and the last will be blocked.

[TILE:0:1:' ':' ':150]
...
The TILE token tells which tile will go where. note, however, that there are 5 entries here instead of 4. The first number, in this case, refers to build stage, numbered from 0 to 3; 3 or 1 is fully built (depending on whether there are stages), 0 is just placed, and 2 is always an intermediate stage, while 1 is usually an intermediate stage. Whether 1 is an intermediate stage or not depends on if there are a 2 and 3 stage; if 2 and 3 exist, 1 will be intermediate. The second number and beyond are similar to BLOCK; however, instead of 1s and 0s, you must input tiles. The tiles themselves can be given in quotes (as in ' ') or given as a number, which can be looked up [[Tilesets|here]]. Here, we have 150, which is û.

[COLOR:1:1:0:0:0:0:0:0:6:0:0]
...
Color is as TILE, but with colors instead of tiles; however, colors are made up of 3 numbers each or MAT. MAT refers to the color of the material used to make it; the 3 numbers refer to foreground:background:foreground brightness, and can be looked up [[Color|here]]. For example, 4:2:1 will give you bright red with a dark green background.

[BUILD_ITEM:1:BUCKET:NONE:NONE:NONE][EMPTY][CAN_USE_ARTIFACT]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]
These refer to items required to build the building. These are in the same format as [[Reaction|reaction reagents and products]]--quantity:[[Item token|item]]:[[Material token|material]]. You'll learn more about those on the article about [[Reaction|reactions]], though. The second BUILD_ITEM is special-- it uses modifiers exclusively to determine its requirements. BUILDMAT refers to wood logs, wood blocks, stone boulders, and stone blocks; WORTHLESS_STONE_ONLY means it can't use economic stone; CAN_USE_ARTIFACT means that it... can use artifacts. EMPTY, in the bucket's case, means that the bucket must be empty.

More can be seen at the [[Building token|building tokens]] article.

== Reactions ==

An in-depth guide for reactions is available [[Reactions|here]].

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic"), which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in addition to the changes made to the template, there are also ENVIRONMENT tokens - these tell the game where to place these minerals during worldgen.

[[material definition token|Here's a list of material tokens]]. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

The Hydling by Mysteryguye (annotated, updated and separated into blocks by Putnam)

[CREATURE:HYDLING]
[DESCRIPTION:A seven-headed small hairy thing, about the size of a dog. It is very loyal to its masters, and will promptly disembowel any enemy straying too close.]
This is the description that shows up in-game when viewing the creature.

[NAME:hydling:hydlings:hydlish] If there were a civ made of hydlings, it would appear as "hydlings" in the neighbors screen.

[CASTE_NAME:hydling:hydlings:hydlish]

[CREATURE_TILE:'='][COLOR:2:0:1] Will appear as a light green "=".

[PETVALUE:78][NATURAL] Creature is known to be naturally occurring by the game. Will cost 40 embark points to buy.

[LARGE_ROAMING] Will spawn outdoors, wandering around.

[COMMON_DOMESTIC][TRAINABLE][PET] Can be bought on embark as a pet, war animal, or hunting animal.

[BONECARN] Can eat meat and bones only--no vegetables.

[PREFSTRING:loyalty] Dwarves will like it for its loyalty.

[LIKES_FIGHTING] Will attack rather than flee.

[BODY:BASIC_2PARTBODY:7HEADNECKS:BASIC_FRONTLEGS:BASIC_REARLEGS:TAIL:2EYES:NOSE:2LUNGS:HEART:GUTS:ORGANS:THROAT:SPINE:BRAIN:SKULL:3TOES_FQ_REG:3TOES_RQ_REG:MOUTH:TONGUE:GENERIC_TEETH_WITH_FANGS:RIBCAGE]

Has a lower body, upper body, 4 legs, a tail, ten eyes, ten ears, five noses, two lungs, a heart, guts, a pancreas etc., and 5 heads with all that goes with those.

[BODYGLOSS:PAW] Feet will be called "paws"

[BODY_DETAIL_PLAN:STANDARD_MATERIALS] Declares the standard materials that most creatures' tissues are made of.

[BODY_DETAIL_PLAN:STANDARD_TISSUES] This declares the tissues that the creature's tissue layers are made of.

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] And this describes the tissue layers that the creature is made of.

[BODY_DETAIL_PLAN:BODY_HAIR_TISSUE_LAYERS:HAIR] Creature will be covered with a layer of fur.

[USE_MATERIAL_TEMPLATE:NAIL:NAIL_TEMPLATE] And it'll have nails.

[USE_TISSUE_TEMPLATE:NAIL:NAIL_TEMPLATE]

[TISSUE_LAYER:BY_CATEGORY:TOE:NAIL:FRONT] On the toe, specifically.

[SELECT_TISSUE_LAYER:HEART:BY_CATEGORY:HEART]
[PLUS_TISSUE_LAYER:SKIN:BY_CATEGORY:THROAT]
[TL_MAJOR_ARTERIES] Heart and throat--called above--will cause heavy bleeding if ruptured.

[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS] Places eyes, ears and what have you into their correct placement, so that you don't have people punching out eyes from behind.

[BODY_DETAIL_PLAN:HUMANOID_RIBCAGE_POSITIONS] Sets the ribcage as being around lungs and heart.

[USE_MATERIAL_TEMPLATE:SINEW:SINEW_TEMPLATE] Defines sinew so that...
[TENDONS:LOCAL_CREATURE_MAT:SINEW:200] Tendons
[LIGAMENTS:LOCAL_CREATURE_MAT:SINEW:200] And ligaments can be defined.

[HAS_NERVES] Creature has nerves, and as such can be disabled by severing them.

[USE_MATERIAL_TEMPLATE:BLOOD:BLOOD_TEMPLATE] Defines the material BLOOD using the template BLOOD_TEMPLATE.
[BLOOD:LOCAL_CREATURE_MAT:BLOOD:LIQUID] Defines the creature's BLOOD as being made of the above-defined BLOOD material in a LIQUID state.

[CREATURE_CLASS:GENERAL_POISON] Creature can be affected by syndromes that affect GENERAL_POISON.

[GETS_WOUND_INFECTIONS] Pretty much self-explanatory. Creature can get infected from wounds.
[GETS_INFECTIONS_FROM_ROT] And from necrosis.

[USE_MATERIAL_TEMPLATE:PUS:PUS_TEMPLATE] Defines PUS using PUS_TEMPLATE.
[PUS:LOCAL_CREATURE_MAT:PUS:LIQUID] Defines PUS as being made of PUS.

[BODY_SIZE:0:0:1000] Creature will be 1000 cubic centimeters at birth...
[BODY_SIZE:1:0:12500] 12500 cubic centimeters at 1 year old...
[BODY_SIZE:2:0:30000] and 30000 cubic centimeters at 2.

[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] Creature can be anywhere from 90% to 110% as long as others.
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] As above, but with height.
[BODY_APPEARANCE_MODIFIER:BROADNESS:90:95:98:100:102:105:110] As above, but with broadness. This puts the minimum size of the creature (when fully grown) at 21870 and the maximum size at 39930.

[MAXAGE:20:30] Creature will die of old age between the ages of 20 and 30, no later than 30, no sooner than 20.

[CAN_DO_INTERACTION:MATERIAL_EMISSION] Creature can use the MATERIAL_EMISSION interaction.
[CDI:ADV_NAME:Hurl fireball] In adventurer mode, the MATERIAL_EMISSION interaction will appear as "Hurl fireball".
[CDI:USAGE_HINT:ATTACK] Creature will use MATERIAL_EMISSION when it's attacking, on creatures that it's attacking.
[CDI:BP_REQUIRED:BY_CATEGORY:HEAD] Creature must have at least one HEAD to use MATERIAL_EMISSION.
[CDI:FLOW:FIREBALL] The MATERIAL_EMISSION will shoot a fireball.
[CDI:TARGET:C:LINE_OF_SIGHT] The target for the emission--a location--must be within the line of sight of the Hydling.
[CDI:TARGET_RANGE:C:15] And must be, at most, 15 tiles away.
[CDI:MAX_TARGET_NUMBER:C:1] The hydling can only shoot at one target at a time...
[CDI:WAIT_PERIOD:30] and only every 30 ticks (3 tenths of a second at 100 FPS)

[ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH] Defines a BITE attack that uses teeth.
[ATTACK_SKILL:BITE] Attack uses the BITE skill.
[ATTACK_VERB:nom:noms] "The Hydling noms the Elf in the left first toe, tearing the muscle!"
[ATTACK_CONTACT_PERC:100] Will use all of the tooth. Note that this can be more than 100.
[ATTACK_PENETRATION_PERC:100] Will sink the tooth all the way in. This can also be more than 100.
[ATTACK_FLAG_EDGE] Attack is an EDGE attack.
[ATTACK_PRIORITY:MAIN] Attack is of priority MAIN. Other option is SECOND.
[ATTACK_FLAG_CANLATCH] Attack can latch.
[ATTACK_PREPARE_AND_RECOVER:3:3] Takes 3 ticks to wind up attack and 3 to recover from it.
[ATTACK_FLAG_INDEPENDENT_MULTIATTACK] Can use each head independently.

[ATTACK:SCRATCH:CHILD_TISSUE_LAYER_GROUP:BY_TYPE:STANCE:BY_CATEGORY:ALL:NAIL] As above, but for nail instead of teeth.
[ATTACK_SKILL:STANCE_STRIKE] Uses the kicking skill.
[ATTACK_VERB:slice:slices] "You slice the Elf in the left foot and the severed part sails off in an arc!"
[ATTACK_CONTACT_PERC:100] Uses the whole nail.
[ATTACK_PENETRATION_PERC:100] The whole nail goes in.
[ATTACK_FLAG_EDGE] Attack is an edge attack.
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK_PRIORITY:SECOND]

[CHILD:1] Hydling will become an adult at 1 year old.

[GENERAL_CHILD_NAME:hydie:hydies] Children will appear as "hydies".

[DIURNAL] Is active during the daytime.

[HOMEOTHERM:10070] Has a body temperature of 102 Fahrenheit.

[APPLY_CREATURE_VARIATION:STANDARD_QUADRUPED_GAITS:900:730:561:351:1900:2900] Can run at 25 kph
[APPLY_CREATURE_VARIATION:STANDARD_SWIMMING_GAITS:3512:2634:1756:878:4900:6900] Can swim at 10 kph
[APPLY_CREATURE_VARIATION:STANDARD_CRAWLING_GAITS:6561:6115:5683:1755:7456:8567] Can crawl at 5 kph
[SWIMS_INNATE]Swims innately.

[CASTE:FEMALE] Defines a caste called FEMALE.
[FEMALE] FEMALE caste is female.

[CASTE:MALE] As above, but with male.
[MALE] See above.

= Modding utilities =

[http://www.bay12forums.com/smf/index.php?topic=28829.0 A list of many mods and community-developed utilities]

{{Category|Modding}}
{{Category|Guides}}

Modding

2016-05-23T13:18:33Z

StrikaAmaru: fix link.

{{Quality|Exceptional|14:13, 7 November 2013 (UTC)}}
{{av}}
This is intended to be a guide to inform those new to DF modding on what elements of the game can be modified, and how. After reading through this guide, a user should be capable of editing creatures, entities, materials ''et al'', and creating their own.

Generally, breaking stuff is fine - nothing that can be changed will affect the DF executable, and new additions can be easily removed.

This guide is based on [[40d:Modding guide|Teldin's guide]], originally created for version 0.27.176.39c. Per wiki tradition, it has been updated through all the major releases since then; hopefully it reflects current knowledge.

'''See also:''' [[:Category:DF2014:Modding]]

= Modding Guide =

== Token reference ==

It's always good to refer to tokens on the wiki. Even experienced modders have to look up tokens! A list of articles about tokens can be found [[http://dwarffortresswiki.org/index.php/Token|here]].

== Basics of DF modding ==

All the base data that can be edited by prospective modders can be found in the \raw\ folder. This folder contains two subfolders: "graphics" (where you insert [[Graphics set repository|graphics sets]]), and "objects", which contains all the data for generally everything in the game that is not hardcoded.

Within the \raw\objects folder are a large number of text files - these are the [[raw file|raw files]], and editing them is quite easy - you can also create your own if you wish. For now, take a look at one of the existing files. For example if you open creature_standard.txt it should look something like this:

creature_standard

[OBJECT:CREATURE]

[CREATURE:DWARF]
[DESCRIPTION:A short, sturdy creature fond of drink and industry.]
[NAME:dwarf:dwarves:dwarven]
[CASTE_NAME:dwarf:dwarves:dwarven]
[CREATURE_TILE:1][COLOR:3:0:0]
[CREATURE_SOLDIER_TILE:2]
...

As you can see, each file comprises a header string stating the file name, a second header stating the type of object data it contains, followed by the contents of the file itself. These are all necessary elements of the file, and without them, the file won't be parsed correctly by the game. You may have also noticed the file naming scheme - this is also important; files containing creatures have names starting with "creature_", entity file names must begin with "entity_", etc..

Below the headers, there begins a list of entries. Each entry is made up of its own header (in this case, "[CREATURE:DWARF]"), again stating the type of object, and then the object's unique identifier - if an identifier isn't unique, the game will mess up and you'll get some serious, and potentially very trippy, errors. Below that, we have the body of the entry, which determines the entry's specific properties.

The body of an entry is made up of a series of "tokens", which are essentially flags that can be added or removed to affect the entry's attributes. Most of these effects are hardcoded: for example, it's possible to make a creature only eat meat with the [CARNIVOROUS] token, but it's impossible to create your own token detailing a specific diet for the creature.

Before we continue, a few key things to remember when modding the raw files:

* Try to avoid modifying the existing raw files when adding objects. It makes removing mods far easier.
* When adding files, all you need to include to ensure proper references are maintained is the token identifiers. The game will load up all *.txt files in the raw folder, and searches through them by tokens. For example, you can add a new pair of leather boots and not even have to add it to the item_shoes.txt file, but rather make your own file, say item_shoes_new.txt and ensure you have the token listed, ex. [ITEM_SHOES:ITEM_SHOES_BOOTS_NEW].

* If you want to edit an already-existing creature, always back up the files you plan on editing to a different location. Since v0.31.22, the game no longer loads backup files with an extension other than ".txt", but duplicate entries are still a very bad thing.
* When a new world is generated, all the raw files get copied into a \raw\ folder within the applicable save folder. If you want to change something within a world that's already been generated, you'll have to edit those files, not the ones in ~DF\raw\objects.
* There's nothing stopping you from just copying an existing creature/entity/whatever, changing the identifier, and modifying it. This can save you a lot of time, especially when it comes to entities... which are coincidentally what we'll be talking about next.

== Modding civilizations (entities) ==

Entities - the objects that determine how civilizations work - are stored in entity_default.txt (though, like all other files, you may add more). They follow the same format as any other raw file:

entity_default

[OBJECT:ENTITY]

[ENTITY:ENTITYNAME]
[CREATURE:CREATURETYPE]
[TRANSLATION:LANGUAGETYPE]
[BIOME_SUPPORT:BIOMETOKEN:FREQENCY]
...[OTHER TAGS]...

Most of the time, it doesn't matter which order these tokens are in or where they're placed so long as they're below the "ENTITY:" identifier, but there are some important exceptions in the case of other files, especially creatures, which can contain a lot of "nested" tokens.

"[CREATURE:]" links the civilization with a specific creature defined in a creature file. This is the creature that'll be making up the entity's population, and will therefore be the creature you'll be playing as in fortress or adventure mode if the entity is a playable one. For example, if you wanted to do something silly, you could switch the "CREATURE:DWARF" entry in entity_default.txt with "CREATURE:ELF" and you would be marching elves around in fortress mode, although they would still use dwarven technology and language and names and so forth.

Oh, and before you get any funny ideas - it ''is'' possible to define more than one creature for a civ, but that won't work in quite the way you probably expect; later on, in the creature section, you'll learn about castes, which will provide a much more viable alternative, so try to bear with us until then.

"[TRANSLATION:]" defines the language file that the entity will be using, which will determine what their untranslated words are for things. This doesn't determine which words they use for naming things, only the way those words are spelled. The default language files are HUMAN, DWARF, ELF, and GOBLIN.

"[BIOME_SUPPORT:]" defines the biomes that civs will attempt to settle in. The "FREQUENCY" value determines the likelihood of them building there, but also raises an important point: most of the values you'll be setting for things are relative to each other. If one were to type:

[BIOME_SUPPORT:ANY_FOREST:1]
[BIOME_SUPPORT:SAVANNA:2]

This would have very much the same effect as:

[BIOME_SUPPORT:ANY_FOREST:5]
[BIOME_SUPPORT:SAVANNA:10]

This holds true for a lot of values throughout the files, excluding when it simply doesn't make sense, such as in materials.

You can find many details about the rest of the civilization tokens [[entity token|here]]. Besides those mentioned, some fundamental ones are the CIV_CONTROLLABLE token, which lets you control the civ in fortress mode, the INDIV_CONTROLLABLE token, which allows you to play the civ in adventure mode as an outsider, and the ADVENTURE_TIER token, which allows you to play a civ native (non-outsider) in adventure mode. Other tokens that you should pay attention to are START_BIOME and the ones regarding sites, but in general, you can just run through the aforementioned list and add or remove what you want.

If you have more than one civ with the CIV_CONTROLLABLE token, all the available civs from those entities will appear in the group selection section on the embark screen. It may not be immediately obvious from which species each civ may be - while this can be determined from legends mode, the topmost species in the "neighbors" display in the embark screen is always the same as the currently selected species; if your group is dwarven, dwarves will be topmost, whilst (say) elves will be topmost if your chosen group is elven. By default, the game seems to choose a civ (and therefore a species if there is more than one) at random.

You can also attempt to discern the civ yourself by the names it uses - this is the realm of "symbols", collections of words centered around a specific concept. The civ will use the words comprising whatever symbols are applicable to it for various things. This association might be a little obfuscating at first, so I'll run through it. Let's refer to the DWARF entity:

[SELECT_SYMBOL:WAR:NAME_WAR]
[SUBSELECT_SYMBOL:WAR:VIOLENT]
[SELECT_SYMBOL:BATTLE:NAME_BATTLE]
[SUBSELECT_SYMBOL:BATTLE:VIOLENT]
[SELECT_SYMBOL:SIEGE:NAME_SIEGE]
[SUBSELECT_SYMBOL:SIEGE:VIOLENT]

Here we can see that dwarves will generally name their wars first after words in the "NAME_WAR" symbol group, and then after words in the "VIOLENT" symbol group. This might, for example, result in a war being named "The War of Carnage". The symbols used for the other types of conflict are arrayed in a similar fashion. It would be trivial to replace the instances of VIOLENT with, say, PEACE and end up with a battle called "The Clash of Calm" or something.

[SELECT_SYMBOL:ROAD:NAME_ROAD]
[SELECT_SYMBOL:TUNNEL:NAME_TUNNEL]
[SELECT_SYMBOL:BRIDGE:NAME_BRIDGE]
[SELECT_SYMBOL:WALL:NAME_WALL]

The above applies here. Dwarves are fond of naming their roads and tunnels after roads and tunnels.

[SELECT_SYMBOL:REMAINING:ARTIFICE]
[SELECT_SYMBOL:REMAINING:EARTH]
[CULL_SYMBOL:ALL:DOMESTIC]
[CULL_SYMBOL:ALL:SUBORDINATE]
[CULL_SYMBOL:ALL:EVIL]
[CULL_SYMBOL:ALL:UNTOWARD]
[CULL_SYMBOL:ALL:FLOWERY]
[CULL_SYMBOL:ALL:NEGATIVE]
[CULL_SYMBOL:ALL:UGLY]
[CULL_SYMBOL:ALL:NEGATOR]

This section deals with everything else. The things that haven't already been dealt with (hence the "REMAINING") - such as site names, kingdom names, the names of individuals, and such - will have names from the ARTIFICE and EARTH symbol groups. After that the dwarf entity is told to cull all innapropriate symbols - this applies to everything (hence the "ALL") so if the game happens to choose a symbol associated with, say, EVIL for one of the battles, it'll scrap that name and try again. This sort of thing adds a lot of flavour to DF's entities and can account for a lot of a civ's perceived personality.

Another basic thing to note: any entity token that's dealing with weapons, armor, clothing, etc., will state the items that the civ can build natively, not necessarily the ones they can wear or use. For example, you could create a species with no clothes specified, but then rob a clothes shop in adventurer mode and wear everything you want, or give them weapons that are too large to wield and they could sell them, but not use them.

An easy method of creating a civilization is just to copy-paste a similar one to the bottom of the entity_default.txt file and edit things to your liking. Remember to always change the civ's "ENTITY:" identifier! This can be anything so long as it's not already existing.

At the end of some of the default entries you'll find a list of positions, both ones that'll directly affect you in fort mode (such as nobles) and ones that'll primarily affect worldgen and adventure mode. A list of the tokens applicable to positions can be found [[position token|here]]; they don't require a great deal of explanation.

== Modding the creatures ==

Creature modding is great fun. You can change nearly any aspect of a creature or make your own completely from scratch.

Modding creatures is very similar to modding civs: it's just a matter of editing, adding, or removing tokens, enclosed in square brackets underneath the creature's [CREATURE:] header. The creature entries contain all of the information about each and every non-random creature in the game, from animals to dwarves to goblins to even caravan wagons. A lot of the creature tokens are fairly self-explanatory; you can find a list of such tokens [[creature token|here]]. But before you start creating your own creatures, you'll want to learn how the tissues system works.

=== Creature materials and tissues ===

In the most basic sense, a creature is a series of bodyparts. These parts are defined in their own file, and we'll talk about them later. As a specific aspect of how creatures work which throws off a lot of prospective modders is the relationship between bodyparts, tissues, and materials. We're going to show you part of the creature entry for a bronze colossus (bear with us):

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[TISSUE:BRONZE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

At the top, we can see the "BODY:" token, followed by a list of bodyparts. As you've probably guessed, these parts make up the physical form of the colossus. But the colossus has to be made out of something - it has to have tissues. And those tissues also have to be made out of something - in this case, bronze.

Below the BODY token you'll see a TISSUE token, followed by an identifier, much like the others we've seen. The TISSUE block is determining how the tissue works, and which purposes it'll serve. As the colossus is just going to be made out of this one tissue, this tissue needs to act like bone, muscle, and everything else combined, hence the MUSCULAR, FUNCTIONAL and STRUCTURAL tokens. The tissue also references a material - INORGANIC:BRONZE - the properties of which are declared in the inorganic materials file, and the tissue is subsequently made out of this material. With us so far?

Below the tissue definition is the TISSUE_LAYER line. TISSUE_LAYER allows you to control where each tissue is applied. Its first argument defines if it's to search by bodypart category (BY_CATEGORY), bodypart type (BY_TYPE), or look for a specific part (BY_TOKEN). That's followed by the parts argument itself, which is in this case ALL (so the game's looking for parts in all categories, which is to say, every bodypart). This is followed by the tissue to be applied, BRONZE. So the TISSUE_LAYER token is telling the game to select all bodyparts in every category and make them out of the tissue "BRONZE". The colossus is now made of bronze.

By now you're probably thinking "Wow, if this was for a creature made out of however many tissues, this would be amazingly longwinded". And you're right. Luckily, there are two methods by which we can speed things up a lot.

Firstly, there are material and tissue templates. Let's say you were going to make a lot of creatures out of bronze, and you didn't want to have to copy and paste the bronze tissue all over the place. Instead, you create a tissue template. This goes, as you've probably guessed, in a tissue template file.

[TISSUE_TEMPLATE:BRONZE_TEMPLATE]
[TISSUE_NAME:bronze:bronze]
[TISSUE_MATERIAL:INORGANIC:BRONZE]
[MUSCULAR]
[FUNCTIONAL]
[STRUCTURAL]
[RELATIVE_THICKNESS:1]
[CONNECTS]
[TISSUE_SHAPE:LAYER]

Now, instead of applying the tissue to each and every bronze creature you're making, you can just refer to the template:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:HUMANOID_JOINTS:5FINGERS:5TOES]
[NO_THOUGHT_CENTER_FOR_MOVEMENT]
[USE_TISSUE_TEMPLATE:BRONZE:BRONZE_TEMPLATE]
[TISSUE_LAYER:BY_CATEGORY:ALL:BRONZE]
...

Material templates work in the same way, but refer to materials instead of tissues.

However, if we're looking at something like a dwarf, even with the templates, editing can get very slow indeed:

...
[USE_MATERIAL_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BONE:BONE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:CARTILAGE:CARTILAGE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HAIR:HAIR_TEMPLATE]
[USE_MATERIAL_TEMPLATE:TOOTH:TOOTH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:EYE:EYE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:NERVE:NERVE_TEMPLATE]
[USE_MATERIAL_TEMPLATE:BRAIN:BRAIN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LUNG:LUNG_TEMPLATE]
[USE_MATERIAL_TEMPLATE:HEART:HEART_TEMPLATE]
[USE_MATERIAL_TEMPLATE:LIVER:LIVER_TEMPLATE]
[USE_MATERIAL_TEMPLATE:GUT:GUT_TEMPLATE]
[USE_MATERIAL_TEMPLATE:STOMACH:STOMACH_TEMPLATE]
[USE_MATERIAL_TEMPLATE:PANCREAS:PANCREAS_TEMPLATE]
[USE_MATERIAL_TEMPLATE:SPLEEN:SPLEEN_TEMPLATE]
[USE_MATERIAL_TEMPLATE:KIDNEY:KIDNEY_TEMPLATE]
[USE_TISSUE_TEMPLATE:SKIN:SKIN_TEMPLATE]
[USE_TISSUE_TEMPLATE:FAT:FAT_TEMPLATE]
[USE_TISSUE_TEMPLATE:MUSCLE:MUSCLE_TEMPLATE]
...

This is where body detail plans come in. Detail plans, of course, have their own file, and they are designed to help automate some of the more common processes in creature creation. The first entry in b_detail_plan_default.txt does exactly what we've been trying to do above: it takes all the common materials and shoves them into one plan, which can be referenced with a single token.

...
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
...

Much easier. But what about the TISSUE_LAYER tokens? Will we have to type out all of those manually?

Nope, detail plans have that covered as well. It's possible to place variable arguments into a detail plan. For example:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS]
[BP_LAYERS:BY_CATEGORY:BODY:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_UPPER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:BODY_LOWER:ARG3:50:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
[BP_LAYERS:BY_CATEGORY:ARM_UPPER:ARG4:25:ARG3:25:ARG2:5:ARG1:1]
...
[BP_LAYERS:BY_CATEGORY:NOSE:ARG5:4:ARG1:1]
...

First an argument is placed in the plan (ARG1, ARG2 etc.), followed by the thickness of the tissue that will be inserted in place of the argument. So when we reference the VERTEBRATE_TISSUE_LAYERS plan, we'll be able to do something like this:

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]

ARG1 in the detail plan is replaced by SKIN, the first tissue we entered. ARG2 is replaced by FAT, ARG3 by muscle, ARG4 by bone, and ARG5 by CARTILAGE. Hence, our creature's bodypart designated as BODY is made up of SKIN with thickness 1, FAT with thickness 5, and MUSCLE with thickness 50. Its nose is made up of SKIN (thickness 1) and CARTILAGE (thickness 4).

Things left out of the body plans aside, our dwarf's entire body, material, tissue and tissue layer tokens have been boiled down to this:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

This can save you a lot of time and space if you're making lots of changes common to many creatures. In general, if you're making a creature that's fleshy or chitinous, there are detail plans already included in the game to help you out. You should only have to resort to declaring tissues individually (like our bronze colossus) if you're doing something really out-of-the-ordinary.

Another great thing about templates (and so, detail plans) is that they can be modified after being declared. Let's say we wanted our dwarves to be perpetually on fire (don't ask). We declare the body stuff normally:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
...

We then select the appropriate material:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
...

We don't want them burning to death, so we'll need to stop that from happening:

...
[BODY:HUMANOID:2EYES:2EARS:NOSE:2LUNGS:HEART:GUTS:ORGANS:HUMANOID_JOINTS:
THROAT:NECK:SPINE:BRAIN:SKULL:5FINGERS:5TOES:MOUTH:FACIAL_FEATURES:TEETH:RIBCAGE]
[BODY_DETAIL_PLAN:STANDARD_MATERIALS]
[BODY_DETAIL_PLAN:STANDARD_TISSUES]
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE]
[SELECT_MATERIAL:SKIN]
[MAT_FIXED_TEMP:10600]
[SELECT_MATERIAL:ALL]
[HEATDAM_POINT:NONE]
...

Note that this makes use of DF's built-in temperature scale. You can read more about that [[Temperature|on this page]]. We're also referencing material tokens, which we haven't gone over yet - we'll talk about making your own materials later.

=== Creature castes ===

Another potentially extremely powerful part of the creature raws is the caste system. The caste system handles both true biological castes and lesser variations, such as sexes.

To understand the true potential of the caste system, we only need to take a look at the raws for antmen, found in creature_subterrenean.txt:

...
[CASTE:WORKER]
[CASTE_NAME:worker ant woman:worker ant women:worker ant woman]
Female, but non-breeding.
[POP_RATIO:10000]
[CASTE:SOLDIER]
[CASTE_NAME:soldier ant woman:soldier ant women:soldier ant woman]
Female, but non-breeding.
[POP_RATIO:1000]
[CASTE:DRONE]
[MALE]
[CASTE_NAME:drone ant man:drone ant men:drone ant man]
[POP_RATIO:5]
[CASTE:QUEEN]
[FEMALE]
[CASTE_NAME:queen ant woman:queen ant women:queen ant woman]
[POP_RATIO:1]
[SELECT_CASTE:WORKER]
[SELECT_ADDITIONAL_CASTE:SOLDIER]
[SELECT_ADDITIONAL_CASTE:QUEEN]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[SELECT_CASTE:DRONE]
[BODY:HUMANOID_4ARMS:2EYES:HEART:GUTS:BRAIN:MOUTH:2WINGS]
[BODYGLOSS:INSECT_UPPERBODY:INSECT_LOWERBODY]
[FLIER]
[SELECT_CASTE:ALL]
[BODY_DETAIL_PLAN:CHITIN_MATERIALS]
[BODY_DETAIL_PLAN:CHITIN_TISSUES]
[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:CHITIN:FAT:MUSCLE]
[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS]
[ATTACK:PUNCH:BODYPART:BY_TYPE:GRASP]
[ATTACK_SKILL:GRASP_STRIKE]
[ATTACK_VERB:punch:punches]
...

It's evident that the process of creating and editing castes is comparable to the modifications we were making to tissues and materials earlier: A caste is declared, and modifications to the base creature are made. Declared castes can be selected and subsequently modified, again, just like tissues and materials.

In this case, each caste is declared, given its own name, and a POP_RATIO, which determines how commonly a birth results in that caste - for every 10000 workers born, there'll be an average of 1000 soldiers, 5 drones and one queen. You've probably also noticed that the DRONE and QUEEN castes have the MALE and FEMALE tokens respectively - these tokens determine how breeding works. A creature without both a MALE caste and a FEMALE caste will be unable to breed (no asexual creatures yet, unfortunately). As they lack FEMALE, the workers and soldiers are unable to breed with the male drones.

After this, there are some modifications to bodyparts. In this case, the drones have wings and the FLIER token, which the other castes lack. It's entirely possible for creatures of different castes to have completely different body stuctures, even to the extent that they don't resemble each other at all. If you read the section of this guide that dealt with entities, you may remember a passing mention of multi-creature civilisations and how they don't quite work as you may think they would. The castes system is your workaround. You could create a caste that is, for all intents and purposes, a human, and another caste of the same creature that acts exactly like a giant cave spider, put the creature in a civ, and get a human-spider civ. The only flaw in this approach is that the castes will interbreed.

That's the most complex components of creature creation out of the way. You should find the rest trivial by comparison.

== Modding items ==

Items are fairly simple to deal with. By default, each item type is contained in its own file; this may help make browsing for a specific item easier, but from a purely technical point of view, it's possible to throw all items into one file. Unfortunately, item tokens don't seem to be especially well-documented (at least not as well as the other object types), but you should be able to figure out most things by way of our explanations and your assumptions.

Let's look at the entry for, of course, the thong:

[ITEM_PANTS:ITEM_PANTS_THONG]
[NAME:thong:thongs]
[LAYER:UNDER]
[COVERAGE:25]
[LAYER_SIZE:10]
[LAYER_PERMIT:30]
[MATERIAL_SIZE:1]
[SOFT]
[LEATHER]
[STRUCTURAL_ELASTICITY_WOVEN_THREAD]

Most of these are pretty obvious if one compares them to the other entries in the file. There's a layer for the item, determining where it's worn; a coverage value to determine how well it protects you from cold and other things; a size token to determine how much it counts for when it's under something else; a layer permit token to determine how much can be worn under it; and a material size token to determine how much raw material it takes to make it.

Now, if you wanted to mod these to turn them into metal thongs (ouch!), you would simply have to add [METAL] to it somewhere. Simple! These tokens work by tying into material properties - some materials are designated as suitable for making hard items, some for soft, etc..

Weapons involve a little more detail:

[ITEM_WEAPON:ITEM_WEAPON_SWORD_2H]
[NAME:two-handed sword:two-handed swords]
[SIZE:900]
[SKILL:SWORD]
[TWO_HANDED:67500]
[MINIMUM_SIZE:62500]
[MATERIAL_SIZE:5]
[ATTACK:EDGE:100000:8000:slash:slashes:NO_SUB:1250]
[ATTACK:EDGE:50:4000:stab:stabs:NO_SUB:1000]
[ATTACK:BLUNT:100000:8000:slap:slaps:flat:1250]
[ATTACK:BLUNT:100:1000:strike:strikes:pommel:1000]

SIZE determines how heavy the weapon is. This has a substantial effect on weapon effectiveness. SKILL determines which skill is used in using the weapon; a list of skills can be found [[skill token|on this page]]. MINIMUM_SIZE determines the minimum size a creature must be before the weapon can be wielded, while TWO_HANDED determines how large a creature must be in order to wield the weapon with one hand.

Attacks take a little more explanation. The first value determines the contact area of the weapon's attack; this should be high for slashing weapons and low for bludgeoning, piercing and poking ones. The second value determines how deep the weapon penetrates - for BLUNT attacks this value is ignored as they're not supposed to penetrate anyway, but in the case of EDGE attacks it should generally be lower for slashing attacks and higher for stabbing attacks.

Following these are the nouns and verb used; they should be self-explanatory. Finally, we have the velocity modifier, which has a multiplying effect on the weapon's size for the purposes of determining how powerful it is in combat.

Other, more miscellaneous items are generally simple and shouldn't require any further explanation.

Once you've made an item, you just add it to the civ entry so a civilization can actually craft it, and it's done.

== Modding language files ==

Let's say you added a whole new species. Sure, you could just swipe one of the existing translation files and steal their language for your species, but that's the lazy way! If you want to create a whole new language, it is very simple.

First, you'd need a whole new language_RACE file, such as language_LIZARDMAN.txt, along with "language_LIZARDMAN" at the top of the file proceeded by [OBJECT:LANGUAGE] and [TRANSLATION:LIZARDMAN]. After that, it's just a matter of copy-pasting one of the existing language lists and editing the finished 'translated' word. That's it! Then just add the translation link to your civ in entity_default.txt and it'll be added to the game on worldgen.

(Note that the name of the file doesn't actually matter; however, it's good form to name the file after a creature if only that creature speaks the language.)

== Modding body parts ==

Imagine you have this fantastic idea for a multi-tentacled winged spider-monster. Sounds great! But in order to make this a reality you may need to create a new set of body parts for it. That's no problem! Making body parts is easy, though it may look complicated at first.

All of the default body definitions are located in body_default.txt and then linked to a creature in the creature's entry. We've talked about how bodyparts make up creatures earlier, in the creature section. You can mix and match them in the creature entry and it makes no difference, as long as they're there: each bodypart will link itself to the appropriate connection automatically when the creature is first created.

Body parts work by sections: you can add as many sections as you want to a bodypart definition, but generally you should keep it fairly low for ease of use. Each body section entry is in the, very simple, format:

[BODY:BODYNAME]
[BP:TOKENID:name][TOKENSGOHERE][DEFAULT_RELSIZE:][CATEGORY:WHATEVER]

The most important tokens are "CONTYPE" and "CON": CONTYPE means the bodypart in question is connected to a certain ''type'' of bodypart, while CON means it's connected to a ''specific'' one. TOKENID is yet another identifier, which should be unique, as it's referenced every time something uses CON or BY_TOKEN. DEFAULT_RELSIZE defines, of course, what the bodypart's size is in relation to the other parts. CATEGORY defines a category for the part, which can be unique or shared with other parts. This is referenced whenever BY_CATEGORY is used.

A list of bodypart tokens can be found [[body token|here]].

Let's take a simple example, a head:

[BODY:BASIC_HEAD]
[BP:HD:head:STP][CONTYPE:UPPERBODY][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]

It connects directly to an upper body.

[BODY:2EYES]
[BP:REYE:right eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][RIGHT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]
[BP:LEYE:left eye:STP][CONTYPE:HEAD][SIGHT][EMBEDDED][SMALL][LEFT][CATEGORY:EYE]
[DEFAULT_RELSIZE:5]

These are a pair of eyes, connecting to the head.

[BODY:HUMANOID]
[BP:UB:upper body:upper bodies][UPPERBODY][CATEGORY:BODY_UPPER]
[DEFAULT_RELSIZE:1000]
[BP:LB:lower body:lower bodies][CON:UB][LOWERBODY][CATEGORY:BODY_LOWER]
[DEFAULT_RELSIZE:1000]
[BP:HD:head:STP][CON:UB][HEAD][CATEGORY:HEAD]
[DEFAULT_RELSIZE:300]
[BP:RUA:right upper arm:STP][CON:UB][LIMB][RIGHT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:LUA:left upper arm:STP][CON:UB][LIMB][LEFT][CATEGORY:ARM_UPPER]
[DEFAULT_RELSIZE:200]
[BP:RLA:right lower arm:STP][CON:RUA][LIMB][RIGHT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:LLA:left lower arm:STP][CON:LUA][LIMB][LEFT][CATEGORY:ARM_LOWER]
[DEFAULT_RELSIZE:200]
[BP:RH:right hand:STP][CON:RLA][GRASP][RIGHT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:LH:left hand:STP][CON:LLA][GRASP][LEFT][CATEGORY:HAND]
[DEFAULT_RELSIZE:80]
[BP:RUL:right upper leg:STP][CON:LB][LIMB][RIGHT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:LUL:left upper leg:STP][CON:LB][LIMB][LEFT][CATEGORY:LEG_UPPER]
[DEFAULT_RELSIZE:500]
[BP:RLL:right lower leg:STP][CON:RUL][LIMB][RIGHT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:LLL:left lower leg:STP][CON:LUL][LIMB][LEFT][CATEGORY:LEG_LOWER]
[DEFAULT_RELSIZE:400]
[BP:RF:right foot:right feet][CON:RLL][STANCE][RIGHT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]
[BP:LF:left foot:left feet][CON:LLL][STANCE][LEFT][CATEGORY:FOOT]
[DEFAULT_RELSIZE:120]

An entire humanoid body. The foot bone's connected to the ankle bone...

"BODYGLOSS" entries, which you can sometimes find applied to creature entries, are simply replacement words for specific part name strings in a creature. For example, you'll find the bodygloss [BODYGLOSS:CLAW_HAND:hand:claw] in body_default.txt; you can then use this in a creature via "[BODYGLOSS:CLAW_HAND]" and it'll replace all instances of "hand" with "claw" in that creature. Be warned, however—if you were to, say make a bodygloss [BODYGLOSS:EARSTALK:ear:stalk:ears:stalk], it would not only change "ear" and "ears" to "stalk" and "stalks", it would also change "h'''ear'''t" to "h'''stalk'''t"! For all intents and purposes the body part will still function as the proper part, though.

== Modding plants ==

Plants are, again, not unlike creatures. With what you've learned so far in regard to tokens and the materials system, running through the notes included in plant_standard.txt should explain most things. [[Plant token|Here's the list of plant-specific tokens]].

Below is the [[plump helmet]] raw description:

[PLANT:MUSHROOM_HELMET_PLUMP]
[NAME:plump helmet][NAME_PLURAL:plump helmets][ADJ:plump helmet]
[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]
[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PICKED_TILE:161][PICKED_COLOR:6:13:0]
[GROWDUR:300][VALUE:2]
[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen dwarven wine]
[STATE_NAME_ADJ:LIQUID:dwarven wine]
[STATE_NAME_ADJ:GAS:boiling dwarven wine]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:5:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]

[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[EDIBLE_COOKED]
[SEED:plump helmet spawn:plump helmet spawn:4:0:1:LOCAL_PLANT_MAT:SEED]
[SPRING][SUMMER][AUTUMN][WINTER]
[FREQUENCY:100]
[CLUSTERSIZE:5]
[PREFSTRING:rounded tops]
[WET][DRY]
[BIOME:SUBTERRANEAN_WATER]
[UNDERGROUND_DEPTH:1:3]
[SHRUB_TILE:142]
[DEAD_SHRUB_TILE:28]
[SHRUB_COLOR:5:13:0]
[DEAD_SHRUB_COLOR:5:6:0]

Let's look at this line by line: 
First, we define its file name. In this case it's MUSHROOM_HELMET_PLUMP. Next we define its in-game name (plump helmet) and its adjective for if you were to craft with it (e.g. plump helmet earrings).

[USE_MATERIAL_TEMPLATE:STRUCTURAL:STRUCTURAL_PLANT_TEMPLATE]
[MATERIAL_VALUE:2]
[BASIC_MAT:LOCAL_PLANT_MAT:STRUCTURAL]

This defines the structure and material of the plant. It references STRUCTURAL_PLANT_TEMPLATE in the first line, so if you were to say, add wings to the template, the plump helmet plant would be winged. This is for the plant itself, not the end plump helmets.

After that we get our edible tokens. These say that vermin can eat the plant, and it can be eaten raw or cooked by your dwarves. So if you wanted a plant vermin would leave alone, you'd remove the [EDIBLE_VERMIN] token.

[EDIBLE_VERMIN]
[EDIBLE_RAW]
[EDIBLE_COOKED]

Next, [PICKED_TILE:161] is the character (161 in this case) shown when the crop is harvested. See [[Main:Character table|character table]] for a table of usable tiles. [PICKED_COLOR:6:13:0] is the color used for the crop's tile when harvested. It's in a foreground:background:brightness format. See [[color]] for the colors usable.

[PICKED_TILE:161][PICKED_COLOR:6:13:0]

[GROWDUR:300] is how long it takes for your crop to grow. There are 1008 growdur units in a season. 
[VALUE:2] Is the value of harvested plant (default 1). Appears to have no effect in version 0.31.

[GROWDUR:300][VALUE:2]

This defines the plant's alcohol states. [STATE_NAME_ADJ:ALL_SOLID:] is the frozen name, followed is the actual drink name, and then its boiling name. These are achieved by either Scorching or Freezing climates. [DISPLAY_COLOR] is, of course, color, and [EDIBLE_RAW] and [EDIBLE_COOKED] are saying you can drink the alcohol raw or cooked.

[USE_MATERIAL_TEMPLATE:DRINK:PLANT_ALCOHOL_TEMPLATE]
[STATE_NAME_ADJ:ALL_SOLID:frozen dwarven wine]
[STATE_NAME_ADJ:LIQUID:dwarven wine]
[STATE_NAME_ADJ:GAS:boiling dwarven wine]
[MATERIAL_VALUE:2]
[DISPLAY_COLOR:5:0:0]
[EDIBLE_RAW]
[EDIBLE_COOKED]
[PREFIX:NONE]
[DRINK:LOCAL_PLANT_MAT:DRINK]

After that we get our seed template:

[USE_MATERIAL_TEMPLATE:SEED:SEED_TEMPLATE]
[MATERIAL_VALUE:1]
[EDIBLE_VERMIN]
[EDIBLE_COOKED]
[SEED:plump helmet spawn:plump helmet spawn:4:0:1:LOCAL_PLANT_MAT:SEED]

And all this says is that the seeds may be eaten by vermin or cooked. Then it gives the name of our plant's seed, its plural name, its foreground, background, and brightness colors, followed by its seed material; said material should have [SEED_MAT] to permit proper stockpiling.

And finally for the last chunk we have this:

[SPRING][SUMMER][AUTUMN][WINTER]
[FREQUENCY:100]
[CLUSTERSIZE:5]
[PREFSTRING:rounded tops]
[WET][DRY]
[BIOME:SUBTERRANEAN_WATER]
[UNDERGROUND_DEPTH:1:3]
[SHRUB_TILE:142]
[DEAD_SHRUB_TILE:28]
[SHRUB_COLOR:5:13:0]
[DEAD_SHRUB_COLOR:5:6:0]

First we define what season(s) the plant may grow in, then we define how frequently this plant is generated in a particular area, followed by how many harvested crop items may come from 1 plant. [PREFSTRING:] is what your dwarves like about the plant, which in this case is the rounded tops. [WET][DRY] are the conditions under which the plant can grow. Wet means it can grow close to water, dry means it can grow away from water. This does not mean you can grow the plant on dry stone however. It is just for natural spawning of the plant. 
[BIOME] Is what biome the plant grows in. [UNDERGROUND_DEPTH:Minimum:Maximum] Is the highest and lowest cavern levels that the plant can appear in if its biome is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1. Defaults to 0:0 (surface only). 
Lastly, [SHRUB_TILE] is the character used for the naturally spawning shrub of this plant, [DEAD_SHRUB] is the dead shrub character. [SHRUB_COLOR] Is the shrub's color, and [DEAD_SHRUB_COLOR] is, of course, the dead shrub's color.

While this may or may not look like a lot of tokens, it's very easy. Just copy an existing plant and edit it to your new plant. 
For the rest of the tokens, see [[plant token]].

== Workshops ==

Workshops are raw-designed pretty differently from everything else in the game, being buildable structures rather than items or methods to gain items. However, they are fairly simple. For example, here's the raw for the [[soap maker's workshop]]:

[BUILDING_WORKSHOP:SOAP_MAKER]
[NAME:Soap Maker's Workshop]
[NAME_COLOR:7:0:1]
[DIM:3:3]
[WORK_LOCATION:2:2]
[BUILD_LABOR:SOAP_MAKER]
[BUILD_KEY:CUSTOM_SHIFT_S]
[BLOCK:1:0:0:1]
[BLOCK:2:0:0:1]
[BLOCK:3:0:0:0]
[TILE:0:1:' ':' ':150]
[TILE:0:2:' ':' ':'/']
[TILE:0:3:'-':' ':' ']
[COLOR:0:1:0:0:0:0:0:0:6:0:0]
[COLOR:0:2:0:0:0:0:0:0:6:0:0]
[COLOR:0:3:6:0:0:0:0:0:0:0:0]
[TILE:1:1:' ':' ':'=']
[TILE:1:2:'-':' ':8]
[TILE:1:3:' ':' ':150]
[COLOR:1:1:0:0:0:0:0:0:6:0:0]
[COLOR:1:2:6:0:0:0:0:0:6:0:0]
[COLOR:1:3:0:0:0:0:0:0:6:0:0]
[TILE:2:1:'-':' ':8]
[TILE:2:2:' ':' ':8]
[TILE:2:3:' ':150:' ']
[COLOR:2:1:6:0:0:0:0:0:6:0:0]
[COLOR:2:2:0:0:0:0:0:0:6:0:0]
[COLOR:2:3:0:0:0:6:0:0:0:0:0]
[TILE:3:1:150:' ':8]
[TILE:3:2:' ':' ':8]
[TILE:3:3:' ':240:' ']
[COLOR:3:1:6:0:0:0:0:0:6:7:0]
[COLOR:3:2:0:0:0:0:0:0:6:7:0]
[COLOR:3:3:0:0:0:7:0:1:0:0:0]
[BUILD_ITEM:1:BUCKET:NONE:NONE:NONE][EMPTY][CAN_USE_ARTIFACT]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]

A line-by-line breakdown:

[NAME:Soap Maker's Workshop]
[NAME_COLOR:7:0:1]

These are the name of the workshop ("Soap Maker's Workshop") and [[color]] of the workshop's name when examined with 'q' (White with a black background).

[DIM:3:3]
[WORK_LOCATION:2:2]

DIM refers to how large the workshop will be, in this case 3 wide, 3 tall. WORK_LOCATION tells where the creature using it (usually a dwarf) will work, numbered from the top right--in this case, 2:2, or the middle. Multiple work locations can be defined, even outside the dim.

[BUILD_LABOR:SOAP_MAKER]
[BUILD_KEY:CUSTOM_SHIFT_S]

These refer to the worker required to build it (soap maker) and the key used to build it in the workshop menu (capital S).

[BLOCK:1:0:0:1]
...
This is a bit more complex, and is where we get to the meaty part of workshop making--the tiles' properties. BLOCK refers to which tiles will be untraversable--1 means blocked, 0 means unblocked. The first number refers to row, and the next 3 refer to column, so 1:0:0:1 means that, on the first row, the first two tiles will be unblocked and the last will be blocked.

[TILE:0:1:' ':' ':150]
...
The TILE token tells which tile will go where. note, however, that there are 5 entries here instead of 4. The first number, in this case, refers to build stage, numbered from 0 to 3; 3 or 1 is fully built (depending on whether there are stages), 0 is just placed, and 2 is always an intermediate stage, while 1 is usually an intermediate stage. Whether 1 is an intermediate stage or not depends on if there are a 2 and 3 stage; if 2 and 3 exist, 1 will be intermediate. The second number and beyond are similar to BLOCK; however, instead of 1s and 0s, you must input tiles. The tiles themselves can be given in quotes (as in ' ') or given as a number, which can be looked up [[Tilesets|here]]. Here, we have 150, which is û.

[COLOR:1:1:0:0:0:0:0:0:6:0:0]
...
Color is as TILE, but with colors instead of tiles; however, colors are made up of 3 numbers each or MAT. MAT refers to the color of the material used to make it; the 3 numbers refer to foreground:background:foreground brightness, and can be looked up [[Color|here]]. For example, 4:2:1 will give you bright red with a dark green background.

[BUILD_ITEM:1:BUCKET:NONE:NONE:NONE][EMPTY][CAN_USE_ARTIFACT]
[BUILD_ITEM:1:NONE:NONE:NONE:NONE][BUILDMAT][WORTHLESS_STONE_ONLY][CAN_USE_ARTIFACT]
These refer to items required to build the building. These are in the same format as [[Reaction|reaction reagents and products]]--quantity:[[Item token|item]]:[[Material token|material]]. You'll learn more about those on the article about [[Reaction|reactions]], though. The second BUILD_ITEM is special-- it uses modifiers exclusively to determine its requirements. BUILDMAT refers to wood logs, wood blocks, stone boulders, and stone blocks; WORTHLESS_STONE_ONLY means it can't use economic stone; CAN_USE_ARTIFACT means that it... can use artifacts. EMPTY, in the bucket's case, means that the bucket must be empty.

More can be seen at the [[Building token|building tokens]] article.

== Reactions ==

An in-depth guide for reactions is available [[Reactions|here]].

== Materials ==

As we've seen when talking about creatures, materials are vital. Materials show up in two forms: material templates, which generally show up in creatures, and specific materials (designated as "inorganic"), which are (by default, at least) consigned purely to metal and stone types.

Let's take a look at METAL_TEMPLATE in material_template_default.txt. It's evident that most of the basic properties of metals are already defined in the template - it goes red and melts at a high enough temperature, it's heavy, and (as noted by the very bottom token) is a metal. We already know just how useful templates can be to creatures, and the same applies to other materials.

Now let's take a look at inorganic_metal.txt. You can see that the metals here refer to the templates, and, just like we did with creatures, then modify the properties of that template and expand upon it.

Finally, let's look at inorganic_stone_mineral.txt. Here we can see that in addition to the changes made to the template, there are also ENVIRONMENT tokens - these tell the game where to place these minerals during worldgen.

[[material definition token|Here's a list of material tokens]]. It should also help you out with any modifications you want to make regarding those creature modifications we were making a while back. See, it all ties together in the end. The beauty of the current materials system is that there's actually very little difference between, say, leather and iron - they're fundamentally the same thing, just with different properties, which is how things really should be.

== Examples ==

The Hydling by Mysteryguye (annotated, updated and separated into blocks by Putnam)

[CREATURE:HYDLING]
[DESCRIPTION:A seven-headed small hairy thing, about the size of a dog. It is very loyal to its masters, and will promptly disembowel any enemy straying too close.]
This is the description that shows up in-game when viewing the creature.

[NAME:hydling:hydlings:hydlish] If there were a civ made of hydlings, it would appear as "hydlings" in the neighbors screen.

[CASTE_NAME:hydling:hydlings:hydlish]

[CREATURE_TILE:'='][COLOR:2:0:1] Will appear as a light green "=".

[PETVALUE:78][NATURAL] Creature is known to be naturally occurring by the game. Will cost 40 embark points to buy.

[LARGE_ROAMING] Will spawn outdoors, wandering around.

[COMMON_DOMESTIC][TRAINABLE][PET] Can be bought on embark as a pet, war animal, or hunting animal.

[BONECARN] Can eat meat and bones only--no vegetables.

[PREFSTRING:loyalty] Dwarves will like it for its loyalty.

[LIKES_FIGHTING] Will attack rather than flee.

[BODY:BASIC_2PARTBODY:7HEADNECKS:BASIC_FRONTLEGS:BASIC_REARLEGS:TAIL:2EYES:NOSE:2LUNGS:HEART:GUTS:ORGANS:THROAT:SPINE:BRAIN:SKULL:3TOES_FQ_REG:3TOES_RQ_REG:MOUTH:TONGUE:GENERIC_TEETH_WITH_FANGS:RIBCAGE]

Has a lower body, upper body, 4 legs, a tail, ten eyes, ten ears, five noses, two lungs, a heart, guts, a pancreas etc., and 5 heads with all that goes with those.

[BODYGLOSS:PAW] Feet will be called "paws"

[BODY_DETAIL_PLAN:STANDARD_MATERIALS] Declares the standard materials that most creatures' tissues are made of.

[BODY_DETAIL_PLAN:STANDARD_TISSUES] This declares the tissues that the creature's tissue layers are made of.

[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] And this describes the tissue layers that the creature is made of.

[BODY_DETAIL_PLAN:BODY_HAIR_TISSUE_LAYERS:HAIR] Creature will be covered with a layer of fur.

[USE_MATERIAL_TEMPLATE:NAIL:NAIL_TEMPLATE] And it'll have nails.

[USE_TISSUE_TEMPLATE:NAIL:NAIL_TEMPLATE]

[TISSUE_LAYER:BY_CATEGORY:TOE:NAIL:FRONT] On the toe, specifically.

[SELECT_TISSUE_LAYER:HEART:BY_CATEGORY:HEART]
[PLUS_TISSUE_LAYER:SKIN:BY_CATEGORY:THROAT]
[TL_MAJOR_ARTERIES] Heart and throat--called above--will cause heavy bleeding if ruptured.

[BODY_DETAIL_PLAN:STANDARD_HEAD_POSITIONS] Places eyes, ears and what have you into their correct placement, so that you don't have people punching out eyes from behind.

[BODY_DETAIL_PLAN:HUMANOID_RIBCAGE_POSITIONS] Sets the ribcage as being around lungs and heart.

[USE_MATERIAL_TEMPLATE:SINEW:SINEW_TEMPLATE] Defines sinew so that...
[TENDONS:LOCAL_CREATURE_MAT:SINEW:200] Tendons
[LIGAMENTS:LOCAL_CREATURE_MAT:SINEW:200] And ligaments can be defined.

[HAS_NERVES] Creature has nerves, and as such can be disabled by severing them.

[USE_MATERIAL_TEMPLATE:BLOOD:BLOOD_TEMPLATE] Defines the material BLOOD using the template BLOOD_TEMPLATE.
[BLOOD:LOCAL_CREATURE_MAT:BLOOD:LIQUID] Defines the creature's BLOOD as being made of the above-defined BLOOD material in a LIQUID state.

[CREATURE_CLASS:GENERAL_POISON] Creature can be affected by syndromes that affect GENERAL_POISON.

[GETS_WOUND_INFECTIONS] Pretty much self-explanatory. Creature can get infected from wounds.
[GETS_INFECTIONS_FROM_ROT] And from necrosis.

[USE_MATERIAL_TEMPLATE:PUS:PUS_TEMPLATE] Defines PUS using PUS_TEMPLATE.
[PUS:LOCAL_CREATURE_MAT:PUS:LIQUID] Defines PUS as being made of PUS.

[BODY_SIZE:0:0:1000] Creature will be 1000 cubic centimeters at birth...
[BODY_SIZE:1:0:12500] 12500 cubic centimeters at 1 year old...
[BODY_SIZE:2:0:30000] and 30000 cubic centimeters at 2.

[BODY_APPEARANCE_MODIFIER:LENGTH:90:95:98:100:102:105:110] Creature can be anywhere from 90% to 110% as long as others.
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] As above, but with height.
[BODY_APPEARANCE_MODIFIER:BROADNESS:90:95:98:100:102:105:110] As above, but with broadness. This puts the minimum size of the creature (when fully grown) at 21870 and the maximum size at 39930.

[MAXAGE:20:30] Creature will die of old age between the ages of 20 and 30, no later than 30, no sooner than 20.

[CAN_DO_INTERACTION:MATERIAL_EMISSION] Creature can use the MATERIAL_EMISSION interaction.
[CDI:ADV_NAME:Hurl fireball] In adventurer mode, the MATERIAL_EMISSION interaction will appear as "Hurl fireball".
[CDI:USAGE_HINT:ATTACK] Creature will use MATERIAL_EMISSION when it's attacking, on creatures that it's attacking.
[CDI:BP_REQUIRED:BY_CATEGORY:HEAD] Creature must have at least one HEAD to use MATERIAL_EMISSION.
[CDI:FLOW:FIREBALL] The MATERIAL_EMISSION will shoot a fireball.
[CDI:TARGET:C:LINE_OF_SIGHT] The target for the emission--a location--must be within the line of sight of the Hydling.
[CDI:TARGET_RANGE:C:15] And must be, at most, 15 tiles away.
[CDI:MAX_TARGET_NUMBER:C:1] The hydling can only shoot at one target at a time...
[CDI:WAIT_PERIOD:30] and only every 30 ticks (3 tenths of a second at 100 FPS)

[ATTACK:BITE:CHILD_BODYPART_GROUP:BY_CATEGORY:HEAD:BY_CATEGORY:TOOTH] Defines a BITE attack that uses teeth.
[ATTACK_SKILL:BITE] Attack uses the BITE skill.
[ATTACK_VERB:nom:noms] "The Hydling noms the Elf in the left first toe, tearing the muscle!"
[ATTACK_CONTACT_PERC:100] Will use all of the tooth. Note that this can be more than 100.
[ATTACK_PENETRATION_PERC:100] Will sink the tooth all the way in. This can also be more than 100.
[ATTACK_FLAG_EDGE] Attack is an EDGE attack.
[ATTACK_PRIORITY:MAIN] Attack is of priority MAIN. Other option is SECOND.
[ATTACK_FLAG_CANLATCH] Attack can latch.
[ATTACK_PREPARE_AND_RECOVER:3:3] Takes 3 ticks to wind up attack and 3 to recover from it.
[ATTACK_FLAG_INDEPENDENT_MULTIATTACK] Can use each head independently.

[ATTACK:SCRATCH:CHILD_TISSUE_LAYER_GROUP:BY_TYPE:STANCE:BY_CATEGORY:ALL:NAIL] As above, but for nail instead of teeth.
[ATTACK_SKILL:STANCE_STRIKE] Uses the kicking skill.
[ATTACK_VERB:slice:slices] "You slice the Elf in the left foot and the severed part sails off in an arc!"
[ATTACK_CONTACT_PERC:100] Uses the whole nail.
[ATTACK_PENETRATION_PERC:100] The whole nail goes in.
[ATTACK_FLAG_EDGE] Attack is an edge attack.
[ATTACK_PREPARE_AND_RECOVER:3:3]
[ATTACK_PRIORITY:SECOND]

[CHILD:1] Hydling will become an adult at 1 year old.

[GENERAL_CHILD_NAME:hydie:hydies] Children will appear as "hydies".

[DIURNAL] Is active during the daytime.

[HOMEOTHERM:10070] Has a body temperature of 102 Fahrenheit.

[APPLY_CREATURE_VARIATION:STANDARD_QUADRUPED_GAITS:900:730:561:351:1900:2900] Can run at 25 kph
[APPLY_CREATURE_VARIATION:STANDARD_SWIMMING_GAITS:3512:2634:1756:878:4900:6900] Can swim at 10 kph
[APPLY_CREATURE_VARIATION:STANDARD_CRAWLING_GAITS:6561:6115:5683:1755:7456:8567] Can crawl at 5 kph
[SWIMS_INNATE]Swims innately.

[CASTE:FEMALE] Defines a caste called FEMALE.
[FEMALE] FEMALE caste is female.

[CASTE:MALE] As above, but with male.
[MALE] See above.

= Modding utilities =

[http://www.bay12forums.com/smf/index.php?topic=28829.0 A list of many mods and community-developed utilities]

{{Category|Modding}}
{{Category|Guides}}

Masterwork:Shrine of Armok

2014-10-24T08:21:14Z

StrikaAmaru: Added quality rating "Exceptional" using the rating script

{{Quality|Exceptional|08:21, 24 October 2014 (UTC)}}
{{workshop|name=Shrine of Armok|key=alt-H
|construction=
* 2 [[cv:block|block]]
|construction_job= [[Prayer]]
|use=
*various
|production=
*various}}
{{av}}
This building is part of the dwarven [[religion]] system.

Shrines are the most basic of religious buildings. Any dwarf can pray at them to receive a small gift from Armok with a success rate of around 3-6% for most things. There is no cost to this praying, which makes it a good way to train your apostles while still retaining a chance to get items (which wouldn't be the case with the [[monastery]]).

If you have a strange mood that can't be fulfilled, you may be able to pray at a shrine for the item(s) you need.

== Build Requirements ==
* 2 blocks
* A space of 3x3
* Praying

== Reactions ==

{| class="wikitable"
|-
! Reaction
! Reagents
! Possible Products
|-
| Pray for booze
| Empty food storage item
| Dwarven Wine
|-
| Pray for food
| Empty food storage item
| Plump helmets
|-
| Pray for soft metal
| Nothing
| Platinum, silver or gold bar
|-
| Pray for hard metal
| Nothing
| Iron, bronze or steel bar
|-
| Pray for gem
| Nothing
| Rough aquamarine, black opal or topaz
|-
| Pray for silk
| Nothing
| Silk thread, rare silk thread or silk cloth
|-
| Pray for wool
| Nothing
| Wool thread or wool cloth
|-
| Pray for cotton
| Nothing
| Cotton fibre thread or cotton fibre cloth
|}

{{buildings}}
{{category|Temples}}

Masterwork:Vermin

2014-10-16T09:32:58Z

StrikaAmaru: Added quality rating "Tattered" using the rating script

Crop

2014-07-15T06:36:22Z

StrikaAmaru: reformulated

{{Migrated_article}}
{{quality|unrated}}

{{av}}
:''(This article is about plants. If you want information about trees, see [[Tree]].)''

'''Crops''' (or more accurately '''plants''') can either be [[farming|farmed]], traded for, or acquired by plant gathering. Farming happens at farm plots. There are two types of crops: above ground and subterranean. The [[seed]]s of subterranean crops may be brought from the starting embark screen or, with some small luck, purchased from dwarven caravans. Above ground crops and [[seed]]s may be purchased from human or elven caravans or gathered by dwarves with the [[plant gathering]] labor enabled. Seeds may also be collected by processing the plants or eating them (but not by cooking!). There is a limit of 200 seeds of a given type at a time, after which no more will be produced.

A few of the plants listed below are not strictly crops, as they have no seeds and can't be planted (see note "4", below.)

Most plants can be brewed into alcohols, each plant type producing a different variation, and dwarves do prefer some variety in their drink. Some plants may be eaten raw, others must be cooked first, others must be processed first (by milling or plant processing) before they are edible, and still others are inedible, producing only non-food products (their seeds can be cooked anyway, however). Drinks may be cooked as ingredients in prepared meals, but at least one of the ingredients must be a non-liquid.

All drinks require a spare [[barrel]] or [[large pot]] for storage, and some other products also require specific containers for storage. Plants can be stored in barrels or without a container; seeds are stored individually or in [[bag]]s which can then be put into barrels. It may be advisable to have a small stockpile that accepts only seeds next to your farm(s), since dwarves will happily carry entire pots of seeds across the map to pick up a single seed, leading to cancellation spam and irregular planting.

Plump helmets and pig tails can be harvested 25 days after sowing. All other subterranean crops need about 42 days.

Standard plants have been changed very little from the previous version; tiles and colors have been upgaded, and brewing, pressing and processing plants to bags have been reimplemented as reactions, which means these options will be unavailable in the workshop if materials are missing.

{{plant table head}}
{{plant table row|name=Plump helmet|tile=♠|color=5:0|biome=Wet cavern|value=4|drink=Dwarven wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Pig tail|tile=τ|color=7:0|seasons={{seasons3||1|1|}}|biome=Wet cavern|value=4|drink=Dwarven ale|drinkv=10|prod=Pig tail thread (p)|prodv=2}}
{{plant table row|name=Cave wheat|tile=τ|color=7:1|seasons={{seasons3||1|1|}}|biome=Wet cavern|value=4|drink=Dwarven beer|drinkv=10|cook=p|prod=Dwarven wheat flour (m)|prodv=20}}
{{plant table row|name=Sweet pod|tile=Φ|color=4:1|seasons={{seasons3|1|1||}}|biome=Wet cavern|value=4|drink=Dwarven rum|drinkv=10|cook=p|prod=Dwarven sugar (m) Dwarven syrup (l)|prodv=20☼ 1001}}
{{plant table row|name=Quarry bush|tile=♣|color=7:0|seasons={{seasons3|1|1|1|}}|biome=Wet cavern|value=4|cook=p|prod=Quarry bush leaves (b) Rock nut paste (m) Rock nut press cake (s) Rock nut oil (s)|prodv=501☼ 1☼ 1☼ 5}}
{{plant table row|name=Dimple cup|tile=♥|color=1:1|biome=Wet cavern|value=4|prod=Dimple [[dye]] (m)|prodv=20}}
{{plant table row|name=Muck root/4|tile=τ|color=0:1|biome=Wetland/Wet|value=1|drink=Swamp whiskey|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Bloated tuber/4|tile=Φ|color=6:0|biome=Wetland/Dry|value=2|drink=Tuber beer|drinv=10|eat=y|cook=y}}
{{plant table row|name=Kobold bulb/4|tile=Φ|color=0:1|biome=Wetland/Wet|value=5|prod=[[Gnomeblight]] (e)|prodv=100}}
{{plant table row|name=Prickle berry|tile=:|color=2:0|biome=Not freezing/Dry|value=1|drink=Prickle berry wine|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Strawberry|tile=:|color=4:0|biome=Not freezing/Dry|value=4|drink=Strawberry wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Longland grass|tile=τ|color=6:1|biome=Not freezing/Dry|value=4|drink=Longland beer|drinkv=10|cook=p|prod=Longland flour (m)|prodv=20}}
{{plant table row|name=Valley herb/4|tile=ÿ|color=2:1|seasons={{seasons3|1|||}}|biome=Temperate grassland/Dry|value=10|cook=y|prod=[[Golden salve]] (v)|prodv=100}}
{{plant table row|name=Rat weed|tile=τ|color=2:0|biome=Not freezing/Wet|value=1|drink=Sewer brew|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Fisher berry|tile=:|color=7:0|biome=Not freezing/Wet|value=4|drink=Fisher berry wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Rope reed|tile=ƒ|color=2:0|biome=Not freezing/Wet|value=4|drink=River spirits|prod=Rope reed thread (p)|prodv=2}}
{{plant table row|name=Blade weed|tile=τ|color=2:0|biome=Not freezing/Dry|value=4|prod=Emerald [[dye]] (m)|prodv=20}}
{{plant table row|name=Hide root|tile=τ|color=6:0|biome=Not freezing/Dry|value=1|prod=Redroot [[dye]] (m)|prodv=10}}
{{plant table row|name=Sliver barb|tile=τ|color=0:1|biome=Not freezing/Dry|align=Evil|value=1|drink=Gutter cruor|drinkv=5|prod=Sliver [[dye]] (m)|prodv=20}}
{{plant table row|name=Sun berry|tile=:|color=6:1|biome=Not freezing/Wet|align=Good|value=9|drink=Sunshine|drinkv=25|eat=y|cook=y}}
{{plant table row|name=Whip vine|tile=§|color=3:1|biome=Not freezing/Dry|align=Savage|value=1|drink=Whip wine|drinkv=15|cook=p|prod=Whip vine flour (m)|prodv=25}}
|}
'''Notes:'''
:1 This is the value for a stack of 5 units, which is the number rendered from a single plant.
:2 Anything that can be cooked is edible afterwards. [[v0.31_Talk:Cook#No_Seeds|Cooking leaves no seeds for re-planting.]]
:3 These plants cannot be eaten/cooked until they are further processed, either by milling or extracting; see "products" column for process product.
:4 These plants cannot be grown on a farm plot as they have no seeds. They can only be acquired through plant gathering (in season only) or trade.
:5 To get the products/extracts from the plants they have to be processed, in the following [[workshop]]s, using the following [[labor]]s:
::*'''m''': mill ([[cave wheat]], [[sweet pod]], [[longland grass]], [[whip vine]], [[dimple cup]], [[blade weed]], [[hide root]], [[sliver barb]]): At [[quern]] or [[millstone]], using [[milling]].
::*'''b''': process to bag ([[quarry bush]]): At [[farmer's workshop]], using [[plant processing]]. In 0.40.01 this reaction neglected to produce any seeds; this bug was fixed in 0.40.02.
::*'''s''': press paste into oil ([[quarry bush]]): At [[screw press]].
::*'''l''': process to barrel ([[sweet pod]]): At farmer's workshop, using plant processing.
::*'''p''': process plant ([[pig tail]], [[rope reed]]): At farmer's workshop, using plant processing.
::*'''v''': process to vial ([[valley herb]]): At farmer's workshop, using plant processing.
::*'''e''': extract plant essence ([[kobold bulb]]): At [[still]], using [[plant gathering]].

== Garden Plants ==
All garden plants are above-ground, and can grow year-round. Garden plants are defined in a separate file from standard plants, named, somewhat predictably, plant_garden.txt 
Unlike standard plants, garden plants will also produce growths - leaves, buds, flowers, pods and fruits.
As a general rule, leaves can be only cooked, buds can be both cooked and brewed. // todo: fill in rest; didn't get that far.
{{plant table head}}
{{plant table row|name=Artichoke|tile=:(58)|color=6:0|biome=dry temperate|value=2
|drink=artichoke wine|drinkv=2|eat=y|cook=y
|prod=leaves (green) heart (purple) flowers seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Asparagus|tile=:(58)|color=2:0|biome=dry grassland|value=2
|eat=y|cook=y
|prod=leaves (yellowish-green) flowers (green) fruits (poisonous) seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Bambara groundnut|tile=:|color=2:0|biome=tropical dry broadleaf forest, tropical grassland, tropical savanna, tropical shrubland/Dry|value=2
|eat=y|cook=y
|prod=leaves flowers fruits seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=String bean|tile=:|color=2:0:1|biome=Temperate/Dry|value=2
|eat=n|cook=y
|prod=leaves flowers pod seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Broad bean|tile=:|color=2:0:1|biome=Temperate/Dry|value=2
|eat=n|cook=y
|prod=leaves flowers pod seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Beet|tile=:|color=4:0:1|biome=Temperate grassland/Dry|value=2
|drink=beetroot wine|drinkv=2|eat=y|cook=y
|prod=leaves flowers seeds 
|prodv=?☼ ?☼ ?}}
{{plant table row|name=Bitter melon|tile=:|color=2:0:1|biome=Tropical/Dry|value=2
|eat=n|cook=y
|prod=leaves flowers fruit seeds
|prodv=?☼ ?☼ ?☼ ?}}
{{plant table row|name=Cabbage|tile=:|color=2:0:1|biome=Temperate/Dry|value=2
|eat=y|cook=y
|prod=leaves flowers seeds
|prodv=?☼ ?☼ ?☼ ?}}
{{plant table row|name=Caper|tile=:|color=2:0|biome=Desert, Grassland/Dry|value=2
|eat=y|cook=y
|prod=leaves buds flowers fruits seeds
|prodv=?☼ ?☼ ?☼ ?☼ ?}}
|}

== Crop Plants ==

== See also ==
* [[Farming]]

{{Category|Crops| }}

DF2014 Talk:Crop

2014-07-15T06:22:51Z

StrikaAmaru: answer

{{newpage|type=cp|Carch}}

== list of new crops ==

since the main page would just get messy, I thought maybe this'd be a good place to add the new garden crops. I'll pull the list here from the raws, but don't know how to make a table (and I could look at the main page, but afraid I'd mess it up beyond my ability to repair)

crops: (name / drink / millable)

single-grain Wheat / Single-grain wheat beer / yes

two-grain wheat / two-grain wheat beer / yes

soft wheat / soft wheat beer / yes

hard wheat / hard wheat beer / yes

spelt / spelt beer / yes

barley / barley whine / yes

buckwheat / buckwheat beer / yes

oats / no drink / yes

Alfalfa / no drink / no

rye / rye beer / yes

sorghum / sorghum beer / yes

rice / rice beer / yes

maize / maize beer / yes

quinoa / quinoa beer / yes

Kaniwa / Kaniwa beer / yes

bitter vetch / no drink / no

pendant amaranth / pendant amaranth beer / yes

blood amaranth / blood amaranth beer / yes

purple amaranth / purple amaranth beer / yes

red spinach / no drink / no

Elephant-head amaranth / no drink / no

pearl millet / pearl millet beer / yes

white millet / white millet beer / yes

finger millet / finger millet beer / yes

foxtail millet / foxtail millet beer / yes

didn't get any further yet. but I think this is about half of the crops raw file
done. after this only the garden stuff to do.
 
---
 
* Shouldn't plants be split by standard / garden / crop? They seem to have different properties - no standard plant has any growths, for instance.
** Beets are in the plant_garden.txt file - they have [GROWTH:LEAVES] and [GROWTH:FLOWERS], and we have Jute in the plant_crops.txt file - also with just [GROWTH:LEAVES] and [GROWTH:FLOWERS]
::: Yes, garden and crop plants have growths; standard plants don't. Plus, crop plants seem to either be inedible to dwarves (excepting various beers) or to require double processing in order to obtain a cookable product.

Crop

2014-07-15T06:12:54Z

StrikaAmaru: add the 0.40.01 seedless bagging bug.

{{Migrated_article}}
{{quality|unrated}}

{{av}}
:''(This article is about plants. If you want information about trees, see [[Tree]].)''

'''Crops''' (or more accurately '''plants''') can either be [[farming|farmed]], traded for, or acquired by plant gathering. Farming happens at farm plots. There are two types of crops: above ground and subterranean. The [[seed]]s of subterranean crops may be brought from the starting embark screen or, with some small luck, purchased from dwarven caravans. Above ground crops and [[seed]]s may be purchased from human or elven caravans or gathered by dwarves with the [[plant gathering]] labor enabled. Seeds may also be collected by processing the plants or eating them (but not by cooking!). There is a limit of 200 seeds of a given type at a time, after which no more will be produced.

A few of the plants listed below are not strictly crops, as they have no seeds and can't be planted (see note "4", below.)

Most plants can be brewed into alcohols, each plant type producing a different variation, and dwarves do prefer some variety in their drink. Some plants may be eaten raw, others must be cooked first, others must be processed first (by milling or plant processing) before they are edible, and still others are inedible, producing only non-food products (their seeds can be cooked anyway, however). Drinks may be cooked as ingredients in prepared meals, but at least one of the ingredients must be a non-liquid.

All drinks require a spare [[barrel]] or [[large pot]] for storage, and some other products also require specific containers for storage. Plants can be stored in barrels or without a container; seeds are stored individually or in [[bag]]s which can then be put into barrels. It may be advisable to have a small stockpile that accepts only seeds next to your farm(s), since dwarves will happily carry entire pots of seeds across the map to pick up a single seed, leading to cancellation spam and irregular planting.

Plump helmets and pig tails can be harvested 25 days after sowing. All other subterranean crops need about 42 days.

{{plant table head}}
{{plant table row|name=Plump helmet|tile=♠|color=5:0|biome=Wet cavern|value=4|drink=Dwarven wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Pig tail|tile=τ|color=7:0|seasons={{seasons3||1|1|}}|biome=Wet cavern|value=4|drink=Dwarven ale|drinkv=10|prod=Pig tail thread (p)|prodv=2}}
{{plant table row|name=Cave wheat|tile=τ|color=7:1|seasons={{seasons3||1|1|1}}|biome=Wet cavern|value=4|drink=Dwarven beer|drinkv=10|cook=p|prod=Dwarven wheat flour (m)|prodv=20}}
{{plant table row|name=Sweet pod|tile=Φ|color=4:1|seasons={{seasons3|1|1|1|}}|biome=Wet cavern|value=4|drink=Dwarven rum|drinkv=10|cook=p|prod=Dwarven sugar (m) Dwarven syrup (l)|prodv=20☼ 1001}}
{{plant table row|name=Quarry bush|tile=♣|color=7:0|seasons={{seasons3|1|1|1|}}|biome=Wet cavern|value=4|cook=p|prod=Quarry bush leaves (b) Rock nut paste (m) Rock nut press cake (s) Rock nut oil (s)|prodv=501☼ 1☼ 1☼ 5}}
{{plant table row|name=Dimple cup|tile=♥|color=1:1|biome=Wet cavern|value=4|prod=Dimple [[dye]] (m)|prodv=20}}
{{plant table row|name=Muck root/4|tile=τ|color=0:1|biome=Wetland/Wet|value=1|drink=Swamp whiskey|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Bloated tuber/4|tile=Φ|color=6:0|biome=Wetland/Dry|value=2|drink=Tuber beer|drinv=10|eat=y|cook=y}}
{{plant table row|name=Kobold bulb/4|tile=Φ|color=0:1|biome=Wetland/Wet|value=5|prod=[[Gnomeblight]] (e)|prodv=100}}
{{plant table row|name=Prickle berry|tile=:|color=2:0|biome=Not freezing/Dry|value=1|drink=Prickle berry wine|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Strawberry|tile=:|color=4:0|biome=Not freezing/Dry|value=4|drink=Strawberry wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Longland grass|tile=τ|color=6:1|biome=Not freezing/Dry|value=4|drink=Longland beer|drinkv=10|cook=p|prod=Longland flour (m)|prodv=20}}
{{plant table row|name=Valley herb/4|tile=ÿ|color=2:1|seasons={{seasons3|1|||}}|biome=Temperate grassland/Dry|value=10|cook=y|prod=[[Golden salve]] (v)|prodv=100}}
{{plant table row|name=Rat weed|tile=τ|color=2:0|biome=Not freezing/Wet|value=1|drink=Sewer brew|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Fisher berry|tile=:|color=7:0|biome=Not freezing/Wet|value=4|drink=Fisher berry wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Rope reed|tile=ƒ|color=2:0|biome=Not freezing/Wet|value=4|drink=River spirits|prod=Rope reed thread (p)|prodv=2}}
{{plant table row|name=Blade weed|tile=τ|color=2:0|biome=Not freezing/Dry|value=4|prod=Emerald [[dye]] (m)|prodv=20}}
{{plant table row|name=Hide root|tile=τ|color=6:0|biome=Not freezing/Dry|value=1|prod=Redroot [[dye]] (m)|prodv=10}}
{{plant table row|name=Sliver barb|tile=τ|color=0:1|biome=Not freezing/Dry|align=Evil|value=1|drink=Gutter cruor|drinkv=5|prod=Sliver [[dye]] (m)|prodv=20}}
{{plant table row|name=Sun berry|tile=:|color=6:1|biome=Not freezing/Wet|align=Good|value=9|drink=Sunshine|drinkv=25|eat=y|cook=y}}
{{plant table row|name=Whip vine|tile=§|color=3:1|biome=Not freezing/Dry|align=Savage|value=1|drink=Whip wine|drinkv=15|cook=p|prod=Whip vine flour (m)|prodv=25}}
|}
'''Notes:'''
:1 This is the value for a stack of 5 units, which is the number rendered from a single plant.
:2 Anything that can be cooked is edible afterwards. [[v0.31_Talk:Cook#No_Seeds|Cooking leaves no seeds for re-planting.]]
:3 These plants cannot be eaten/cooked until they are further processed, either by milling or extracting; see "products" column for process product.
:4 These plants cannot be grown on a farm plot as they have no seeds. They can only be acquired through plant gathering (in season only) or trade.
:5 To get the products/extracts from the plants they have to be processed, in the following [[workshop]]s, using the following [[labor]]s:
::*'''m''': mill ([[cave wheat]], [[sweet pod]], [[longland grass]], [[whip vine]], [[dimple cup]], [[blade weed]], [[hide root]], [[sliver barb]]): At [[quern]] or [[millstone]], using [[milling]].
::*'''b''': process to bag ([[quarry bush]]): At [[farmer's workshop]], using [[plant processing]]. In Df2014, processing plants to bag was reimplemented as a reaction. In 0.40.01 this reaction neglected to produce any seeds; this bug was fixed in 0.40.02.
::*'''s''': press paste into oil ([[quarry bush]]): At [[screw press]].
::*'''l''': process to barrel ([[sweet pod]]): At farmer's workshop, using plant processing.
::*'''p''': process plant ([[pig tail]], [[rope reed]]): At farmer's workshop, using plant processing.
::*'''v''': process to vial ([[valley herb]]): At farmer's workshop, using plant processing.
::*'''e''': extract plant essence ([[kobold bulb]]): At [[still]], using [[plant gathering]].

== Garden Plants ==
All garden plants are above-ground, and can grow year-round. Garden plants are defined in a separate file from standard plants, named, somewhat predictably, plant_garden.txt 
Unlike standard plants, garden plants will also produce growths - leaves, buds, flowers, pods and fruits.
As a general rule, leaves can be only cooked, buds can be both cooked and brewed. // todo: fill in rest; didn't get that far.
{{plant table head}}
{{plant table row|name=Artichoke|tile=:(58)|color=6:0|biome=dry temperate|value=2
|drink=artichoke wine|drinkv=2|eat=y|cook=y
|prod=leaves (green) heart (purple) flowers seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Asparagus|tile=:(58)|color=2:0|biome=dry grassland|value=2
|eat=y|cook=y
|prod=leaves (yellowish-green) flowers (green) fruits (poisonous) seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Bambara groundnut|tile=:|color=2:0|biome=tropical dry broadleaf forest, tropical grassland, tropical savanna, tropical shrubland/Dry|value=2
|eat=y|cook=y
|prod=leaves flowers fruits seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=String bean|tile=:|color=2:0:1|biome=Temperate/Dry|value=2
|eat=n|cook=y
|prod=leaves flowers pod seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Broad bean|tile=:|color=2:0:1|biome=Temperate/Dry|value=2
|eat=n|cook=y
|prod=leaves flowers pod seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Beet|tile=:|color=4:0:1|biome=Temperate grassland/Dry|value=2
|drink=beetroot wine|drinkv=2|eat=y|cook=y
|prod=leaves flowers seeds 
|prodv=?☼ ?☼ ?}}
{{plant table row|name=Bitter melon|tile=:|color=2:0:1|biome=Tropical/Dry|value=2
|eat=n|cook=y
|prod=leaves flowers fruit seeds
|prodv=?☼ ?☼ ?☼ ?}}
{{plant table row|name=Cabbage|tile=:|color=2:0:1|biome=Temperate/Dry|value=2
|eat=y|cook=y
|prod=leaves flowers seeds
|prodv=?☼ ?☼ ?☼ ?}}
{{plant table row|name=Caper|tile=:|color=2:0|biome=Desert, Grassland/Dry|value=2
|eat=y|cook=y
|prod=leaves buds flowers fruits seeds
|prodv=?☼ ?☼ ?☼ ?☼ ?}}
|}

== Crop Plants ==

== See also ==
* [[Farming]]

{{Category|Crops| }}

DF2014 Talk:Tree

2014-07-13T17:20:05Z

StrikaAmaru: fix paragraph order

So, before anyone works on the tree page here, what should we do? Do we need gifs of new trees since I could make some but I dont feel like writing an article. -- I suggest setting up the tree part as a cross section, showing what the roots are and such. Also, we could change the current tree icon(spades or clubs) to the 1/4 signs since its the leaf colours that matter – [[template:unsigned|unsigned]] comment by [[User:209.197.142.167|209.197.142.167]] 02:56, 9 July 2014 (UTC)
:I suggest making a new version of the table template that shows all tiles for each species, though I'm not sure what would be the best way to organize it.--[[User:Amena Ralikema|Amena Ralikema]] ([[User talk:Amena Ralikema|talk]]) 13:12, 12 July 2014 (UTC)

What the current way of organising it, with the root trunk, leavs is fairly good. I approve of it. also praise Amena Ralikema! The tree page is looking quite better- oddstranger

== Burning trees ==
Burning trees collapse, and forest fires cause immense pause+recenter spam of trees collapsing.
Perhaps something to mention(and warn for forest fires, aside from the obvious dangers). [[Special:Contributions/83.83.21.167|83.83.21.167]] 15:18, 9 July 2014 (UTC)

== Fruit ==
How do you get the fruits the new trees drop? – [[template:unsigned|unsigned]] comment by [[User:66.177.96.41|66.177.96.41]] 14:52, 10 July 2014 (UTC)

In adventurer mode i believe you can eat directly from the tree with e or use g to pick up the fruit form the tree. I dont think it's in fortress mode since he mentioned hes still working on harvesting.-stranger – [[template:unsigned|unsigned]] comment by [[User:72.38.18.124|72.38.18.124]] 13:09, 11 July 2014 (UTC)

== Cutting Trees in Fortress Mode ==

I'd like to put this bit of page for discussing and confirming... well, what's in the title.

Some things I've noticed so far:

* when cutting a tree at a trunk tile '''above''' the ground level ( = the lowest z-level the tree occupies), it's possible to produce some sort of a cave-in; presumably, the woodcutter chops the trunk that s/he's standing on.
** Can anyone replicate this behavior?
** Has anyone received any quasi-cave-ins by cutting trees at ground level? --[[User:StrikaAmaru|StrikaAmaru]] 15:25, 12 July 2014‎ (UTC)
:What do you mean by "cave in"? A message about something collapsing? I remember seeing something like that on the bug tracker. --[[User:Amena Ralikema|Amena Ralikema]] ([[User talk:Amena Ralikema|talk]]) 15:31, 12 July 2014 (UTC)
:: Yes, exactly like a cave-in; my woodcutter was happily chopping a branch, then I get the message, the game re-centers, and the dorf is on the ground, stunned but uninjured. Actually, when considering that cutting a branch cuts down the whole tree, a cave-in is exactly what happened: she was sitting on the tree, then the tree stopped existing. Cue one dropping dwarf. I'm inclined to think this is normal behavior, but still something that we need to take into account. BTW: the bug about cave-ins is probably about the completely unrelated, and definitely buggy, random "Something has collapsed on the surface!" messages that keep popping up with no rhyme or reason. --[[User:StrikaAmaru|StrikaAmaru]] 17:15, 13 July 2014‎ (UTC)

* Trees grow every year; a freshly-matured tree only extends 2 z-levels, and produces comparatively little wood (7 in my case). Still has fruit, even though it was a sapling when flowering season passed.--[[User:StrikaAmaru|StrikaAmaru]] 15:25, 12 July 2014‎ (UTC)
:As for the fruiting, I don't think pollination is implemented yet. :) Fruit just grows at a set time.--[[User:Amena Ralikema|Amena Ralikema]] ([[User talk:Amena Ralikema|talk]]) 15:31, 12 July 2014 (UTC)
::More interested in verifying tree growth across multiple years; the fruit thing was a minor quirk, seeing how fruits are useless now :( --[[User:StrikaAmaru|StrikaAmaru]] 17:20, 13 July 2014‎ (UTC)

DF2014 Talk:Tree

2014-07-13T17:13:35Z

StrikaAmaru: Answer question

So, before anyone works on the tree page here, what should we do? Do we need gifs of new trees since I could make some but I dont feel like writing an article. -- I suggest setting up the tree part as a cross section, showing what the roots are and such. Also, we could change the current tree icon(spades or clubs) to the 1/4 signs since its the leaf colours that matter – [[template:unsigned|unsigned]] comment by [[User:209.197.142.167|209.197.142.167]] 02:56, 9 July 2014 (UTC)
:I suggest making a new version of the table template that shows all tiles for each species, though I'm not sure what would be the best way to organize it.--[[User:Amena Ralikema|Amena Ralikema]] ([[User talk:Amena Ralikema|talk]]) 13:12, 12 July 2014 (UTC)

What the current way of organising it, with the root trunk, leavs is fairly good. I approve of it. also praise Amena Ralikema! The tree page is looking quite better- oddstranger

== Burning trees ==
Burning trees collapse, and forest fires cause immense pause+recenter spam of trees collapsing.
Perhaps something to mention(and warn for forest fires, aside from the obvious dangers). [[Special:Contributions/83.83.21.167|83.83.21.167]] 15:18, 9 July 2014 (UTC)

== Fruit ==
How do you get the fruits the new trees drop? – [[template:unsigned|unsigned]] comment by [[User:66.177.96.41|66.177.96.41]] 14:52, 10 July 2014 (UTC)

In adventurer mode i believe you can eat directly from the tree with e or use g to pick up the fruit form the tree. I dont think it's in fortress mode since he mentioned hes still working on harvesting.-stranger – [[template:unsigned|unsigned]] comment by [[User:72.38.18.124|72.38.18.124]] 13:09, 11 July 2014 (UTC)

== Cutting Trees in Fortress Mode ==

I'd like to put this bit of page for discussing and confirming... well, what's in the title.

Some things I've noticed so far:

* when cutting a tree at a trunk tile '''above''' the ground level ( = the lowest z-level the tree occupies), it's possible to produce some sort of a cave-in; presumably, the woodcutter chops the trunk that s/he's standing on.
** Can anyone replicate this behavior?
** Has anyone received any quasi-cave-ins by cutting trees at ground level?

* Trees grow every year; a freshly-matured tree only extends 2 z-levels, and produces comparatively little wood (7 in my case). Still has fruit, even though it was a sapling when flowering season passed.– [[template:unsigned|unsigned]] comment by [[User:StrikaAmaru|StrikaAmaru]] 15:25, 12 July 2014‎ (UTC)
:What do you mean by "cave in"? A message about something collapsing? I remember seeing something like that on the bug tracker.
:: Yes, exactly like a cave-in; my woodcutter was happily chopping a branch, then I get the message, the game re-centers, and the dorf is on the ground, stunned but uninjured. Actually, when considering that cutting a branch cuts down the whole tree, a cave-in is exactly what happened: she was sitting on the tree, then the tree stopped existing. Cue one dropping dwarf. I'm inclined to think this is normal behavior, but still something that we need to take into account. BTW: the bug about cave-ins is probably about the completely unrelated, and definitely buggy, random "Something has collapsed on the surface!" messages that keep popping up with no rhyme or reason.
:As for the fruiting, I don't think pollination is implemented yet. :) Fruit just grows at a set time.--[[User:Amena Ralikema|Amena Ralikema]] ([[User talk:Amena Ralikema|talk]]) 15:31, 12 July 2014 (UTC)

DF2014 Talk:Tree

2014-07-12T15:30:25Z

StrikaAmaru: clarified prev edit

DF2014 Talk:Tree

2014-07-12T15:25:43Z

StrikaAmaru: /* Cutting Trees in Fortress Mode */ new section

Tree

2014-07-12T15:06:57Z

StrikaAmaru: added details ab. flowers, fruits and possible cave-in when cutting trees from above-ground trunk tiles

{{migrated article}}
{{quality|unrated}}
{{av}}
{{update in next major version}}
[[File:Cavern.png|thumb|right|350px|Trees are generally present in the [[caverns]] regardless of above-ground conditions, an important feature in a [[desert]] biome.]]
<big>'''Notice:'''</big> With DF2014, Trees have received significant revision. They are now multi-tile creations, spanning multiple z-levels, with separate tiles for trunk, roots, flowers, fruits, twigs, leaves, etc. Exactly how much of the remainder of this article still applies is yet to be determined.

Trunks can be chopped down, yielding multiple logs. A single tree can have multiple trunk tiles, on separate z-levels as well as otherwise, but only one tile of trunk can be designated for chopping on a single tree, so make sure you pick one that can be reached. Chopping a single tile from a tree will chop down the whole tree - there's no such thing as partially cutting a tree. Cutting a tree from a trunk section above ground level may result in the woodcutter losing his/her footing and crashing to the ground (similar to having a tile deconstructed under their feet). Conversely, designating trees to be cut at the ground level tile has never (so far) resulted in a cave-in. Some trees have multiple tiles at ground-level; ginkgo, for instance.

Roots can be designated for digging, though the tile doesn't flash to indicate it's designated. Some trees can have multiple tiles of roots, others just the one; in either case, when a single tile of roots is dug out, the entire tree vanishes without a trace.

Certain flowers will fall in a cloud during the transition from flowers to fruit; the cloud is shown falling, and loo[k]ing at the ground post-fact will show "<tree> flowers", in addition to other tile contents.

Fruit can be picked in Adventure mode, but Fort mode harvesting is not yet in the game. You can trade for or embark with them though, and brew them at a [[still]]. Fruit do fall on the ground in fortress mode, but they cannot be collected or brewed. Cutting a tree with fruit causes the fruits to vanish.

Leaves will fall in autumn, coloring tiles beneath a tree. Some can be cooked at a [[kitchen]].

---

'''Trees''' are a multi-[[tile]] feature that can be found aboveground on all but the most arid or most mountainous of maps, and below ground in the [[caverns]]. What kind of trees grow in a given location depends on [[biome]], as different species prefer different conditions. For example, tropical areas often have palm trees, while colder areas feature pines. An exception are underground trees, such as [[nether-cap]]s, that will grown anywhere underground. The species of a tree in turn determines its properties, including its structure, the color and density of its wood and what kind of growths it produces. Note also that "trees" in DF covers also things that are not literally trees, such as large cacti (e.g. [[saguaro]]s) and mushrooms (e.g. all underground trees).

== Structure ==
Trees consist of several types of tiles - roots, trunks, branches and twigs, as well as a number of "growths" (leaves, needles, flowers, fruit, cones, etc., depending on species). A single tree is a structure that can span multiple tiles in both horizontal and vertical directions. For example, a typical deciduous tree will have a single tile-wide trunk at ground level supporting a multiple-level crown of intertwined branches and twigs covered with leaves. Not all species follow the same scheme, though - palms have a high, naked trunk that doesn't branch and just a tuft of leaves on top of it, and some species can have trunks that are thicker than a single tile at ground level. Underground, things are simpler, as there is only one kind of root tiles and the extent of the root system doesn't seem to vary with species.

Trees can be [[climb]]ed in both fortress and [[adventure mode]], and the levels of the crown provide support for walking. In a densely wooded areas, the overlapping tree crowns can form a continuous canopy that can be traversed.

{{migrated section}}
Viewed on their same [[z-level]], many different sub-types of trees have their own symbol, such as {{tile|♣|2:0}}, {{tile|♠|2:0}}, {{tile|¶|2:0}}, {{tile|╞|2:0}} or {{tile|⌠|2:0}}. Some share the same symbol, but since the differences are only in preferences, this is not a significant problem (see table below for symbol pairings). For most purposes, a tree is a tree. Trees viewed from one z-level higher look like coloured rectangles ( {{tile|■|2:0}} ), appearing identical to coloured [[block]]s floating in the air. Deciduous trees will change colour to red or yellow in [[autumn]] ( {{tile|♣|4:1}}, {{tile|♠|6:1}} ), and lose their leaves in [[winter]] ( {{tile|╞|6:0}} ).

Tree trunks are a type of [[map tile]] and as such will form a solid barrier to movement, preventing [[channel]]ing or the creation of [[wall]]s and other [[construction]]s on their tile. This is problematic for caravan [[wagon]]s, which require a path at least three tiles wide in order to access your fortress; on heavily forested maps it may be necessary to check [[trade depot|depot]] access ({{k|D}}) every once in a while as trees continue to grow to make sure wagons can get through, and chop down ({{k|d}}-{{k|t}}) the impeding forest if they can't. Later on this can actually become a blessing, as if there is only one or a few pathways to the fortress it makes it easier to route incoming caravans down certain well-defended pathways, instead of allowing them to choose their own way across the map, where they may fall foul of ambushers or worse. It also makes building above-ground constructions more challenging, as any trees in the way must be chopped down first.

== Wood ==
{{migrated section}}
[[Woodcutter|Chopping down]] trees yields [[wood]] (obviously), one of the game's most important resources. Without wood it is not possible to build [[bed]]s, generate or transfer [[power]], create [[ash]], or power [[furnace]]s without [[magma]] (unless [[coal]] is available), and since wood is easily craftable many items become more difficult to craft. Thus a lack of trees can be an important deterministic factor in fortress development, as without a ready source of wood the player will be forced to rely on [[caravan]]s for wood item production and possibly [[magma]] for metal-forging (that being said, it is not impossible to circumvent). The density of growth on the embark site is determined by the [[biome]], and those are visible on the pre-[[embark]] screen by hitting {{k|F1}}, {{k|F2}} etc. The tree density of the biome does not change as there are no climate shifts during game play, but heavy woodcutting activity will eventually strip any [[forest]] bare.

One of the variation between the different tree species is in the weight and color of their wood. Weight is often a minor concern but when using wood to create objects that will be moved, such as bins or buckets, choosing lighter wood is an advantage as it will be hauled faster. Heavier wood will make wooden weapons and siege engine projectiles more effective, while lighter wooden shields reduce penalties to speed while blocking just as well as heavier shields.

Nonetheless, all trees have the same intrinsic value{{verify}} (beyond the [[preference]]s of individual dwarves), although the [[color]] of the wood may matter for aesthetic purposes.

== Growth ==
{{migrated section}}
[[File:Many miners extend tree farm.png|thumb|left|350px|Extensions being made to a in-hill tree farm.]]
Trees grow from '''saplings''', which start growing randomly on non-occupied tiles of a suitable biome; thus chopping down a forest may create a clearing, but within a couple of years a new forest will have grown. Saplings can be killed by heavy [[traffic|foot traffic]], but not by flooding — they can survive submergence for extended periods of time and will still grow to maturity once the water level drops to 4/7{{verify}} or lower. Dead saplings will remain for some seasons, and then disappear, more quickly if heavy traffic tramples them away. Growth from a sapling to a tree takes exactly 3 years. Many underground trees are called "young <tree>" instead of sapling, but the concept is the same. Saplings will not grow to maturity if their tile contains an item or building (including stockpile designations), though removing the item may cause the tree to spontaneously grow up. Paved [[road]]s and [[farm plot]]s periodically purge all terrain features below them, preventing trees (or shrubs) from growing in unwanted areas. Trees cannot grow on stairs or ramps, making it possible to keep trees out of your plumbing by using {{K|u}}p stairs instead of {{K|d}}igging (this does not reveal the tile above). Above-ground trees will only grow in areas where there is sufficient soil 1 Z-level beneath them (currently observed to be at least one unmined tile within a two-tile radius); underground trees not only ignore this restriction for dry subterranean soil but will also grow on muddy subterranean stone. Additionally, saplings on soil cavern floors will block the construction of farm plots unless there is also a dusting or pile of mud beneath them.

Trees ''cannot'' be specifically "planted"; even if a map is stripped of all trees, new saplings will regrow, randomly and in their own time. Sadly, the [[elf|elves]] do not seem to comprehend this. It is possible to [[tree farming|farm]] trees by walling off or engineering a patch of soil and locking it away so your dwarves don't trample all over it, but it will take a long time for the farm to yield results. After you expose the [[caverns]] subterranean flora (including trees) will begin to grow on any exposed and previously bare soil within your fortress; this can be annoying when a copse of blood thorns suddenly appears in your [[sand#Glass|sand collection]] area, but allows you to easily mine out large subterranean tree farms full of colorful subterranean trees.
{{clear}}

== List of tree species ==
{{multi-tile tree table head}}

{{multi-tile tree table row|name=[[Acacia]]|hab=Tropical Dry Broadleaf Forest Tropical Grassland Tropical Savanna Tropical Shrubland|align=All (Dry)|root=|trunk=|branch=|growths={{tile|`|2:0:0}} Leaves {{tile|U|7:0:1}} Flowers {{tile|%|2:0:1}} Pods |decid=No |wt=0.600 |pref=thorns}}

|}

{{migrated section}}
{{Tree table head}}

{{Tree table row|name=[[Acacia]]|tile={{tile|¼|7:1}}|hab=Tropical Dry Broadleaf Forest Tropical Grassland Tropical Savanna Tropical Shrubland|align=All (Dry)|decid=No|wt=0.600|pref=thorns}}

{{Tree table row|name=[[Alder]]|tile={{tile|¼|2:0}}|hab=Any Temperate Broadleaf Forest|align=All (Dry)|decid=Yes|wt=0.410|pref=catkins autumn coloration}}

{{Tree table row|name=[[Almond]]|tile={{tile|♣|7:1}}|hab=Any Temperate Broadleaf Forest|align=All (Dry)|decid=Yes|wt=0.410|pref=catkins autumn coloration}}

{{Tree table row|name=[[Ash (tree)|Ash]]|tile={{tile|¼|2:0}}|hab=Any Temperate Broadleaf Forest|align=All (Dry)|decid=Yes|wt=0.600|pref=flying keys autumn coloration}}

{{Tree table row|name=[[Birch]]|tile={{tile|¼|2:0}}|hab=Any Temperate Broadleaf Forest|align=All (Dry)|decid=Yes|wt=0.650|pref=catkins silver bark autumn coloration}}

{{Tree table row|name=[[Black-cap]]|tile={{tile|¼|0:1}}|hab=Subterranean Cavern (layers 2-3)|align=All|decid=No|wt=0.650|pref=gloomy appeal}}

{{Tree table row|name=[[Blood thorn]]|tile={{tile|¼|4:0}}|hab=Subterranean Cavern (layer 3) Subterranean Chasm|align=All|decid=No|wt=1.250|pref=sickening appearance}}

{{Tree table row|name=[[Cacao tree]]|tile={{tile|¼|2:0}}|hab=Tropical Moist Broadleaf Forest|align=All (Dry)|decid=No|wt=0.430|pref=flowers}}

{{Tree table row|name=[[Candlenut]]|tile={{tile|¼|2:0}}|hab=Any Tropical Forest|align=All (Dry)|decid=No|wt=0.140|pref=nuts}}

{{Tree table row|name=[[Cedar]]|tile={{tile|¼|2:0}}|hab=Temperate Conifer Forest Tropical Conifer Forest|align=All (Dry)|decid=No|wt=0.570|pref=majesty}}

{{Tree table row|name=[[Chestnut]]|tile={{tile|¼|2:0}}|hab=Any Temperate Broadleaf Forest|align=All (Dry)|decid=Yes|wt=0.430|pref=smelly catkins spiny pods chestnuts autumn coloration}}

{{Tree table row|name=[[Feather tree]]|tile={{tile|¼|7:1}}|hab=Not Freezing|align=Good (Dry)|decid=No|wt=0.100|pref=feathery leaves}}

{{Tree table row|name=[[Fungiwood]]|tile={{tile|¼|6:1}}|hab=Subterranean Cavern (layers 1-2)|align=All|decid=No|wt=0.600|pref=fine grain}}

{{Tree table row|name=[[Glumprong]]|tile={{tile|¼|5:0}}|hab=Not Freezing|align=Evil (Dry)|decid=No|wt=1.200|pref=living shadows}}

{{Tree table row|name=[[Goblin-cap]]|tile={{tile|¼|4:1}}|hab=Subterranean Cavern (layers 2-3)|align=All|decid=No|wt=0.600|pref=stunning color}}

{{Tree table row|name=[[Highwood]]|tile={{tile|¼|2:0}}|hab=Not Freezing|align=Savage (Dry)|decid=No|wt=0.500|pref=magnificence}}

{{Tree table row|name=[[Kapok]]|tile={{tile|¼|2:0}}|hab=Tropical Moist Broadleaf Forest|align=All (Dry)|decid=No|wt=0.260|pref=buttresses}}

{{Tree table row|name=[[Larch]]|tile={{tile|¼|2:0}}|hab=Taiga Temperate Conifer Forest|align=All (Dry)|decid=Yes|wt=0.590|pref=cones needles}}

{{Tree table row|name=[[Mango tree]]|tile={{tile|¼|2:0}}|hab=Any Tropical Forest|align=All (Dry)|decid=No|wt=0.520|pref=sweet-smelling flowers}}

{{Tree table row|name=[[Mahogany]]|tile={{tile|¼|2:0}}|hab=Any Tropical Forest|align=All (Dry)|decid=No|wt=0.600|pref=loose inflorescences}}

{{Tree table row|name=[[Maple]]|tile={{tile|¼|2:0}}|hab=Temperate Broadleaf Forest Temperate Grassland Temperate Savanna Temperate Shrubland|align=All (Dry)|decid=Yes|wt=0.540|pref=autumn coloration}}

{{Tree table row|name=[[Mangrove]]|tile={{tile|¼|2:0}}|hab=Mangrove Swamp|align=All (Wet)|decid=No|wt=0.830|pref=roots}}

{{Tree table row|name=[[Nether-cap]]|tile={{tile|¼|1:0}}|hab=Subterranean Cavern (layer 3)|align=All|decid=No|wt=0.550|pref=coldness to the touch (wood has [MAT_FIXED_TEMP:10000])}}

{{Tree table row|name=[[Oak]]|tile={{tile|¼|2:0}}|hab=Any Temperate Broadleaf Forest|align=All (Dry)|decid=Yes|wt=0.700|pref=acorns autumn coloration}}

{{Tree table row|name=[[Palm]]|tile={{tile|¼|2:0}}|hab=Any Tropical|align=All (Dry)|decid=No|wt=0.680|pref=leaves}}

{{Tree table row|name=[[Pine]]|tile={{tile|¼|2:0}}|hab=Taiga Temperate Conifer Forest Tropical Conifer Forest|align=All (Dry)|decid=No|wt=0.510|pref=cones needles}}

{{Tree table row|name=[[Rubber tree]]|tile={{tile|¼|2:0}}|hab=Tropical Moist Broadleaf Forest|align=All (Dry)|decid=No|wt=0.490|pref=branch shedding}}

{{Tree table row|name=[[Saguaro]]|tile={{tile|¼|2:0}}|hab=Any Desert|align=All (Dry)|decid=No|wt=0.430|pref=amazing arms}}

{{Tree table row|name=[[Spore tree]]|tile={{tile|¼|3:0}}|hab=Subterranean Cavern (layers 2-3)|align=All|decid=No|wt=0.600|pref=raining spores}}

{{Tree table row|name=[[Tower-cap]]|tile={{tile|¼|7:1}}|hab=Subterranean Cavern (layers 1-2)|align=All|decid=No|wt=0.600|pref=great size}}

{{Tree table row|name=[[Tunnel tube]]|tile={{tile|¼|5:1}}|hab=Subterranean Cavern (layers 2-3)|align=All|decid=No|wt=0.500|pref=curving trunk}}

{{Tree table row|name=[[Willow]]|tile={{tile|*|7:1}}|hab=Any Temperate Any Tropical Forest Tropical Grassland Tropical Savanna Tropical Shrubland Tropical Freshwater Swamp Tropical Saltwater Swamp Tropical Freshwater Marsh Tropical Saltwater Marsh|align=All (Wet)|decid=No|wt=0.390|pref=sad appearance fluffy catkins}}

|}



==Bugs==
* In fortress mode, tree fruit (and presumably, other growths) can't be harvested yet, though it's possible to eat fruit in [[adventure mode]]. See [[DF2014:Release information]].
* (0.40.2) Constructing on trees causes them to vanish. {{bug|6551}}
* (0.40.2) When a root tile is mined, the entire tree ceases to exist. {{bug|6749}}
* (0.40.2) Building something (e.g. a cage) in a tree and then chopping down the tree leaves the building floating in the air. {{bug|6949}}

{{Plants}}

[[Category:Map tiles]]
{{Category|Trees}}

Crop

2014-07-11T15:09:23Z

StrikaAmaru: Started table for garden plants

{{Migrated_article}}
{{quality|unrated}}

{{av}}
:''(This article is about plants. If you want information about trees, see [[Tree]].)''

'''Crops''' (or more accurately '''plants''') can either be [[farming|farmed]], traded for, or acquired by plant gathering. Farming happens at farm plots. There are two types of crops: above ground and subterranean. The [[seed]]s of subterranean crops may be brought from the starting embark screen or, with some small luck, purchased from dwarven caravans. Above ground crops and [[seed]]s may be purchased from human or elven caravans or gathered by dwarves with the [[plant gathering]] labor enabled. Seeds may also be collected by processing the plants or eating them (but not by cooking!). There is a limit of 200 seeds of a given type at a time, after which no more will be produced.

A few of the plants listed below are not strictly crops, as they have no seeds and can't be planted (see note "4", below.)

Most plants can be brewed into alcohols, each plant type producing a different variation, and dwarves do prefer some variety in their drink. Some plants may be eaten raw, others must be cooked first, others must be processed first (by milling or plant processing) before they are edible, and still others are inedible, producing only non-food products (their seeds can be cooked anyway, however). Drinks may be cooked as ingredients in prepared meals, but at least one of the ingredients must be a non-liquid.

All drinks require a spare [[barrel]] or [[large pot]] for storage, and some other products also require specific containers for storage. Plants can be stored in barrels or without a container; seeds are stored individually or in [[bag]]s which can then be put into barrels. It may be advisable to have a small stockpile that accepts only seeds next to your farm(s), since dwarves will happily carry entire pots of seeds across the map to pick up a single seed, leading to cancellation spam and irregular planting.

Plump helmets and pig tails can be harvested 25 days after sowing. All other subterranean crops need about 42 days.

{{plant table head}}
{{plant table row|name=Plump helmet|tile=♠|color=5:0|biome=Wet cavern|value=4|drink=Dwarven wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Pig tail|tile=τ|color=7:0|seasons={{seasons3||1|1|}}|biome=Wet cavern|value=4|drink=Dwarven ale|drinkv=10|prod=Pig tail thread (p)|prodv=2}}
{{plant table row|name=Cave wheat|tile=τ|color=7:1|seasons={{seasons3||1|1|1}}|biome=Wet cavern|value=4|drink=Dwarven beer|drinkv=10|cook=p|prod=Dwarven wheat flour (m)|prodv=20}}
{{plant table row|name=Sweet pod|tile=Φ|color=4:1|seasons={{seasons3|1|1|1|}}|biome=Wet cavern|value=4|drink=Dwarven rum|drinkv=10|cook=p|prod=Dwarven sugar (m) Dwarven syrup (l)|prodv=20☼ 1001}}
{{plant table row|name=Quarry bush|tile=♣|color=7:0|seasons={{seasons3|1|1|1|}}|biome=Wet cavern|value=4|cook=p|prod=Quarry bush leaves (b) Rock nut paste (m) Rock nut press cake (s) Rock nut oil (s)|prodv=501☼ 1☼ 1☼ 5}}
{{plant table row|name=Dimple cup|tile=♥|color=1:1|biome=Wet cavern|value=4|prod=Dimple [[dye]] (m)|prodv=20}}
{{plant table row|name=Muck root/4|tile=τ|color=0:1|biome=Wetland/Wet|value=1|drink=Swamp whiskey|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Bloated tuber/4|tile=Φ|color=6:0|biome=Wetland/Dry|value=2|drink=Tuber beer|drinv=10|eat=y|cook=y}}
{{plant table row|name=Kobold bulb/4|tile=Φ|color=0:1|biome=Wetland/Wet|value=5|prod=[[Gnomeblight]] (e)|prodv=100}}
{{plant table row|name=Prickle berry|tile=:|color=2:0|biome=Not freezing/Dry|value=1|drink=Prickle berry wine|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Strawberry|tile=:|color=4:0|biome=Not freezing/Dry|value=4|drink=Strawberry wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Longland grass|tile=τ|color=6:1|biome=Not freezing/Dry|value=4|drink=Longland beer|drinkv=10|cook=p|prod=Longland flour (m)|prodv=20}}
{{plant table row|name=Valley herb/4|tile=ÿ|color=2:1|seasons={{seasons3|1|||}}|biome=Temperate grassland/Dry|value=10|cook=y|prod=[[Golden salve]] (v)|prodv=100}}
{{plant table row|name=Rat weed|tile=τ|color=2:0|biome=Not freezing/Wet|value=1|drink=Sewer brew|drinkv=5|eat=y|cook=y}}
{{plant table row|name=Fisher berry|tile=:|color=7:0|biome=Not freezing/Wet|value=4|drink=Fisher berry wine|drinkv=10|eat=y|cook=y}}
{{plant table row|name=Rope reed|tile=ƒ|color=2:0|biome=Not freezing/Wet|value=4|drink=River spirits|prod=Rope reed thread (p)|prodv=2}}
{{plant table row|name=Blade weed|tile=τ|color=2:0|biome=Not freezing/Dry|value=4|prod=Emerald [[dye]] (m)|prodv=20}}
{{plant table row|name=Hide root|tile=τ|color=6:0|biome=Not freezing/Dry|value=1|prod=Redroot [[dye]] (m)|prodv=10}}
{{plant table row|name=Sliver barb|tile=τ|color=0:1|biome=Not freezing/Dry|align=Evil|value=1|drink=Gutter cruor|drinkv=5|prod=Sliver [[dye]] (m)|prodv=20}}
{{plant table row|name=Sun berry|tile=:|color=6:1|biome=Not freezing/Wet|align=Good|value=9|drink=Sunshine|drinkv=25|eat=y|cook=y}}
{{plant table row|name=Whip vine|tile=§|color=3:1|biome=Not freezing/Dry|align=Savage|value=1|drink=Whip wine|drinkv=15|cook=p|prod=Whip vine flour (m)|prodv=25}}
|}
'''Notes:'''
:1 This is the value for a stack of 5 units, which is the number rendered from a single plant.
:2 Anything that can be cooked is edible afterwards. [[v0.31_Talk:Cook#No_Seeds|Cooking leaves no seeds for re-planting.]]
:3 These plants cannot be eaten/cooked until they are further processed, either by milling or extracting; see "products" column for process product.
:4 These plants cannot be grown on a farm plot as they have no seeds. They can only be acquired through plant gathering (in season only) or trade.
:5 To get the products/extracts from the plants they have to be processed, in the following [[workshop]]s, using the following [[labor]]s:
::*'''m''': mill ([[cave wheat]], [[sweet pod]], [[longland grass]], [[whip vine]], [[dimple cup]], [[blade weed]], [[hide root]], [[sliver barb]]): At [[quern]] or [[millstone]], using [[milling]].
::*'''b''': process to bag ([[quarry bush]]): At [[farmer's workshop]], using [[plant processing]].
::*'''s''': press paste into oil ([[quarry bush]]): At [[screw press]].
::*'''l''': process to barrel ([[sweet pod]]): At farmer's workshop, using plant processing.
::*'''p''': process plant ([[pig tail]], [[rope reed]]): At farmer's workshop, using plant processing.
::*'''v''': process to vial ([[valley herb]]): At farmer's workshop, using plant processing.
::*'''e''': extract plant essence ([[kobold bulb]]): At [[still]], using [[plant gathering]].

== Garden Plants ==
Garden plants are defined in a separate file from standard plants, named, somewhat predictably, plant_garden.txt 
Unlike standard plants, garden plants will also produce growths - leaves, buds, flowers, pods and fruits.
As a general rule, leaves can be only cooked, buds can be both cooked and brewed. // todo: fill in rest; didn't get that far.
{{plant table head}}
{{plant table row|name=Artichoke|tile=:(58)|color=6:0|biome=dry temperate|value=2
|drink=artichoke wine|drinkv=2|eat=y|cook=y
|prod=leaves (green) heart (purple) flowers seeds
|prodv=?☼ ?☼ ?☼ 1}}
{{plant table row|name=Asparagus|tile=:(58)|color=2:0|biome=dry grassland|value=2
|eat=y|cook=y
|prod=leaves (yellowish-green) flowers (green) fruits (poisonous) seeds
|prodv=?☼ ?☼ ?☼ 1}}
|}

Sofar:soybean(magenta),muskmelon(yellow),Chicory(blue), amaranths(purple)
(someone please make me a table, im incompetent)

== Crop Plants ==

== See also ==
* [[Farming]]

{{Category|Crops| }}

DF2014 Talk:Crop

2014-07-11T15:06:53Z

StrikaAmaru: ask q.