Editing v0.34:Syndrome

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

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

==List of syndromes==
{| {{prettytable}}
|- bgcolor="#dddddd"
! Syndrome
! Venom
! Acquired
! Short-term Symptoms
! Long-term Symptoms
! Chronic Symptoms 
|-
| Adder bite
| adder venom (injected)
| Being bitten by an [[adder]], [[giant adder]] or [[adder man]]
| Strong pain
| Swelling<br>Blisters<br>Nausea
| 
|-
| 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<br>Drowsiness<br>Strong pain<br>Fever<br>Unconsciousness<br>Complete paralysis<sup>1</sup>
| 
| 
|-
| Blob blisters
| cave blob fluid<br />(contact or ingested)
| Touching a [[cave blob]]
| Mild pain<br/>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<br>Fever<br>Pain<br>
| Severe localized necrosis
| 
|-
| Bumblebee sting
| bumblebee venom (injected)
| Being stung by a [[bumblebee]] worker
| Pain<br>Strong swelling
| 
| 
|-
| Bushmaster bite
| bushmaster venom (injected)
| Being bitten by a [[bushmaster]], [[giant bushmaster]] or [[bushmaster man]]
| Strong pain<br>Mild bleeding<br>Dizziness<br>Nausea<br>Unconsciousness<br>Complete paralysis<sup>1</sup>
| 
| 
|-
| Cave floater sickness
| cave floater gas<br />(inhaled or ingested)
| Expelled from [[cave floater]]
| Mild nausea
| Fever<br/>Strong drowsiness (delayed)<br/>Strong dizziness (delayed)
| None
|-
| Cave spider bite
| cave spider venom<br />(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<br>Swelling<br>Nausea
| 
| 
|-
| Giant cave spider bite
| giant cave spider venom<br />(injected)
| Being bitten by a [[giant cave spider]]
| Complete paralysis<sup>1</sup><br/>'''Being eaten by the GCS'''
| None, not that it really matters.
| None
|-
| Gila monster bite
| gila monster venom (injected)
| Being bitten by a [[gila monster]], [[giant gila monster]] or [[gila monster man]]
| Pain<br>Mild swelling
| 
| 
|-
| Gnomeblight
| [[gnomeblight]]<br />(contact, inhaled, injected, or ingested)
| Unknown. Affects gnomes only
| None
| Severe systemic necrosis<sup>2</sup>
| None
|-
| Giant desert scorpion sting
| giant desert scorpion venom<br />(injected)
| Being stung by a [[giant desert scorpion]]
| 
| Necrosis of the brain and nervous system<sup>2</sup>
| '''Unavoidable death'''
|- 
| Helmet snake bite
| helmet snake venom<br />(injected)
| Being bitten by a [[helmet snake]]
| Minor bleeding
| Fever<br/>Nausea<br/>Dizziness<br/>Localized swelling<br/>Localized oozing<br/>Localized bruising<br/>Strong pain<br/>Intense localized necrosis<br/>Possible loss of limb 
| None
|-
| Honey bee sting
| honey bee venom (injected)
| Being stung by a [[honey bee]] worker
| Pain<br>Strong swelling
| 
| 
|-
| Iron man cough
| iron man gas<br />(inhaled)
| Expelled by [[iron man]]
| Coughing blood
| None
| None
|-
| King cobra bite
| king cobra venom<br />(injected)
| Being bitten by a [[king cobra]]
| Complete paralysis<sup>1</sup><br/>Pain, dizziness, drowsiness
| None
| None
|-
| Phantom spider bite
| phantom spider venom<br />(injected)
| Being bitten by a [[phantom spider]]
| None
| Numbness and mild dizziness
| None
|-
| Platypus sting
| platypus venom<br />(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<br />(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<br />(injected)
| Being bitten by a [[serpent man]]
| Complete paralysis<sup>1</sup>
| None
| None
|-
| [evil rain] sickness<sup>3</sup>
|rowspan=5| random
| Being caught outside in freakish weather in an evil biome
|rowspan=5| random
|rowspan=5| random
|rowspan=5| random
|-
| [evil cloud] sickness<sup>4</sup>
| Being caught in a creeping cloud in an evil biome
|-
| beast sickness<sup>5</sup>
| Encounters with [[forgotten beast]]s
|-
| titan sickness<sup>5</sup>
| Encounters with [[titan]]s
|-
| demon sickness<sup>5</sup>
| Encounters with [[demon]]s
|}
:<small>1. For small creatures such as humans and dwarves, paralysis tends to result in suffocation.</small>
:<small>2. Necrosis of the brain will eventually result in death once the brain rots away completely.</small>
:<small>3. Evil rain typically only causes minor symptoms such as blisters, bruising, coughing blood, dizziness, fever, nausea, oozing, and pain.</small>
:<small>4. Evil clouds either cause major symptoms (as with beast/titan/demon sicknesses) or permanently transform creatures into [[Undead|zombie-like]] forms.</small>
:<small>5. [[Titan]]s, [[forgotten beast]]s, and [[demon]]s have a chance to have a randomized syndrome. These range from pointless (mild blisters from inhaling boiling blood) to instantly fatal (severe necrosis from a contact poison attached to a breath weapon/creature made of blood).</small>

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

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

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

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

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

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


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


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

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

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


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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

The most important part is this line:

  [CDI:MATERIAL:LOCAL_CREATURE_MAT:CUSTOMMATERIAL:TRAILING_VAPOR_FLOW]

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

  [CDI:TARGET:C:LINE_OF_SIGHT]

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

===Breath Attack Types===

{| {{prettytable}}
|- bgcolor="#ddd"
! Token
! Description
|-
| TRAILING_DUST_FLOW
| Lets out a cloud of solid dust. Appears to use cave-in dust physics, causing this to fling around anything it comes in contact with, making it capable of smashing creatures into the ground and flinging them over walls. Creature will attack as normal.
|-
| TRAILING_VAPOR_FLOW
| Shoots a trail of liquid mist at the target which can condense and trigger contact syndromes. Creature will attack as normal.
|-
| TRAILING_GAS_FLOW
| Shoots a trail of gas substance at the creature which can be inhaled. Creature will attack as normal.
|-
| SOLID_GLOB
| Shoots a solid glob of spinning substance at the creature, leaving symbols similar to broken arrows. Essentially a projectile weapon. If the cooldown rate is short enough, some creatures with this breath attack will not move, preferring instead to stay and shoot globs at you, even when you are literally right next to them.
|-
| LIQUID_GLOB
| Shoots a "liquid" glob of spinning substance at the creature, behaving mostly the same as SOLID_GLOB but using the material's ''liquid'' density when calculating impact force and damage.
|-
| SPATTER_POWDER
| Creates a pile of powder at the specified location.
|-
| SPATTER_LIQUID
| Creates a pool of liquid at the specified location.
|-
| UNDIRECTED_GAS
| Creature occasionally releases a cloud of gas substance. Similar to TRAILING_GAS_FLOW, but undirected, thus affecting a larger area but losing the distance. Creature will attack as normal.
|-
| UNDIRECTED_VAPOR
| Creature occasionally releases a cloud of liquid mist. Similar to TRAILING_VAPOR_FLOW, but undirected, thus affecting a larger area but losing the distance. Creature will attack as normal.
|-
| UNDIRECTED_DUST
| Creature occasionally releases a cloud of solid dust, which will spread and dissipate. Similar to TRAILING_DUST_FLOW, but undirected, thus affecting a larger area but losing the distance - range is roughly the same as that of a cave-in. Creature will attack as normal. <s>DO NOT USE THIS TAG UNLESS YOU WANT TO KILL THE CREATURE AND EVERYTHING NEAR IT AND SEND PEOPLE FLYING.</s> You know you want to.
|-
| WEB_SPRAY
| Emits a burst of [[web]]s that entangle target creatures.
|-
| DRAGONFIRE
| Emits a wide cone of [[dragon]] [[fire]] that burns target creatures at a scorching {{ct|50000}}. For this you want FLOW instead of a material.
|-
| FIREJET
| Emits a narrow cone of [[fire]] that burns target creatures at {{ct|11000}}. For this you want FLOW instead of a material.
|-
| FIREBALL
| Emits a fireball that burns the target creature. For this you want FLOW instead of a material.
|-
| WEATHER_CREEPING_GAS
| Creates a cloud of gas that appears at the edge of the map and slowly creeps across the map. Not usable by creatures.
|-
| WEATHER_CREEPING_VAPOR
| Creates a cloud of creeping vapor. Not usable by creatures.
|-
| WEATHER_CREEPING_DUST
| Creates a cloud of creeping dust. Not usable by creatures.
|-
| WEATHER_FALLING_MATERIAL
| Causes it to start raining a particular material.  If the material is solid at the outdoor temperatures, it will snow the material instead.  Regardless of the nature of the material, being caught in it will give dwarves the bad thought of being 'caught in freakish weather lately'. Not usable by creatures.
|}

Keep in mind that you can use multiple breath attacks, which appears to make the creature choose between them at random.  Creatures cannot use the WEATHER effects, these being reserved for regional interactions.

One major difference between GAS, VAPOR, and DUST is that if the material cannot exist in the specified state at the current temperature, it will automatically be created at a temperature allowing it to exist.  So if you create a vapor spray that uses rock or metal as a material, that spray will be created at the material's melting point, setting everything it touches on fire.  You can also create a freezing spray by using a custom material that has extremely low melting and/or boiling points.

If you give a creature a material breath attack, be aware that it will be caught in the attack more frequently than its own targets.  Make sure to make your creatures immune to their own breath weapons!

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