Dwarf Fortress Wiki - User contributions [en]

v0.34:Immigration

2012-08-21T14:30:32Z

Bobleb01: /* Bugs */

{{quality|Exceptional|21:11, 20 August 2010 (UTC)}}{{av}}{{buggy}}

Immigration can occur at any time once per season. Smaller migrant waves of 2 to 10 seem typical in early seasons, followed by a large wave in the low double digits in the second Spring, one year after embark. It may be the case that the first 2 migrant waves are special and possibly generated out of thin air, like all waves used to be. Even if your parent civilization is extinct, two waves will still show up. Each group of migrants will often include domestic animals, either as a pet or unclaimed livestock. Be prepared with adequate [[food]], [[alcohol|drink]], and [[bed]]s, among other things. Max wave size reported to date is 77.[http://www.reddit.com/r/dwarffortress/comments/q580c/hole_shit/ Source]

Migrants will have skills that match your fortress' needs: Migrants with skills your fortress uses a lot or skills that your fortress doesn't have at all are more likely to show up at your gates. Important skills (mining, food production and basic crafting according to Toady) are weighed more heavily than other skills.[http://www.bay12games.com/media/Dwarf_Fortress_Talk_12.mp3 Source]

Migration waves are generally a good thing-- if you're prepared for them.

== Labor preference bug ==

Each migrant can arrive with a wide collection of often unrelated skills, far greater than possible with one of the [[starting build|starting 7 dwarves]], and [[experience]] levels as high as Legendary.
Any and all skills might be represented, including obscure military skills (like [[blowgunner]]), high levels of one or more [[social skill]]s, [[crutch walker]], [[concentration]] and others. It's even possible to have dwarves with skills that may not be obtainable by other means, like [[military tactics]] or [[tracker|tracking]].

Immigrants may have high skills in certain [[labor|labors]] without actually having them enabled in their labor preferences. This leads to dwarves either doing jobs from an area they are not labeled for or no work at all. For example, an adequate cheese maker (with the cheese making labor turned on) may also have the skill bone carving on "high master", albeit turned off in his preferences. The dwarf in question is listed as a bone carver on screen and in the [[status]] tab, but will only perform the cheese making labor. Individually checking each immigrant for skills and labor preferences is the only workaround so far. But the use of programs such as [[utilities|Dwarf Therapist]] can greatly decrease the time taken to check each dwarf's skills.

As of v34.04, migrants may arrive with all labors except hauling, cleaning, recovering wounded, and caring for wounded disabled, depending on the settings one has entered into data/[[init.txt]].

== Historical migrants ==

Some immigrants are [[legends|historical]] figures. These immigrants come to your fortress with skills representing their history, and may come to your fortress with wounds they have suffered during [[world generation]]. Immigrants may even be [[vampire]]s.

==Limiting/preventing immigration==
If the fortress population exceeds the population cap when the dwarven [[liaison]] is visiting he will note that you don't want any more dwarves. On his safe return to the dwarven homeland he then will see that no migrants are sent that year. So you can stop immigration by setting the POPULATION_CAP option in [[d_init.txt]] to a number lower than your current population, the change will only take effect after the dwarven caravan visits so you may get up to three waves of migrants before the change takes effect.{{Verify}}

The first two immigrant waves are hardcoded so you will always receive them, and if you have less than 4 dwarves POPULATION_CAP is ignored {{Verify}}. The number of migrants depends on the [[wealth|created wealth]] of your fortress and so is affected by your dwarves activities. Note that if your fortress should ever become a mountainhome, you will receive an additional migration wave with the promotion, regardless of your population cap. The number of migrants is not affected by how far below the population cap your fortress was. One dwarf short, or twenty - it's all the same.

It is worth noting that you need a certain minimum population size before any of your dwarves will experience [[strange mood]]s. Additionally, POPULATION_CAP still allows babies to be born. You will need to alter BABY_CAP in order to change it.

There is an open bug where it seems that for some people POPULATION_CAP doesn't work at all. {{Verify}}{{Bug|2922}}

==Immigration mechanics==
The date on which immigrants appear in a season seems to be fixed at the start of that season, but the number of immigrants and their skills are determined when the migrant wave arrives.

There is never a migration in the first winter. There won't even be a {{DFtext|The fortress attracted no migrants this season|DarkGoldenRod}} message.

==Migrant wave sizes==
The first two migrant waves have a minimum size of 2 and a maximum size of 10. The size of these waves are unaffected by fortress wealth.

The third migrant wave and on are influenced by the [[wealth|created wealth]] of the fortress, with more wealth attracting more immigrants (more research is needed to determine specifics). Specifically, they're influenced by the fortress wealth as reported by the last outgoing dwarven [[caravan]]. Wealth created after the caravan leaves has no influence until the next year's caravan leaves. If the caravan fails to make it out then the fortress' wealth is not reported. The dwarven [[liaison]] does not report on fortress wealth, in those circumstances where the liaison makes it out but the caravan doesn't.

Imported wealth, caravan sales figures, absolute caravan profit and caravan profit margin either have no effect on migration numbers, or only have an effect by applying a percent modification to the numbers driven by created wealth. If a fortress manages to [[trading|trade]] (not offer) away 100% of its created wealth then no immigrants will come the next season. More research is needed to determine if the aforementioned statistics have any influence on migration numbers.

==Adventure mode==
In certain locations in [[adventure mode]], you may come across a '''Migrating Group'''. One such location is near a recently [[abandon|abandoned]] [[fortress]]; choosing to travel to the group will allow you to talk to the members of your former fortress as they travel back to dwarven civilization.

==Bugs==
If any migrants to your fort were formerly traders or soldiers with a trade caravan, then they will be marked as a "friendly" Trader, stand around at the map edge for a while (blocking the rest of the migrants, and caravans or even a Monarch), and then wander around randomly, unable to be assigned labors. {{Bug|5098}}

Also, some migrants will be incorrectly listed as babies or children, when they are not in the expected age range for those categories. This will automatically fix itself when they have their next birthday. Some baby migrants may have future birth dates. {{Bug|3945}}

v0.34:Immigration

2012-08-20T17:54:18Z

Bobleb01: /* Bugs */

{{quality|Exceptional|21:11, 20 August 2010 (UTC)}}{{av}}{{buggy}}

Immigration can occur at any time once per season. Smaller migrant waves of 2 to 10 seem typical in early seasons, followed by a large wave in the low double digits in the second Spring, one year after embark. It may be the case that the first 2 migrant waves are special and possibly generated out of thin air, like all waves used to be. Even if your parent civilization is extinct, two waves will still show up. Each group of migrants will often include domestic animals, either as a pet or unclaimed livestock. Be prepared with adequate [[food]], [[alcohol|drink]], and [[bed]]s, among other things. Max wave size reported to date is 77.[http://www.reddit.com/r/dwarffortress/comments/q580c/hole_shit/ Source]

Migrants will have skills that match your fortress' needs: Migrants with skills your fortress uses a lot or skills that your fortress doesn't have at all are more likely to show up at your gates. Important skills (mining, food production and basic crafting according to Toady) are weighed more heavily than other skills.[http://www.bay12games.com/media/Dwarf_Fortress_Talk_12.mp3 Source]

Migration waves are generally a good thing-- if you're prepared for them.

== Labor preference bug ==

Each migrant can arrive with a wide collection of often unrelated skills, far greater than possible with one of the [[starting build|starting 7 dwarves]], and [[experience]] levels as high as Legendary.
Any and all skills might be represented, including obscure military skills (like [[blowgunner]]), high levels of one or more [[social skill]]s, [[crutch walker]], [[concentration]] and others. It's even possible to have dwarves with skills that may not be obtainable by other means, like [[military tactics]] or [[tracker|tracking]].

Immigrants may have high skills in certain [[labor|labors]] without actually having them enabled in their labor preferences. This leads to dwarves either doing jobs from an area they are not labeled for or no work at all. For example, an adequate cheese maker (with the cheese making labor turned on) may also have the skill bone carving on "high master", albeit turned off in his preferences. The dwarf in question is listed as a bone carver on screen and in the [[status]] tab, but will only perform the cheese making labor. Individually checking each immigrant for skills and labor preferences is the only workaround so far. But the use of programs such as [[utilities|Dwarf Therapist]] can greatly decrease the time taken to check each dwarf's skills.

As of v34.04, migrants may arrive with all labors except hauling, cleaning, recovering wounded, and caring for wounded disabled, depending on the settings one has entered into data/[[init.txt]].

== Historical migrants ==

Some immigrants are [[legends|historical]] figures. These immigrants come to your fortress with skills representing their history, and may come to your fortress with wounds they have suffered during [[world generation]]. Immigrants may even be [[vampire]]s.

==Limiting/preventing immigration==
If the fortress population exceeds the population cap when the dwarven [[liaison]] is visiting he will note that you don't want any more dwarves. On his safe return to the dwarven homeland he then will see that no migrants are sent that year. So you can stop immigration by setting the POPULATION_CAP option in [[d_init.txt]] to a number lower than your current population, the change will only take effect after the dwarven caravan visits so you may get up to three waves of migrants before the change takes effect.{{Verify}}

The first two immigrant waves are hardcoded so you will always receive them, and if you have less than 4 dwarves POPULATION_CAP is ignored {{Verify}}. The number of migrants depends on the [[wealth|created wealth]] of your fortress and so is affected by your dwarves activities. Note that if your fortress should ever become a mountainhome, you will receive an additional migration wave with the promotion, regardless of your population cap. The number of migrants is not affected by how far below the population cap your fortress was. One dwarf short, or twenty - it's all the same.

It is worth noting that you need a certain minimum population size before any of your dwarves will experience [[strange mood]]s. Additionally, POPULATION_CAP still allows babies to be born. You will need to alter BABY_CAP in order to change it.

There is an open bug where it seems that for some people POPULATION_CAP doesn't work at all. {{Verify}}{{Bug|2922}}

==Immigration mechanics==
The date on which immigrants appear in a season seems to be fixed at the start of that season, but the number of immigrants and their skills are determined when the migrant wave arrives.

There is never a migration in the first winter. There won't even be a {{DFtext|The fortress attracted no migrants this season|DarkGoldenRod}} message.

==Migrant wave sizes==
The first two migrant waves have a minimum size of 2 and a maximum size of 10. The size of these waves are unaffected by fortress wealth.

The third migrant wave and on are influenced by the [[wealth|created wealth]] of the fortress, with more wealth attracting more immigrants (more research is needed to determine specifics). Specifically, they're influenced by the fortress wealth as reported by the last outgoing dwarven [[caravan]]. Wealth created after the caravan leaves has no influence until the next year's caravan leaves. If the caravan fails to make it out then the fortress' wealth is not reported. The dwarven [[liaison]] does not report on fortress wealth, in those circumstances where the liaison makes it out but the caravan doesn't.

Imported wealth, caravan sales figures, absolute caravan profit and caravan profit margin either have no effect on migration numbers, or only have an effect by applying a percent modification to the numbers driven by created wealth. If a fortress manages to [[trading|trade]] (not offer) away 100% of its created wealth then no immigrants will come the next season. More research is needed to determine if the aforementioned statistics have any influence on migration numbers.

==Adventure mode==
In certain locations in [[adventure mode]], you may come across a '''Migrating Group'''. One such location is near a recently [[abandon|abandoned]] [[fortress]]; choosing to travel to the group will allow you to talk to the members of your former fortress as they travel back to dwarven civilization.

==Bugs==
If any migrants to your fort were formerly traders or soldiers with a trade caravan, then they will be marked as a "friendly" Trader, stand around at the map edge for a while (blocking the rest of the migrants, and caravans), and then wander around randomly, unable to be assigned labors. {{Bug|5098}}

Also, some migrants will be incorrectly listed as babies or children, when they are not in the expected age range for those categories. This will automatically fix itself when they have their next birthday. Some baby migrants may have future birth dates. {{Bug|3945}}

v0.34:Strange mood

2012-08-18T03:12:00Z

Bobleb01: /* Possessed */

{{quality|Exceptional|02:25, 4 May 2011 (UTC)}}{{av}}

{{buggy|bugsection=Bugs}}
{{minorspoiler}}
Periodically, individual dwarves are struck with an idea for a [[legendary artifact]] and enter a '''strange mood'''. Dwarves which enter a strange mood will stop whatever they are doing and pursue the construction of this artifact to the exclusion of all else. They will not stop to eat, drink, sleep, or even run away from dangerous creatures. If they do not manage to begin construction of the artifact within a handful of months, they will go [[#Failure|insane]] and die soon afterward.

Note: All controllable civilizations are currently able to enter strange moods, though in earlier versions of DF the only civilization this applies to is dwarves.

==Overview==

# The conditions necessary for a strange mood to occur are not fully understood, although they may possess even dwarf children.
# The game will pause, center on a dwarf, and announce that the dwarf has entered one of five different types of strange moods. The [[#Types of moods|types of moods]] are listed below. While in a mood, a dwarf will display a blinking exclamation point (see [[Status icon|status icons]]).
# For the duration of the mood, the dwarf will claim a workshop related to the skill that the mood affects (not all skills are eligible), kick out any dwarf who was using it, and render it otherwise unusable until the mood has been resolved. If a moody dwarf does not claim a workshop, it is because the appropriate workshop does not exist. (See [[#Skills and workshops|skills and workshops]] below to determine which workshop(s) might be required.) A moody dwarf will ''not'' be able to build a needed workshop; another dwarf with the appropriate [[labor]] designation must do so for them, if one is necessary.
# After claiming a workshop, the dwarf will set about collecting the required materials for their artifact. If the dwarf remains idle inside the workshop, it's because they cannot find the right material. Reference the [[#Demands|demands]] section to determine what may be required. Important Note: They will only collect these materials in the order that they require them. In other words, you have to determine where they are on the list of required materials and then provide the next one before they will continue collecting other materials.
# Once all materials have been gathered, the game will once again pause and center, and the moody dwarf will begin construction. Upon completion the dwarf will create a semi-random artifact related to the skill affected and gain [[legendary]] (or higher) status in that skill (unless the mood type is [[#Possessed|possessed]]). See the [[#Skills and workshops|skills and workshops]] for information on which skills can be gained, or the [[#Artifacts created|artifacts created]] section for more details on the artifacts themselves.

== Types of moods ==
For each of the following types of moods, the first message is how the mood is [[Announcement|announced]]; the second message appears in the dwarf's profile when he or she is viewed with the {{K|v}} key. All moody dwarves will have "Strange Mood" listed as their active task and are "quite content", regardless of any recent [[thought]]s they may have had.

=== Fey ===
* {{Gametext|<dwarf> is taken by a fey mood!|7:1}}
: ''Has the aspect of one fey!''

This is the most basic strange mood. Fey dwarves will clearly state their demands when the workshop they are in is examined.

=== Secretive ===
* {{Gametext|<dwarf> withdraws from society...|7:0}}
: ''Peculiarly secretive...''

Secretive moods are the same as fey moods, except a secretive dwarf will sketch pictures of their required materials instead of clearly stating their demands if they cannot find what they need. Descriptions of all these [[#Demands|secretive requirements]] can be seen only by viewing the workshop that the moody dwarf has claimed, with {{k|q}}, and then only while the dwarf is waiting inside it. More than one "picture" is likely; these will cycle through the entire list automatically if any one is not available. (Since materials are gathered ''in order'', it's quite possible that only one of a long list is needed to allow the moody dwarf to continue on their project. If the dwarf has gathered some of the materials (seen as "tasked" when looking at the workshop with {{k|t}}), then the next in the list is what they are looking for.)

=== Possessed ===
* {{Gametext|<dwarf> has been possessed!|5:1}}
: ''Possessed by unknown forces!''

Possessed dwarves have cryptic material requests, and have the unfortunate distinction of not receiving any experience upon successful construction of an artifact. No controllable circumstances lead to a possessed mood instead of one of the more desirable fey or secretive moods. It is pure luck-based. Possessed dwarves will mutter the name of the artifact they are working on (which, under some circumstances, might end up being ''their own name'') once they have all the materials they need.

A possession is the only mood that does '''''not''''' result in a jump in [[experience]].

A possessed dwarf that "keeps muttering <name of the artifact>..." has already gathered everything it needs

=== Fell ===
* {{Gametext|<dwarf> looses a roaring laughter, fell and terrible!|5:0}}
: ''Has a horrible fell look!''

A dwarf that goes into a fell mood will always take over a [[butcher's shop]] or a [[tanner's shop]]. If neither are available, any other workshop will be used instead. The dwarf will then ''murder'' the nearest dwarf (bonus if its a noble), drag the corpse into the shop and make some sort of object out of dwarf [[leather]] or [[bone]]. Once the artifact is completed, the fell dwarf will become a legendary [[bone carver]] or [[leatherworker]]. Only unhappy dwarves may enter a fell mood.

Amusingly, it seems fell dwarves can murder [[ghost]]s as well.

Aside from the loss of a potentially important dwarf in the wrong place at the wrong time, there doesn't seem to be any downside to a fell mood. The end result is always an artifact and a legendary craftsdwarf. Since the only ingredient used (a dwarf) is available in abundance, a fell mood will only fail if the fell dwarf is completely isolated from other dwarves, or if the proper workshop does not exist.

If no one is around to witness the murder, whichever dwarf Urist McEmo decides to slaughter will be reported as missing some time after his death. If the murder is witnessed, the moody dwarf will be subject to dwarven [[justice]].

=== Macabre ===
* {{Gametext|<dwarf> begins to stalk and brood...|0:1}}
: ''Brooding darkly...''

Macabre moods are similar to fell moods, but the dwarf will not murder a fellow dwarf. A macabre dwarf may require bones, skulls{{verify}}, or vermin remains; if you do not happen to have any, you will have to make some, e.g. by butchering an animal and/or allowing a [[cat]] to go hunting, or let the moody dwarf go insane. Like fell moods, only unhappy dwarves can enter macabre moods.

==Caveats==
* Shells are a common request in moods and are only produced from preparing raw [[turtle]]s, [[mussel]]s, [[oyster]]s, or [[cave lobster]]s at a fishery. That is, you must be able to fish them at your site - there is no way of trading for them, since traded [[cave lobster]]s and [[turtle]]s are ''processed'' fish (with the shells already removed). Version 0.31.12 and beyond should have much fewer shell requests.
* Should the claimed workshop be a [[magma forge]] and lose power due to insufficient magma beneath it, the mood will fail immediately and the dwarf will go [[insanity|insane]]. Should the forge be in danger of losing power, you should forbid it before it is claimed and wait until it is powered up reliably. Once magma forges are built, at least some dwarves will no longer be satisfied with a regular forge.
* The following can happen (v .31.12) "OVERWROTE JOB: Strange Mood BY Starting Fist Fight".
* The mood's primary material will only be mentioned ''once'' in the dwarf's requests, even if the dwarf wants more than one unit of it. [http://www.bay12forums.com/smf/index.php?topic=75139.0;topicseen]
* The item to be built is not set at the beginning of the mood. Saving (even after a dwarf has begun to gather materials) will allow you to reload and the result may be a different artifact. If you want to receive artifact adamantine breastplate, make sure to have adamantine nearby and forbid/move away any other materials. You can reload the artifact creating process, even after the dwarf has gathered most of components by forbidding the claimed items. If other items of that type are available, dwarf will immediately switch to them.

==Bugs==
* There are bugs reported related to moody dwarves. As has been the case in 40d, most turned out to be (understandable) failures of the player to grasp the mechanics of artifact creation and demands. Bug tracker: [http://bay12games.com/dwarves/mantisbt/view_all_bug_page.php]
* Moody Dwarves don't respect burrows when grabbing a workshop, but DO when looking for items. If his claimed workshop is outside his assigned burrow, the dwarf will continue to grab materials until all materials of the needed type are exhausted within his assigned burrow, this is similar to the [[Main:Planepacked|Planepacked]] glitch.
* If a dwarf dies because of failing to complete an artifact, a memorial made to the dwarf will read that the dwarf did create it, despite the failure, and will even list the name of the artifact that never came to be.

== Demands ==
Once a workshop is claimed, the dwarf will begin collecting materials. Each artifact will require between one and ten materials to complete. The dwarf may well need several items of one material! If the moody dwarf remains idle, then the necessary materials are not available. [[Forbid|Forbidden]] items must be reclaimed ({{K|d}} - {{K|b}} - {{K|c}}) before they may be used, but moody dwarves will ignore settings regarding [[economic stone]]. Press {{K|q}} and highlight the workshop to receive a series of clues about what the dwarf needs. Hints that stay active for longer than 2 seconds mean that multiple pieces of that material will be required; each single demand will be displayed for 2 seconds, so if it says "gems... shining" for 6 seconds, 3 gems are demanded. However, occasionally a hint shown for only 2 seconds will require more than one item to fulfill it; this behavior seems to occur mainly (only?) with the primary material (the base material of the artifact, and the first item gathered).{{Verify}} Materials will always be fetched ''in order'', so if at least one item has already been retrieved (the items will show up with "TSK" ("task") next to them when the workshop is viewed with the {{K|t}} context menu), it will usually be possible to tell what item is required next.

If you want your dwarves to construct their artifacts out of valuable materials instead of whatever useless thing happens to be close at hand, you can selectively forbid types of material through the stocks screen so that only the material you want them to use is available; though this might interfere with the normal crafting operations of your fortress, the disruption is generally short-lived (as long as you remember to unforbid them again afterwards!). You can even forbid something a moody dwarf is carrying (which may be necessary sometimes, since while they are not waiting in the workshop they will not tell you what they need); the dwarf will finish hauling it to the workshop, but then immediately go searching for another. This trick can mean the difference between a bauxite statue decorated with moss agates and a native platinum statue encrusted with diamonds. Be aware that this may not always work - moody [[metalsmith]]s will occasionally insist on a specific type of metal with which to make their artifact, and forbidding other metals to force them to use a more valuable material will simply cause them to sit in the workshop until you give them what they want. This metal is usually the one listed in their Thoughts and Preferences page as their favorite metal. Weaponsmiths and armorers are likely to insist on adamantine wafers should any exist in your fortress, forbidden or not, regardless of the particular dwarf's preferences{{verify}}.

Burrows allow even better control over moody dwarf's material usage. Simply by creating a burrow around claimed workshop and another part over desired material, moody dwarf can be controlled without forbidding every single stone in fortress. A moody dwarf will follow the burrow-definitions just like a regular worker, but be mindful that they will not leave the burrow to get materials that are outside of their assigned burrow. A problem can arise when bones from an outside refuse stockpile are needed by a moody dwarf that is assigned to a burrow.

The various demands are translated here:

:{| class="wikitable" style="text-align:left;width:90%;"
|-
! Material
! Fey
! Secretive
! Possessed
|-
|
| <dwarf> screams "I must have <demand>!"
| <dwarf> sketches pictures of <demand>.
| <dwarf> mutters "<artifact> needs <demand>..."
|-
| [[Stone]]
| rock
| a quarry
| stone... rock
|-
| Stone/metal [[block]]s
| rock blocks
| square blocks
| blocks... bricks
|-
| [[Wood]]
| wood logs
| a forest
| tree... life
|-
| Metal [[bar]]
| metal bars
| shining bars of metal
| bars... metal
|-
| [[Gem]]s (cut)
| cut gems
| cut gems
| gems... shining
|-
| [[Gem]]s (raw)
| rough gems
| rough gems
| rough... color
|-
| Green [[glass]]
| raw green glass
| glass
| raw... green
|-
| Clear glass
| raw clear glass{{verify}}
| glass and burning wood
| raw... clear
|-
| Crystal glass
| raw crystal glass{{verify}}
| rough gems and glass
| raw... crystal
|-
| [[Bone]]{{verify}}
| bones
| skeletons
| bones... yes
|-
| [[Shell]]{{verify}}
| shells
| shells
| a shell...
|-
| [[Leather]]
| tanned hides
| stacked leather
| leather... skin
|-
| [[Cloth]] (plant fiber)
| plant cloth
| stacked cloth
| cloth... thread
|-
| [[Cloth]] (silk)
| silk cloth
| stacked cloth
| cloth... thread
|-
| [[Cloth]] (yarn)
| yarn cloth
| stacked cloth
| cloth... thread
|-
| [[Bone]], possibly [[Skull]], [[Horn]], [[Ivory]]
| body parts
| death
| a corpse
|}

Dwarves in macabre moods will list their demands in the same fashion as those in fey moods (though with them brooding "Yes. I need <item>." instead of screaming "I must have <item>!"). They may also say "Leave me. I need... things... certain things", in which case they want special items such as [[skull]]s or vermin [[remains]].

Related to the above behavior, moody dwarves demanding rock blocks will also accept blocks forged from metal bars.

Moody metalworkers may occasionally require a specific type of metal as their artifact's primary material - for secretive moods and possessions, take a look at the dwarf's material preferences to see which metal the dwarf wants to use.

Once all materials have been gathered, viewing the workshop with {{K|q}} will display a special message depending on the type of mood:
* Fey - "<dwarf> works furiously!"
* Secretive - "<dwarf> works secretly..."
* Possessed - "<dwarf> keeps muttering <artifact>..."
* Macabre - "<dwarf> works, darkly brooding..."
* Fell - "<dwarf> works with menacing fury!"

''note:'' moody dwarves may also use materials that are restricted by culture (intelligent creature parts):
a '''POSSESSED''' dwarf claimed a craftsdwarf workshop then collected the '''right upper arm bone of a goblin warrior''' (dead obviously) as the first ingredient of his work.

== The mechanics of moods ==

=== Frequency===
When a fortress is started, an internal counter is set to 1000. Every 100 frames (12 times per day), this counter is decremented by 1, running down to zero in about 3 months. When the counter would ordinarily be decremented when it has already reached zero, there is a 1 in 500 chance that a strange mood will strike. This means that, once all conditions are met and the clock is ticking, while there is approximately a 2.4% chance of a strange mood per day, or ''very approximately'' a 50% chance of a strange mood per month, there is no guarantee when a mood will strike - might be sooner, might be (almost) never.

=== Conditions ===
In order for a dwarf to be struck with a strange mood, three conditions must be met:
:* There is no currently active strange mood,
:* The maximum number of artifacts is not met,
:* There are at least 20 eligible dwarves ''(see below)''.

If all three of these conditions are true, the game may trigger a strange mood according to the frequency.

==== Maximum number of artifacts ====
The maximum number of artifacts in any one fortress is limited by the lower of:
* The number of items created divided by 100.1 Mined-out rock '''does''' count as an "item created", though it is not clear whether bolts or units of drink are counted individually.
* The number of revealed [[subterranean]] tiles divided by 2304 (this is an area equivalent to a 48x48 square). Once you discover and explore the [[cavern]]s and [[magma sea]], this limit becomes largely irrelevant, and using a [[utilities#DFHack|"reveal" utility]] will eliminate it altogether.
:1 - actually the sum of all items by type '''and''' by type+subtype+material, divided by 200. Furthermore, destroying items does '''not''' decrement these counters, so casting and mining [[obsidian]] will count toward this.

==== Eligibility ====
The deciding factor for eligibility is a dwarf's actual [[profession]]. ''(Note that "[[Skill#Custom profession labels|custom professions]]" have no effect on this!)'' Thus, dwarves may enter strange moods regardless of what skills they have or don't have, so long as they are of an acceptable profession. Dwarves who have already created an artifact are not eligible to create another, and since every mood ends in either an artifact or death, every dwarf may enter at most one mood. Dwarves who have obtained one or more legendary skills without creating artifacts '''may''' enter strange moods and will simply become even ''more'' legendary.

Dwarves with a [[Soldier#Soldier professions|military profession]] other than "Recruit" '''cannot''' enter moods. Incidental military skills make no difference - eligibility (and weighting) depends purely on the actual ''[[profession]]'' as listed at the time, so soldiers '''can''' enter moods if they are ''off duty'' and thus in Civilian mode. Babies may '''not''' enter moods.

Any other profession is eligible to enter a mood, but not all have the same ''chance'' to enter a mood...

:''('''Note''' - Specifically, and to avoid previous misunderstandings, [[Strand extractor]], [[Clerk]]/[[Administrator]]/[[Trader]], [[Doctor]] (and related), [[Building designer|Architect]], [[Soldier#Recruits|Recruit]] and [[Child]] '''are''' moodable professions.)''

=== Chance ===
When determining who will have a strange mood, each eligible dwarf is put into a weighted lottery. The odds are assigned a higher or lower weight based on the dwarf's [[profession]]. The default weight is 6, but some professions are more likely to enter a strange mood than others. (This is like most dwarves getting 6 tickets to the lottery, and others getting more.)

{| class="wikitable" cellspacing="0" border="2" cellpadding="5"
|-
! Weighting
! Professions

|-
| 21 ||Armorer, Blacksmith, Bone Carver, Clothier, Craftsdwarf, Jeweler, Gem Cutter, Gem Setter, Glassmaker, Leatherworker, Metalcrafter, Metalsmith, Stonecrafter, Weaponsmith, Weaver, Woodcrafter
|-
| 11 ||Bowyer, Carpenter, Stoneworker, Mason, Woodworker
|-
| 6 ||Engraver, Mechanic, Miner, Tanner, & all other [[profession]]s (including Peasant).

|}

:'''''Example:''' What this means is: if you had 21 dwarves, made up of 20 eligible farmers, furnace operators, miners, woodcutters etc. (with 6 chances each) plus one Armorer (with 21 chances), that one Armorer would have a 21 in 141 chance (20 dwarves x 6 chances each = 120 + 21 chances more = 141 total) of the mood striking them. That's about 1 in 7, while the other 20 have a 6 in 141 chance each, or about 1 in 24. The odds are still against the armorer, but much better than for any other single dwarf.''

Note that not every profession is from a moodable skill. A Soaper, Architect, Furnace Operator or Strand Extractor can be taken by a mood, but that will not make those skills legendary, nor will they create an artifact bar of soap, building, bar of metal or wafer of adamantine.

:NOTE: ''If your game was saved shortly before one of your dwarves acquired a mood, reloading that game will most likely cause the chances to be completely re-figured, resulting in a different mood at a different time for a different dwarf with different materials. This is true for most all random events and results in Dwarf Fortress.''

=== Skills and workshops ===

{| class="wikitable" cellpadding="4" style="border:1px solid black;border-collapse:collapse;text-align:left;float:right;margin:0 0 20px 30px;"
|-
! colspan="2" style="background-color:#eee;border-bottom:1px solid black;text-align:center;" | Artifact Skill Rewards
|-
! Highest skill
! Workshop used
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Armorsmith]]
| [[Metalsmith's forge]] (or [[Magma forge]])
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Bone carver]]
| [[Craftsdwarf's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Bowyer]]
| [[Bowyer's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Carpenter]]
| [[Carpenter's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Clothier]]
| [[Clothier's shop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Engraver]]
| [[Craftsdwarf's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Gem cutter]]
| [[Jeweler's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Gem setter]]
| [[Jeweler's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Glassmaker]]
| [[Glass furnace]] (or [[Magma glass furnace]])
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Leatherworker]]
| [[Leather works]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Mason]]
| [[Mason's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Mechanic]]
| [[Mechanic's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Metal crafter]]
| [[Magma forge]] (or [[Metalsmith's forge]])
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Metalsmith]]
| [[Magma forge]] (or [[Metalsmith's forge]])
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Miner]]
| [[Mason's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Stone crafter]]
| [[Craftsdwarf's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Tanner]]
| [[Leather works]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Weaponsmith]]
| [[Magma forge]] (or [[Metalsmith's forge]])
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Weaver]]
| [[Clothier's shop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| [[Wood crafter]]
| [[Craftsdwarf's workshop]]
|- style="border-top:1px solid #aaa;vertical-align:top;"
| Anyone Else
| [[Craftsdwarf's workshop]]
|}

A dwarf will claim a workshop according to their highest applicable skill, and upon completion of the artifact, gain 20,000 [[experience]] in that skill (excepting [[Strange mood#Possessed|possessed]] dwarves). This will give the dwarf a legendary-level [[skill]] (specifically, "legendary+1" or higher, depending on the dwarf's initial skill level). The table to the right describes all applicable skills and their potential workshop requirements - there are only 20 skills that determine the workshop and that can be affected by a mood (sometimes referred to as '''moodable''' skills.) If a dwarf does not possess at least one of the moodable skills listed to the right, they will take over a [[craftsdwarf's workshop]] and gain one of [[bone carver]], [[stone crafter]], or [[wood crafter]] skills, producing an artifact [[craft]].

This fact can be utilized to maximize the possibility of getting a dwarf with the specific legendary skill you want: since ''non''-moodable skills are ignored, whenever possible make sure that each dwarf's highest ''moodable'' skill is one of those you want*. Have all your peasants, [[farmer]]s, non-professional military and other dwarves without any moodable skills do a tiny bit of work in the skill(s) you most want; if a "[[experience|dabbling]]" skill is the highest moodable skill they have, that is the skill that will be used.

[[Weaponsmith]], [[Armorsmith]], [[Bowyer]], [[Leatherworker]], [[Clothier]], and [[Mechanic]] are the only skills that provide a uniquely beneficial item other than an extremely valuable trinket or piece of furniture. Note that artifact furniture is useful for increasing [[room value]].

== Artifacts created ==
The type of artifact created will depend on the dwarf's highest moodable skill. Masons and miners will always create some kind of stone furniture; bone carvers, a bone or shell object (including furniture); carpenters, a piece of wooden furniture; engravers and stone crafters, a stone craft; metalworkers, metal crafts, weapons, or armor (depending on the type of metalworker); weavers and clothiers, an article of clothing; tanners and leatherworkers, a leather armor or object. If a dwarf has no moodable skills, they will randomly select stone crafting, wood crafting, or bone carving as their mood skill and produce their artifact accordingly. The precise type of craft created is usually somewhat random, but if a dwarf has a personality preference for a particular thing, such as gauntlets or floodgates or crowns, and that thing is an available choice given the dwarf's profession, they are guaranteed to create an object of that type (if multiple preferences match, one will be randomly selected).

The first object grabbed by the dwarf will be the "primary" substance; all other materials will be used to decorate the artifact. If a dwarf grabs a piece of [[chalk]] and makes a statue, for instance, it will be a "chalk statue", but an artifact can potentially be composed of bone, cloth, gems, leather, metal, shell, stone, and wood all at once. In some cases, a moody dwarf will produce an item which normally cannot be made from that material, leading to such odd constructions as an [[obsidian]] [[bed]], [[ruby]] [[floodgate]], or turtle [[shell]] [[cage]], but the actual item types available for each mood type are still very much restricted (e.g. only a glassmaker or jeweler can make a [[window]], and a moody clothier cannot produce an article of clothing that could not normally be made from cloth).

Once created, most [[artifact]]s will be available for use just like a normal item of its type. Artifact furniture is useful for high value [[noble]] rooms. Artifact weapons in [[Trap components|weapon trap]]s can also boost a room's value considerably, as in the case of artifact trap components and mechanisms.

Unless the mood was a Possession, the dwarf will gain 20,000 points of [[experience]] in the skill used to produce the artifact, enough to boost them to Legendary.

== Failure ==
If you can't provide the desired workshop and all the required component materials within a couple of months, the dwarf will go [[insanity|insane]], which cancels the mood and the artifact. As if that's not bad enough, any dwarf who goes insane will soon die, one way or another.

A dwarf who is '''stark raving mad''' or '''melancholy''' is harmless to others (until they die and start a [[tantrum]] spiral), but a '''berserk''' dwarf will attack other dwarves and possibly pull levers at random. You may want to station a squad nearby or assign a few war dogs to the dwarf on the chance that they will lash out. If you build your workshops inside enclosed rooms with doors you can also lock the moody dwarf in the room until he or she starves. In extreme cases, building a wall around an open workshop is the best precaution.

v0.34:Syndrome

2012-08-01T18:33:59Z

Bobleb01: /* List of syndromes */

{{quality|Masterwork|21:09, 26 April 2011 (UTC)}}{{av}}

A '''syndrome''' is a disease or effect that a poor hapless creature might get through encountering certain creatures, extracts or vindictive modders. They generally cause unpleasant and frequently fatal [[symptoms]] over a short to long period of time, but some will clear up over time or with the assistance of a [[doctor]]. A [[Health care|Hospital]] is required to diagnose and potentially treat the syndrome. [[File:Snakebite.png|200px|thumb|right|An example of a syndrome in effect. This hippo did not ultimately survive the encounter despite one bite being the only injury sustained.]]

==List of syndromes==
{| {{prettytable}}
|- bgcolor="#dddddd"
! Syndrome
! Venom
! Acquired
! Short-term Symptoms
! Long-term Symptoms
! Chronic Symptoms
|-
| Adder bite
| adder venom (injected)
| Being bitten by an [[adder]], [[giant adder]] or [[adder man]]
| Strong pain
| Swelling Blisters Nausea
|
|-
| Alcohol poisoning (Could someone confirm this?)
| Lots of alcohol (ingested)
| Consumption of alcohol
| Nausea Dizziness Minor paralysis Vomiting Fever (rare)
| suffocation (rare)
| Motor nerve damage Kidney damage Death (unlikely, but killed one of my dwarfs.)
|-
| Bark scorpion sting
| bark scorpion venom (injected)
| Being stung by a [[bark scorpion]], [[giant bark scorpion]] or [[bark scorpion man]]
| Strong pain
| none
| none
|-
| Black mamba bite
| black mamba venom (injected)
| Being bitten by a [[black mamba]], [[giant black mamba]] or [[black mamba man]]
| Dizziness Drowsiness Strong pain Fever Unconsciousness Complete paralysis1
|
|
|-
| Blob blisters
| cave blob fluid (contact or ingested)
| Touching a [[cave blob]]
| Mild pain Mild blisters
| None
| None
|-
| Brown recluse spider bite
| brown recluse spider venom (injected)
| Being bitten by a [[brown recluse spider]], [[giant brown recluse spider]] or [[brown recluse spider man]]
| Nausea Fever Pain 
| Severe localized necrosis
|
|-
| Bumblebee sting
| bumblebee venom (injected)
| Being stung by a [[bumblebee]] worker
| Pain Strong swelling
|
|
|-
| Bushmaster bite
| bushmaster venom (injected)
| Being bitten by a [[bushmaster]], [[giant bushmaster]] or [[bushmaster man]]
| Strong pain Mild bleeding Dizziness Nausea Unconsciousness Complete paralysis1
|
|
|-
| Cave floater sickness
| cave floater gas (inhaled or ingested)
| Expelled from [[cave floater]]
| Mild nausea
| Fever Strong drowsiness (delayed) Strong dizziness (delayed)
| None
|-
| Cave spider bite
| cave spider venom (injected)
| Being bitten by a [[cave spider]]
| None
| None
| Very mild dizziness
|-
| Copperhead snake bite
| copperhead snake venom (injected)
| Being bitten by a [[copperhead snake]], [[giant copperhead snake]] or [[copperhead snake man]]
| Pain Swelling Nausea
|
|
|-
| Giant cave spider bite
| giant cave spider venom (injected)
| Being bitten by a [[giant cave spider]]
| Complete paralysis1 '''Being eaten by the GCS'''
| None, not that it really matters.
| None
|-
| Gila monster bite
| gila monster venom (injected)
| Being bitten by a [[gila monster]], [[giant gila monster]] or [[gila monster man]]
| Pain Mild swelling
|
|
|-
| Gnomeblight
| [[gnomeblight]] (contact, inhaled, injected, or ingested)
| Unknown. Affects gnomes only
| None
| Severe systemic necrosis2
| None
|-
| Giant desert scorpion sting
| giant desert scorpion (injected)
| Being stung by a [[giant desert scorpion]]
|
| Necrosis of the brain and nervous system2
| '''Unavoidable death'''
|-
| Helmet snake bite
| helmet snake venom (injected)
| Being bitten by a [[helmet snake]]
| Minor bleeding
| Fever Nausea Dizziness Localized swelling Localized oozing Localized bruising Strong pain Intense localized necrosis Possible loss of limb
| None
|-
| Honey bee sting
| honey bee venom (injected)
| Being stung by a [[honey bee]] worker
| Pain Strong swelling
|
|
|-
| Iron man cough
| iron man gas (inhaled)
| Expelled by [[iron man]]
| Coughing blood
| None
| None
|-
| King cobra bite
| king cobra venom (injected)
| Being bitten by a [[king cobra]]
| Complete paralysis1 Pain, dizziness, drowsiness
| None
| None
|-
| Phantom spider bite
| phantom spider venom (injected)
| Being bitten by a [[phantom spider]]
| None
| Numbness and mild dizziness
| None
|-
| Platypus sting
| platypus venom (injected)
| Being kicked by a [[platypus]], [[giant platypus]] or [[platypus man]]
| Pain and swelling
| Extreme pain, swelling possibly to the point of necrosis
| None
|-
| Rattlesnake bite
| rattlesnake venom (injected)
| Being bitten by a [[rattlesnake]], [[giant rattlesnake]] or [[rattlesnake man]]
| Pain, nausea, blisters, swelling, bruising
| Severe localized necrosis
| None
|-
| Serpent man bite
| serpent man venom (injected)
| Being bitten by a [[serpent man]]
| Complete paralysis1
| None
| None
|-
| [evil rain] sickness3
| random
| Being caught outside in freakish weather in an evil biome
| random
| random
| random
|-
| [evil cloud] sickness4
| random
| Being caught in a creeping cloud in an evil biome
| random
| random
| random
|-
| beast sickness5
| random
| Encounters with [[forgotten beast]]s
| random
| random
| random
|-
| titan sickness5
| random
| Encounters with [[titan]]s
| random
| random
| random
|-
| demon sickness5
| random
| Encounters with [[demon]]s
| random
| random
| random
|}
:1. For small creatures such as humans and dwarves, paralysis tends to result in suffocation.
:2. Necrosis of the brain will eventually result in death once the brain rots away completely.
:3. Evil rain typically only causes minor symptoms such as blisters, bruising, coughing blood, dizziness, fever, nausea, oozing, and pain.
:4. Evil clouds either cause major symptoms (as with beast/titan/demon sicknesses) or permanently transform creatures into [[Undead|zombie-like]] forms.
:5. [[Titan]]s, [[forgotten beast]]s, and [[demon]]s have a chance to have a randomized syndrome. These range from pointless (mild blisters from inhaling boiling blood) to instantly deadly (Severe necrosis from a contact poison attached to a breath weapon/creature made of blood.

==The anatomy of a syndrome==
Mechanically, syndromes are bundles of tokens attached to a material - they're confined to creature materials in vanilla DF, but it's a simple matter to add them to inorganic materials. When the material is injected, touched, inhaled, or ingested (depending on the syndrome), the creature suffers the predations of a nasty disease or poison. Here's an example syndrome, taken from the Giant Cave Spider raws.

If you are having troubles getting the syndromes to work (ie, in combat reports, getting "'''supersnake''' n/a splatters~etc"), then simply throw the venom template into the actual creature's raw, which is what the LOCAL_CREATURE_MAT actually calls on; the venom being in the same file.

[USE_MATERIAL_TEMPLATE:POISON:CREATURE_EXTRACT_TEMPLATE]
[STATE_NAME:ALL_SOLID:frozen giant cave spider venom]
[STATE_ADJ:ALL_SOLID:frozen giant cave spider venom]
[STATE_NAME:LIQUID:giant cave spider venom]
[STATE_ADJ:LIQUID:giant cave spider venom]
[STATE_NAME:GAS:boiling giant cave spider venom]
[STATE_ADJ:GAS:boiling giant cave spider venom]
[PREFIX:NONE]
[ENTERS_BLOOD]
[SYNDROME]
[SYN_NAME:giant cave spider bite]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[SYN_IMMUNE_CREATURE:SPIDER_CAVE:ALL]
[SYN_INJECTED]
[CE_PARALYSIS:SEV:100:PROB:100:RESISTABLE:SIZE_DILUTES:START:5:PEAK:10:END:20]

The first line, USE_MATERIAL_TEMPLATE, is creating a new material, called POISON, using the CREATURE_EXTRACT_TEMPLATE as the basis. After this, the STATE_NAME and STATE_ADJ tokens are used to define the names and adjectives assigned to different states of the material - GAS, LIQUID and ALL_SOLID, in this case, though ALL is also a valid token. At this stage, you can use any material tags like MAT_FIXED_TEMP or similar to set further material properties, though this usually isn't necessary.

ENTERS_BLOOD
This tag determines whether a poison enters the blood or not. If it is not included, the poison will splatter (if liquid) or flow (if gas) over the affected body part instead when injected. If you're using a contact poison, leave this out. Necessary for injected poisons.
SYNDROME
This tag ends the material details and begins the definition of the actual syndrome.
SYN_NAME
This one is self-explanatory - the name of the syndrome as it will appear in-game.
SYN_AFFECTED_CLASS
This token defines what CREATURE_CLASS will be affected by the syndrome. Most creatures are classed under GENERAL_POISON. Multiple tokens can be used in a single syndrome.
SYN_IMMUNE_CLASS
As above, but makes class immune.
SYN_IMMUNE_CREATURE
This token defines which creatures CANNOT be affected by the syndrome - useful for addressing specific instances within a population, such as a specific caste or an individual creature that falls under GENERAL_POISON. Syntax is [SYN_IMMUNE_CREATURE:creature:caste]. ALL can be used for the caste.
SYN_AFFECTED_CREATURE
As above, but makes creature or caste susceptible.
SYN_CLASS
This tag sets a class for the syndrome that can be used in [[Interaction token|interactions.]]

SYN_INJECTED, SYN_CONTACT, SYN_INHALED, SYN_INGESTED
This token determines the method of infection - injected syndromes must be injected via a creature attack, while contact syndromes result from any contamination of a creature by material splatter (such as blood), inhaled syndromes must be inhaled in gaseous form (such as from boiling or a creature breath attack), and ingestion syndromes must be eaten or drunk. Any combination of these tags can be used. A fun variation on the usual creature injection routine is to create a material with a SYN_CONTACT syndrome and have a creature use it for blood - this tends to end poorly for any predator that chooses to attack them.

[SPECIALATTACK_INJECT_EXTRACT:LOCAL_CREATURE_MAT:VENOM:LIQUID:100:100]
This is one method for getting a poison into a creature. If [ENTERS_BLOOD] is applied, it will be injected into the bloodstream. Otherwise, it will just splatter over the area. Put this on a creature attack. Substance type (gas, liquid, solid) does not appear to have an effect. The numbers on the end are minimum and maximum.

CE_X, or creature effect tokens, are the real meat and bones of your syndrome. They're detailed below.

==Creature effect tokens==
Each and every syndrome has a number of creature effect tokens, represented by CE_X - these lovely little beauties determine exactly how the poor creature suffering from the syndrome is affected. An example CE token is as follows:

[CE_NECROSIS:SEV:100:PROB:100:LOCALIZED:VASCULAR_ONLY:RESISTABLE:START:50:PEAK:1000:END:2000]

In this example, we have an effect that will always cause severe necrosis in whichever bodypart it touches, so long as that bodypart is vascular and that the creature is not able to resist it in some manner. The effect begins shortly after the syndrome is contracted, peaks 1000 [[time|time units]] afterwards, and finally ceases another 1000 time units later.

As a general rule of thumb, so long as CE_X starts the string and START/PEAK/END end it, the order of the intervening tokens isn't important.

*CE_X
The effect type. This can be a number of different tokens, as detailed in the table below this list.
*SEV:X
The severity of the effect. Higher values appear to be worse, with SEV:1000 CE_NECROSIS causing a part to near-instantly become rotten.
*PROB:X
The probability of the effect actually manifesting in the victim, as a percentage. 100 means always, 1 means a 1 in 100 chance.
*LOCALIZED (Overwrites BP tokens)
This tag causes an effect to ignore all BP tokens and then forces the game to attempt to apply the effect to the limb that came into contact with the contagion - i.e. the part that was bitten by the creature injecting the syndrome material, or the one that was splattered by a contact contagion. If an effect can not be applied to the contacted limb (such as IMPAIR_FUNCTION on a non-organ) then this token makes the syndrome have no effect. This token also makes inhaled syndromes have no effect.
*BP:BODY_PART:TISSUE (Overwritten by LOCALIZED)
Specifies which body parts and tissues are to be affected by the syndrome. BODY_PART can be BY_CATEGORY:x to target body parts with a matching [CATEGORY:x] [[body token]] (or ALL to affect everything), BY_TYPE:x to target body parts having a particular type (UPPERBODY, LOWERBODY, HEAD, GRASP, or STANCE), or BY_TOKEN:x to target individual body parts by their ID (as specified in the [BP] token). For example, if you wanted to target the lungs of a creature, you would use BP:BY_CATEGORY:LUNG:ALL. The syndrome would act on all bodyparts within the creature with the CATEGORY tag LUNG and affect all tissue layers. For another example, say you wanted to cause the skin to rot off a creature - you could use BP:BY_CATEGORY:ALL:SKIN, targeting the SKIN tissue on all bodyparts. Multiple targets can be given in one syndrome by placing the BP tokens end to end. This is one of the most powerful and useful aspects of the syndrome system, as it allows you to selectively target bodyparts relevant to the contagion, like lungs for coal dust inhalation, or the eyes for exposure to an acid gas. Not everything takes a target!
*VASCULAR_ONLY (Optional)
This syndrome only affects tissue layers with the VASCULAR token.
*MUSCULAR_ONLY (Optional)
This syndrome only affects tissue layers with the MUSCULAR token. Are you seeing a trend here?
*SIZE_DILUTES (Optional)
This token presumably causes the effects of the syndrome to scale with the size of the creature compared to the size of the dose of contagion they received, but has yet to be extensively tested.
*SIZE_DELAYS (Optional)
As above, this token has yet to be tested but presumably delays the onset of a syndrome according to the size of the victim.

The details of this table are still being thrashed out by modders, so if you have anything to add, please don't hesitate to hit the edit button!

Non-targeted syndromes will ignore any BP tokens and LOCALIZED tokens.
{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| CE_BLEEDING
| Yes
| Causes the targeted bodypart to start bleeding, with heavy enough bleeding resulting in the death of the sufferer. Some conditions seem to cause bleeding to be fatal no matter how weak.
|-
| CE_BLISTERS
| Yes
| Covers the targeted bodypart with blisters.
|-
| CE_BRUISING
| Yes
| Causes the targeted bodypart to undergo bruising.
|-
| CE_IMPAIR_FUNCTION
| Yes
| An organ afflicted with this CE is rendered inoperable - for example, if both lungs are impaired the creature can't breathe and will suffocate. This token only affects organs, not limbs.
|-
| CE_NECROSIS
| Yes
| Causes the targeted bodypart to rot, with associated tissue damage and miasma. Badly necrotic limbs will require amputation and heavy rot will eventually result in bleeding. Necrosis has some strange behavior involving bleeding to death that isn't fully understood; a 100% necrotic creature can survive fine with no non-yellow bodyparts but will die of bleeding as soon as they end a round of combat, even if they never take a hit. Because of this, fairly useless unless targeting the lungs or eyes.
|-
| CE_NUMBNESS
| Yes
| Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage.
|-
| CE_OOZING
| Yes
| Causes pus to ooze from the afflicted bodypart.
|-
| CE_PAIN
| Yes
| Afflicts the targeted bodypart with intense pain.
|-
| CE_PARALYSIS
| Yes
| Causes paralysis in the affected body part. Targeted causes sluggishness and significantly reduces speed. Untargeted paralysis is 'complete paralysis' and will cause suffocation in smaller creatures.
|-
| CE_SWELLING
| Yes
| Causes the targeted bodypart to swell up. Extreme swelling may lead to necrosis.
|-
| CE_COUGH_BLOOD
| No
| This effect results in the sufferer periodically coughing blood, which stains the tile they're on and requires cleanup. It doesn't appear to be lethal, but may cause minor bleeding damage.
|-
| CE_DIZZINESS
| No
| Inflicts the Dizziness condition, occasional fainting and a general slowdown in movement and work speed.
|-
| CE_DROWSINESS
| No
| Causes the Drowsiness condition.
|-
| CE_FEVER
| No
| Causes the Fever condition.
|-
| CE_NAUSEA
| No
| Causes the Nausea condition, and heavy vomiting. Can eventually lead to dehydration and death.
|-
| CE_UNCONSCIOUSNESS
| No
| Renders unconscious.
|-
| CE_VOMIT_BLOOD
| No
| This effect results in the sufferer periodically vomiting blood, which stains the tile they're on and requires cleanup. It doesn't appear to be lethal, but may cause minor bleeding damage.
|}

===Special Effects===
Several special syndrome effects take different arguments than the above. These are used for generated interactions in unmodded games, but may be used as well for any substance or custom interaction.

{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Arguments
! Description
|-
| CE_ADD_TAG
| tags
| Adds a tag to the affected creature. Many arguments can be used sequentially within one syndrome token. See the [[Interaction token]] '''IT_REQUIRES''' for valid tags.
|-
| CE_REMOVE_TAG
| tags
| Removes a tag from a creature. Supported arguments are the same as CE_ADD_TAG.
|-
| CE_DISPLAY_TILE
| TILE:tile number:colour
| The creature displays the specified tile and colour instead of its normal one.
|-
| CE_DISPLAY_NAME
| NAME:singular:plural:adjective
| Attaches a specified name to the creature's normal name.
|-
| CE_FLASH_TILE
| TILE:tile number:colour:FREQUENCY:?:?
| The creature flashes between its normal tile and the one specified here.
|-
| CE_PHYS_ATT_CHANGE
| [[Attribute]]:percentage:fixed boost(?)
| Alters the physical [[attribute]]s of a creature.
|-
| CE_MENT_ATT_CHANGE
| [[Attribute]]:percentage:fixed boost(?)
| Alters the mental [[attribute]]s of a creature.
|-
| CE_BODY_APPEARANCE_MODIFIER
|
|
|-
| CE_BP_APPEARANCE_MODIFIER
| body part:APPEARANCE_MODIFIER:attribute:number]
| Alters the characteristics (height, width etc.) of a body part.
|-
| CE_MATERIAL_FORCE_MULTIPLIER
|
|
|-
| CE_BODY_MAT_INTERACTION
|
| Causes one of the creature's materials to trigger an interaction, generally when ingested. Several additional tokens may be specified after this:
* CE:INTERACTION:interaction_id
* CE:SYNDROME_TAG:syndrome_trigger_type (SYN_INGESTED, SYN_INJECTED, etc.)
|-
| CE_SPEED_CHANGE
| speed modifier:number
| Changes the speed of a creature.
Speed modifier contains one or both:
* SPEED_PERC:percentage (this modifies a creature's in-game speed, so higher numbers are faster)
* SPEED_ADD:number (this modifies a creature's [SPEED:XX] token, so higher numbers are slower. Negative numbers are accepted though will only reduce a creature's speed to zero)
The minimum and maximum speeds able to be created by CE_SPEED_CHANGE are 99 and 10,000 respectively.
|-
| CE_CAN_DO_INTERACTION
|
| Makes the creature able to perform an interaction. See [[Interaction token]]. To specify the interaction, use the argument:
* CDI:INTERACTION:interaction name
|-
| CE_BODY_TRANSFORMATION
| PROB:percentage:START:time:END:time
| Transforms into another creature. PROB and END arguments optional. The target creature is specified with:
* CE:CREATURE:creature name:caste name 
Note that any wounds the creature has suffered will instantly heal upon transforming, both into and out of the target form. [[Undead]] limbs of a creature with this token will grow into a full instance of that creature.
|-
| CE_SKILL_ROLL_ADJUST
| PERC:percentage:PERC_ON:percentage:
| Alters the skill level of a creature. The argument PERC specifies a percentage of the creature's current skill, and PERC_ON the probability of the effect being applied.
|}

'''All''' creature effect tokens take START, END and PROB numbers, and can be followed by [CE:PERIODIC] and/or [CE:COUNTER_TRIGGER] to restrict when they actually take effect.
* PERIODIC:period_type:min_value:max_value
* COUNTER_TRIGGER:counter_name:min_value:max_value:REQUIRED

Currently, the only valid period type is MOON_PHASE. Valid counter values are below:

{| {{prettytable}}
|- bgcolor="Bisque"
! Counter
! Description
|-
| ALCOHOLIC
| How long it's been (in [[time]] units) since the creature last had a drink of alcohol. Only present on creatures who need alcohol to get through the working day.
* 100800 (3 months) = and is starting to work slowly due to its scarcity
* 201600 (6 months) = and really wants a drink
* 302400 (9 months) = and has gone without a drink for far, far too long
* 403200 (1 year) = and can't even remember the last time he/she had some
|-
| MOUNTAIN
| How much the creature minds being outdoors.
* 0 = likes working outdoors and grumbles only mildly at inclement weather.
* 1 = does not mind being outdoors, at least for a time.
* 2 = (no message)
|-
| TIME_SINCE_BREAK
| How long it's been (in [[time]] units) since the creature last went on [[break]]. Creatures generally go at least a year (100800 time units) between breaks unless the [[economy]] is active (which never happens).
|-
| COMBATHARDNESS
| How much the creature has witnessed death and suffered tragedy. Higher values are known to decrease the severity of certain unhappy [[thought]]s.
* 0-32 = (no message)
* 33-66 = is getting used to tragedy
* 67-99 = is a hardened individual
* 100 = doesn't really care about anything anymore
|-
| ON_BREAK
| How long (in [[time]] units) the creature has been on break. Once it reaches 15000 (about 12.5 days), the creature should get back to work.
|-
| CAVE_ADAPT
| How cave-adapted the creature is. Increases by 1 for every [[time]] unit spent underground, to a maximum of 800000.
* 403200 (1 year) = going outside causes irritation
* 604800 (1.5 years) = going outside causes nausea
|-
| PARTIED_OUT
| How long it's been since the creature has been attending a [[party]] (or how long before it gets bored and goes back to work).{{verify}}
|-
| MILK_COUNTER
| How long it's been since the creature has been milked (or how long before it can be milked again).{{verify}}
|-
| EGG_SPENT
| How long it's been since the creature laid eggs (or how long before it can do so again).{{verify}}
|-
| GROUNDED_ANIMAL_ANGER
| How angry (and likely to attack) an animal is from being over-crowded.
|-
| TIME_SINCE_SUCKED_BLOOD
| How long it's been (in [[time]] units) since the creature last sucked somebody's blood.
|-
| DRINKING_BLOOD
| How long the creature has been drinking somebody's blood (or how much longer before it's done).{{verify}}
|}

==Inorganic syndromes and you!==
It's perfectly possible - and quite simple - to add a nasty syndrome to a type of rock or metal - you simply add the syndrome tokens to the material definition in the same manner that you would add them to a creature material definition. The only catch is that since your hapless dwarves will only normally encounter the material in metal, gem or boulder form, a bit of creativity must be used to actually get them inside your citizens - that is, you need to make them 'explosively boil' as soon as they're mined or produced. This has the sad side effect of destroying the actual item - sorry, no highly radioactive uranium this release.

The easiest way to accomplish this is to assign the material a low boiling point, usually just under room temperature, and make sure its temperature is fixed to a point above it.
[MAT_FIXED_TEMP:9001]
[BOILING_POINT:9000]
Now, as soon as this substance hits the open air - by being mined, smelted or reaction-produced at a custom workshop - it will EXPLOSIVELY BOIL, flooding a small area with delicious syndrome-rich gas. Creatures who inhale the gas will be immediately hit with the syndrome you thoughtfully attached to the material definition earlier!

There are a number of other tokens you can use to control the colour and naming conventions of your syndrome material, referred to as MATERIAL tokens.

==Breath attacks==
Breath attacks are controlled by the MATERIAL_EMISSION interaction, like so:

[CAN_DO_INTERACTION:MATERIAL_EMISSION]
[CDI:ADV_NAME:Breath custom material]
[CDI:USAGE_HINT:ATTACK]
[CDI:BP_REQUIRED:BY_CATEGORY:MOUTH]
[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]
[CDI:TARGET:C:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:C:15]
[CDI:MAX_TARGET_NUMBER:C:1]
[CDI:WAIT_PERIOD:50]

The most important part is this line:

[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]

The CDI refers to CAN_DO_INTERACTION; the MATERIAL states that this line shows what the material is. LOCAL_CREATURE_MAT:CUSTOMMATERIAL is your material, and TRAILING_VAPOR_FLOW refers to the breath attack type. Other types are seen below. Also important is this line:

[CDI:TARGET:C:LINE_OF_SIGHT]

LINE_OF_SIGHT refers to where the target C may be; others include SELF_ALLOWED (presumably like LINE_OF_SIGHT, but with the creature allowed to target itself), SELF_ONLY (preferable for undirected attacks and TOUCHABLE (for up-close attacks, as trailing flows tend to be).

===Breath Attack Types===

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Description
|-
| TRAILING_DUST_FLOW
| Lets out a cloud of solid dust. Appears to use cave-in dust physics, causing this to fling around anything it comes in contact with, making it capable of smashing creatures into the ground and flinging them over walls. Creature will attack as normal.
|-
| TRAILING_VAPOR_FLOW
| Similar to the trailing gas, but easier to breathe in, and condensed, so it will collect on creatures. Creature will attack as normal.
|-
| TRAILING_GAS_FLOW
| Shoots a trail of gas substance at the creature. Fairly easy to dodge. Creature will attack as normal.
|-
| SOLID_GLOB
| Shoots a solid glob of spinning substance at the creature, leaving symbols similar to broken arrows. Essentially a projectile weapon. Some creatures with this breath attack will not move, preferring instead to stay and shoot globs at you, even when you are literally right next to them.
|-
| LIQUID_GLOB
| Shoots a '''solid''' glob of spinning substance at the creature. Essentially the same as SOLID_GLOB. May do less damage.
|-
| SPATTER_POWDER
|
|-
| SPATTER_LIQUID
|
|-
| UNDIRECTED_GAS
| Creature occasionally releases a cloud of substance. Similar to TRAILING_GAS_FLOW, but undirected, thus affecting a larger area but losing the distance. Creature will attack as normal.
|-
| UNDIRECTED_VAPOR
| Creature occasionally releases a cloud of substance. Similar to TRAILING_VAPOR_FLOW, but undirected, thus affecting a larger area but losing the distance. Creature will attack as normal.
|-
| UNDIRECTED_DUST
| Creature occasionally releases a large cloud of substance, which will spread and dissipate. Similar to TRAILING_DUST_FLOW, but undirected, thus affecting a larger area but losing the distance - range is roughly the same as that of a cave-in. Creature will attack as normal. <s>DO NOT USE THIS TAG UNLESS YOU WANT TO KILL THE CREATURE AND EVERYTHING NEAR IT AND SEND PEOPLE FLYING.</s> You know you want to.
|-
| WEB_SPRAY
| Emits a burst of [[web]]s that entangle target creatures.
|-
| DRAGONFIRE
| Emits a wide cone of [[fire]] that burns target creatures. For this you want FLOW instead of a material.
|-
| FIREJET
| Emits a narrow cone of [[fire]] that burns target creatures. For this you want FLOW instead of a material.
|-
| FIREBALL
| Emits a fireball that burns the target creature. For this you want FLOW instead of a material.
|-
| WEATHER_CREEPING_GAS
| Creates a slowly expanding cloud of gas, similar to miasma.
|-
| WEATHER_CREEPING_VAPOR
| Creates a slowly expanding cloud of vapor.
|-
| WEATHER_CREEPING_DUST
| Creates a slowly expanding cloud of dust.
|-
| WEATHER_FALLING_MATERIAL
| Causes it to start raining a particular material.
|}

Keep in mind that you can use multiple breath attacks, which appears to make the creature choose between them at random.

{{Category|Modding}}
[[ru:DF2012:Syndrome]]

v0.34:Syndrome

2012-08-01T18:22:31Z

Bobleb01: /* List of syndromes */

{{quality|Masterwork|21:09, 26 April 2011 (UTC)}}{{av}}

A '''syndrome''' is a disease or effect that a poor hapless creature might get through encountering certain creatures, extracts or vindictive modders. They generally cause unpleasant and frequently fatal [[symptoms]] over a short to long period of time, but some will clear up over time or with the assistance of a [[doctor]]. A [[Health care|Hospital]] is required to diagnose and potentially treat the syndrome. [[File:Snakebite.png|200px|thumb|right|An example of a syndrome in effect. This hippo did not ultimately survive the encounter despite one bite being the only injury sustained.]]

==List of syndromes==
{| {{prettytable}}
|- bgcolor="#dddddd"
! Syndrome
! Venom
! Acquired
! Short-term Symptoms
! Long-term Symptoms
! Chronic Symptoms
|-
| Adder bite
| adder venom (injected)
| Being bitten by an [[adder]], [[giant adder]] or [[adder man]]
| Strong pain
| Swelling Blisters Nausea
|
|-
| Alcohol poisoning (Could someone confirm this?)
| Lots of alcohol (ingested)
| Consumption of alcohol
| Nausea Dizziness Minor paralysis Vomiting Fever (rare)
| suffocation (rare)
| Motor nerve damage Kidney damage (if serious) Death (unlikely, but killed one of my dwarfs.)
|-
| Bark scorpion sting
| bark scorpion venom (injected)
| Being stung by a [[bark scorpion]], [[giant bark scorpion]] or [[bark scorpion man]]
| Strong pain
| none
| none
|-
| Black mamba bite
| black mamba venom (injected)
| Being bitten by a [[black mamba]], [[giant black mamba]] or [[black mamba man]]
| Dizziness Drowsiness Strong pain Fever Unconsciousness Complete paralysis1
|
|
|-
| Blob blisters
| cave blob fluid (contact or ingested)
| Touching a [[cave blob]]
| Mild pain Mild blisters
| None
| None
|-
| Brown recluse spider bite
| brown recluse spider venom (injected)
| Being bitten by a [[brown recluse spider]], [[giant brown recluse spider]] or [[brown recluse spider man]]
| Nausea Fever Pain 
| Severe localized necrosis
|
|-
| Bumblebee sting
| bumblebee venom (injected)
| Being stung by a [[bumblebee]] worker
| Pain Strong swelling
|
|
|-
| Bushmaster bite
| bushmaster venom (injected)
| Being bitten by a [[bushmaster]], [[giant bushmaster]] or [[bushmaster man]]
| Strong pain Mild bleeding Dizziness Nausea Unconsciousness Complete paralysis1
|
|
|-
| Cave floater sickness
| cave floater gas (inhaled or ingested)
| Expelled from [[cave floater]]
| Mild nausea
| Fever Strong drowsiness (delayed) Strong dizziness (delayed)
| None
|-
| Cave spider bite
| cave spider venom (injected)
| Being bitten by a [[cave spider]]
| None
| None
| Very mild dizziness
|-
| Copperhead snake bite
| copperhead snake venom (injected)
| Being bitten by a [[copperhead snake]], [[giant copperhead snake]] or [[copperhead snake man]]
| Pain Swelling Nausea
|
|
|-
| Giant cave spider bite
| giant cave spider venom (injected)
| Being bitten by a [[giant cave spider]]
| Complete paralysis1 '''Being eaten by the GCS'''
| None, not that it really matters.
| None
|-
| Gila monster bite
| gila monster venom (injected)
| Being bitten by a [[gila monster]], [[giant gila monster]] or [[gila monster man]]
| Pain Mild swelling
|
|
|-
| Gnomeblight
| [[gnomeblight]] (contact, inhaled, injected, or ingested)
| Unknown. Affects gnomes only
| None
| Severe systemic necrosis2
| None
|-
| Giant desert scorpion sting
| giant desert scorpion (injected)
| Being stung by a [[giant desert scorpion]]
|
| Necrosis of the brain and nervous system2
| '''Unavoidable death'''
|-
| Helmet snake bite
| helmet snake venom (injected)
| Being bitten by a [[helmet snake]]
| Minor bleeding
| Fever Nausea Dizziness Localized swelling Localized oozing Localized bruising Strong pain Intense localized necrosis Possible loss of limb
| None
|-
| Honey bee sting
| honey bee venom (injected)
| Being stung by a [[honey bee]] worker
| Pain Strong swelling
|
|
|-
| Iron man cough
| iron man gas (inhaled)
| Expelled by [[iron man]]
| Coughing blood
| None
| None
|-
| King cobra bite
| king cobra venom (injected)
| Being bitten by a [[king cobra]]
| Complete paralysis1 Pain, dizziness, drowsiness
| None
| None
|-
| Phantom spider bite
| phantom spider venom (injected)
| Being bitten by a [[phantom spider]]
| None
| Numbness and mild dizziness
| None
|-
| Platypus sting
| platypus venom (injected)
| Being kicked by a [[platypus]], [[giant platypus]] or [[platypus man]]
| Pain and swelling
| Extreme pain, swelling possibly to the point of necrosis
| None
|-
| Rattlesnake bite
| rattlesnake venom (injected)
| Being bitten by a [[rattlesnake]], [[giant rattlesnake]] or [[rattlesnake man]]
| Pain, nausea, blisters, swelling, bruising
| Severe localized necrosis
| None
|-
| Serpent man bite
| serpent man venom (injected)
| Being bitten by a [[serpent man]]
| Complete paralysis1
| None
| None
|-
| [evil rain] sickness3
| random
| Being caught outside in freakish weather in an evil biome
| random
| random
| random
|-
| [evil cloud] sickness4
| random
| Being caught in a creeping cloud in an evil biome
| random
| random
| random
|-
| beast sickness5
| random
| Encounters with [[forgotten beast]]s
| random
| random
| random
|-
| titan sickness5
| random
| Encounters with [[titan]]s
| random
| random
| random
|-
| demon sickness5
| random
| Encounters with [[demon]]s
| random
| random
| random
|}
:1. For small creatures such as humans and dwarves, paralysis tends to result in suffocation.
:2. Necrosis of the brain will eventually result in death once the brain rots away completely.
:3. Evil rain typically only causes minor symptoms such as blisters, bruising, coughing blood, dizziness, fever, nausea, oozing, and pain.
:4. Evil clouds either cause major symptoms (as with beast/titan/demon sicknesses) or permanently transform creatures into [[Undead|zombie-like]] forms.
:5. [[Titan]]s, [[forgotten beast]]s, and [[demon]]s have a chance to have a randomized syndrome. These range from pointless (mild blisters from inhaling boiling blood) to instantly deadly (Severe necrosis from a contact poison attached to a breath weapon/creature made of blood.

==The anatomy of a syndrome==
Mechanically, syndromes are bundles of tokens attached to a material - they're confined to creature materials in vanilla DF, but it's a simple matter to add them to inorganic materials. When the material is injected, touched, inhaled, or ingested (depending on the syndrome), the creature suffers the predations of a nasty disease or poison. Here's an example syndrome, taken from the Giant Cave Spider raws.

If you are having troubles getting the syndromes to work (ie, in combat reports, getting "'''supersnake''' n/a splatters~etc"), then simply throw the venom template into the actual creature's raw, which is what the LOCAL_CREATURE_MAT actually calls on; the venom being in the same file.

[USE_MATERIAL_TEMPLATE:POISON:CREATURE_EXTRACT_TEMPLATE]
[STATE_NAME:ALL_SOLID:frozen giant cave spider venom]
[STATE_ADJ:ALL_SOLID:frozen giant cave spider venom]
[STATE_NAME:LIQUID:giant cave spider venom]
[STATE_ADJ:LIQUID:giant cave spider venom]
[STATE_NAME:GAS:boiling giant cave spider venom]
[STATE_ADJ:GAS:boiling giant cave spider venom]
[PREFIX:NONE]
[ENTERS_BLOOD]
[SYNDROME]
[SYN_NAME:giant cave spider bite]
[SYN_AFFECTED_CLASS:GENERAL_POISON]
[SYN_IMMUNE_CREATURE:SPIDER_CAVE:ALL]
[SYN_INJECTED]
[CE_PARALYSIS:SEV:100:PROB:100:RESISTABLE:SIZE_DILUTES:START:5:PEAK:10:END:20]

The first line, USE_MATERIAL_TEMPLATE, is creating a new material, called POISON, using the CREATURE_EXTRACT_TEMPLATE as the basis. After this, the STATE_NAME and STATE_ADJ tokens are used to define the names and adjectives assigned to different states of the material - GAS, LIQUID and ALL_SOLID, in this case, though ALL is also a valid token. At this stage, you can use any material tags like MAT_FIXED_TEMP or similar to set further material properties, though this usually isn't necessary.

ENTERS_BLOOD
This tag determines whether a poison enters the blood or not. If it is not included, the poison will splatter (if liquid) or flow (if gas) over the affected body part instead when injected. If you're using a contact poison, leave this out. Necessary for injected poisons.
SYNDROME
This tag ends the material details and begins the definition of the actual syndrome.
SYN_NAME
This one is self-explanatory - the name of the syndrome as it will appear in-game.
SYN_AFFECTED_CLASS
This token defines what CREATURE_CLASS will be affected by the syndrome. Most creatures are classed under GENERAL_POISON. Multiple tokens can be used in a single syndrome.
SYN_IMMUNE_CLASS
As above, but makes class immune.
SYN_IMMUNE_CREATURE
This token defines which creatures CANNOT be affected by the syndrome - useful for addressing specific instances within a population, such as a specific caste or an individual creature that falls under GENERAL_POISON. Syntax is [SYN_IMMUNE_CREATURE:creature:caste]. ALL can be used for the caste.
SYN_AFFECTED_CREATURE
As above, but makes creature or caste susceptible.
SYN_CLASS
This tag sets a class for the syndrome that can be used in [[Interaction token|interactions.]]

SYN_INJECTED, SYN_CONTACT, SYN_INHALED, SYN_INGESTED
This token determines the method of infection - injected syndromes must be injected via a creature attack, while contact syndromes result from any contamination of a creature by material splatter (such as blood), inhaled syndromes must be inhaled in gaseous form (such as from boiling or a creature breath attack), and ingestion syndromes must be eaten or drunk. Any combination of these tags can be used. A fun variation on the usual creature injection routine is to create a material with a SYN_CONTACT syndrome and have a creature use it for blood - this tends to end poorly for any predator that chooses to attack them.

[SPECIALATTACK_INJECT_EXTRACT:LOCAL_CREATURE_MAT:VENOM:LIQUID:100:100]
This is one method for getting a poison into a creature. If [ENTERS_BLOOD] is applied, it will be injected into the bloodstream. Otherwise, it will just splatter over the area. Put this on a creature attack. Substance type (gas, liquid, solid) does not appear to have an effect. The numbers on the end are minimum and maximum.

CE_X, or creature effect tokens, are the real meat and bones of your syndrome. They're detailed below.

==Creature effect tokens==
Each and every syndrome has a number of creature effect tokens, represented by CE_X - these lovely little beauties determine exactly how the poor creature suffering from the syndrome is affected. An example CE token is as follows:

[CE_NECROSIS:SEV:100:PROB:100:LOCALIZED:VASCULAR_ONLY:RESISTABLE:START:50:PEAK:1000:END:2000]

In this example, we have an effect that will always cause severe necrosis in whichever bodypart it touches, so long as that bodypart is vascular and that the creature is not able to resist it in some manner. The effect begins shortly after the syndrome is contracted, peaks 1000 [[time|time units]] afterwards, and finally ceases another 1000 time units later.

As a general rule of thumb, so long as CE_X starts the string and START/PEAK/END end it, the order of the intervening tokens isn't important.

*CE_X
The effect type. This can be a number of different tokens, as detailed in the table below this list.
*SEV:X
The severity of the effect. Higher values appear to be worse, with SEV:1000 CE_NECROSIS causing a part to near-instantly become rotten.
*PROB:X
The probability of the effect actually manifesting in the victim, as a percentage. 100 means always, 1 means a 1 in 100 chance.
*LOCALIZED (Overwrites BP tokens)
This tag causes an effect to ignore all BP tokens and then forces the game to attempt to apply the effect to the limb that came into contact with the contagion - i.e. the part that was bitten by the creature injecting the syndrome material, or the one that was splattered by a contact contagion. If an effect can not be applied to the contacted limb (such as IMPAIR_FUNCTION on a non-organ) then this token makes the syndrome have no effect. This token also makes inhaled syndromes have no effect.
*BP:BODY_PART:TISSUE (Overwritten by LOCALIZED)
Specifies which body parts and tissues are to be affected by the syndrome. BODY_PART can be BY_CATEGORY:x to target body parts with a matching [CATEGORY:x] [[body token]] (or ALL to affect everything), BY_TYPE:x to target body parts having a particular type (UPPERBODY, LOWERBODY, HEAD, GRASP, or STANCE), or BY_TOKEN:x to target individual body parts by their ID (as specified in the [BP] token). For example, if you wanted to target the lungs of a creature, you would use BP:BY_CATEGORY:LUNG:ALL. The syndrome would act on all bodyparts within the creature with the CATEGORY tag LUNG and affect all tissue layers. For another example, say you wanted to cause the skin to rot off a creature - you could use BP:BY_CATEGORY:ALL:SKIN, targeting the SKIN tissue on all bodyparts. Multiple targets can be given in one syndrome by placing the BP tokens end to end. This is one of the most powerful and useful aspects of the syndrome system, as it allows you to selectively target bodyparts relevant to the contagion, like lungs for coal dust inhalation, or the eyes for exposure to an acid gas. Not everything takes a target!
*VASCULAR_ONLY (Optional)
This syndrome only affects tissue layers with the VASCULAR token.
*MUSCULAR_ONLY (Optional)
This syndrome only affects tissue layers with the MUSCULAR token. Are you seeing a trend here?
*SIZE_DILUTES (Optional)
This token presumably causes the effects of the syndrome to scale with the size of the creature compared to the size of the dose of contagion they received, but has yet to be extensively tested.
*SIZE_DELAYS (Optional)
As above, this token has yet to be tested but presumably delays the onset of a syndrome according to the size of the victim.

The details of this table are still being thrashed out by modders, so if you have anything to add, please don't hesitate to hit the edit button!

Non-targeted syndromes will ignore any BP tokens and LOCALIZED tokens.
{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Accepts Target
! Description
|-
| CE_BLEEDING
| Yes
| Causes the targeted bodypart to start bleeding, with heavy enough bleeding resulting in the death of the sufferer. Some conditions seem to cause bleeding to be fatal no matter how weak.
|-
| CE_BLISTERS
| Yes
| Covers the targeted bodypart with blisters.
|-
| CE_BRUISING
| Yes
| Causes the targeted bodypart to undergo bruising.
|-
| CE_IMPAIR_FUNCTION
| Yes
| An organ afflicted with this CE is rendered inoperable - for example, if both lungs are impaired the creature can't breathe and will suffocate. This token only affects organs, not limbs.
|-
| CE_NECROSIS
| Yes
| Causes the targeted bodypart to rot, with associated tissue damage and miasma. Badly necrotic limbs will require amputation and heavy rot will eventually result in bleeding. Necrosis has some strange behavior involving bleeding to death that isn't fully understood; a 100% necrotic creature can survive fine with no non-yellow bodyparts but will die of bleeding as soon as they end a round of combat, even if they never take a hit. Because of this, fairly useless unless targeting the lungs or eyes.
|-
| CE_NUMBNESS
| Yes
| Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage.
|-
| CE_OOZING
| Yes
| Causes pus to ooze from the afflicted bodypart.
|-
| CE_PAIN
| Yes
| Afflicts the targeted bodypart with intense pain.
|-
| CE_PARALYSIS
| Yes
| Causes paralysis in the affected body part. Targeted causes sluggishness and significantly reduces speed. Untargeted paralysis is 'complete paralysis' and will cause suffocation in smaller creatures.
|-
| CE_SWELLING
| Yes
| Causes the targeted bodypart to swell up. Extreme swelling may lead to necrosis.
|-
| CE_COUGH_BLOOD
| No
| This effect results in the sufferer periodically coughing blood, which stains the tile they're on and requires cleanup. It doesn't appear to be lethal, but may cause minor bleeding damage.
|-
| CE_DIZZINESS
| No
| Inflicts the Dizziness condition, occasional fainting and a general slowdown in movement and work speed.
|-
| CE_DROWSINESS
| No
| Causes the Drowsiness condition.
|-
| CE_FEVER
| No
| Causes the Fever condition.
|-
| CE_NAUSEA
| No
| Causes the Nausea condition, and heavy vomiting. Can eventually lead to dehydration and death.
|-
| CE_UNCONSCIOUSNESS
| No
| Renders unconscious.
|-
| CE_VOMIT_BLOOD
| No
| This effect results in the sufferer periodically vomiting blood, which stains the tile they're on and requires cleanup. It doesn't appear to be lethal, but may cause minor bleeding damage.
|}

===Special Effects===
Several special syndrome effects take different arguments than the above. These are used for generated interactions in unmodded games, but may be used as well for any substance or custom interaction.

{| {{prettytable}}
|- bgcolor="Bisque"
! Token
! Arguments
! Description
|-
| CE_ADD_TAG
| tags
| Adds a tag to the affected creature. Many arguments can be used sequentially within one syndrome token. See the [[Interaction token]] '''IT_REQUIRES''' for valid tags.
|-
| CE_REMOVE_TAG
| tags
| Removes a tag from a creature. Supported arguments are the same as CE_ADD_TAG.
|-
| CE_DISPLAY_TILE
| TILE:tile number:colour
| The creature displays the specified tile and colour instead of its normal one.
|-
| CE_DISPLAY_NAME
| NAME:singular:plural:adjective
| Attaches a specified name to the creature's normal name.
|-
| CE_FLASH_TILE
| TILE:tile number:colour:FREQUENCY:?:?
| The creature flashes between its normal tile and the one specified here.
|-
| CE_PHYS_ATT_CHANGE
| [[Attribute]]:percentage:fixed boost(?)
| Alters the physical [[attribute]]s of a creature.
|-
| CE_MENT_ATT_CHANGE
| [[Attribute]]:percentage:fixed boost(?)
| Alters the mental [[attribute]]s of a creature.
|-
| CE_BODY_APPEARANCE_MODIFIER
|
|
|-
| CE_BP_APPEARANCE_MODIFIER
| body part:APPEARANCE_MODIFIER:attribute:number]
| Alters the characteristics (height, width etc.) of a body part.
|-
| CE_MATERIAL_FORCE_MULTIPLIER
|
|
|-
| CE_BODY_MAT_INTERACTION
|
| Causes one of the creature's materials to trigger an interaction, generally when ingested. Several additional tokens may be specified after this:
* CE:INTERACTION:interaction_id
* CE:SYNDROME_TAG:syndrome_trigger_type (SYN_INGESTED, SYN_INJECTED, etc.)
|-
| CE_SPEED_CHANGE
| speed modifier:number
| Changes the speed of a creature.
Speed modifier contains one or both:
* SPEED_PERC:percentage (this modifies a creature's in-game speed, so higher numbers are faster)
* SPEED_ADD:number (this modifies a creature's [SPEED:XX] token, so higher numbers are slower. Negative numbers are accepted though will only reduce a creature's speed to zero)
The minimum and maximum speeds able to be created by CE_SPEED_CHANGE are 99 and 10,000 respectively.
|-
| CE_CAN_DO_INTERACTION
|
| Makes the creature able to perform an interaction. See [[Interaction token]]. To specify the interaction, use the argument:
* CDI:INTERACTION:interaction name
|-
| CE_BODY_TRANSFORMATION
| PROB:percentage:START:time:END:time
| Transforms into another creature. PROB and END arguments optional. The target creature is specified with:
* CE:CREATURE:creature name:caste name 
Note that any wounds the creature has suffered will instantly heal upon transforming, both into and out of the target form. [[Undead]] limbs of a creature with this token will grow into a full instance of that creature.
|-
| CE_SKILL_ROLL_ADJUST
| PERC:percentage:PERC_ON:percentage:
| Alters the skill level of a creature. The argument PERC specifies a percentage of the creature's current skill, and PERC_ON the probability of the effect being applied.
|}

'''All''' creature effect tokens take START, END and PROB numbers, and can be followed by [CE:PERIODIC] and/or [CE:COUNTER_TRIGGER] to restrict when they actually take effect.
* PERIODIC:period_type:min_value:max_value
* COUNTER_TRIGGER:counter_name:min_value:max_value:REQUIRED

Currently, the only valid period type is MOON_PHASE. Valid counter values are below:

{| {{prettytable}}
|- bgcolor="Bisque"
! Counter
! Description
|-
| ALCOHOLIC
| How long it's been (in [[time]] units) since the creature last had a drink of alcohol. Only present on creatures who need alcohol to get through the working day.
* 100800 (3 months) = and is starting to work slowly due to its scarcity
* 201600 (6 months) = and really wants a drink
* 302400 (9 months) = and has gone without a drink for far, far too long
* 403200 (1 year) = and can't even remember the last time he/she had some
|-
| MOUNTAIN
| How much the creature minds being outdoors.
* 0 = likes working outdoors and grumbles only mildly at inclement weather.
* 1 = does not mind being outdoors, at least for a time.
* 2 = (no message)
|-
| TIME_SINCE_BREAK
| How long it's been (in [[time]] units) since the creature last went on [[break]]. Creatures generally go at least a year (100800 time units) between breaks unless the [[economy]] is active (which never happens).
|-
| COMBATHARDNESS
| How much the creature has witnessed death and suffered tragedy. Higher values are known to decrease the severity of certain unhappy [[thought]]s.
* 0-32 = (no message)
* 33-66 = is getting used to tragedy
* 67-99 = is a hardened individual
* 100 = doesn't really care about anything anymore
|-
| ON_BREAK
| How long (in [[time]] units) the creature has been on break. Once it reaches 15000 (about 12.5 days), the creature should get back to work.
|-
| CAVE_ADAPT
| How cave-adapted the creature is. Increases by 1 for every [[time]] unit spent underground, to a maximum of 800000.
* 403200 (1 year) = going outside causes irritation
* 604800 (1.5 years) = going outside causes nausea
|-
| PARTIED_OUT
| How long it's been since the creature has been attending a [[party]] (or how long before it gets bored and goes back to work).{{verify}}
|-
| MILK_COUNTER
| How long it's been since the creature has been milked (or how long before it can be milked again).{{verify}}
|-
| EGG_SPENT
| How long it's been since the creature laid eggs (or how long before it can do so again).{{verify}}
|-
| GROUNDED_ANIMAL_ANGER
| How angry (and likely to attack) an animal is from being over-crowded.
|-
| TIME_SINCE_SUCKED_BLOOD
| How long it's been (in [[time]] units) since the creature last sucked somebody's blood.
|-
| DRINKING_BLOOD
| How long the creature has been drinking somebody's blood (or how much longer before it's done).{{verify}}
|}

==Inorganic syndromes and you!==
It's perfectly possible - and quite simple - to add a nasty syndrome to a type of rock or metal - you simply add the syndrome tokens to the material definition in the same manner that you would add them to a creature material definition. The only catch is that since your hapless dwarves will only normally encounter the material in metal, gem or boulder form, a bit of creativity must be used to actually get them inside your citizens - that is, you need to make them 'explosively boil' as soon as they're mined or produced. This has the sad side effect of destroying the actual item - sorry, no highly radioactive uranium this release.

The easiest way to accomplish this is to assign the material a low boiling point, usually just under room temperature, and make sure its temperature is fixed to a point above it.
[MAT_FIXED_TEMP:9001]
[BOILING_POINT:9000]
Now, as soon as this substance hits the open air - by being mined, smelted or reaction-produced at a custom workshop - it will EXPLOSIVELY BOIL, flooding a small area with delicious syndrome-rich gas. Creatures who inhale the gas will be immediately hit with the syndrome you thoughtfully attached to the material definition earlier!

There are a number of other tokens you can use to control the colour and naming conventions of your syndrome material, referred to as MATERIAL tokens.

==Breath attacks==
Breath attacks are controlled by the MATERIAL_EMISSION interaction, like so:

[CAN_DO_INTERACTION:MATERIAL_EMISSION]
[CDI:ADV_NAME:Breath custom material]
[CDI:USAGE_HINT:ATTACK]
[CDI:BP_REQUIRED:BY_CATEGORY:MOUTH]
[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]
[CDI:TARGET:C:LINE_OF_SIGHT]
[CDI:TARGET_RANGE:C:15]
[CDI:MAX_TARGET_NUMBER:C:1]
[CDI:WAIT_PERIOD:50]

The most important part is this line:

[CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]

The CDI refers to CAN_DO_INTERACTION; the MATERIAL states that this line shows what the material is. LOCAL_CREATURE_MAT:CUSTOMMATERIAL is your material, and TRAILING_VAPOR_FLOW refers to the breath attack type. Other types are seen below. Also important is this line:

[CDI:TARGET:C:LINE_OF_SIGHT]

LINE_OF_SIGHT refers to where the target C may be; others include SELF_ALLOWED (presumably like LINE_OF_SIGHT, but with the creature allowed to target itself), SELF_ONLY (preferable for undirected attacks and TOUCHABLE (for up-close attacks, as trailing flows tend to be).

===Breath Attack Types===

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Description
|-
| TRAILING_DUST_FLOW
| Lets out a cloud of solid dust. Appears to use cave-in dust physics, causing this to fling around anything it comes in contact with, making it capable of smashing creatures into the ground and flinging them over walls. Creature will attack as normal.
|-
| TRAILING_VAPOR_FLOW
| Similar to the trailing gas, but easier to breathe in, and condensed, so it will collect on creatures. Creature will attack as normal.
|-
| TRAILING_GAS_FLOW
| Shoots a trail of gas substance at the creature. Fairly easy to dodge. Creature will attack as normal.
|-
| SOLID_GLOB
| Shoots a solid glob of spinning substance at the creature, leaving symbols similar to broken arrows. Essentially a projectile weapon. Some creatures with this breath attack will not move, preferring instead to stay and shoot globs at you, even when you are literally right next to them.
|-
| LIQUID_GLOB
| Shoots a '''solid''' glob of spinning substance at the creature. Essentially the same as SOLID_GLOB. May do less damage.
|-
| SPATTER_POWDER
|
|-
| SPATTER_LIQUID
|
|-
| UNDIRECTED_GAS
| Creature occasionally releases a cloud of substance. Similar to TRAILING_GAS_FLOW, but undirected, thus affecting a larger area but losing the distance. Creature will attack as normal.
|-
| UNDIRECTED_VAPOR
| Creature occasionally releases a cloud of substance. Similar to TRAILING_VAPOR_FLOW, but undirected, thus affecting a larger area but losing the distance. Creature will attack as normal.
|-
| UNDIRECTED_DUST
| Creature occasionally releases a large cloud of substance, which will spread and dissipate. Similar to TRAILING_DUST_FLOW, but undirected, thus affecting a larger area but losing the distance - range is roughly the same as that of a cave-in. Creature will attack as normal. <s>DO NOT USE THIS TAG UNLESS YOU WANT TO KILL THE CREATURE AND EVERYTHING NEAR IT AND SEND PEOPLE FLYING.</s> You know you want to.
|-
| WEB_SPRAY
| Emits a burst of [[web]]s that entangle target creatures.
|-
| DRAGONFIRE
| Emits a wide cone of [[fire]] that burns target creatures. For this you want FLOW instead of a material.
|-
| FIREJET
| Emits a narrow cone of [[fire]] that burns target creatures. For this you want FLOW instead of a material.
|-
| FIREBALL
| Emits a fireball that burns the target creature. For this you want FLOW instead of a material.
|-
| WEATHER_CREEPING_GAS
| Creates a slowly expanding cloud of gas, similar to miasma.
|-
| WEATHER_CREEPING_VAPOR
| Creates a slowly expanding cloud of vapor.
|-
| WEATHER_CREEPING_DUST
| Creates a slowly expanding cloud of dust.
|-
| WEATHER_FALLING_MATERIAL
| Causes it to start raining a particular material.
|}

Keep in mind that you can use multiple breath attacks, which appears to make the creature choose between them at random.

{{Category|Modding}}
[[ru:DF2012:Syndrome]]