v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "Syndrome"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(I think this might be part of the code and not a placeholder name)
 
(179 intermediate revisions by 28 users not shown)
Line 1: Line 1:
{{Quality|Masterwork|13:02, 6 April 2015 (UTC)}}
+
{{Quality|Masterwork}}
 
{{av}}
 
{{av}}
[[File:Snakebite.png|200px|thumb|right|A single bite from a [[helmet snake]] led to a slow, lingering death for this unfortunate hippo.]]
+
[[File:syndrome_statuses_anim.gif|right]]In ''Dwarf Fortress'', a '''syndrome''' can be thought of as a condition which applies a collection of [[Syndrome#Creature effect tokens|effects]] to [[creature]]s who contract it. Syndromes give rise to several of the game's [[fun|more interesting]] [[Health care|medical]] [[Status_icon|predicaments]], such as [[alcohol]] inebriation, venomous snake bites, and the brain-rotting secretions of certain [[Forgotten beast|uninvited guests]]. That said, the syndrome system isn't functionally restricted to the simulation of disease -  many of the game's supernatural features, such as [[werewolf|werewolves]], [[vampire]]s, [[necromancer]]s, [[mummy|mummy curses]] and the [[undead]], are in fact produced by applying various [[Syndrome#Special_Effects|special effects]] to creatures via syndromes.
A '''syndrome''' is a specific combination of [[symptom]]s that a poor, helpless creature might get from a disease, venom or other effect, through encountering certain other creatures, substances, or supernatural [[weather]].  Syndromes 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 those syndromes that can be helped by treatment.  
 
  
 +
Graphically, [[Dwarf|dwarves]], [[human]]s, [[elf|elves]], [[goblin]]s and [[kobold]]s with supernatural syndromes will have a different skin color, as seen in the image to the right. Other creatures will appear exactly as they are with no alterations, unless they're undead, in which they will appear with an indigo/blue tint, black eyes and white pupils, as every creature will have a unique undead sprite (including that of children and babies for some creatures).
 +
 +
''"Yeah, I know this. I was looking for [[Syndrome examples|examples]]..."''
 +
[[File:skin_color_preview.png|thumb|right|What different undead/immortal creatures' skin colors mean, which are also syndromes.]]
 
==List of syndromes==
 
==List of syndromes==
Syndromes are generally named after the animal, substance or effect that delivers them. Note that in a world with [[dragon]]s and [[giant elephant]]s, dwarves (and elves and humans) fall into the "small creatures" category for purposes of this discussion.
+
In unmodded games, syndromes are generally named after the animal, substance or effect that delivers them. They can cause unpleasant and sometimes fatal [[symptom]]s over a short to long duration, 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 those that can be helped by treatment. Note that in a world with [[dragon]]s and [[giant elephant]]s, dwarves (and elves and humans) fall into the "small creatures" category for purposes of this discussion.
 
{| {{prettytable}}
 
{| {{prettytable}}
 
|- bgcolor="#dddddd"
 
|- bgcolor="#dddddd"
Line 127: Line 130:
 
| None
 
| None
 
|-
 
|-
| Inebriation{{version|0.42.01}}
+
| Inebriation
 
| [[Alcohol]] (consumed/injected)
 
| [[Alcohol]] (consumed/injected)
 
| Consuming alcoholic drinks
 
| Consuming alcoholic drinks
Line 177: Line 180:
 
|-
 
|-
 
| Mummy's curse
 
| Mummy's curse
| [[DF2014:Mummy|Disturbance interaction]].
+
| [[Mummy|Disturbance interaction]].
 
| Being cursed by a [[mummy]], when caught raiding their tombs
 
| Being cursed by a [[mummy]], when caught raiding their tombs
 
| None
 
| None
Line 184: Line 187:
 
|-
 
|-
 
| Vampirism
 
| Vampirism
| [[Deity|Divine]] Curse.
+
| [[Deity|Divine]] curse
| Drinking the blood of a [[vampire]]. Toppling statues in shrines in Adventure Mode or temples in Fortress Mode (random chance).
+
| Drinking the blood of a [[vampire]]. Toppling statues in shrines and temples (random chance), rolling divination dice too frequently.
 
| None
 
| None
 
| None
 
| None
 
| Victim becomes a [[vampire]].
 
| Victim becomes a [[vampire]].
 
|-
 
|-
| Werebeast Curse
+
| Werebeast curse
| [[Deity|Divine]] Curse.
+
| [[Deity|Divine]] curse
| Being bitten by a [[werebeast]] or toppling statues in shrines in Adventure Mode (random chance).
+
| Being bitten by a [[werebeast]], toppling statues in shrines and temples (random chance), rolling divination dice too frequently.
 
| None
 
| None
 
| None
 
| None
Line 198: Line 201:
 
|-
 
|-
 
| Necromancy
 
| Necromancy
| [[Deity|Divine]] Curse.
+
| [[Deity|Divine]] 'curse'
 
| Reading a book/slab that contains the secrets of life and death.
 
| Reading a book/slab that contains the secrets of life and death.
 
| None
 
| None
 
| None
 
| None
| Reader becomes a [[Necromancer]].
+
| Reader becomes a [[necromancer]].
 
|-
 
|-
 
| evil rain sickness<sup>3</sup>
 
| evil rain sickness<sup>3</sup>
Line 212: Line 215:
 
|-
 
|-
 
| evil cloud sickness<sup>4</sup>
 
| evil cloud sickness<sup>4</sup>
| Being caught in a [Weather#Evil weather|creeping cloud]] in an evil [[biome]]
+
| Being caught in a [[Weather#Evil weather|creeping cloud]] in an evil [[biome]]
 
|-
 
|-
 
| beast sickness<sup>5</sup>
 
| beast sickness<sup>5</sup>
Line 221: Line 224:
 
|-
 
|-
 
| night sickness<sup>5</sup>
 
| night sickness<sup>5</sup>
| Encounters with [[werebeast]]s or [[experiment]]s
+
| Encounters with [[nightmare]]s or [[experiment]]s
 
|-
 
|-
 
| demon sickness<sup>5</sup>
 
| demon sickness<sup>5</sup>
Line 233: Line 236:
 
: 3. Evil rain typically only causes minor symptoms such as blisters, bruising, coughing blood, dizziness, fever, nausea, oozing, and pain.  
 
: 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.  
 
: 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, [[werebeast]]s, [[experiment]]s, [[demon]]s and [[angel]]s have a chance to have a randomized syndrome. These range from mildly hazardous (mild [[Symptom#Blisters|blisters]] from inhaling boiling blood) to instantly fatal (severe necrosis from a contact poison attached to a breath weapon/creature made of blood).
+
: 5. [[Titan]]s, [[forgotten beast]]s, [[nightmare]]s, [[experiment]]s, [[demon]]s and [[angel]]s have a chance to have a randomized syndrome. These range from mildly hazardous (mild [[Symptom#Blisters|blisters]] from inhaling boiling blood) to instantly fatal (severe necrosis from a contact poison attached to a breath weapon/creature made of blood).
  
 
==The anatomy of a syndrome==
 
==The anatomy of a syndrome==
Mechanically, syndromes are bundles of tokens attached to a material (or to an interaction effect; see below) - 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.
+
To recap, syndromes are "diseases" which inflict effects upon creatures who acquire them. Mechanically, they're composed of a bunch of different syndrome tokens which detail [[Syndrome#Basic syndrome tokens|how it works]] and [[Syndrome#Creature effect tokens|what it does]]. Syndrome acquisition can be boiled down into two main routes: (1) via materials and (2) via interactions. Unlike most objects in the game, syndromes aren't defined in their own raw file; they're instead built up within the raw definition of the material or interaction effect to which they are tied, as described below.
 +
{{Modding}}
 +
'''1) Transmission via Materials'''
 +
Any material (be it [[Material_token#INORGANIC|inorganic]], [[Material_token#CREATURE_MAT|creature-derived]], or [[Material_token#PLANT_MAT|plant-derived]]) can have one or more syndromes added to it, simply by defining the syndrome within the material's own raw definition. The addition of certain tokens (detailed [[Syndrome#SYN_CONTACT|below]]) to the syndrome will determine what must be done to the material so as to transmit the syndrome to a creature; the current modes of transmission are as follows: [[Syndrome#SYN_CONTACT|bodily contact]] with the material, [[Syndrome#SYN_INGESTED|ingestion]] or [[Syndrome#SYN_INHALED|inhalation]] of the material, or [[Syndrome#SYN_INJECTED|injection]] of the material into the bloodstream. Any combination of transmission modes can be specified per syndrome.
  
If you are having troubles getting the syndromes to work (i.e., 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:VENOM:CREATURE_EXTRACT_TEMPLATE]
+
Here's the material definition of [[giant cave spider]] venom with its associated syndrome as an example:
 +
 
 +
''(See [[Giant cave spider/raw|here]] for the complete creature raw.)''
 +
     [USE_MATERIAL_TEMPLATE:POISON:CREATURE_EXTRACT_TEMPLATE]
 
         [STATE_NAME:ALL_SOLID:frozen giant cave spider venom]
 
         [STATE_NAME:ALL_SOLID:frozen giant cave spider venom]
 
         [STATE_ADJ:ALL_SOLID:frozen giant cave spider venom]
 
         [STATE_ADJ:ALL_SOLID:frozen giant cave spider venom]
Line 249: Line 257:
 
         [PREFIX:NONE]
 
         [PREFIX:NONE]
 
         [ENTERS_BLOOD]
 
         [ENTERS_BLOOD]
         [SYNDROME]
+
         '''[SYNDROME]'''
             [SYN_NAME:giant cave spider bite]
+
             '''[SYN_NAME:giant cave spider bite]'''
             [SYN_AFFECTED_CLASS:GENERAL_POISON]
+
             '''[SYN_AFFECTED_CLASS:GENERAL_POISON]'''
             [SYN_IMMUNE_CREATURE:SPIDER_CAVE:ALL]
+
             '''[SYN_IMMUNE_CREATURE:SPIDER_CAVE_GIANT:ALL]'''
             [SYN_INJECTED]
+
             '''[SYN_INJECTED]'''
             [CE_PARALYSIS:SEV:100:PROB:100:RESISTABLE:SIZE_DILUTES:START:5:PEAK:10:END:20]
+
             '''[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.
+
In the above, the non-bolded section consists of various [[material definition token]]s used to define and customise the venom material. (USE_MATERIAL_TEMPLATE defines a material called 'POISON', and creates it using the template 'CREATURE_EXTRACT_TEMPLATE' as a basis, which is then altered by the other tokens placed below it. See [[Material_definition_token#STATE_NAME|STATE_NAME]], [[Material_definition_token#STATE_ADJ|STATE_ADJ]], and [[Material_definition_token#PREFIX|PREFIX]] for more information about these tokens). The relevance of [[Material_definition_token#ENTERS_BLOOD|ENTERS_BLOOD]] in this context is explained below.
  
  ENTERS_BLOOD
+
The bolded section consists of the syndrome definition, which is initiated using the [[Syndrome#SYNDROME|[SYNDROME]]] token. The tokens placed after this (which are described in further detail [[Syndrome#Basic syndrome tokens|below]]) flesh out the syndrome - in this case they name it "giant cave spider bite", make it work only against creatures belonging to the 'GENERAL_POISON' [[Creature token#CREATURE_CLASS|creature class]], render giant cave spiders immune to it, and cause creatures to contract it if the venom is injected into them. The creature effect at the very bottom makes the syndrome inflict progressive complete paralysis upon the victim after a short delay, for what would be a relatively short-lived period were it not for the fact that most small creatures tend to suffocate before the effect wears off (that, or they get eaten by the giant cave spider that caused it).
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_IDENTIFIER{{version|0.42.01}}.
 
Similar to SYN_CLASS, this sets an identifier that can be shared between multiple syndromes, for use with the SYNDROME_DILUTION_FACTOR creature token. In vanilla DF, this is used to allow dwarves to drink more alcohol before becoming inebriated.
 
  SYN_NO_HOSPITAL{{version|0.42.01}}.
 
Probably prevents affected dwarves from being carried to the hospital.{{verify}}
 
  SYN_CONCENTRATION_ADDED:x:x{{version|0.42.01}}.
 
Repeated exposure to the syndrome will result in the effects becoming more intense. In vanilla [SYN_CONCENTRATION_ADDED:100:1000] is used with alcohol.
 
  
  SYN_INJECTED, SYN_CONTACT, SYN_INHALED, SYN_INGESTED
+
Great, so how do we get this lethal venom into a creature's bloodstream to transmit the syndrome? Giant cave spiders are able to do this via the [[Creature token#SPECIALATTACK_INJECT_EXTRACT|SPECIALATTACK_INJECT_EXTRACT]] token appended to their bite attack as such:
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:POISON:LIQUID:100:100]
 +
This makes their bites inject 100 units of the 'POISON' material in its liquid [[Material_definition_token#Material_States|state]]. Note that '[[Material_token#LOCAL_CREATURE_MAT|LOCAL_CREATURE_MAT]]:POISON' indicates that the 'POISON' material is defined amidst the same creature raws where the attack was detailed i.e. within the SPIDER_CAVE_GIANT creature definition; we could have written '[[Material_token#CREATURE_MAT|CREATURE_MAT]]:SPIDER_CAVE_GIANT:POISON' instead for the same result. Also note that we can make the attack inject any material we want it to, not just creature-associated materials. (Want your spider to inject molten [[gold]] into its victims to melt them from the inside out instead of bothering with syndromes? Simply replace 'LOCAL_CREATURE_MAT:POISON:LIQUID' with '[[Material_token#INORGANIC|INORGANIC]]:GOLD:LIQUID' and you're good to go).
  
 +
Note that [ENTERS_BLOOD] must be added to the material definition for injection attacks making use of this material to function properly. Without this token, the material would simply [[contaminant|splatter]] over the attacked bodypart instead of entering the bloodstream, so the above syndrome, which relies solely on the [[Syndrome#SYN_INJECTED|injectable]] transmission route, wouldn't be contracted. [ENTERS_BLOOD] can of course be left out intentionally, if the aim is to cover creatures with a material that transmits syndromes [[Syndrome#SYN_CONTACT|on contact]]. Keep in mind that splattering in lieu of injection also occurs with blunt attacks, on attacked body parts devoid of [[Tissue_definition_token#VASCULAR|VASCULAR]] tissue, and on [[Creature token#BLOOD|bloodless]] victims (including creatures who've had their blood removed via [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG:HAS_BLOOD]]).
  
  [SPECIALATTACK_INJECT_EXTRACT:LOCAL_CREATURE_MAT:VENOM:LIQUID:100:100]
+
A fun variation on typical creature venoms is to add a [[Syndrome#SYN_CONTACT|contact-transmissible]] syndrome to the creature's [[Creature token#BLOOD|blood]] material - this tends to end poorly for any predator that chooses to attack them.
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.
+
'''2) Transmission via Interactions'''
  
==Creature effect tokens==
+
The [[Interaction token|interaction]] system can be used to add syndromes to creatures directly via certain interaction effects, most notably [[Interaction token#I_EFFECT|I_EFFECT:ADD_SYNDROME]]. After placing this I_EFFECT in an interaction definition, the syndrome to be added is defined beneath it in exactly the same manner as that used for the material-bound syndromes described above. (Note that any [[Interaction_token#IE_TARGET|IE_ tokens]] used with this I_EFFECT can be placed before or after the syndrome definition; the order doesn’t really matter). The [[Interaction token#I_EFFECT| ANIMATE]] and [[Interaction token#I_EFFECT| RESURRECT]] interaction effects also allow syndromes to be tied to them in the same manner; in this case the syndrome is applied to the target creature after it is animated or resurrected respectively.
 +
 
 +
See [[Syndrome#Spreading_diseases|below]] for an example of a syndrome-transmitting interaction.
 +
 
 +
==Basic syndrome tokens==
 +
 
 +
{| {{prettytable}}
 +
|- bgcolor="Bisque"
 +
! Token
 +
! Arguments
 +
! Description
 +
 
 +
|-
 +
| {{text anchor|SYNDROME}}
 +
|
 +
| Used to begin defining a new syndrome.
 +
 
 +
|-
 +
| {{text anchor|SYN_NAME}}
 +
| <your text>
 +
| Used to specify the name of the syndrome as it appears in-game. Names don't have to be unique; it's perfectly acceptable to have multiple syndromes with identical names.
 +
 
 +
For example, this name is displayed when <nowiki>[</nowiki>[[Syndrome#CE_FEEL_EMOTION|CE_FEEL_EMOTION:<...>]]] causes an emotional reaction {{dftext|Urist is |0:1}}{{dftext|<emotion>|6:0}}{{dftext| due to <your_syn_name>.|0:1}}
 +
 
 +
|-
 +
| {{text anchor|SYN_CLASS}}
 +
| <your text>
 +
| Can be included to create a syndrome class and assign the syndrome to it, for use with the [[Interaction token#IT_CANNOT_HAVE_SYNDROME_CLASS|IT_CANNOT_HAVE_SYNDROME_CLASS]] interaction token. Can be specified more than once to assign the syndrome to multiple classes. Other syndromes can also be assigned to the same class.
 +
 
 +
|-
 +
| {{text anchor|SYN_CONTACT}}
 +
|
 +
| If the syndrome is tied to a material, creatures who come into contact with this material will contract the syndrome if this token is included in the syndrome definition. Contact transmission occurs when a creature's body becomes [[contaminant|contaminated]] with the material (visible as [material name] 'smear', 'dusting' or 'covering' over body parts when viewing the creature's inventory). Note that contact with [[item]]s made of a syndrome-inducing material currently doesn't result in transmission.
 +
 
 +
Methods of getting a material contaminant onto a creature's body include:
 +
* [[Creature token#SECRETION|secretions]]
 +
* [[Interaction_token#LIQUID_GLOB|liquid projectiles]] (contaminate struck body parts if exposed)
 +
* [[Interaction_token#TRAILING_VAPOR_FLOW|vapor]] and [[Interaction_token#TRAILING_DUST_FLOW|dust clouds]] (contaminate all external body parts, even if covered)
 +
* [[Interaction_token#SPATTER_LIQUID|puddles]] and [[Interaction_token#SPATTER_POWDER|dust piles]] ([[Body_token#STANCE|STANCE]] body parts become contaminated if the creature walks into them [[clothing|barefoot]], and all uncovered external body parts are contaminated if the creature is [[Status icon#Non-flashing|prone]])
 +
* [[Interaction_token#WEATHER_FALLING_MATERIAL|freakish rain]] (contaminates all external body parts, even if covered, if the creature is outside)
 +
* unprotected bodily contact with a contaminated creature (including performing or receiving body part attacks such as punches and [[wrestling]] moves, creature collisions, as well as [[Interaction_token#I_EFFECT|CONTACT]] interaction effects, if the involved body parts are exposed)
 +
* items [[Material_definition_token#MELTING_POINT|melting]] whilst equipped or hauled (this contaminates the body part that was holding them if exposed)
 +
* striking the creature's body with a contaminated item (see below)
 +
 
 +
It is possible to use this token for syndromes intended to be applied via envenomed weapons (but also check out [[Syndrome#SYN_INJECTED|SYN_INJECTED]]). When a creature's body is struck with an item which is contaminated with a contact syndrome-inducing material, the syndrome will be transmitted to the struck creature, even if the attack doesn't pierce the flesh. Syndrome transmission in this context often occurs in the absence of a visible contaminant on the body.
 +
 
 +
Contact transmission only appears to occur at the moment of contamination (which is to say, when a new bodily spatter is created). If the syndrome ends (once all its [[Syndrome#Creature_effect_tokens|creature effects]] reach their END point, at which point it will be removed from the creature), it will NOT be reapplied by the original syndrome-inducing contaminant (assuming it hasn't been cleaned off yet); the creature will need to be recontaminated with the causative material for this to occur. (Note that in the case of [[Creature token#SECRETION|secretions]], the secreted contaminants are continuously reapplied to the secretory body parts, so any associated short-lasting contact syndromes allowed to target the secreting creature can potentially be reapplied at the rate of secretion; this may work differently in [[adventurer mode]]).
 +
 
 +
|-
 +
| {{text anchor|SYN_INGESTED}}
 +
|
 +
| If the syndrome is tied to a material, creatures who [[food|eat]] or drink substances comprising, containing or [[contaminant|contaminated]] with this material will contract the syndrome if this token is included. This includes [[kitchen|prepared meals]] when any of the constituent ingredients contains the material in question.
 +
 
 +
This also applies to [[creature token#GRAZER|grazing]] creatures which happen to munch on a [[plant token#GRASS|grass]] that has an ingestion-triggered syndrome tied to any of its constituent materials.
 +
 
 +
|-
 +
| {{text anchor|SYN_INHALED}}
 +
|
 +
| If the syndrome is tied to a material, creatures who inhale the material will contract the syndrome if this token is included. Materials can only be inhaled in their [[Material_definition_token#BOILING_POINT|gaseous]] state, which is attainable by [[temperature|boiling]], or in the form of a [[Interaction_token#TRAILING_GAS_FLOW|TRAILING_GAS_FLOW]], [[Interaction_token#UNDIRECTED_GAS|UNDIRECTED_GAS]] or [[Interaction_token#WEATHER_CREEPING_GAS|WEATHER_CREEPING_GAS]]. Creatures can also be made to [[Tissue_definition_token#TISSUE_LEAKS|leak]] [[Tissue_definition_token#TISSUE_MAT_STATE|gaseous tissue]] when damaged.
 +
 
 +
Note that {{token|AQUATIC|c}} creatures never inhale gaseous materials, and creatures which do breathe air aren't guaranteed to inhale gases when exposed to them for a short time. Contrary to what one might expect, creatures with {{token|NOBREATHE|c}} are in fact capable of contracting inhalation syndromes; this is presumably a bug.
 +
 
 +
|-
 +
| {{text anchor|SYN_INJECTED}}
 +
|
 +
| If the syndrome is tied to a material, the injection of this material into a creature's bloodstream will cause it to contract the syndrome if this token is included. Injection can be carried out as part of a creature attack via [[Creature_token#SPECIALATTACK_INJECT_EXTRACT|SPECIALATTACK_INJECT_EXTRACT]], or by piercing the flesh of a creature with an [[item]] that has been [[contaminant|contaminated]] with the material. Thus, this token can be used as a more specific alternative to [[Syndrome#SYN_CONTACT|SYN_CONTACT]] for syndromes intended to be administered by envenomed weapons.
 +
 
 +
For injection to work, the material definition must include [[Material_definition_token#ENTERS_BLOOD|ENTERS_BLOOD]], the attacked body part needs to have [[Tissue_definition_token#VASCULAR|VASCULAR]] tissue, and the intended victim must have [[Creature token#BLOOD|BLOOD]] (so it won't work on creatures with the [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG:HAS_BLOOD]] syndrome effect). Getting the weapon "lodged into the wound" isn't a requirement.
 +
 
 +
|-
 +
| {{text anchor|SYN_AFFECTED_CLASS}}
 +
| <[[Creature token#CREATURE_CLASS|creature class]]>
 +
| If this is included, only creatures which belong to the specified [[Creature token#CREATURE_CLASS|creature class]] (as well as creatures which pass the [[Syndrome#SYN_AFFECTED_CREATURE|SYN_AFFECTED_CREATURE]] check if this is included) will be able to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures which have at least one matching class will be considered susceptible. If [[Syndrome#SYN_IMMUNE_CLASS|SYN_IMMUNE_CLASS]] and/or [[Syndrome#SYN_IMMUNE_CREATURE|SYN_IMMUNE_CREATURE]] are included, creatures which fail these checks will be unable to contract the syndrome even if they pass this class check.
 +
 
 +
|-
 +
| {{text anchor|SYN_IMMUNE_CLASS}}
 +
| <[[Creature token#CREATURE_CLASS|creature class]]>
 +
| If this is included, creatures which belong to the specified [[Creature token#CREATURE_CLASS|creature class]] will be unable to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures with at least one matching class will be considered immune (unless overridden by [[Syndrome#SYN_AFFECTED_CREATURE|SYN_AFFECTED_CREATURE]]).
 +
 
 +
|-
 +
| {{text anchor|SYN_AFFECTED_CREATURE}}
 +
| <creature>:<[[Creature_token#CASTE|caste]]>
 +
| If this is included, only the specified creature (and, if [[Syndrome#SYN_AFFECTED_CLASS|SYN_AFFECTED_CLASS]] is included, also creatures which pass this check as explained above) will be able to contract the syndrome. This token can be used multiple times per syndrome. If used alongside [[Syndrome#SYN_IMMUNE_CLASS|SYN_IMMUNE_CLASS]], the specified creature will be able to contract the syndrome regardless of this class check.
 +
 
 +
DWARF:FEMALE is an example of a valid <creature>:<caste> combination; "ALL" can be used in place of a specific caste so as to indicate that this applies to all castes of the specified creature.
 +
 
 +
|-
 +
| {{text anchor|SYN_IMMUNE_CREATURE}}
 +
| <creature>:<[[Creature_token#CASTE|caste]]>
 +
| If this is included, the specified creature will be unable to contract the syndrome (even if it matches [[Syndrome#SYN_AFFECTED_CLASS|SYN_AFFECTED_CLASS]]). It can be specified multiple times per syndrome. As above, "ALL" can be used in place of a specific caste.
 +
 
 +
|-
 +
| {{text anchor|SYN_NO_HOSPITAL}}
 +
|
 +
| Prevents creatures from being admitted to [[health care|hospital]] for problems arising directly as a result of the syndrome's effects, no matter how bad they get.
 +
 
 +
|-
 +
| {{text anchor|SYN_IDENTIFIER}}
 +
| <your text>
 +
| This token can be included to give a syndrome an identifier which can be shared between multiple syndromes. Only one identifier may be specified per syndrome.
 +
 
 +
Syndrome identifiers can be used in conjunction with the [[Creature token#SYNDROME_DILUTION_FACTOR|SYNDROME_DILUTION_FACTOR]] creature token to alter a creature’s innate resistance to the relevant [[Syndrome#Symptomatic effects|effects]] of any syndromes that possess the specified identifier. For example, every [[alcohol|alcoholic beverage]] in unmodded games comes with its own copy of an intoxicating syndrome, each of which has a <code>[SYN_IDENTIFIER:INEBRIATION]</code> token. All [[dwarf|dwarves]] have <code>[SYNDROME_DILUTION_FACTOR:INEBRIATION:150]</code>, which decreases the severity of any effects derived from a syndrome with the INEBRIATION identifier, thus enabling them to better handle all forms of alcohol.
 +
 
 +
When a creature gets a new syndrome with the same SYN_IDENTIFIER, it merges the effects of the new syndrome into the old one, resetting any overlapping syndrome effects to their PEAK time. If the new one comes with a [[Syndrome#SYN_CONCENTRATION_ADDED|SYN_CONCENTRATION_ADDED]] token, it will additionally adjust the first syndrome's concentration on any overlapping syndrome effects as described below. Taking the above example once again, a sober dwarf drinking their first alcoholic beverage would be exposed to an INEBRIATION syndrome, contracting it and having its effects manifest normally. If the dwarf were to have another drink before the effects of this first syndrome have all worn off (by reaching their [[Syndrome#Creature effect tokens|END]] point), then exposure to the second INEBRIATION syndrome would increase the severity of the original syndrome's effects, making the dwarf progressively more intoxicated, and reset the timer on inebriation to its PEAK.
 +
 
 +
|-
 +
| {{text anchor|SYN_CONCENTRATION_ADDED}}
 +
| <amount>:<max>
 +
| Syndrome concentration is essentially a quantity which impacts the severity of the syndrome's relevant [[Syndrome#Symptomatic effects|effects]]. The higher the syndrome's concentration, the greater its severity. When a syndrome is contracted, the value specified in <amount> is its initial concentration level.
 +
 
 +
As described above, if a creature is exposed to a syndrome with a particular [[Syndrome#SYN_IDENTIFIER|SYN_IDENTIFIER]] when already possessing an active syndrome with the same identifier, then this later syndrome isn't contracted, instead contributing to the original syndrome's concentration as indicated by its SYN_CONCENTRATION_ADDED token, if present. The syndrome in question will increase the original syndrome's concentration by <amount> whenever the creature is exposed to it, until its specified <max> concentration is reached by the original syndrome, causing subsequent exposure to this particular syndrome to do nothing (that is, until the original syndrome ends, at which point a new one may be contracted normally). Should the creature be exposed to a different syndrome with the same identifier and a higher <max> value, the concentration will of course increase further.
 +
 
 +
For example, all forms of [[alcohol]] in the vanilla game have a syndrome with <code>[SYN_IDENTIFIER:INEBRIATION]</code> and <code>[SYN_CONCENTRATION_ADDED:100:1000]</code>. When alcohol is first drunk, the creature contracts the relevant inebriating syndrome at a concentration level of 100. Every subsequent drink will increase the concentration of this first syndrome by a further 100, intensifying its effects, until it plateaus at concentration level 1000. Once all the effects of the original syndrome have ended, the cycle can be started anew (assuming the drinker hasn't died of [[Alcohol#Alcohol_poisoning|alcohol poisoning]] yet). As described by Toady, "Each 100 of <amount> will contribute SEV in general to each effect (before [[Creature token#SYNDROME_DILUTION_FACTOR|dilution]]), <max> goes up to 1000. The concentration does not decrease, but will stay at the maximum attained until the syndrome wears off."
 +
 
 +
Some of the generated interaction-derived syndromes come with <code>[SYN_CONCENTRATION_ADDED:1000:0]</code>. According to Toady, this "was a precaution after I had one bug with effects not fully manifesting due to low levels. It may not be necessary, but I decided to give everybody a full dose of the juice until I could get a closer look at it." [http://www.bay12forums.com/smf/index.php?topic=169696.msg8083872#msg8083872]
 +
|}
 +
 
 +
==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:
 
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]
 
   [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) ends it, the order of the intervening tokens isn't important.
 +
 +
{| {{prettytable}}
 +
|- bgcolor="Bisque"
 +
! Token
 +
! Arguments
 +
! Description
 +
 +
|-
 +
| {{text anchor|CE_X}}
 +
|
 +
| The effect type.  This can be a number of different tokens, as detailed in the tables that follow this one.
 +
 +
|-
 +
| {{text anchor|SEV}}
 +
| <amount>
 +
| The severity of the effect.  Higher values appear to be worse, with SEV:1000 CE_NECROSIS causing a part to near-instantly become rotten. Can go as high as 2147483647, and can be negative.
 +
 +
|-
 +
| {{text anchor|PROB}}
 +
| <amount>
 +
| The probability of the effect actually manifesting in the victim, as a percentage.  100 means always, 1 means a 1 in 100 chance.
 +
 +
|-
 +
| {{text anchor|BP}}
 +
| <body part>:<tissue>
 +
| (Optional; overridden by [[Syndrome#LOCALIZED|LOCALIZED]]) Specifies which body parts and tissues the effect is to be applied to. Not every effect requires a target!
 +
 +
<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 by the [BP] token of the body plan definition. For example, if you wanted to target the lungs of a creature, you would use BP:BY_CATEGORY:LUNG:ALL.  The effect would act on all body parts 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 body parts. Multiple targets can be given in one effect 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 body parts relevant to the contagion, like lungs for coal dust inhalation, or the eyes for exposure to an acid gas.
 +
 +
|-
 +
| {{text anchor|LOCALIZED}}
 +
|
 +
| (Optional; overrides [[Syndrome#BP|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 effect do nothing. This token also makes inhaled syndromes have no effect.
 +
 +
|-
 +
| {{text anchor|VASCULAR_ONLY}}
 +
|
 +
| (Optional) This effect only affects tissue layers with the VASCULAR token.
 +
 +
|-
 +
| {{text anchor|MUSCULAR_ONLY}}
 +
|
 +
| (Optional) This effect only affects tissue layers with the MUSCULAR token.
 +
 +
|-
 +
| {{text anchor|SIZE_DILUTES}}
 +
|
 +
| (Optional) This token presumably causes the severity of the effect 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.
 +
 +
|-
 +
| {{text anchor|SIZE_DELAYS}}
 +
|
 +
| (Optional) As above, this token has yet to be tested but presumably delays the onset of an effect according to the size of the victim.
 +
 +
|-
 +
| {{text anchor|CAN_BE_HIDDEN}}
 +
|
 +
| (Optional) Can be hidden by a unit assuming a secret identity, such as a [[vampire]]. {{verify}}
 +
 +
|-
 +
| {{text anchor|RESISTABLE}} (sic)
 +
|
 +
| (Optional) Whether a syndrome can build tolerance by exposure. If this token is present, each application of the syndrome will cause future applications to be weaker. This seems to be a permanent effect that does not fall off over time. (yes, it's spelled incorrectly)
 +
 +
|-
 +
| {{text anchor|DWF_STRETCH}}
 +
| <amount>
 +
| (Optional) Multiplies the duration values of the effect by the specified amount in Fortress mode.
 +
 +
|-
 +
| {{text anchor|ABRUPT_START}}
 +
|
 +
| (Optional) Makes the effect begin immediately rather than ramping up.
 +
 +
|-
 +
| {{text anchor|ABRUPT_END}}
 +
|
 +
| (Optional) Makes the effect end immediately rather than ramping down.
 +
 +
|-
 +
| {{text anchor|ABRUPT}}
 +
|
 +
| (Optional) Combination of ABRUPT_START and ABRUPT_END.
 +
 +
|-
 +
| {{text anchor|START}}
 +
| <time>
 +
| Determines the time after exposure, in ticks, when the effect starts. Required for all effects.
 +
 +
|-
 +
| {{text anchor|PEAK}}
 +
| <time>
 +
| (Optional) Determines the time after exposure, in ticks, when the effect reaches its peak intensity.
 +
 +
|-
 +
| {{text anchor|END}}
 +
| <time>
 +
| (Optional) Determines the time after exposure, in ticks, when the effect ends.
 +
|}
 +
 +
A key point that needs to be understood with regards to damaging syndrome effects such as [[Syndrome#CE_BRUISING|bruising]] is that they deal a quantity of damage (based on the effect's SEV and other modifiers) '''every [[time|tick]]''', and this damage accumulates over time. Thus, even a bruising effect at the lowest possible severity value '''will''' eventually lead to destruction of the affected body part(s) if the effect has a long enough duration. Similarly, [[Syndrome#Healing_Effects|healing effects]] undo a specific amount of damage every tick whilst the effect lasts.
  
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) ends it, the order of the intervening tokens isn't important. PEAK and END aren't required.
+
===Symptomatic Effects===
  
*CE_X
+
The following table contains [[Syndrome#Creature effect tokens|creature effect tokens]] which cause purely medical [[symptom]]s.
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.
 
*DWF_STRETCH:X{{version|0.42.01}} (Optional)
 
Multiplies the duration of the syndrome by X in Fortress mode.  If X is 72, syndrome will last the same amount of ticks in fortress and adventure mode.
 
*ABRUPT{{version|0.42.01}} (Optional)
 
Makes the symptom begin immediately rather than ramping up. {{verify}}
 
*CAN_BE_HIDDEN (Optional)
 
Can be hidden by a unit assuming a secret identity, such as a [[vampire]]. {{verify}}
 
*RESISTABLE (Optional)
 
Determines if the effect can be hindered by the target creature's [[Attribute#Disease_Resistance|disease resistance attribute]]. Without this token, disease resistance is ignored.
 
  
 +
Non-targeted effects will ignore any BP tokens and LOCALIZED tokens.
  
 
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!
 
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}}
 
{| {{prettytable}}
 
|- bgcolor="Bisque"
 
|- bgcolor="Bisque"
Line 338: Line 521:
 
! Description
 
! Description
 
|-
 
|-
| CE_BLEEDING
+
| {{text anchor|CE_BRUISING}}
 
| Yes
 
| 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.
+
| Causes the targeted body part to undergo bruising.
 
|-
 
|-
| CE_BLISTERS
+
| {{text anchor|CE_BLISTERS}}
 
| Yes
 
| Yes
| Covers the targeted bodypart with blisters.
+
| Covers the targeted body part with blisters.
 
|-
 
|-
| CE_BRUISING
+
| {{text anchor|CE_OOZING}}
 
| Yes
 
| Yes
| Causes the targeted bodypart to undergo bruising.
+
| Causes pus to ooze from the afflicted body part.
 
|-
 
|-
| CE_IMPAIR_FUNCTION
+
| {{text anchor|CE_BLEEDING}}
 
| Yes
 
| 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. Note that this effect is currently bugged, and will not "turn off" until the creature receives a wound to cause its body parts to update.
+
| Causes the targeted body part 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_NECROSIS
+
| {{text anchor|CE_SWELLING}}
 
| Yes
 
| Yes
| Causes the targeted bodypart to rot, with associated tissue damage, miasma emission and bleeding. The victim slowly bleeds to death if the wound is not treated. Badly necrotic limbs will require amputation.
+
| Causes the targeted body part to swell up. Extreme swelling may lead to necrosis.
 
|-
 
|-
| CE_NUMBNESS
+
| {{text anchor|CE_NECROSIS}}
 
| Yes
 
| Yes
| Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage.
+
| Causes the targeted body part to rot, with associated tissue damage, miasma emission and bleeding. The victim slowly bleeds to death if the wound is not treated. Badly necrotic limbs will require amputation.
 
|-
 
|-
| CE_OOZING
+
| {{text anchor|CE_NUMBNESS}}
| Yes
+
| Optional
| Causes pus to ooze from the afflicted bodypart.
+
| Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage.  If no target is specified this applies to all body parts.
 
|-
 
|-
| CE_PAIN
+
| {{text anchor|CE_PAIN}}
| Yes
+
| Optional
| Afflicts the targeted bodypart with intense pain.
+
| Afflicts the targeted body part with intense pain.  If no target is specified this applies to all body parts.
 
|-
 
|-
| CE_PARALYSIS
+
| {{text anchor|CE_PARALYSIS}}
| Yes
+
| Optional
| Causes paralysis. Paralysis is complete paralysis and will cause suffocation in smaller creatures. Paralysis on a limb may lead to motor nerve damage.
+
| Causes complete paralysis of the affected body part. Paralysis on a limb may lead to motor nerve damage. If no target is specified this causes total paralysis, which can lead to suffocation of smaller creatures.
 
|-
 
|-
| CE_SWELLING
+
| {{text anchor|CE_IMPAIR_FUNCTION}}
 
| Yes
 
| Yes
| Causes the targeted bodypart to swell up. Extreme swelling may lead to necrosis.
+
| An organ afflicted with this effect 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. Note that this effect is currently bugged, and will not "turn off" until the creature receives a wound to cause its body parts to update.
 
|-
 
|-
| CE_COUGH_BLOOD
+
| {{text anchor|CE_DIZZINESS}}
 
| No
 
| 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.
+
| Inflicts the Dizziness condition, occasional fainting and a general slowdown in movement and work speed.
 
|-
 
|-
| CE_DIZZINESS
+
| {{text anchor|CE_DROWSINESS}}
 
| No
 
| No
| Inflicts the Dizziness condition, occasional fainting and a general slowdown in movement and work speed.
+
| Causes the Drowsiness condition.
 
|-
 
|-
| CE_DROWSINESS
+
| {{text anchor|CE_UNCONSCIOUSNESS}}
 
| No
 
| No
| Causes the Drowsiness condition.
+
| Renders the creature unconscious.
 
|-
 
|-
| CE_FEVER
+
| {{text anchor|CE_FEVER}}
 
| No
 
| No
 
| Causes the Fever condition.
 
| Causes the Fever condition.
 
|-
 
|-
| CE_NAUSEA
+
| {{text anchor|CE_NAUSEA}}
 
| No
 
| No
 
| Causes the Nausea condition, and heavy vomiting. Can eventually lead to dehydration and death.
 
| Causes the Nausea condition, and heavy vomiting. Can eventually lead to dehydration and death.
 
|-
 
|-
| CE_UNCONSCIOUSNESS
+
| {{text anchor|CE_COUGH_BLOOD}}
 
| No
 
| No
| Renders unconscious.
+
| 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_VOMIT_BLOOD
+
| {{text anchor|CE_VOMIT_BLOOD}}
 
| No
 
| 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.
 
| 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.
|-
 
| CE_ERRATIC_BEHAVIOR{{version|0.42.01}}
 
| No
 
| Causes erratic behavior, meaning "People that like to brawl have a chance of starting a brawl-level fight with any nearby adult" [http://www.bay12forums.com/smf//index.php?topic=159164.msg7632503#msg7632503 -Toady]
 
 
|}
 
|}
====Healing Effects====
+
 
Starting with DF version 0.47.01, there are healing counterparts to most of the tokens above that will heal various syndrome effects or physical damage.
+
===Healing Effects===
 +
Most of the [[Syndrome#Symptomatic_Effects|above]] effects have counterparts to alleviate [[symptom]]s and heal physical damage:
 
{| {{prettytable}}
 
{| {{prettytable}}
 
|- bgcolor="Bisque"
 
|- bgcolor="Bisque"
Line 418: Line 598:
 
! Description
 
! Description
 
|-
 
|-
| CE_STOP_BLEEDING
+
| {{text anchor|CE_REDUCE_PAIN}}
| Yes?
+
| Yes
| Decreases the severity of the bleeding of any wounds or syndrome effects on the targeted bodypart. The SEV value probably controls by how much the bleeding is decreased.
+
| Decreases the severity of pain produced by wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the pain is decreased.
 +
|-
 +
| {{text anchor|CE_REDUCE_SWELLING}}
 +
| Yes
 +
| Decreases the severity of swelling on the targeted body part.
 +
|-
 +
| {{text anchor|CE_REDUCE_PARALYSIS}}
 +
| Yes
 +
| Decreases the severity of any paralysis effects on the targeted body part.
 
|-
 
|-
| CE_CLOSE_OPEN_WOUNDS
+
| {{text anchor|CE_REDUCE_DIZZINESS}}
| Yes?
+
| No
| Closes any wounds on the targeted bodypart with speed depending on the SEV value.
+
| Decreases the severity of any dizziness the creature has.
 
|-
 
|-
| CE_HEAL_TISSUES
+
| {{text anchor|CE_REDUCE_NAUSEA}}
| Yes?
+
| No
| Heals the tissues of the targeted bodypart with speed depending on the SEV value.
+
| Decreases the severity of any nausea the creature has.
 
|-
 
|-
| CE_HEAL_NERVES
+
| {{text anchor|CE_REDUCE_FEVER}}
| Yes?
+
| No
| Heals the nerves of the targeted bodypart with speed depending on the SEV value.
+
| Decreases the severity of any fever the creature has.
 
|-
 
|-
| CE_REDUCE_PAIN
+
| {{text anchor|CE_STOP_BLEEDING}}
| Yes?
+
| Yes
| Decreases the severity of pain produced by wounds or syndrome effects on the targeted bodypart. The SEV value probably controls by how much the pain is decreased.
+
| Decreases the severity of the bleeding of any wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the bleeding is decreased.
 
|-
 
|-
| CE_REDUCE_SWELLING
+
| {{text anchor|CE_CLOSE_OPEN_WOUNDS}}
| Yes?
+
| Yes
| Decreases the severity of swelling on the targeted bodypart.
+
| Closes any wounds on the targeted body part with speed depending on the SEV value.
 
|-
 
|-
| CE_CURE_INFECTION
+
| {{text anchor|CE_CURE_INFECTION}}
 
| Yes?
 
| Yes?
 
| Probably decreases the severity of the infection from infected wounds over time.
 
| Probably decreases the severity of the infection from infected wounds over time.
 
|-
 
|-
| CE_REDUCE_PARALYSIS
+
| {{text anchor|CE_HEAL_TISSUES}}
| Yes?
+
| Yes
| Decreases the severity of any paralysis effects on the targeted bodypart.
+
| Heals the tissues of the targeted body part with speed depending on the SEV value.
 
|-
 
|-
| CE_REGROW_PARTS
+
| {{text anchor|CE_HEAL_NERVES}}
 
| Yes
 
| Yes
| Causes missing bodyparts to regrow. SEV controls how quickly bodyparts are regrown. In adventure, parts will be regrown until you travel or wait/sleep {{bug|0011396}}.
+
| Heals the nerves of the targeted body part with speed depending on the SEV value.
 
|-
 
|-
| CE_REDUCE_DIZZINESS
+
| {{text anchor|CE_REGROW_PARTS}}
| No
+
| Yes
| Decreases the severity of any dizziness the creature has.
+
| Causes missing body parts to regrow. SEV controls how quickly body parts are regrown. In adventure, parts may be lost again once you travel or wait/sleep {{bug|0011396}}.
|-
 
| CE_REDUCE_NAUSEA
 
| No
 
| Decreases the severity of any nausea the creature has.
 
|-
 
| CE_REDUCE_FEVER
 
| No
 
| Decreases the severity of any fever the creature has.
 
 
|}
 
|}
  
 
===Special Effects===
 
===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.
+
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 custom substance or interaction. CE_FEEL_EMOTION is the only one of these that takes SEV.
  
 
{| {{prettytable}}
 
{| {{prettytable}}
Line 479: Line 659:
 
| {{text anchor|CE_ADD_TAG}}
 
| {{text anchor|CE_ADD_TAG}}
 
| No
 
| No
| tags
+
| <tag 1>:<tag 2>:etc
| Adds a tag to the affected creature. Many arguments can be used sequentially within one syndrome token. Valid tags are the same as that of the [[interaction token]] '''IT_REQUIRES''', ie.
+
| Adds the specified tag(s) to the affected creature. Multiple tags can be specified sequentially within a single effect token. Valid tags:
 +
 
 +
 
 +
'''Special tags:'''
 +
 
 +
*NO_AGING
 +
Halts the creature's aging process and prevents [[Creature token#MAXAGE|death by old age]].
 +
 
 +
*STERILE
 +
Makes the creature unable to produce [[children|offspring]].
 +
 
 +
*HAS_BLOOD
 +
*MORTAL
 +
*FIT_FOR_ANIMATION
 +
*FIT_FOR_RESURRECTION
 +
Adding these tags to a creature doesn't appear to do anything.
 +
 
 +
 
 +
'''Creature tokens:'''
 +
 
 +
*[[Creature_token#BLOODSUCKER|BLOODSUCKER]]
 +
*[[Creature_token#CAN_LEARN|CAN_LEARN]]
 +
*[[Creature_token#CAN_SPEAK|CAN_SPEAK]]
 +
*[[Creature_token#CRAZED|CRAZED]]
 +
*[[Creature_token#EXTRAVISION|EXTRAVISION]]
 +
*[[Creature_token#MISCHIEVOUS|MISCHIEVOUS]] (or [[Creature_token#MISCHIEVIOUS|MISCHIEVIOUS]])
 +
*[[Creature_token#NO_CONNECTIONS_FOR_MOVEMENT|NO_CONNECTIONS_FOR_MOVEMENT]]
 +
*[[Creature_token#NO_DIZZINESS|NO_DIZZINESS]]
 +
*[[Creature_token#NO_DRINK|NO_DRINK]]
 +
*[[Creature_token#NO_EAT|NO_EAT]]
 +
*[[Creature_token#NO_FEVERS|NO_FEVERS]]
 +
*[[Creature_token#NO_PHYS_ATT_GAIN|NO_PHYS_ATT_GAIN]]
 +
*[[Creature_token#NO_PHYS_ATT_RUST|NO_PHYS_ATT_RUST]]
 +
*[[Creature_token#NO_SLEEP|NO_SLEEP]]
 +
*[[Creature_token#NO_THOUGHT_CENTER_FOR_MOVEMENT|NO_THOUGHT_CENTER_FOR_MOVEMENT]]
 +
*[[Creature_token#NOBREATHE|NOBREATHE]]
 +
*[[Creature_token#NOEMOTION|NOEMOTION]]
 +
*[[Creature_token#NOEXERT|NOEXERT]]
 +
*[[Creature_token#NOFEAR|NOFEAR]]
 +
*[[Creature_token#NONAUSEA|NONAUSEA]]
 +
*[[Creature_token#NOPAIN|NOPAIN]]
 +
*[[Creature_token#NOSTUN|NOSTUN]]
 +
*[[Creature_token#NOT_LIVING|NOT_LIVING]]
 +
*[[Creature_token#NOTHOUGHT|NOTHOUGHT]]
 +
*[[Creature_token#OPPOSED_TO_LIFE|OPPOSED_TO_LIFE]]
 +
*[[Creature_token#PARALYZEIMMUNE|PARALYZEIMMUNE]]
 +
*[[Creature_token#SUPERNATURAL|SUPERNATURAL]]
 +
*[[Creature_token#TRANCES|TRANCES]]
 +
*[[Creature_token#UTTERANCES|UTTERANCES]]
 +
*[[Creature_token#NIGHT_CREATURE_EXPERIMENTER|NIGHT_CREATURE_EXPERIMENTER]]
 +
 
 +
Adding tags will cause the creature to pass/fail any relevant <code>[[Interaction token#IT_REQUIRES|IT_REQUIRES]]</code>/<code>[[Interaction_token#IT_FORBIDDEN|IT_FORBIDDEN]]</code> checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION). Note that [[Syndrome#CE_REMOVE_TAG|CE_REMOVE_TAG]] overrides this effect.
  
BLOODSUCKER, CAN_LEARN, CAN_SPEAK, CRAZED, EXTRAVISION, LIKES_FIGHTING (or LIKESFIGHTING), MISCHIEVOUS (or MISCHIEVIOUS), NO_CONNECTIONS_FOR_MOVEMENT, NO_DIZZINESS, NO_DRINK, NO_EAT, NO_FEVERS, NO_PHYS_ATT_GAIN, NO_PHYS_ATT_RUST, NO_SLEEP, NO_THOUGHT_CENTER_FOR_MOVEMENT, NOBREATHE, NOEMOTION, NOEXERT, NOFEAR, NONAUSEA, NOPAIN, NOSTUN, NOT_LIVING, NOTHOUGHT, OPPOSED_TO_LIFE, PARALYZEIMMUNE, SUPERNATURAL, TRANCES, NO_AGING, STERILE, UTTERANCES.
 
 
|-
 
|-
 
| {{text anchor|CE_REMOVE_TAG}}
 
| {{text anchor|CE_REMOVE_TAG}}
 
| No
 
| No
| tags
+
| <tag 1>:<tag 2>:etc
| Removes a tag from a creature. Supported arguments are the same as CE_ADD_TAG.
+
| Removes the specified tag(s) from the affected creature. Multiple tags can be specified sequentially within a single effect token. The tags listed [[Syndrome#CE_ADD_TAG|above]] can all be removed via this effect.
|-
+
 
 +
If a particular tag is targeted by both CE_REMOVE_TAG and [[Syndrome#CE_ADD_TAG|CE_ADD_TAG]], and both effects are active simultaneously, CE_REMOVE_TAG takes precedence (i.e. the overall effect is that of tag removal for as long as CE_REMOVE_TAG remains active). The order in which the effects activate doesn't affect this, not even if CE_ADD_TAG is added later/earlier via a different syndrome.
 +
 
 +
Removing tags will cause the creature to fail/pass any relevant <code>[[Interaction token#IT_REQUIRES|IT_REQUIRES]]</code>/<code>[[Interaction_token#IT_FORBIDDEN|IT_FORBIDDEN]]</code> checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION).
 +
 
 +
 
 +
'''Special tags:'''
 +
 
 +
* HAS_BLOOD
 +
If this tag is removed, the creature behaves as though it has no [[Creature token#BLOOD|blood]]; it doesn't bleed when [[Tissue definition token#VASCULAR|VASCULAR]] tissues are damaged (and thus cannot die of blood loss), and substances cannot be [[Syndrome#SYN_INJECTED|injected]] into it.
 +
 
 +
* NO_AGING
 +
* STERILE
 +
Removing these tags doesn't appear to do anything unless they've been added to a creature via [[Syndrome#CE_ADD_TAG|CE_ADD_TAG]], in which case their effects will be negated as described above.
 +
 
 +
* MORTAL
 +
* FIT_FOR_ANIMATION
 +
* FIT_FOR_RESURRECTION
 +
Removing these tags doesn't appear to do anything.
 +
 
 +
|- a
 
| {{text anchor|CE_DISPLAY_NAME}}
 
| {{text anchor|CE_DISPLAY_NAME}}
 
| No
 
| No
 
| NAME:singular:plural:adjective
 
| NAME:singular:plural:adjective
 
| Attaches the specified name to the creature's normal name.
 
| Attaches the specified name to the creature's normal name.
 +
 
|-
 
|-
 
| {{text anchor|CE_DISPLAY_TILE}}
 
| {{text anchor|CE_DISPLAY_TILE}}
Line 498: Line 749:
 
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
 
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
 
| Causes the creature to display the specified tile instead of its normal one.
 
| Causes the creature to display the specified tile instead of its normal one.
 +
 
|-
 
|-
 
| {{text anchor|CE_FLASH_TILE}}
 
| {{text anchor|CE_FLASH_TILE}}
Line 503: Line 755:
 
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]:FREQUENCY:<frames default tile>:<frames syndrome tile>
 
| TILE:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]:FREQUENCY:<frames default tile>:<frames syndrome tile>
 
| Causes the creature to flash between its normal tile and the one specified here.
 
| Causes the creature to flash between its normal tile and the one specified here.
 +
 
|-
 
|-
 
| {{text anchor|CE_PHYS_ATT_CHANGE}}
 
| {{text anchor|CE_PHYS_ATT_CHANGE}}
 
| No
 
| No
 
| [[Attribute]]:percentage:fixed boost(?)
 
| [[Attribute]]:percentage:fixed boost(?)
| Alters the physical [[attribute]]s of a creature.
+
| Alters the creature's specified [[Attribute#Body_attributes|physical attribute]].
 +
 
 
|-
 
|-
 
| {{text anchor|CE_MENT_ATT_CHANGE}}
 
| {{text anchor|CE_MENT_ATT_CHANGE}}
 
| No
 
| No
 
| [[Attribute]]:percentage:fixed boost(?)
 
| [[Attribute]]:percentage:fixed boost(?)
| Alters the mental [[attribute]]s of a creature.
+
| Alters the creature's specified [[Attribute#Soul_attributes|mental attribute]].
 +
 
 +
|-
 +
| {{text anchor|CE_SPEED_CHANGE}}
 +
| No
 +
| speed modifier:number
 +
| Changes the creature's speed.
 +
Speed modifier contains one or both of:
 +
* 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.
 +
 
 +
|-
 +
| {{text anchor|CE_SKILL_ROLL_ADJUST}}
 +
| No
 +
| PERC:percentage:PERC_ON:percentage
 +
| Alters the creature's specified{{verify}} skill level.  The argument PERC specifies a percentage of the creature's current skill, and PERC_ON the probability of the effect being applied on a particular roll.
 +
e.g. This causes a 20% chance of any skill roll being 0 (multiplies the current skill level by 0/100) instead of the normal result
 +
[CE_SKILL_ROLL_ADJUST:PROB:100:PERC:0:PERC_ON:20:START:0]
 +
 
 
|-
 
|-
 
| {{text anchor|CE_BODY_APPEARANCE_MODIFIER}}
 
| {{text anchor|CE_BODY_APPEARANCE_MODIFIER}}
Line 518: Line 791:
 
| APPEARANCE_MODIFIER:HEIGHT/LENGTH/BROADNESS:percentage(?)  
 
| APPEARANCE_MODIFIER:HEIGHT/LENGTH/BROADNESS:percentage(?)  
 
| Alters the size of the creature.
 
| Alters the size of the creature.
 +
 
|-
 
|-
 
| {{text anchor|CE_BP_APPEARANCE_MODIFIER}}
 
| {{text anchor|CE_BP_APPEARANCE_MODIFIER}}
 
| Yes
 
| Yes
| body part:APPEARANCE_MODIFIER:attribute:number]
+
| body part:APPEARANCE_MODIFIER:attribute:number
| Alters the characteristics (height, width etc.) of a body part.
+
| Alters the characteristics (height, width etc.) of a body part. "body part" here can either be BP, followed by the usual BY_CATEGORY etc., or TL, followed by the usual selection for SELECT_TISSUE_LAYER.
 +
 
 
|-
 
|-
| {{text anchor|CE_MATERIAL_FORCE_MULTIPLIER}}
+
| {{text anchor|CE_BODY_TRANSFORMATION}}
 
| No
 
| No
| MAT_MULT:[[<material token>]]:<value A>:<value B>
+
|
| When the affected creature is struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to the material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. '''NONE:NONE''' can be used in place of a specific material so as to make the effect applicable to all materials.
+
| Makes the affected unit transform into a different creature. The target creature may either be specified directly by following this with a CE:CREATURE token, or else set to be randomly selected as indicated by the additional tokens listed below (of which multiple may be specified).
 +
 
 +
Note that transformation into or out of the target form causes the creature to drop all items in its inventory and instantly heals all of its wounds.  If an [[undead]] limb happens to be transformed, its entire body will regenerate upon transforming back.
 +
 
 +
Transformation will also re-roll a creature's age to somewhere within the new form's adult age range. This prevents a 70 year old dwarf from dying the moment it turns into a bat ([[Creature token#MAXAGE|max age]] of 3). If it remains stuck as a bat for (at most) three consecutive years it will die of old age as a bat before the syndrome is able to wear off.
 +
 
 +
A transformed creature generally retains its previous group and civilization membership (unless it becomes [[Creature token#OPPOSED_TO_LIFE|OPPOSED_TO_LIFE]] for example). A transformed dwarf will remain a member of your fortress (and may still hold or gain [[Noble|positions]]), a transformed trader will hang out at the trade depot and eventually leave along with its fellow traders, and a transformed goblin will continue sieging your fortress with its fellow siege members.
 +
 
 +
A transformed diplomat (like a trade liaison or expedition leader) will still be able to conduct diplomatic meetings even if they no longer [[Creature token#CAN_SPEAK|CAN_SPEAK]].
 +
 
 +
Transformed creatures can be trained and adopted following the usual rules. However note that if a transformed creature is a member of your fortress then [[Animal Training|animal trainers]] will not attempt to train it.
 +
 
 +
A transformed creature can produce offspring with creatures of the species it has transformed into and will follow that creature's normal rules for reproduction.
 +
 
 +
[[Butcher#Butchering|Butchering]] a transformed creature may produce an odd mix of products. For example, if Urist the dwarf is transformed into a [[Cow|bull]] and then is led to the butcher's block for slaughter the resulting products will contain some bull creature parts like "Urist's horn", "Urist's hoof", and "Urist's skin" (which becomes "cow leather" when [[Tanner|tanned]]) but will also contain some dwarf creature parts like "dwarf meat", "dwarf eye", and "dwarf brain".
 +
 
 +
 
 +
'''Specific transformation:'''
 +
 
 +
* '''CE:CREATURE:'''<creature>:<caste><br>
 +
This can be used to specify a target creature to transform into ([CE:CREATURE:DWARF:FEMALE], for example). '''ALL''' or '''ANY''' can be used in place of a specific caste to randomise this for every transformation.
 +
Do note that using '''ALL''' or '''ANY''' for transformation castes will make the creature transform over and over again with the interval depending on the '''START''' token. This can lead to an unending transformation loop. [[Syndrome#looping_problem|However, there is a way to get around this.]]
 +
 
 +
 
 +
'''Random transformation:'''
 +
 
 +
* '''CE:CREATURE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|creature flag]]><br>
 +
Narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]]. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.
 +
 
 +
* '''CE:FORBIDDEN_CREATURE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|creature flag]]><br>
 +
Excludes creatures with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.
 +
 
 +
* '''CE:CREATURE_CASTE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|caste flag]]><br>
 +
Narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.
 +
 
 +
* '''CE:FORBIDDEN_CREATURE_CASTE_FLAG:'''<[[Interaction_token#Creature_and_Caste_Flags|caste flag]]><br>
 +
Excludes any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]] from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.
 +
 
 +
*'''CE:HAVE_FAST_EFFORTLESS_GAIT_SPEED:'''<minimum [[Gait#Speed|gait speed]]><br>
 +
Narrows down the selection to creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] less than or equal to the specified <minimum gait speed> ("less than" because lower is faster in the scale used for [[Gait#Speed|gait speed]]). This is used in generated [[Die#Adventurer_Mode|divination curses]] to prevent the player from being transformed into a creature that is frustratingly slow to play as. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]
 +
 
 +
*'''CE:ALL_SLOW_EFFORTLESS_GAIT_SPEED:'''<maximum [[Gait#Speed|gait speed]]><br>
 +
Excludes any creatures which have at least one [[gait]] with an [[Creature_token#GAIT|<energy expenditure>]] of 0 and a [[Creature_token#GAIT|<max speed>]] value less than or equal to the specified <maximum gait speed> (note that larger values are slower in the scale used for [[Gait#Speed|gait speed]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]
 +
 
 
|-
 
|-
| {{text anchor|CE_SPEED_CHANGE}}
+
| {{text anchor|CE_MATERIAL_FORCE_MULTIPLIER}}
 
| No
 
| No
| speed modifier:number
+
| MAT_MULT:[[material token|<material token>]]:<value A>:<value B>
| Changes the speed of a creature.  
+
| When the affected creature is struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. '''NONE:NONE''' can be used in place of a specific material token so as to make the effect applicable to all materials. Note that this syndrome effect is equivalent to the [[Creature_token#MATERIAL_FORCE_MULTIPLIER|MATERIAL_FORCE_MULTIPLIER]] creature token.
Speed modifier contains one or both of:
 
* 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.
 
  
 
|-
 
|-
Line 544: Line 858:
 
| Makes the creature able to perform an [[Interaction_token|interaction]]. Follow this effect token with [[Interaction_token#INTERACTION|[CDI:INTERACTION:<interaction name>]]] to specify the desired interaction, and add other [[Interaction_token#Usage|CDI tokens]] as required.
 
| Makes the creature able to perform an [[Interaction_token|interaction]]. Follow this effect token with [[Interaction_token#INTERACTION|[CDI:INTERACTION:<interaction name>]]] to specify the desired interaction, and add other [[Interaction_token#Usage|CDI tokens]] as required.
 
|-
 
|-
| {{text anchor|CE_SPECIAL_ATTACK_INTERACTION}}{{version|0.47.01}}
+
| {{text anchor|CE_SPECIAL_ATTACK_INTERACTION}}
 
| Yes
 
| Yes
 
| INTERACTION:<interaction name>:BP:<selection criteria>:<name of category,type, or token of designated part/parts>
 
| INTERACTION:<interaction name>:BP:<selection criteria>:<name of category,type, or token of designated part/parts>
Line 553: Line 867:
 
| No
 
| No
 
| MAT_TOKEN:<body material token>
 
| MAT_TOKEN:<body material token>
| This is used to tie an [[Interaction_token#Definitions |interaction]] to one of the creature’s body materials. Generated [[vampire]] syndromes use this effect to make vampire blood pass on the vampirism curse when consumed.
+
| This is used to tie an [[Interaction_token|interaction]] to one of the creature’s body materials. Generated [[vampire]] syndromes use this effect to make vampire blood pass on the vampirism curse when consumed.
  
The target body material is specified by inserting its identifier as defined in the creature raws. For example, when a syndrome with “CE_BODY_MAT_INTERACTION:MAT_TOKEN:SWEAT” is gained by a unit, the effect will apply to any material defined as “SWEAT” in the creature raws of that unit, if such a material is present.
+
The target body material is specified by inserting its ID as defined in the creature raws. For example, when a syndrome with “CE_BODY_MAT_INTERACTION:MAT_TOKEN:SWEAT” is gained by a unit, the effect will apply to any material defined as “SWEAT” in the creature raws of that unit, if such a material is present.
'''RESERVED_BLOOD''' is a special body material token which can be used to specify the [[Creature_token#BLOOD|[BLOOD]]] material of any creature, regardless of the material's actual identifier.
+
'''RESERVED_BLOOD''' is a special body material token which can be used to specify the [[Creature_token#BLOOD|[BLOOD]]] material of any creature, regardless of the material's actual ID.
  
 
The following tokens should be placed after this effect:
 
The following tokens should be placed after this effect:
* '''CE:SYNDROME_TAG:syndrome_trigger_type''' is used to specify what must be done with the body material to trigger the interaction. Replace "syndrome_trigger_type" with any of '''SYN_INGESTED, SYN_INJECTED, SYN_CONTACT, SYN_INHALED'''. Multiple instances of this tag may be used to specify different valid transmission routes. However, it seems that only SYN_INGESTED and SYN_INJECTED are currently implemented.
+
* '''CE:SYNDROME_TAG:'''<transmission method> is used to specify what must be done with the body material to trigger the interaction. Replace "<transmission method>" with any of '''[[Syndrome#SYN_INGESTED|SYN_INGESTED]], [[Syndrome#SYN_INJECTED|SYN_INJECTED]], [[Syndrome#SYN_CONTACT|SYN_CONTACT]], [[Syndrome#SYN_INHALED|SYN_INHALED]]'''. Multiple instances of this tag may be used to specify different valid transmission routes. ''However, SYN_INGESTED appears to be the only one that works at present.''
* '''CE:INTERACTION:interaction_id''' is used to specify which interaction is to be run (replace "interaction_id" with the name of the desired interaction). Appropriate interaction effects with a creature target (such as [[Interaction_token#I_EFFECT|ADD_SYNDROME]]) will be inflicted upon the unit who interacts with the body material as specified above. Note that the linked interaction must have an [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]] token for this to work.
+
* '''CE:INTERACTION:'''<[[Interaction_token#INTERACTION|interaction ID]]> is used to specify which interaction is to be run (replace "<interaction ID>" with the name of the desired interaction). Appropriate interaction effects with a creature target (such as [[Interaction_token#I_EFFECT|ADD_SYNDROME]]) will be inflicted upon the unit who interacts with the body material as specified above. Note that the linked interaction must have an [[Interaction_token#I_SOURCE|[I_SOURCE:INGESTION]]] token for this to work.
  
This currently only works on materials obtained from historical figures! That is to say, the material must bear the source unit's name, such as "Urist McVampire's dwarf blood" as opposed to mere "dwarf blood".
+
This currently only works on materials obtained from historical figures. That is to say, the material must bear the source unit's name, such as "Urist McVampire's dwarf blood" as opposed to mere "dwarf blood".
  
 
|-
 
|-
| {{text anchor|CE_BODY_TRANSFORMATION}}
+
| {{text anchor|CE_SENSE_CREATURE_CLASS}}
 
| No
 
| No
|
+
| CLASS:<[[Creature_token#CREATURE_CLASS|creature class]]>:
| Makes the affected unit transform into a different creature. The target creature may either be specified directly by following this with a CE:CREATURE token, or else set to be randomly selected as indicated by the creature and/or caste flag restrictions listed below (of which multiple may be specified).
+
[[Tilesets|<tile value or character>]]:
* '''CE:CREATURE:<creature ID>:<caste ID>''' - Specify the target creature and caste (for example: CE:CREATURE:DWARF:FEMALE). '''ANY''' can be used in place of a specific caste ID to randomise the caste for every transformation.<br>
+
[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
* '''CE:CREATURE_FLAG: <creature flag>'''{{version|0.47.01}} - Any creature with the specified [[:Interaction_token#Creature_and_Caste_Flags|creature flag]] is a valid transformation target.<br>
+
| Provides the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when such creatures lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.
* '''CE:FORBIDDEN_CREATURE_FLAG:<creature flag>'''{{version|0.47.01}} - Forbids all creatures with the specified [[:Interaction_token#Creature_and_Caste_Flags|creature flag]] from the random selection pool.<br>
 
* '''CE:CREATURE_CASTE_FLAG:<caste flag>'''{{version|0.47.01}} - Any creature with the specified [[:Interaction_token#Creature_and_Caste_Flags|caste flag]] is a valid transformation target.<br>
 
* '''CE:FORBIDDEN_CREATURE_CASTE_FLAG:<caste flag>'''{{version|0.47.01}} - Forbids all creatures with the specified [[:Interaction_token#Creature_and_Caste_Flags|caste flag]] from being randomly selected.<br>
 
*'''CE:HAVE_FAST_EFFORTLESS_GAIT_SPEED'''{{version|0.47.01}} - Unknown. Possibly disallows all creatures with only slow gaits.{{verify}}
 
  
Note that any wounds the creature has suffered will instantly heal upon transforming, both into and out of the target form.  If an [[undead]] limb happens to be transformed, its entire body will regenerate upon transforming back.
 
 
|-
 
|-
| {{text anchor|CE_SKILL_ROLL_ADJUST}}
+
| {{text anchor|CE_FEEL_EMOTION}}
 
| No
 
| No
| PERC:percentage:PERC_ON:percentage
+
| EMOTION:<[[emotion]]>
| 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 on a particular roll.
+
| Makes the creature feel a specific [[emotion]]. The effect's SEV value determines how intense the emotion is. The creature also receives a [[thought]] in the following format: "[creature] feels [emotion] due to [[Syndrome#SYN_NAME|[syndrome name]]]". See [[Emotion]] for the list of valid emotions.
 +
 
 
|-
 
|-
| {{text anchor|CE_SENSE_CREATURE_CLASS}}
+
| {{text anchor|CE_CHANGE_PERSONALITY}}
 
| No
 
| No
| CLASS:<[[Creature_token#CREATURE_CLASS|creature class]]>:[[Tilesets|<tile value or character>]]:[[Color#Color_values|<foreground color>:<background color>:<foreground brightness>]]
+
| TRAIT:<[[Personality traits, values, and dreams#Traits|personality trait]]>:<amount>
| Provides the ability to sense creatures belonging to the specified [[Creature_token#CREATURE_CLASS|creature class]] even when such creatures lie far beyond line of sight, including through walls. It also appears to reduce or negate the combat penalty of [[Wound#Blindness|blind]] units when fighting creatures they can sense. In [[adventure mode]], the specified tile will be used to represent sensed creatures when they cannot be seen directly.
+
| Changes a [[personality trait]] by the given amount. Multiple TRAIT:<trait>:<amount> sets may be used, and <amount> can be negative. For example, generated [[necromancer]] syndromes come with the following effect:<br>
 +
<code>[CE_CHANGE_PERSONALITY:FACET:ANXIETY_PROPENSITY:50:FACET:TRUST:-50:START:0:ABRUPT]</code>
 +
 
 +
According to Toady, CE_CHANGE_PERSONALITY effects can cause creatures to re-evaluate their [[Personality traits, values, and dreams#Dreams|dreams]] in worldgen; the boost to anxiety and distrust given to necromancers makes it more likely for them to develop the goal of [[Personality traits, values, and dreams#Dream:RULE_THE_WORLD|ruling the world]]. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8275328#msg8275328]
 +
 
 
|-
 
|-
| {{text anchor|CE_CHANGE_PERSONALITY}}{{version|0.42.01}}
+
| {{text anchor|CE_ERRATIC_BEHAVIOR}}
 
| No
 
| No
| FACET:[[DF2014:Personality_trait#Facets|trait]]:amount
+
|
| Changes a [[personality trait]] by amount. Multiple FACET:trait:amount sets may be used.
+
| Causes erratic behavior, meaning "People that [[Personality traits, values, and dreams#Trait:VIOLENT|like to brawl]] have a chance of starting a brawl-level fight with any nearby adult." [http://www.bay12forums.com/smf//index.php?topic=159164.msg7632503#msg7632503 -Toady]
|-
 
| {{text anchor|CE_FEEL_EMOTION}}{{version|0.42.01}}
 
| No
 
| EMOTION:[[emotion]]
 
| Makes the creature feel a specific [[emotion]]; severity based on standard SEV value. The [[thought]] the creature receives is: "[creature] feels [emotion] due to [syndrome name]". See [[Emotion]] for the list of valid emotions.
 
 
|}
 
|}
  
Line 607: Line 916:
 
When this token is placed after a syndrome effect, it will prevent that effect from working unless within the specified period range.
 
When this token is placed after a syndrome effect, it will prevent that effect from working unless within the specified period range.
  
For example, generated [[werebeast]] syndromes have a [[Syndrome#CE_BODY_TRANSFORMATION|body transformation effect]] with [CE:PERIODIC:[[Syndrome#MOON_PHASE|MOON_PHASE]]:27:0], which makes the transformation take place only throughout moon phases 27 to 0 (the full moon period). Once the moon phase changes from 0 to 1, the transformation will end and remain inactive until phase 27 is reached again.
+
For example, generated [[werebeast]] syndromes have a [[Syndrome#CE_BODY_TRANSFORMATION|body transformation effect]] with <code>[CE:PERIODIC:[[Syndrome#MOON_PHASE|MOON_PHASE]]:27:0]</code>, which makes the transformation active only throughout moon phases 27 to 0 (the full moon period). Once the moon phase changes from 0 to 1, the transformation will end and remain inactive until phase 27 is reached again (unless of course the effect has an END time which is reached before this happens. On that note, keep in mind that the START time of the effect needs to have been reached for activation to have become possible).
 +
 
 +
Only one periodic trigger may currently be specified per effect. [[Syndrome#Counter_Triggers|Counter triggers]] can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have its conditions met for the effect to be allowed to work.
  
 
MOON_PHASE is currently the only valid period type:
 
MOON_PHASE is currently the only valid period type:
Line 633: Line 944:
 
'''[CE:{{text anchor|COUNTER_TRIGGER}}:<counter_name>:<min_value>:<max_value>:REQUIRED]'''
 
'''[CE:{{text anchor|COUNTER_TRIGGER}}:<counter_name>:<min_value>:<max_value>:REQUIRED]'''
  
Each creature in the game has internal counters which keep track of its various activities and statuses. When this token is placed after a syndrome effect, it will prevent the effect from working unless the affected creature's indicated counter lies within the specified range.
+
Creatures in ''Dwarf Fortress'' possess internal counters which keep track of their various activities and statuses. When this token is placed after a syndrome effect, it will prevent the effect from working unless the affected creature has the indicated counter, and its value lies within the specified range.
 +
 
 +
For example, generated [[vampire]] syndromes use <code>[CE:COUNTER_TRIGGER:[[Syndrome#DRINKING_BLOOD|DRINKING_BLOOD]]:1:NONE:REQUIRED]</code> with an [[Syndrome#CE_BP_APPEARANCE_MODIFIER|appearance modifier]] to make the vampire's teeth temporarily lengthen whilst leeching blood.
 +
 
 +
Note that <code>NONE</code> can be used in place of <max_value> to indicate that any value above <min_value> is valid. <code>NONE</code> can also be used in place of <min_value>, which is equivalent to the lowest value attainable by a counter.
 +
 
 +
<code>REQUIRED</code> implies that the effect won't proceed if the counter exists but doesn't lie within the range provided. However, it's actually redunant as COUNTER_TRIGGER always checks for both of these conditions [http://www.bay12forums.com/smf/index.php?topic=169696.msg8173424#msg8173424]; replacing it with <code>NONE</code> doesn't alter the way the trigger functions, though it ''will'' fail to work if this slot is left empty instead.
  
Note that 'NONE' can be used in place of <max_value>.
+
As detailed below, most counters only exist temporarily, so their use as triggers is somewhat more restricted than intuition suggests. For example, specifying <code>0</code> or <code>NONE</code> as the <min_value> for a [[Syndrome#CAVE_ADAPT|CAVE_ADAPT]] trigger wouldn't permit the effect to work when the affected creature is outside, since this counter is removed from the unit as soon as its value decreases past 1. Similarly, [[Syndrome#MILK_COUNTER|MILK_COUNTER]] is only present for some time ''after'' a creature is milked.
  
For example, generated [[vampire]] syndromes use [CE:COUNTER_TRIGGER:[[Syndrome#DRINKING_BLOOD|DRINKING_BLOOD]]:1:NONE:REQUIRED] with an [[Syndrome#CE_BP_APPEARANCE_MODIFIER|appearance modifier]] to make the vampire's teeth temporarily lengthen whilst leeching blood.
+
Multiple counter triggers can be specified per effect, in which case the effect will be permitted to work if at least one of the trigger conditions is met. A [[Syndrome#Periodic_Triggers|periodic trigger]] can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have their conditions met for the effect to work.
  
 
The following is a list of valid counter types including a couple of notable values:
 
The following is a list of valid counter types including a couple of notable values:
Line 645: Line 962:
 
! Counter
 
! Counter
 
! Description
 
! Description
 +
 
|-
 
|-
 
| {{text anchor|ALCOHOLIC}}
 
| {{text anchor|ALCOHOLIC}}
| For [[Creature_token#ALCOHOL_DEPENDENT|ALCOHOL_DEPENDENT]] creatures, this counter increases by 1 each [[time|tick]], and is reset to 0 when the creature drinks [[alcohol]]. The following messages are added after "needs alcohol to get through the working day" in the creature's description when the counter reaches the specified values:
+
| For {{token|ALCOHOL_DEPENDENT|c}} creatures, this counter increases by 1 each [[time|tick]], and is reset to 0 when the creature drinks [[alcohol]]. The following messages are added after "needs alcohol to get through the working day" in the creature's description when the counter reaches the specified values:
 
* 100800 (3 months) = and is starting to work slowly due to its scarcity
 
* 100800 (3 months) = and is starting to work slowly due to its scarcity
 
* 201600 (6 months) = and really wants a drink
 
* 201600 (6 months) = and really wants a drink
 
* 302400 (9 months) = and has gone without a drink for far, far too long
 
* 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 (s)he had some
 
* 403200 (1 year) = and can't even remember the last time (s)he had some
 +
 
|-
 
|-
 
| {{text anchor|CAVE_ADAPT}}
 
| {{text anchor|CAVE_ADAPT}}
| For creatures with the [[Creature_token#CAVE_ADAPT|CAVE_ADAPT]] token, this counter increases by 1 each [[time|tick]] when the creature is underground, and decreases by 10 each tick when outside. See [[cave adaptation]] for more information.
+
| For creatures with the {{token|CAVE_ADAPT|c}} token, this counter is created and increases by 1 each [[time|tick]] when the creature is in the {{DFtext|Dark|0:1}}, and decreases by 10 each tick when {{DFtext|Outside|3:1}}. The counter is removed if it decreases to 0. See [[cave adaptation]] for more information.
 
* 403200 (1 year) = going outside causes irritation
 
* 403200 (1 year) = going outside causes irritation
 
* 604800 (1.5 years) = going outside causes nausea
 
* 604800 (1.5 years) = going outside causes nausea
|-
+
 
| {{text anchor|PARTIED_OUT}}
 
| How long before the creature will decide to attend another party. Starts at 3+ months when a party ends and counts down to 0.
 
 
|-
 
|-
 
| {{text anchor|MILK_COUNTER}}
 
| {{text anchor|MILK_COUNTER}}
| When a creature is milked, this counter is set to the frequency value specified in its [[Creature_token#MILKABLE|MILKABLE]] creature token, and subsequently decreases by 1 each [[time|tick]] until it reaches 0, at which point the creature will be available for milking again.
+
| When a creature is milked, this counter is created and set to the frequency value specified in the creature's {{token|MILKABLE|c}} token, and subsequently decreases by 1 each [[time|tick]] until it reaches 0, at which point it is immediately removed, making the creature available for milking again.
 +
 
 
|-
 
|-
 
| {{text anchor|EGG_SPENT}}
 
| {{text anchor|EGG_SPENT}}
| This is set to 100800 (the total number of [[time|tick]]s in 3 months) when a creature [[Creature_token#LAYS_EGGS|lays eggs]], and thereafter decreases by 1 each tick until it reaches 0, at which point the creature will be able to lay eggs again.
+
| This counter is created and set to 100800 (3 months' worth of [[time|tick]]s in fortress mode) when a creature [[Creature_token#LAYS_EGGS|lays eggs]], and thereafter decreases by 1 each tick until it reaches 0, at which point it is removed and the creature regains the ability to lay eggs.
 +
 
 
|-
 
|-
 
| {{text anchor|GROUNDED_ANIMAL_ANGER}}
 
| {{text anchor|GROUNDED_ANIMAL_ANGER}}
| How angry (and likely to attack) an animal is from being in an overcrowded location. Increases when overcrowded and otherwise counts down to 0.
+
| How angry (and likely to attack) an animal is from being in an overcrowded location. The counter is created and set to 200 when the animal is forced to lie on the ground whilst sharing a tile with another creature. It subsequently decreases by 1 each [[time|tick]], but this is overcome by the addition of 200 every so often (with a variable delay between each spike) if the creature remains grounded. The counter is removed if it decreases to 0.
 +
 
 
|-
 
|-
 
| {{text anchor|TIME_SINCE_SUCKED_BLOOD}}
 
| {{text anchor|TIME_SINCE_SUCKED_BLOOD}}
| This counter rises by 1 every [[time|tick]] for [[Creature_token#BLOODSUCKER|blood-sucking]] creatures such as [[vampire]]s. When it rises high enough, the creature will seek an unconscious victim to leech off.  Blood-sucking causes the counter to decrease, and will continue either until it reaches 0, or the victim is dead.
+
| This counter rises by 1 every [[time|tick]] for creatures with the {{token|BLOODSUCKER|c}} token. When it rises high enough (generally around 100800; 3 months in fortress mode time), the creature will seek an [[sleep|unconscious]] victim to leech off of.  Blood-sucking causes the counter to decrease, and will continue until either the victim is dead or the counter reaches 0. Note that this counter isn't removed when 0 is reached.
 +
 
 +
When playing as a bloodsucker in [[adventure mode]], the following bloodthirst indicators are displayed when this counter reaches the specified values:
 +
* 172800 (1 day in adventure mode time) = {{DFtext|Thirsty|4:0}}
 +
* 1209600 (1 week) = {{DFtext|Thirsty!|4:1}}
 +
* 2419200 (2 weeks) = {{DFtext|Thirsty!|5:1}}
 +
Various penalties are applied as bloodthirst increases; see the [[vampire]] article for more information.
 +
 
 
|-
 
|-
 
| {{text anchor|DRINKING_BLOOD}}
 
| {{text anchor|DRINKING_BLOOD}}
| This appears to be set to a fixed value of 20 whilst the creature is sucking blood, and begins to decrease by 1 each [[time|tick]] once blood-sucking ceases (as described [[Syndrome#TIME_SINCE_SUCKED_BLOOD|above]]), seemingly delaying the creature from doing other activities until it reaches 0.
+
| This appears to be created and set to a fixed value of 20 whilst the creature is sucking blood, and begins to decrease by 1 each [[time|tick]] once blood-sucking ceases (as described [[Syndrome#TIME_SINCE_SUCKED_BLOOD|above]]) until it reaches 0, at which point the counter is removed.
 +
 
 
|}
 
|}
  
Line 686: Line 1,014:
 
   [BOILING_POINT:10000]
 
   [BOILING_POINT:10000]
 
   [MAT_FIXED_TEMP:10001]
 
   [MAT_FIXED_TEMP:10001]
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!
+
  [SPEC_HEAT:1]
 +
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#SYN_INHALED|SYN_INHALED]] syndrome you thoughtfully attached to the material definition earlier! Note that creatures do not need to inhale every tick, so there is a chance that the gas will dissipate before it can infect any particular creature.
  
 
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 definition token]]s.
 
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 definition token]]s.
 
  
 
==Spreading diseases==
 
==Spreading diseases==
Line 728: Line 1,056:
 
As soon as the said creature is startled by your dwarves, the [[fun]] will begin.
 
As soon as the said creature is startled by your dwarves, the [[fun]] will begin.
  
==''In 0.47.01''==
+
===In 0.47.01===
 
As of version 0.47.01, it may be possible to use a creature's established methods of attack for use in disease-spreading.
 
As of version 0.47.01, it may be possible to use a creature's established methods of attack for use in disease-spreading.
  
Line 752: Line 1,080:
  
 
The line [CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:BITE_PLAGUE:BP:BY_CATEGORY:MOUTH:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT] allows any infected creature with an attack using mouth or tooth category body parts to immediately spread the disease using said attack. The victim of the attack may then spread the disease if they are able to attack with the needed body part/parts.
 
The line [CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:BITE_PLAGUE:BP:BY_CATEGORY:MOUTH:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT] allows any infected creature with an attack using mouth or tooth category body parts to immediately spread the disease using said attack. The victim of the attack may then spread the disease if they are able to attack with the needed body part/parts.
 +
 +
==Multi-caste/multi-creature body transformations==
 +
This is a way to get around the {{text anchor|looping problem}} when using ANY or ALL castes for [[Syndrome#CE_BODY_TRANSFORMATION|CE_BODY_TRANSFORMATION]] and not being limited to a single creature for transformations. It's an incredibly simple solution as you can see in this example code:
 +
{{code|code=
 +
[SYNDROME]
 +
[SYN_NAME:draconic curse]
 +
[SYN_CLASS:DRACONIC_CURSE]
 +
[CE_BODY_TRANSFORMATION:PROB:25:START:0]
 +
[CE:CREATURE:HYDRA:MALE]
 +
[CE_BODY_TRANSFORMATION:PROB:25:START:0]
 +
[CE:CREATURE:DRAGON:MALE]
 +
[CE_BODY_TRANSFORMATION:PROB:25:START:0]
 +
[CE:CREATURE:HYDRA:FEMALE]
 +
[CE_BODY_TRANSFORMATION:PROB:100:START:0]
 +
[CE:CREATURE:DRAGON:FEMALE]
 +
}}
 +
This code will transform a creature into either a female/male [[hydra]] or a female/male [[dragon]].
 +
 +
For every caste/creature you want a ''victim'' to transform into, you add a [CE_BODY_TRANSFORMATION] token with a [PROB] token attached to it. For most of the transformations the PROB is set to ``1/number_of_transformations * 100`` (or a different number if you want uneven odds), but the final transformation needs a PROB of 100 to ensure there is always at least one transformation chosen. A creature can only have one active transformation at a time. If any of the lower PROB transformations occurs then the PROB 100 transformation can not happen.
 +
 +
If you instead want a ''sequence'' of transformations to take place then you need make sure that one transformation ends on the same tick that the next one begins:
 +
{{code|code=
 +
[SYNDROME]
 +
[SYN_NAME:draconic sequence curse]
 +
[SYN_CLASS:DRACONIC_SEQUENCE_CURSE]
 +
[CE_BODY_TRANSFORMATION:PROB:100:START:0:END:10]
 +
[CE:CREATURE:HYDRA:MALE]
 +
[CE_BODY_TRANSFORMATION:PROB:100:START:10:END:20]
 +
[CE:CREATURE:DRAGON:MALE]
 +
[CE_BODY_TRANSFORMATION:PROB:100:START:20:END:30]
 +
[CE:CREATURE:HYDRA:FEMALE]
 +
[CE_BODY_TRANSFORMATION:PROB:100:START:30:END:40]
 +
[CE:CREATURE:DRAGON:FEMALE]
 +
}}
 +
 +
==See also==
 +
 +
* [[Syndrome examples]]
 +
* [[Interaction token]]
 +
* [[Modding]]
  
 
{{Category|Modding}}
 
{{Category|Modding}}

Latest revision as of 09:55, 12 October 2024

This article is about the current version of DF.
Note that some content may still need to be updated.

Syndrome statuses anim.gif

In Dwarf Fortress, a syndrome can be thought of as a condition which applies a collection of effects to creatures who contract it. Syndromes give rise to several of the game's more interesting medical predicaments, such as alcohol inebriation, venomous snake bites, and the brain-rotting secretions of certain uninvited guests. That said, the syndrome system isn't functionally restricted to the simulation of disease - many of the game's supernatural features, such as werewolves, vampires, necromancers, mummy curses and the undead, are in fact produced by applying various special effects to creatures via syndromes.

Graphically, dwarves, humans, elves, goblins and kobolds with supernatural syndromes will have a different skin color, as seen in the image to the right. Other creatures will appear exactly as they are with no alterations, unless they're undead, in which they will appear with an indigo/blue tint, black eyes and white pupils, as every creature will have a unique undead sprite (including that of children and babies for some creatures).

"Yeah, I know this. I was looking for examples..."

What different undead/immortal creatures' skin colors mean, which are also syndromes.

List of syndromes[edit]

In unmodded games, syndromes are generally named after the animal, substance or effect that delivers them. They can cause unpleasant and sometimes fatal symptoms over a short to long duration, but some will clear up over time or with the assistance of a doctor. A hospital is required to diagnose and potentially treat those that can be helped by treatment. Note that in a world with dragons and giant elephants, dwarves (and elves and humans) fall into the "small creatures" category for purposes of this discussion.

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
None
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
None None
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 None
Bumblebee sting bumblebee venom (injected) Being stung by a bumblebee worker Pain
Strong swelling
None None
Bushmaster bite bushmaster venom (injected) Being bitten by a bushmaster, giant bushmaster or bushmaster man Strong pain
Mild bleeding
Dizziness
Nausea
Unconsciousness
Complete paralysis1
None None
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
None None
Giant cave spider bite giant cave spider venom
(injected)
Being bitten by a giant cave spider Size-dependant paralysis. Death by asphyxiation, in small targets. Large targets are generally unhindered...unless you count the high probability of being eaten by the giant cave spider as a hindrance. None, not that it really matters.
Gila monster bite gila monster venom (injected) Being bitten by a gila monster, giant gila monster or gila monster man Pain
Mild swelling
None None
Gnomeblight gnomeblight
(contact, inhaled, injected, or ingested)
Purposely exposing oneself to the extract. Only affects mountain gnomes and dark gnomes. None Severe systemic necrosis2 None
Giant desert scorpion sting giant desert scorpion venom
(injected)
Being stung by a giant desert scorpion Necrosis of the brain and nervous system Certain death None, not that it really matters.
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
None None
Inebriation Alcohol (consumed/injected) Consuming alcoholic drinks Nausea
Dizziness
Unconsciousness
Personality changes
Euphoria
Erratic behavior
Trouble breathing
None None
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
Mummy's curse Disturbance interaction. Being cursed by a mummy, when caught raiding their tombs None None 20% chance of any skill roll failing, regardless of skill.
Vampirism Divine curse Drinking the blood of a vampire. Toppling statues in shrines and temples (random chance), rolling divination dice too frequently. None None Victim becomes a vampire.
Werebeast curse Divine curse Being bitten by a werebeast, toppling statues in shrines and temples (random chance), rolling divination dice too frequently. None None Victim becomes a werebeast.
Necromancy Divine 'curse' Reading a book/slab that contains the secrets of life and death. None None Reader becomes a necromancer.
evil rain sickness3 Random Being caught outside in freakish weather in an evil biome Random Random Random
evil cloud sickness4 Being caught in a creeping cloud in an evil biome
beast sickness5 Encounters with forgotten beasts
titan sickness5 Encounters with titans
night sickness5 Encounters with nightmares or experiments
demon sickness5 Encounters with demons
divine sickness5 Encounters with angels
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 zombie-like forms.
5. Titans, forgotten beasts, nightmares, experiments, demons and angels have a chance to have a randomized syndrome. These range from mildly hazardous (mild blisters from inhaling boiling blood) to instantly fatal (severe necrosis from a contact poison attached to a breath weapon/creature made of blood).

The anatomy of a syndrome[edit]

To recap, syndromes are "diseases" which inflict effects upon creatures who acquire them. Mechanically, they're composed of a bunch of different syndrome tokens which detail how it works and what it does. Syndrome acquisition can be boiled down into two main routes: (1) via materials and (2) via interactions. Unlike most objects in the game, syndromes aren't defined in their own raw file; they're instead built up within the raw definition of the material or interaction effect to which they are tied, as described below.


1) Transmission via Materials Any material (be it inorganic, creature-derived, or plant-derived) can have one or more syndromes added to it, simply by defining the syndrome within the material's own raw definition. The addition of certain tokens (detailed below) to the syndrome will determine what must be done to the material so as to transmit the syndrome to a creature; the current modes of transmission are as follows: bodily contact with the material, ingestion or inhalation of the material, or injection of the material into the bloodstream. Any combination of transmission modes can be specified per syndrome.


Here's the material definition of giant cave spider venom with its associated syndrome as an example:

(See here for the complete creature raw.)

   [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_GIANT:ALL]
           [SYN_INJECTED]
           [CE_PARALYSIS:SEV:100:PROB:100:RESISTABLE:SIZE_DILUTES:START:5:PEAK:10:END:20]

In the above, the non-bolded section consists of various material definition tokens used to define and customise the venom material. (USE_MATERIAL_TEMPLATE defines a material called 'POISON', and creates it using the template 'CREATURE_EXTRACT_TEMPLATE' as a basis, which is then altered by the other tokens placed below it. See STATE_NAME, STATE_ADJ, and PREFIX for more information about these tokens). The relevance of ENTERS_BLOOD in this context is explained below.

The bolded section consists of the syndrome definition, which is initiated using the [SYNDROME] token. The tokens placed after this (which are described in further detail below) flesh out the syndrome - in this case they name it "giant cave spider bite", make it work only against creatures belonging to the 'GENERAL_POISON' creature class, render giant cave spiders immune to it, and cause creatures to contract it if the venom is injected into them. The creature effect at the very bottom makes the syndrome inflict progressive complete paralysis upon the victim after a short delay, for what would be a relatively short-lived period were it not for the fact that most small creatures tend to suffocate before the effect wears off (that, or they get eaten by the giant cave spider that caused it).

Great, so how do we get this lethal venom into a creature's bloodstream to transmit the syndrome? Giant cave spiders are able to do this via the SPECIALATTACK_INJECT_EXTRACT token appended to their bite attack as such:

   [SPECIALATTACK_INJECT_EXTRACT:LOCAL_CREATURE_MAT:POISON:LIQUID:100:100]

This makes their bites inject 100 units of the 'POISON' material in its liquid state. Note that 'LOCAL_CREATURE_MAT:POISON' indicates that the 'POISON' material is defined amidst the same creature raws where the attack was detailed i.e. within the SPIDER_CAVE_GIANT creature definition; we could have written 'CREATURE_MAT:SPIDER_CAVE_GIANT:POISON' instead for the same result. Also note that we can make the attack inject any material we want it to, not just creature-associated materials. (Want your spider to inject molten gold into its victims to melt them from the inside out instead of bothering with syndromes? Simply replace 'LOCAL_CREATURE_MAT:POISON:LIQUID' with 'INORGANIC:GOLD:LIQUID' and you're good to go).

Note that [ENTERS_BLOOD] must be added to the material definition for injection attacks making use of this material to function properly. Without this token, the material would simply splatter over the attacked bodypart instead of entering the bloodstream, so the above syndrome, which relies solely on the injectable transmission route, wouldn't be contracted. [ENTERS_BLOOD] can of course be left out intentionally, if the aim is to cover creatures with a material that transmits syndromes on contact. Keep in mind that splattering in lieu of injection also occurs with blunt attacks, on attacked body parts devoid of VASCULAR tissue, and on bloodless victims (including creatures who've had their blood removed via CE_REMOVE_TAG:HAS_BLOOD).

A fun variation on typical creature venoms is to add a contact-transmissible syndrome to the creature's blood material - this tends to end poorly for any predator that chooses to attack them.


2) Transmission via Interactions

The interaction system can be used to add syndromes to creatures directly via certain interaction effects, most notably I_EFFECT:ADD_SYNDROME. After placing this I_EFFECT in an interaction definition, the syndrome to be added is defined beneath it in exactly the same manner as that used for the material-bound syndromes described above. (Note that any IE_ tokens used with this I_EFFECT can be placed before or after the syndrome definition; the order doesn’t really matter). The ANIMATE and RESURRECT interaction effects also allow syndromes to be tied to them in the same manner; in this case the syndrome is applied to the target creature after it is animated or resurrected respectively.

See below for an example of a syndrome-transmitting interaction.

Basic syndrome tokens[edit]

Token Arguments Description
SYNDROME Used to begin defining a new syndrome.
SYN_NAME <your text> Used to specify the name of the syndrome as it appears in-game. Names don't have to be unique; it's perfectly acceptable to have multiple syndromes with identical names.

For example, this name is displayed when [CE_FEEL_EMOTION:<...>] causes an emotional reaction Urist is <emotion> due to <your_syn_name>.

SYN_CLASS <your text> Can be included to create a syndrome class and assign the syndrome to it, for use with the IT_CANNOT_HAVE_SYNDROME_CLASS interaction token. Can be specified more than once to assign the syndrome to multiple classes. Other syndromes can also be assigned to the same class.
SYN_CONTACT If the syndrome is tied to a material, creatures who come into contact with this material will contract the syndrome if this token is included in the syndrome definition. Contact transmission occurs when a creature's body becomes contaminated with the material (visible as [material name] 'smear', 'dusting' or 'covering' over body parts when viewing the creature's inventory). Note that contact with items made of a syndrome-inducing material currently doesn't result in transmission.

Methods of getting a material contaminant onto a creature's body include:

  • secretions
  • liquid projectiles (contaminate struck body parts if exposed)
  • vapor and dust clouds (contaminate all external body parts, even if covered)
  • puddles and dust piles (STANCE body parts become contaminated if the creature walks into them barefoot, and all uncovered external body parts are contaminated if the creature is prone)
  • freakish rain (contaminates all external body parts, even if covered, if the creature is outside)
  • unprotected bodily contact with a contaminated creature (including performing or receiving body part attacks such as punches and wrestling moves, creature collisions, as well as CONTACT interaction effects, if the involved body parts are exposed)
  • items melting whilst equipped or hauled (this contaminates the body part that was holding them if exposed)
  • striking the creature's body with a contaminated item (see below)

It is possible to use this token for syndromes intended to be applied via envenomed weapons (but also check out SYN_INJECTED). When a creature's body is struck with an item which is contaminated with a contact syndrome-inducing material, the syndrome will be transmitted to the struck creature, even if the attack doesn't pierce the flesh. Syndrome transmission in this context often occurs in the absence of a visible contaminant on the body.

Contact transmission only appears to occur at the moment of contamination (which is to say, when a new bodily spatter is created). If the syndrome ends (once all its creature effects reach their END point, at which point it will be removed from the creature), it will NOT be reapplied by the original syndrome-inducing contaminant (assuming it hasn't been cleaned off yet); the creature will need to be recontaminated with the causative material for this to occur. (Note that in the case of secretions, the secreted contaminants are continuously reapplied to the secretory body parts, so any associated short-lasting contact syndromes allowed to target the secreting creature can potentially be reapplied at the rate of secretion; this may work differently in adventurer mode).

SYN_INGESTED If the syndrome is tied to a material, creatures who eat or drink substances comprising, containing or contaminated with this material will contract the syndrome if this token is included. This includes prepared meals when any of the constituent ingredients contains the material in question.

This also applies to grazing creatures which happen to munch on a grass that has an ingestion-triggered syndrome tied to any of its constituent materials.

SYN_INHALED If the syndrome is tied to a material, creatures who inhale the material will contract the syndrome if this token is included. Materials can only be inhaled in their gaseous state, which is attainable by boiling, or in the form of a TRAILING_GAS_FLOW, UNDIRECTED_GAS or WEATHER_CREEPING_GAS. Creatures can also be made to leak gaseous tissue when damaged.

Note that [AQUATIC] creatures never inhale gaseous materials, and creatures which do breathe air aren't guaranteed to inhale gases when exposed to them for a short time. Contrary to what one might expect, creatures with [NOBREATHE] are in fact capable of contracting inhalation syndromes; this is presumably a bug.

SYN_INJECTED If the syndrome is tied to a material, the injection of this material into a creature's bloodstream will cause it to contract the syndrome if this token is included. Injection can be carried out as part of a creature attack via SPECIALATTACK_INJECT_EXTRACT, or by piercing the flesh of a creature with an item that has been contaminated with the material. Thus, this token can be used as a more specific alternative to SYN_CONTACT for syndromes intended to be administered by envenomed weapons.

For injection to work, the material definition must include ENTERS_BLOOD, the attacked body part needs to have VASCULAR tissue, and the intended victim must have BLOOD (so it won't work on creatures with the CE_REMOVE_TAG:HAS_BLOOD syndrome effect). Getting the weapon "lodged into the wound" isn't a requirement.

SYN_AFFECTED_CLASS <creature class> If this is included, only creatures which belong to the specified creature class (as well as creatures which pass the SYN_AFFECTED_CREATURE check if this is included) will be able to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures which have at least one matching class will be considered susceptible. If SYN_IMMUNE_CLASS and/or SYN_IMMUNE_CREATURE are included, creatures which fail these checks will be unable to contract the syndrome even if they pass this class check.
SYN_IMMUNE_CLASS <creature class> If this is included, creatures which belong to the specified creature class will be unable to contract the syndrome. This token can be specified multiple times per syndrome, in which case creatures with at least one matching class will be considered immune (unless overridden by SYN_AFFECTED_CREATURE).
SYN_AFFECTED_CREATURE <creature>:<caste> If this is included, only the specified creature (and, if SYN_AFFECTED_CLASS is included, also creatures which pass this check as explained above) will be able to contract the syndrome. This token can be used multiple times per syndrome. If used alongside SYN_IMMUNE_CLASS, the specified creature will be able to contract the syndrome regardless of this class check.

DWARF:FEMALE is an example of a valid <creature>:<caste> combination; "ALL" can be used in place of a specific caste so as to indicate that this applies to all castes of the specified creature.

SYN_IMMUNE_CREATURE <creature>:<caste> If this is included, the specified creature will be unable to contract the syndrome (even if it matches SYN_AFFECTED_CLASS). It can be specified multiple times per syndrome. As above, "ALL" can be used in place of a specific caste.
SYN_NO_HOSPITAL Prevents creatures from being admitted to hospital for problems arising directly as a result of the syndrome's effects, no matter how bad they get.
SYN_IDENTIFIER <your text> This token can be included to give a syndrome an identifier which can be shared between multiple syndromes. Only one identifier may be specified per syndrome.

Syndrome identifiers can be used in conjunction with the SYNDROME_DILUTION_FACTOR creature token to alter a creature’s innate resistance to the relevant effects of any syndromes that possess the specified identifier. For example, every alcoholic beverage in unmodded games comes with its own copy of an intoxicating syndrome, each of which has a [SYN_IDENTIFIER:INEBRIATION] token. All dwarves have [SYNDROME_DILUTION_FACTOR:INEBRIATION:150], which decreases the severity of any effects derived from a syndrome with the INEBRIATION identifier, thus enabling them to better handle all forms of alcohol.

When a creature gets a new syndrome with the same SYN_IDENTIFIER, it merges the effects of the new syndrome into the old one, resetting any overlapping syndrome effects to their PEAK time. If the new one comes with a SYN_CONCENTRATION_ADDED token, it will additionally adjust the first syndrome's concentration on any overlapping syndrome effects as described below. Taking the above example once again, a sober dwarf drinking their first alcoholic beverage would be exposed to an INEBRIATION syndrome, contracting it and having its effects manifest normally. If the dwarf were to have another drink before the effects of this first syndrome have all worn off (by reaching their END point), then exposure to the second INEBRIATION syndrome would increase the severity of the original syndrome's effects, making the dwarf progressively more intoxicated, and reset the timer on inebriation to its PEAK.

SYN_CONCENTRATION_ADDED <amount>:<max> Syndrome concentration is essentially a quantity which impacts the severity of the syndrome's relevant effects. The higher the syndrome's concentration, the greater its severity. When a syndrome is contracted, the value specified in <amount> is its initial concentration level.

As described above, if a creature is exposed to a syndrome with a particular SYN_IDENTIFIER when already possessing an active syndrome with the same identifier, then this later syndrome isn't contracted, instead contributing to the original syndrome's concentration as indicated by its SYN_CONCENTRATION_ADDED token, if present. The syndrome in question will increase the original syndrome's concentration by <amount> whenever the creature is exposed to it, until its specified <max> concentration is reached by the original syndrome, causing subsequent exposure to this particular syndrome to do nothing (that is, until the original syndrome ends, at which point a new one may be contracted normally). Should the creature be exposed to a different syndrome with the same identifier and a higher <max> value, the concentration will of course increase further.

For example, all forms of alcohol in the vanilla game have a syndrome with [SYN_IDENTIFIER:INEBRIATION] and [SYN_CONCENTRATION_ADDED:100:1000]. When alcohol is first drunk, the creature contracts the relevant inebriating syndrome at a concentration level of 100. Every subsequent drink will increase the concentration of this first syndrome by a further 100, intensifying its effects, until it plateaus at concentration level 1000. Once all the effects of the original syndrome have ended, the cycle can be started anew (assuming the drinker hasn't died of alcohol poisoning yet). As described by Toady, "Each 100 of <amount> will contribute SEV in general to each effect (before dilution), <max> goes up to 1000. The concentration does not decrease, but will stay at the maximum attained until the syndrome wears off."

Some of the generated interaction-derived syndromes come with [SYN_CONCENTRATION_ADDED:1000:0]. According to Toady, this "was a precaution after I had one bug with effects not fully manifesting due to low levels. It may not be necessary, but I decided to give everybody a full dose of the juice until I could get a closer look at it." [1]

Creature Effect Tokens[edit]

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 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) ends it, the order of the intervening tokens isn't important.

Token Arguments Description
CE_X The effect type. This can be a number of different tokens, as detailed in the tables that follow this one.
SEV <amount> The severity of the effect. Higher values appear to be worse, with SEV:1000 CE_NECROSIS causing a part to near-instantly become rotten. Can go as high as 2147483647, and can be negative.
PROB <amount> The probability of the effect actually manifesting in the victim, as a percentage. 100 means always, 1 means a 1 in 100 chance.
BP <body part>:<tissue> (Optional; overridden by LOCALIZED) Specifies which body parts and tissues the effect is to be applied to. Not every effect requires a target!

<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 by the [BP] token of the body plan definition. For example, if you wanted to target the lungs of a creature, you would use BP:BY_CATEGORY:LUNG:ALL. The effect would act on all body parts 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 body parts. Multiple targets can be given in one effect 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 body parts relevant to the contagion, like lungs for coal dust inhalation, or the eyes for exposure to an acid gas.

LOCALIZED (Optional; overrides 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 effect do nothing. This token also makes inhaled syndromes have no effect.
VASCULAR_ONLY (Optional) This effect only affects tissue layers with the VASCULAR token.
MUSCULAR_ONLY (Optional) This effect only affects tissue layers with the MUSCULAR token.
SIZE_DILUTES (Optional) This token presumably causes the severity of the effect 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 an effect according to the size of the victim.
CAN_BE_HIDDEN (Optional) Can be hidden by a unit assuming a secret identity, such as a vampire.[Verify]
RESISTABLE (sic) (Optional) Whether a syndrome can build tolerance by exposure. If this token is present, each application of the syndrome will cause future applications to be weaker. This seems to be a permanent effect that does not fall off over time. (yes, it's spelled incorrectly)
DWF_STRETCH <amount> (Optional) Multiplies the duration values of the effect by the specified amount in Fortress mode.
ABRUPT_START (Optional) Makes the effect begin immediately rather than ramping up.
ABRUPT_END (Optional) Makes the effect end immediately rather than ramping down.
ABRUPT (Optional) Combination of ABRUPT_START and ABRUPT_END.
START Determines the time after exposure, in ticks, when the effect starts. Required for all effects.
PEAK (Optional) Determines the time after exposure, in ticks, when the effect reaches its peak intensity.
END (Optional) Determines the time after exposure, in ticks, when the effect ends.

A key point that needs to be understood with regards to damaging syndrome effects such as bruising is that they deal a quantity of damage (based on the effect's SEV and other modifiers) every tick, and this damage accumulates over time. Thus, even a bruising effect at the lowest possible severity value will eventually lead to destruction of the affected body part(s) if the effect has a long enough duration. Similarly, healing effects undo a specific amount of damage every tick whilst the effect lasts.


Symptomatic Effects[edit]

The following table contains creature effect tokens which cause purely medical symptoms.

Non-targeted effects will ignore any BP tokens and LOCALIZED tokens.

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!

Token Accepts Target Description
CE_BRUISING Yes Causes the targeted body part to undergo bruising.
CE_BLISTERS Yes Covers the targeted body part with blisters.
CE_OOZING Yes Causes pus to ooze from the afflicted body part.
CE_BLEEDING Yes Causes the targeted body part 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_SWELLING Yes Causes the targeted body part to swell up. Extreme swelling may lead to necrosis.
CE_NECROSIS Yes Causes the targeted body part to rot, with associated tissue damage, miasma emission and bleeding. The victim slowly bleeds to death if the wound is not treated. Badly necrotic limbs will require amputation.
CE_NUMBNESS Optional Causes numbness in the affected body part, blocking pain. Extreme numbness may lead to sensory nerve damage. If no target is specified this applies to all body parts.
CE_PAIN Optional Afflicts the targeted body part with intense pain. If no target is specified this applies to all body parts.
CE_PARALYSIS Optional Causes complete paralysis of the affected body part. Paralysis on a limb may lead to motor nerve damage. If no target is specified this causes total paralysis, which can lead to suffocation of smaller creatures.
CE_IMPAIR_FUNCTION Yes An organ afflicted with this effect 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. Note that this effect is currently bugged, and will not "turn off" until the creature receives a wound to cause its body parts to update.
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_UNCONSCIOUSNESS No Renders the creature unconscious.
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_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_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.

Healing Effects[edit]

Most of the above effects have counterparts to alleviate symptoms and heal physical damage:

Token Accepts Target Description
CE_REDUCE_PAIN Yes Decreases the severity of pain produced by wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the pain is decreased.
CE_REDUCE_SWELLING Yes Decreases the severity of swelling on the targeted body part.
CE_REDUCE_PARALYSIS Yes Decreases the severity of any paralysis effects on the targeted body part.
CE_REDUCE_DIZZINESS No Decreases the severity of any dizziness the creature has.
CE_REDUCE_NAUSEA No Decreases the severity of any nausea the creature has.
CE_REDUCE_FEVER No Decreases the severity of any fever the creature has.
CE_STOP_BLEEDING Yes Decreases the severity of the bleeding of any wounds or syndrome effects on the targeted body part. The SEV value probably controls by how much the bleeding is decreased.
CE_CLOSE_OPEN_WOUNDS Yes Closes any wounds on the targeted body part with speed depending on the SEV value.
CE_CURE_INFECTION Yes? Probably decreases the severity of the infection from infected wounds over time.
CE_HEAL_TISSUES Yes Heals the tissues of the targeted body part with speed depending on the SEV value.
CE_HEAL_NERVES Yes Heals the nerves of the targeted body part with speed depending on the SEV value.
CE_REGROW_PARTS Yes Causes missing body parts to regrow. SEV controls how quickly body parts are regrown. In adventure, parts may be lost again once you travel or wait/sleep Bug:0011396.

Special Effects[edit]

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 custom substance or interaction. CE_FEEL_EMOTION is the only one of these that takes SEV.

Token Accepts Target Arguments Description
CE_ADD_TAG No <tag 1>:<tag 2>:etc Adds the specified tag(s) to the affected creature. Multiple tags can be specified sequentially within a single effect token. Valid tags:


Special tags:

  • NO_AGING

Halts the creature's aging process and prevents death by old age.

  • STERILE

Makes the creature unable to produce offspring.

  • HAS_BLOOD
  • MORTAL
  • FIT_FOR_ANIMATION
  • FIT_FOR_RESURRECTION

Adding these tags to a creature doesn't appear to do anything.


Creature tokens:

Adding tags will cause the creature to pass/fail any relevant IT_REQUIRES/IT_FORBIDDEN checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION). Note that CE_REMOVE_TAG overrides this effect.

CE_REMOVE_TAG No <tag 1>:<tag 2>:etc Removes the specified tag(s) from the affected creature. Multiple tags can be specified sequentially within a single effect token. The tags listed above can all be removed via this effect.

If a particular tag is targeted by both CE_REMOVE_TAG and CE_ADD_TAG, and both effects are active simultaneously, CE_REMOVE_TAG takes precedence (i.e. the overall effect is that of tag removal for as long as CE_REMOVE_TAG remains active). The order in which the effects activate doesn't affect this, not even if CE_ADD_TAG is added later/earlier via a different syndrome.

Removing tags will cause the creature to fail/pass any relevant IT_REQUIRES/IT_FORBIDDEN checks (with the apparent exceptions of FIT_FOR_ANIMATION and FIT_FOR_RESURRECTION).


Special tags:

  • HAS_BLOOD

If this tag is removed, the creature behaves as though it has no blood; it doesn't bleed when VASCULAR tissues are damaged (and thus cannot die of blood loss), and substances cannot be injected into it.

  • NO_AGING
  • STERILE

Removing these tags doesn't appear to do anything unless they've been added to a creature via CE_ADD_TAG, in which case their effects will be negated as described above.

  • MORTAL
  • FIT_FOR_ANIMATION
  • FIT_FOR_RESURRECTION

Removing these tags doesn't appear to do anything.

CE_DISPLAY_NAME No NAME:singular:plural:adjective Attaches the specified name to the creature's normal name.
CE_DISPLAY_TILE No TILE:<tile value or character>:<foreground color>:<background color>:<foreground brightness> Causes the creature to display the specified tile instead of its normal one.
CE_FLASH_TILE No TILE:<tile value or character>:<foreground color>:<background color>:<foreground brightness>:FREQUENCY:<frames default tile>:<frames syndrome tile> Causes the creature to flash between its normal tile and the one specified here.
CE_PHYS_ATT_CHANGE No Attribute:percentage:fixed boost(?) Alters the creature's specified physical attribute.
CE_MENT_ATT_CHANGE No Attribute:percentage:fixed boost(?) Alters the creature's specified mental attribute.
CE_SPEED_CHANGE No speed modifier:number Changes the creature's speed.

Speed modifier contains one or both of:

  • 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_SKILL_ROLL_ADJUST No PERC:percentage:PERC_ON:percentage Alters the creature's specified[Verify] skill level. The argument PERC specifies a percentage of the creature's current skill, and PERC_ON the probability of the effect being applied on a particular roll.

e.g. This causes a 20% chance of any skill roll being 0 (multiplies the current skill level by 0/100) instead of the normal result

[CE_SKILL_ROLL_ADJUST:PROB:100:PERC:0:PERC_ON:20:START:0]
CE_BODY_APPEARANCE_MODIFIER No APPEARANCE_MODIFIER:HEIGHT/LENGTH/BROADNESS:percentage(?) Alters the size of the creature.
CE_BP_APPEARANCE_MODIFIER Yes body part:APPEARANCE_MODIFIER:attribute:number Alters the characteristics (height, width etc.) of a body part. "body part" here can either be BP, followed by the usual BY_CATEGORY etc., or TL, followed by the usual selection for SELECT_TISSUE_LAYER.
CE_BODY_TRANSFORMATION No Makes the affected unit transform into a different creature. The target creature may either be specified directly by following this with a CE:CREATURE token, or else set to be randomly selected as indicated by the additional tokens listed below (of which multiple may be specified).

Note that transformation into or out of the target form causes the creature to drop all items in its inventory and instantly heals all of its wounds. If an undead limb happens to be transformed, its entire body will regenerate upon transforming back.

Transformation will also re-roll a creature's age to somewhere within the new form's adult age range. This prevents a 70 year old dwarf from dying the moment it turns into a bat (max age of 3). If it remains stuck as a bat for (at most) three consecutive years it will die of old age as a bat before the syndrome is able to wear off.

A transformed creature generally retains its previous group and civilization membership (unless it becomes OPPOSED_TO_LIFE for example). A transformed dwarf will remain a member of your fortress (and may still hold or gain positions), a transformed trader will hang out at the trade depot and eventually leave along with its fellow traders, and a transformed goblin will continue sieging your fortress with its fellow siege members.

A transformed diplomat (like a trade liaison or expedition leader) will still be able to conduct diplomatic meetings even if they no longer CAN_SPEAK.

Transformed creatures can be trained and adopted following the usual rules. However note that if a transformed creature is a member of your fortress then animal trainers will not attempt to train it.

A transformed creature can produce offspring with creatures of the species it has transformed into and will follow that creature's normal rules for reproduction.

Butchering a transformed creature may produce an odd mix of products. For example, if Urist the dwarf is transformed into a bull and then is led to the butcher's block for slaughter the resulting products will contain some bull creature parts like "Urist's horn", "Urist's hoof", and "Urist's skin" (which becomes "cow leather" when tanned) but will also contain some dwarf creature parts like "dwarf meat", "dwarf eye", and "dwarf brain".


Specific transformation:

  • CE:CREATURE:<creature>:<caste>

This can be used to specify a target creature to transform into ([CE:CREATURE:DWARF:FEMALE], for example). ALL or ANY can be used in place of a specific caste to randomise this for every transformation. Do note that using ALL or ANY for transformation castes will make the creature transform over and over again with the interval depending on the START token. This can lead to an unending transformation loop. However, there is a way to get around this.


Random transformation:

Narrows down the selection to creatures which have the specified creature flag. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.

Excludes creatures with the specified creature flag from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.

Narrows down the selection to creatures which have the specified caste flag. May be used multiple times per transformation effect; creatures which lack any of the indicated flags will never be transformed into.

Excludes any creature with the specified caste flag from the random selection pool. May be used multiple times per transformation effect; creatures which possess any of the indicated flags will never be transformed into.

  • CE:HAVE_FAST_EFFORTLESS_GAIT_SPEED:<minimum gait speed>

Narrows down the selection to creatures which have at least one gait with an <energy expenditure> of 0 and a <max speed> less than or equal to the specified <minimum gait speed> ("less than" because lower is faster in the scale used for gait speed). This is used in generated divination curses to prevent the player from being transformed into a creature that is frustratingly slow to play as. [2]

  • CE:ALL_SLOW_EFFORTLESS_GAIT_SPEED:<maximum gait speed>

Excludes any creatures which have at least one gait with an <energy expenditure> of 0 and a <max speed> value less than or equal to the specified <maximum gait speed> (note that larger values are slower in the scale used for gait speed). [3]

CE_MATERIAL_FORCE_MULTIPLIER No MAT_MULT:<material token>:<value A>:<value B> When the affected creature is struck with a weapon made of the specified material, the force exerted will be multiplied by A/B, thus making the creature more or less susceptible to this material. For example, if A is 2 and B is 1, the force exerted by the defined material will be doubled. If A is 1 and B is 2, it will be halved instead. NONE:NONE can be used in place of a specific material token so as to make the effect applicable to all materials. Note that this syndrome effect is equivalent to the MATERIAL_FORCE_MULTIPLIER creature token.
CE_CAN_DO_INTERACTION No Makes the creature able to perform an interaction. Follow this effect token with [CDI:INTERACTION:<interaction name>] to specify the desired interaction, and add other CDI tokens as required.
CE_SPECIAL_ATTACK_INTERACTION Yes INTERACTION:<interaction name>:BP:<selection criteria>:<name of category,type, or token of designated part/parts> Makes the creature able to perform an interaction when using an attack with a designated body part/parts. See below for an example
CE_BODY_MAT_INTERACTION No MAT_TOKEN:<body material token> This is used to tie an interaction to one of the creature’s body materials. Generated vampire syndromes use this effect to make vampire blood pass on the vampirism curse when consumed.

The target body material is specified by inserting its ID as defined in the creature raws. For example, when a syndrome with “CE_BODY_MAT_INTERACTION:MAT_TOKEN:SWEAT” is gained by a unit, the effect will apply to any material defined as “SWEAT” in the creature raws of that unit, if such a material is present. RESERVED_BLOOD is a special body material token which can be used to specify the [BLOOD] material of any creature, regardless of the material's actual ID.

The following tokens should be placed after this effect:

  • CE:SYNDROME_TAG:<transmission method> is used to specify what must be done with the body material to trigger the interaction. Replace "<transmission method>" with any of SYN_INGESTED, SYN_INJECTED, SYN_CONTACT, SYN_INHALED. Multiple instances of this tag may be used to specify different valid transmission routes. However, SYN_INGESTED appears to be the only one that works at present.
  • CE:INTERACTION:<interaction ID> is used to specify which interaction is to be run (replace "<interaction ID>" with the name of the desired interaction). Appropriate interaction effects with a creature target (such as ADD_SYNDROME) will be inflicted upon the unit who interacts with the body material as specified above. Note that the linked interaction must have an [I_SOURCE:INGESTION] token for this to work.

This currently only works on materials obtained from historical figures. That is to say, the material must bear the source unit's name, such as "Urist McVampire's dwarf blood" as opposed to mere "dwarf blood".

CE_SENSE_CREATURE_CLASS No CLASS:<creature class>:

<tile value or character>: <foreground color>:<background color>:<foreground brightness>

Provides the ability to sense creatures belonging to the specified creature class even when such creatures lie far beyond line of sight, including through walls and floors. It also appears to reduce or negate the combat penalty of blind units when fighting creatures they can sense. In adventure mode, the specified tile will be used to represent sensed creatures when they cannot be seen directly.
CE_FEEL_EMOTION No EMOTION:<emotion> Makes the creature feel a specific emotion. The effect's SEV value determines how intense the emotion is. The creature also receives a thought in the following format: "[creature] feels [emotion] due to [syndrome name]". See Emotion for the list of valid emotions.
CE_CHANGE_PERSONALITY No TRAIT:<personality trait>:<amount> Changes a personality trait by the given amount. Multiple TRAIT:<trait>:<amount> sets may be used, and <amount> can be negative. For example, generated necromancer syndromes come with the following effect:

[CE_CHANGE_PERSONALITY:FACET:ANXIETY_PROPENSITY:50:FACET:TRUST:-50:START:0:ABRUPT]

According to Toady, CE_CHANGE_PERSONALITY effects can cause creatures to re-evaluate their dreams in worldgen; the boost to anxiety and distrust given to necromancers makes it more likely for them to develop the goal of ruling the world. [4]

CE_ERRATIC_BEHAVIOR No Causes erratic behavior, meaning "People that like to brawl have a chance of starting a brawl-level fight with any nearby adult." -Toady

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 Triggers[edit]

[CE:PERIODIC:<period_type>:<min_value>:<max_value>]

When this token is placed after a syndrome effect, it will prevent that effect from working unless within the specified period range.

For example, generated werebeast syndromes have a body transformation effect with [CE:PERIODIC:MOON_PHASE:27:0], which makes the transformation active only throughout moon phases 27 to 0 (the full moon period). Once the moon phase changes from 0 to 1, the transformation will end and remain inactive until phase 27 is reached again (unless of course the effect has an END time which is reached before this happens. On that note, keep in mind that the START time of the effect needs to have been reached for activation to have become possible).

Only one periodic trigger may currently be specified per effect. Counter triggers can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have its conditions met for the effect to be allowed to work.

MOON_PHASE is currently the only valid period type:

Period Description
MOON_PHASE The lunar cycle in Dwarf Fortress is composed of 28 segments (each slightly shorter than a day in duration), with each segment represented by a value ranging from 0 to 27. These correspond to moon phases as follows:
  • 0 = full moon
  • 1-4 = waning gibbous
  • 5-8 = waning half
  • 9-12 = waning crescent
  • 13-14 = new moon
  • 15-18 = waxing crescent
  • 19-22 = waxing half
  • 23-26 = waxing gibbous
  • 27 = full moon

Counter Triggers[edit]

[CE:COUNTER_TRIGGER:<counter_name>:<min_value>:<max_value>:REQUIRED]

Creatures in Dwarf Fortress possess internal counters which keep track of their various activities and statuses. When this token is placed after a syndrome effect, it will prevent the effect from working unless the affected creature has the indicated counter, and its value lies within the specified range.

For example, generated vampire syndromes use [CE:COUNTER_TRIGGER:DRINKING_BLOOD:1:NONE:REQUIRED] with an appearance modifier to make the vampire's teeth temporarily lengthen whilst leeching blood.

Note that NONE can be used in place of <max_value> to indicate that any value above <min_value> is valid. NONE can also be used in place of <min_value>, which is equivalent to the lowest value attainable by a counter.

REQUIRED implies that the effect won't proceed if the counter exists but doesn't lie within the range provided. However, it's actually redunant as COUNTER_TRIGGER always checks for both of these conditions [5]; replacing it with NONE doesn't alter the way the trigger functions, though it will fail to work if this slot is left empty instead.

As detailed below, most counters only exist temporarily, so their use as triggers is somewhat more restricted than intuition suggests. For example, specifying 0 or NONE as the <min_value> for a CAVE_ADAPT trigger wouldn't permit the effect to work when the affected creature is outside, since this counter is removed from the unit as soon as its value decreases past 1. Similarly, MILK_COUNTER is only present for some time after a creature is milked.

Multiple counter triggers can be specified per effect, in which case the effect will be permitted to work if at least one of the trigger conditions is met. A periodic trigger can also be specified for the same effect, in which case both the periodic trigger and at least one counter trigger will need to have their conditions met for the effect to work.

The following is a list of valid counter types including a couple of notable values:

Counter Description
ALCOHOLIC For [ALCOHOL_DEPENDENT] creatures, this counter increases by 1 each tick, and is reset to 0 when the creature drinks alcohol. The following messages are added after "needs alcohol to get through the working day" in the creature's description when the counter reaches the specified values:
  • 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 (s)he had some
CAVE_ADAPT For creatures with the [CAVE_ADAPT] token, this counter is created and increases by 1 each tick when the creature is in the Dark, and decreases by 10 each tick when Outside. The counter is removed if it decreases to 0. See cave adaptation for more information.
  • 403200 (1 year) = going outside causes irritation
  • 604800 (1.5 years) = going outside causes nausea
MILK_COUNTER When a creature is milked, this counter is created and set to the frequency value specified in the creature's [MILKABLE] token, and subsequently decreases by 1 each tick until it reaches 0, at which point it is immediately removed, making the creature available for milking again.
EGG_SPENT This counter is created and set to 100800 (3 months' worth of ticks in fortress mode) when a creature lays eggs, and thereafter decreases by 1 each tick until it reaches 0, at which point it is removed and the creature regains the ability to lay eggs.
GROUNDED_ANIMAL_ANGER How angry (and likely to attack) an animal is from being in an overcrowded location. The counter is created and set to 200 when the animal is forced to lie on the ground whilst sharing a tile with another creature. It subsequently decreases by 1 each tick, but this is overcome by the addition of 200 every so often (with a variable delay between each spike) if the creature remains grounded. The counter is removed if it decreases to 0.
TIME_SINCE_SUCKED_BLOOD This counter rises by 1 every tick for creatures with the [BLOODSUCKER] token. When it rises high enough (generally around 100800; 3 months in fortress mode time), the creature will seek an unconscious victim to leech off of. Blood-sucking causes the counter to decrease, and will continue until either the victim is dead or the counter reaches 0. Note that this counter isn't removed when 0 is reached.

When playing as a bloodsucker in adventure mode, the following bloodthirst indicators are displayed when this counter reaches the specified values:

  • 172800 (1 day in adventure mode time) = Thirsty
  • 1209600 (1 week) = Thirsty!
  • 2419200 (2 weeks) = Thirsty!

Various penalties are applied as bloodthirst increases; see the vampire article for more information.

DRINKING_BLOOD This appears to be created and set to a fixed value of 20 whilst the creature is sucking blood, and begins to decrease by 1 each tick once blood-sucking ceases (as described above) until it reaches 0, at which point the counter is removed.

Inorganic syndromes and you![edit]

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.

 [MELTING_POINT:NONE]
 [BOILING_POINT:10000]
 [MAT_FIXED_TEMP:10001]
 [SPEC_HEAT:1]

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 SYN_INHALED syndrome you thoughtfully attached to the material definition earlier! Note that creatures do not need to inhale every tick, so there is a chance that the gas will dissipate before it can infect any particular creature.

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 definition tokens.

Spreading diseases[edit]

It's fully possible to make a nasty disease capable of spreading itself from an infected dwarf to others, though it requires some skill in modding interactions as well. Here is an example of a plague-inflicting interaction:

 [INTERACTION:PLAGUE]
 	[I_TARGET:A:CREATURE]
 		[IT_LOCATION:CONTEXT_CREATURE]
 		[IT_FORBIDDEN:NOT_LIVING]
 		[IT_AFFECTED_CLASS:GENERAL_POISON]
 		[IT_MANUAL_INPUT:creatures]
 	[I_EFFECT:ADD_SYNDROME]
 		[IE_TARGET:A]
 		[IE_IMMEDIATE]
 		[SYNDROME]
 			[SYN_NAME:the plague]
 			[SYN_AFFECTED_CLASS:GENERAL_POISON]
 			[CE_FEVER:SEV:250:PROB:100:START:250:PEAK:1500:END:25000]
 			[CE_BLISTERS:SEV:325:PROB:100:BP:BY_CATEGORY:ALL:SKIN:START:250:PEAK:1500:END:25000]
 			[CE_NECROSIS:SEV:300:PROB:100:BP:BY_CATEGORY:ALL:ALL:VASCULAR_ONLY:START:22500:PEAK:23750:END:25000]
 			[CE_CAN_DO_INTERACTION:START:1500:END:25000]
 				[CDI:ADV_NAME:Spread the plague]
 				[CDI:INTERACTION:PLAGUE]
 				[CDI:TARGET:A:LINE_OF_SIGHT]
 				[CDI:TARGET_RANGE:A:10]
 				[CDI:WAIT_PERIOD:30]

As you can see, the syndrome here inflicts blisters, fever and, after roughly a month, necrosis of the whole body - that's when the infected creatures will start dying out. But before that happens, CE_CAN_DO_INTERACTION makes them capable of spreading the plague further.

You also need a disease vector that will bring the plague straight to your fort. (hint: use various species of rats - they're perfect for that). The following code, added to a creature's raws, ensures the creature will infect anybody it encounters:

 [CAN_DO_INTERACTION:PLAGUE]
 	[CDI:ADV_NAME:Spread the plague]
 	[CDI:TARGET:A:LINE_OF_SIGHT]
 	[CDI:TARGET_RANGE:A:10]
 	[CDI:WAIT_PERIOD:30]

As soon as the said creature is startled by your dwarves, the fun will begin.

In 0.47.01[edit]

As of version 0.47.01, it may be possible to use a creature's established methods of attack for use in disease-spreading.

Let's use the borrowed example of the plague above. This time, the plague will spread through biting, using the following syndrome code:

 [INTERACTION:PLAGUE]
 	[I_TARGET:A:CREATURE]
 		[IT_LOCATION:CONTEXT_CREATURE]
 		[IT_FORBIDDEN:NOT_LIVING]
 		[IT_AFFECTED_CLASS:GENERAL_POISON]
 		[IT_MANUAL_INPUT:creatures]
 	[I_EFFECT:ADD_SYNDROME]
 		[IE_TARGET:A]
 		[IE_IMMEDIATE]
 		[SYNDROME]
 			[SYN_NAME:the plague]
 			[SYN_AFFECTED_CLASS:GENERAL_POISON]
 			[CE_FEVER:SEV:250:PROB:100:START:250:PEAK:1500:END:25000]
 			[CE_BLISTERS:SEV:325:PROB:100:BP:BY_CATEGORY:ALL:SKIN:START:250:PEAK:1500:END:25000]
 			[CE_NECROSIS:SEV:300:PROB:100:BP:BY_CATEGORY:ALL:ALL:VASCULAR_ONLY:START:22500:PEAK:23750:END:25000]
 			[CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:PLAGUE:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT]


The line [CE_SPECIAL_ATTACK_INTERACTION:INTERACTION:BITE_PLAGUE:BP:BY_CATEGORY:MOUTH:BP:BY_CATEGORY:TOOTH:START:0:ABRUPT] allows any infected creature with an attack using mouth or tooth category body parts to immediately spread the disease using said attack. The victim of the attack may then spread the disease if they are able to attack with the needed body part/parts.

Multi-caste/multi-creature body transformations[edit]

This is a way to get around the looping problem when using ANY or ALL castes for CE_BODY_TRANSFORMATION and not being limited to a single creature for transformations. It's an incredibly simple solution as you can see in this example code:

[SYNDROME]
	[SYN_NAME:draconic curse]
	[SYN_CLASS:DRACONIC_CURSE]
	[CE_BODY_TRANSFORMATION:PROB:25:START:0]
			[CE:CREATURE:HYDRA:MALE]
	[CE_BODY_TRANSFORMATION:PROB:25:START:0]
			[CE:CREATURE:DRAGON:MALE]
	[CE_BODY_TRANSFORMATION:PROB:25:START:0]
			[CE:CREATURE:HYDRA:FEMALE]
	[CE_BODY_TRANSFORMATION:PROB:100:START:0]
			[CE:CREATURE:DRAGON:FEMALE]

This code will transform a creature into either a female/male hydra or a female/male dragon.

For every caste/creature you want a victim to transform into, you add a [CE_BODY_TRANSFORMATION] token with a [PROB] token attached to it. For most of the transformations the PROB is set to 1/number_of_transformations * 100 (or a different number if you want uneven odds), but the final transformation needs a PROB of 100 to ensure there is always at least one transformation chosen. A creature can only have one active transformation at a time. If any of the lower PROB transformations occurs then the PROB 100 transformation can not happen.

If you instead want a sequence of transformations to take place then you need make sure that one transformation ends on the same tick that the next one begins:

[SYNDROME]
	[SYN_NAME:draconic sequence curse]
	[SYN_CLASS:DRACONIC_SEQUENCE_CURSE]
	[CE_BODY_TRANSFORMATION:PROB:100:START:0:END:10]
			[CE:CREATURE:HYDRA:MALE]
	[CE_BODY_TRANSFORMATION:PROB:100:START:10:END:20]
			[CE:CREATURE:DRAGON:MALE]
	[CE_BODY_TRANSFORMATION:PROB:100:START:20:END:30]
			[CE:CREATURE:HYDRA:FEMALE]
	[CE_BODY_TRANSFORMATION:PROB:100:START:30:END:40]
			[CE:CREATURE:DRAGON:FEMALE]

See also[edit]