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.

Editing Interaction token

Jump to navigation Jump to search

Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.

If you are creating a redirect to the current version's page, do not use any namespace. For example: use #REDIRECT [[Cat]], not #REDIRECT [[Main:Cat]] or #REDIRECT [[cv:Cat]]. See DF:Versions for more information.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
{{Quality|Fine}}
 
 
{{av}}
 
{{av}}
{{Modding}}
 
  
The following [[token]]s can be used to define and use interactions. (''It appears that, at least in order to make the big list make a little more sense, [[Necromancer#Modding|some]]  [[Interaction_examples|examples]] of those may be necessary.'')
+
The following [[token]]s can be used to define and use interactions.
 
 
__TOC__
 
{{clear}}
 
  
 
==Definitions==
 
==Definitions==
Line 23: Line 18:
  
 
|-
 
|-
| {{text anchor|EXPERIMENT_ONLY}}
+
| {{text anchor|EXPERIMENT_ONLY}}{{version|0.47.01}}
 
| Global
 
| Global
 
|  
 
|  
| Disallows use of the interaction in play, but if the interaction animates or resurrects corpses, or has an I_SOURCE:EXPERIMENT tag, it can be used in worldgen. Animation and resurrection interactions do not need I_SOURCE:EXPERIMENT to work in worldgen.
+
| This disallows use of the interaction in play, and also encourages usage specifically to create experimental populations. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8083872#msg8083872]
  
 
|-
 
|-
Line 34: Line 29:
 
| Defines what things are capable of triggering this interaction - multiple sources may be specified. Valid values:
 
| Defines what things are capable of triggering this interaction - multiple sources may be specified. Valid values:
 
* '''CREATURE_ACTION''' - Specifies that the interaction may be used in conjunction with [[Creature_token#CAN_DO_INTERACTION|[CAN_DO_INTERACTION]]] and [[Syndrome#CE_CAN_DO_INTERACTION|[CE_CAN_DO_INTERACTION]]], but it isn't actually necessary for this. It might exist simply to allow for the inclusion of IS_ tokens (detailed below) to be applied when the interaction is used in this context.
 
* '''CREATURE_ACTION''' - Specifies that the interaction may be used in conjunction with [[Creature_token#CAN_DO_INTERACTION|[CAN_DO_INTERACTION]]] and [[Syndrome#CE_CAN_DO_INTERACTION|[CE_CAN_DO_INTERACTION]]], but it isn't actually necessary for this. It might exist simply to allow for the inclusion of IS_ tokens (detailed below) to be applied when the interaction is used in this context.
* '''ATTACK''' - Allows the interaction to be used in conjunction with [[Creature_token#SPECIALATTACK_INTERACTION|[SPECIALATTACK_INTERACTION]]] and [[Syndrome#CE_SPECIAL_ATTACK_INTERACTION|[CE_SPECIAL_ATTACK_INTERACTION]]].
+
* '''ATTACK''' - Allows the interaction to be used in conjunction with [[Creature_token#SPECIALATTACK_INTERACTION|[SPECIALATTACK_INTERACTION]]] and [[Syndrome#Special_Effects|[CE_SPECIAL_ATTACK_INTERACTION]]].
 
* '''INGESTION''' - Allows the interaction to be used in conjunction with [[Syndrome#CE_BODY_MAT_INTERACTION|[CE_BODY_MAT_INTERACTION]]].
 
* '''INGESTION''' - Allows the interaction to be used in conjunction with [[Syndrome#CE_BODY_MAT_INTERACTION|[CE_BODY_MAT_INTERACTION]]].
 
* '''DEITY''' - Allows the interaction to be inflicted upon mortals by the gods, for reasons dictated by [[Interaction_token#IS_USAGE_HINT|[IS_USAGE_HINT]]].
 
* '''DEITY''' - Allows the interaction to be inflicted upon mortals by the gods, for reasons dictated by [[Interaction_token#IS_USAGE_HINT|[IS_USAGE_HINT]]].
Line 40: Line 35:
 
* '''REGION''' - Allows the interaction to take place spontaneously in regions specified using [[Interaction_token#IS_REGION|[IS_REGION]]]. Also see [[Interaction_token#IS_FREQUENCY|[IS_FREQUENCY]]] and [[Interaction_token#IE_INTERMITTENT|[IE_INTERMITTENT]]].
 
* '''REGION''' - Allows the interaction to take place spontaneously in regions specified using [[Interaction_token#IS_REGION|[IS_REGION]]]. Also see [[Interaction_token#IS_FREQUENCY|[IS_FREQUENCY]]] and [[Interaction_token#IE_INTERMITTENT|[IE_INTERMITTENT]]].
 
* '''DISTURBANCE''' - Allows the interaction to take place spontaneously in disturbed [[tomb|tombs]]; generated interactions with this token are used to create [[mummy|mummies]].
 
* '''DISTURBANCE''' - Allows the interaction to take place spontaneously in disturbed [[tomb|tombs]]; generated interactions with this token are used to create [[mummy|mummies]].
* '''UNDERGROUND_SPECIAL''' - Allows the interaction to take place spontaneously in [[Demonic fortress|curious underground structures]] (which no longer generate); generated interactions with this token used to be used to produce [[undead|zombies]] when creating the structure's inhabitants.
+
* '''UNDERGROUND_SPECIAL''' - Allows the interaction to take place spontaneously in [[Demonic fortress|curious underground structures]] (which have since been removed {{version|0.40.01}}); generated interactions with this token used to be used to produce [[undead|zombies]] when creating the structure's inhabitants.
* '''EXPERIMENT''' - This can be used by NIGHT_CREATURE_EXPERIMENTERs while "performing horrible experiments" in worldgen. Only seems relevant for interactions that target living creatures. Note that all NIGHT_CREATURE_EXPERIMENTERs have access to generated experiments, and due to the large number of generated experiments available custom experiment interactions will tend to show up very rarely.
+
* '''EXPERIMENT''' - Allows the interaction to be used when experimenting on creatures. [http://www.bay12forums.com/smf/index.php?topic=175437.msg8083510#msg8083510]
  
 
|-
 
|-
Line 60: Line 55:
  
 
|-
 
|-
| {{text anchor|IS_TRIGGER_STRING}}
+
| {{text anchor|IS_TRIGGER_STRING}}{{version|0.47.01}}
 
| Within I_SOURCE
 
| Within I_SOURCE
 
| text
 
| text
Line 68: Line 63:
  
 
|-
 
|-
| {{text anchor|IS_TRIGGER_STRING_SECOND}}
+
| {{text anchor|IS_TRIGGER_STRING_SECOND}}{{version|0.47.01}}
 
| Within I_SOURCE
 
| Within I_SOURCE
 
| text
 
| text
Line 76: Line 71:
  
 
|-
 
|-
| {{text anchor|IS_TRIGGER_STRING_THIRD}}
+
| {{text anchor|IS_TRIGGER_STRING_THIRD}}{{version|0.47.01}}
 
| Within I_SOURCE
 
| Within I_SOURCE
 
| text
 
| text
Line 114: Line 109:
 
* '''SEE_THE_GREAT_NATURAL_SITES'''
 
* '''SEE_THE_GREAT_NATURAL_SITES'''
 
* '''IMMORTALITY'''
 
* '''IMMORTALITY'''
* '''MAKE_A_GREAT_DISCOVERY'''
+
However, currently only IMMORTALITY will result in a secret being pursued during world-gen.
* '''ATTAIN_RANK_IN_SOCIETY'''
 
* '''BATHE_WORLD_IN_CHAOS'''
 
However, currently only IMMORTALITY will result in a secret being pursued during worldgen.
 
  
 
|-
 
|-
Line 125: Line 117:
 
| Indicates how the secret can be learned. Valid values:
 
| Indicates how the secret can be learned. Valid values:
 
* '''SUPERNATURAL_LEARNING_POSSIBLE''' - gods may gift the secret to their worshippers. Secrets with [[Interaction_token#IS_SPHERE|[IS_SPHERE]]] specified may only be granted by gods who have at least one matching sphere.
 
* '''SUPERNATURAL_LEARNING_POSSIBLE''' - gods may gift the secret to their worshippers. Secrets with [[Interaction_token#IS_SPHERE|[IS_SPHERE]]] specified may only be granted by gods who have at least one matching sphere.
* '''MUNDANE_RESEARCH_POSSIBLE''' - the secret can be researched by mundane means. This doesn't do anything at present. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222].
+
* '''MUNDANE_RESEARCH_POSSIBLE''' - the secret can be researched by mundane means
 
* '''MUNDANE_TEACHING_POSSIBLE''' - the secret can be taught to apprentices
 
* '''MUNDANE_TEACHING_POSSIBLE''' - the secret can be taught to apprentices
* '''MUNDANE_RECORDING_POSSIBLE:TITLE_SET:NAME_SET''' - the secret can be written in books whose title and name are taken from the specified text sets. If this tag is present, a slab will be created upon learning the secret by supernatural means.
+
* '''MUNDANE_RECORDING_POSSIBLE:objects/text/(book_title).txt:objects/text/(book_topic).txt''' - the secret can be written in books with the specified title. If this tag is present, a slab will be created upon learning the secret by supernatural means.
  
 
|-
 
|-
Line 133: Line 125:
 
| Within I_SOURCE:DEITY
 
| Within I_SOURCE:DEITY
 
| Usage Hint token
 
| Usage Hint token
| Indicates why a deity would choose to perform this interaction. See [[Interaction_token#USAGE_HINT|CDI:USAGE_HINT]] below for valid values - in this context, '''MINOR_BLESSING''', '''MEDIUM_BLESSING''', '''MINOR_CURSE''', '''MEDIUM_CURSE''', and '''MAJOR_CURSE''' are the only values that make sense.
+
| Indicates why a deity would choose to perform this interaction. See [[Interaction_token#USAGE_HINT|CDI:USAGE_HINT]] below for valid values - in this context, '''MINOR_BLESSING'''{{version|0.47.01}}, '''MEDIUM_BLESSING'''{{version|0.47.01}}, '''MINOR_CURSE'''{{version|0.47.01}}, '''MEDIUM_CURSE'''{{version|0.47.01}}, and '''MAJOR_CURSE''' are the only values that make sense.
  
 
|-
 
|-
Line 197: Line 189:
 
* '''CONTEXT_REGION''' - Can only be used by [[Interaction_token#I_SOURCE|[I_SOURCE:REGION]]] interactions.
 
* '''CONTEXT_REGION''' - Can only be used by [[Interaction_token#I_SOURCE|[I_SOURCE:REGION]]] interactions.
 
* '''CONTEXT_MATERIAL''' - Used with MATERIAL if you want an [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] to obtain the emission material/flow type from [[Interaction_token#MATERIAL|[CDI:MATERIAL]]] or [[Interaction_token#FLOW|[CDI:FLOW]]].
 
* '''CONTEXT_MATERIAL''' - Used with MATERIAL if you want an [[Interaction_token#I_EFFECT|[I_EFFECT:MATERIAL_EMISSION]]] to obtain the emission material/flow type from [[Interaction_token#MATERIAL|[CDI:MATERIAL]]] or [[Interaction_token#FLOW|[CDI:FLOW]]].
* '''RANDOM_NEARBY_LOCATION''' - Used with LOCATION. Targets a location from somewhere random within a number of squares from another LOCATION target specified by its target ID. For example, [I_TARGET:B:LOCATION] with [IT_LOCATION:RANDOM_NEARBY_LOCATION:A:5] will randomly select a tile lying somewhere within a radius of 5 tiles from [I_TARGET:A:LOCATION]. A walkable path between the two locations must exist.
+
* '''RANDOM_NEARBY_LOCATION'''{{version|0.47.01}} - Used with LOCATION. Targets a location from somewhere random within a number of squares from another LOCATION target specified by its target ID. For example, [I_TARGET:B:LOCATION] with [IT_LOCATION:RANDOM_NEARBY_LOCATION:A:5] will randomly select a tile lying somewhere within a radius of 5 tiles from [I_TARGET:A:LOCATION]. A walkable path between the two locations must exist.
  
 
|-
 
|-
Line 274: Line 266:
 
| type
 
| type
 
| Specifies what the interaction does to the targets. Multiple [I_EFFECT]s may be specified in a single interaction, and the same type may be used more than once. Valid values:
 
| Specifies what the interaction does to the targets. Multiple [I_EFFECT]s may be specified in a single interaction, and the same type may be used more than once. Valid values:
 
+
* '''ADD_SYNDROME''' - Adds one or more syndromes to a valid creature target.  You must specify the syndrome details just below this interaction effect using the [SYNDROME] tag followed by the relevant syndrome tokens. See [[syndrome#The anatomy of a syndrome|here]] for more information.
* '''ADD_SYNDROME''' - Adds one or more syndromes to a valid creature target.  You must specify the syndrome details just below this interaction effect using the <code>[[Syndrome#SYNDROME|[SYNDROME]]]</code> tag followed by the relevant syndrome tokens. See [[syndrome#The anatomy of a syndrome|here]] for more information.
 
 
 
 
* '''ANIMATE''' - Raises the target corpse/bodypart as an [[undead]] unit. The zombie will always be hostile to life and will retain no information about its original personality/loyalties. Syndromes can also be specified within this tag. If a regional interaction contains this effect, affected regions will have undead wildlife.
 
* '''ANIMATE''' - Raises the target corpse/bodypart as an [[undead]] unit. The zombie will always be hostile to life and will retain no information about its original personality/loyalties. Syndromes can also be specified within this tag. If a regional interaction contains this effect, affected regions will have undead wildlife.
 
 
* '''RESURRECT''' - Takes a target corpse and returns the creature to life.  This can be used on parts that are not FIT_FOR_RESURRECTION, but only the main part (with an UPPERBODY attached) will remain loyal to its original faction.  Syndromes can also be specified within this tag.
 
* '''RESURRECT''' - Takes a target corpse and returns the creature to life.  This can be used on parts that are not FIT_FOR_RESURRECTION, but only the main part (with an UPPERBODY attached) will remain loyal to its original faction.  Syndromes can also be specified within this tag.
 
+
* '''CLEAN''' - Removes [[Contaminant|contaminants]] from a valid creature target. See [[Interaction_token#IE_GRIME_LEVEL|[IE_GRIME_LEVEL]]] and [[Interaction_token#IE_SYNDROME_TAG|[IE_SYNDROME_TAG]]].
* '''CLEAN''' - Removes [[Contaminant|contaminants]] from a valid creature target. See {{token|IE_GRIME_LEVEL|in}}  and {{token|IE_SYNDROME_TAG|in}}.
 
 
 
 
* '''CONTACT''' - Causes the creatures to touch.
 
* '''CONTACT''' - Causes the creatures to touch.
 
 
* '''MATERIAL_EMISSION''' - Causes a particular material to be emitted. Used by [[evil weather]] and the MATERIAL_EMISSION interaction.
 
* '''MATERIAL_EMISSION''' - Causes a particular material to be emitted. Used by [[evil weather]] and the MATERIAL_EMISSION interaction.
 
+
* '''HIDE''' - Allows the creature to hide even if another creature can see it.
* '''HIDE''' - Allows the creature to [[Ambusher|hide]] even if another creature can see it.
+
* '''CREATE_ITEM'''{{version|0.47.01}} - Creates an item as described by [[Interaction_token#IE_ITEM|[IE_ITEM]]] and [[Interaction_token#IE_ITEM_QUALITY|[IE_ITEM_QUALITY]]].
 
+
* '''CHANGE_ITEM_QUALITY'''{{version|0.47.01}} - Alters an item's quality level as indicated by either [[Interaction_token#IE_CHANGE_QUALITY|[IE_CHANGE_QUALITY]]] or [[Interaction_token#IE_SET_QUALITY|[IE_SET_QUALITY]]]. When targeting a unit, all items equipped by that unit will be affected.
* '''CREATE_ITEM''' - Creates an item as described by {{token|IE_ITEM|in}} and {{token|IE_ITEM_QUALITY|in}}.
+
* '''SUMMON_UNIT'''{{version|0.47.01}} - Creates a new unit at the target. The type of unit can either be specified using the [[Interaction_token#CREATURE|[CREATURE]]] token, or made to be randomly selected as indicated by a variety of flag-based tokens: [[Interaction_token#IE_CREATURE_FLAG|[IE_CREATURE_FLAG]]], [[Interaction_token#IE_FORBIDDEN_CREATURE_FLAG|[IE_FORBIDDEN_CREATURE_FLAG]]], [[Interaction_token#IE_CREATURE_CASTE_FLAG|[IE_CREATURE_CASTE_FLAG]]] and/or [[Interaction_token#IE_FORBIDDEN_CREATURE_CASTE_FLAG|[IE_FORBIDDEN_CREATURE_CASTE_FLAG]]]. See also [[Interaction_token#IE_TIME_RANGE|[IE_TIME_RANGE]]] and [[Interaction_token#IE_MAKE_PET_IF_POSSIBLE|[IE_MAKE_PET_IF_POSSIBLE]]].
 
+
* '''PROPEL_UNIT'''{{version|0.47.01}} - Applies a force specified using [[Interaction_token#IE_PROPEL_FORCE|[IE_PROPEL_FORCE]]] to a unit to knock it back.
* '''CHANGE_ITEM_QUALITY''' - Alters an item's quality level as indicated by either {{token|IE_CHANGE_QUALITY|in}} or {{token|IE_SET_QUALITY|in}}. When targeting a unit, all items equipped by that unit will be affected.
+
* '''CHANGE_WEATHER'''{{version|0.47.01}} - Changes the weather as specified by [[Interaction_token#IE_ADD_WEATHER|[IE_ADD_WEATHER]]] and/or [[Interaction_token#IE_REMOVE_WEATHER|[IE_REMOVE_WEATHER]]].
 
+
* '''RAISE_GHOST'''{{version|0.47.01}} - Present in version 0.47.01 and accepted as a valid I_EFFECT token, but does not have an effect currently.
* '''SUMMON_UNIT''' - Creates a new unit at the target. The type of unit can either be specified using the {{token|CREATURE|in}} token, or made to be randomly selected as indicated by a variety of flag-based tokens: {{token|IE_CREATURE_FLAG|in}}, {{token|IE_FORBIDDEN_CREATURE_FLAG|in}}, {{token|IE_CREATURE_CASTE_FLAG|in}}, {{token|IE_FORBIDDEN_CREATURE_CASTE_FLAG|in}}, {{token|IE_HAVE_FAST_EFFORTLESS_GAIT_SPEED|in}} and/or {{token|IE_ALL_SLOW_EFFORTLESS_GAIT_SPEED|in}}. See also {{token|IE_TIME_RANGE|in}} and {{token|IE_MAKE_PET_IF_POSSIBLE|in}}.
 
 
 
* '''PROPEL_UNIT''' - Applies a force specified using {{token|IE_PROPEL_FORCE|in}} to a unit to knock it back.
 
 
 
* '''CHANGE_WEATHER''' - Changes the weather as specified by {{token|IE_ADD_WEATHER|in}} and/or {{token|IE_REMOVE_WEATHER|in}}.
 
 
 
* '''RAISE_GHOST''' - Present in version 0.47.01 and accepted as a valid I_EFFECT token, but does not have an effect currently.
 
  
 
|-
 
|-
Line 345: Line 324:
  
 
|-
 
|-
| {{text anchor|IE_ADD_WEATHER}}
+
| {{text anchor|IE_ADD_WEATHER}}{{version|0.47.01}}
 
| Within I_EFFECT:CHANGE_WEATHER
 
| Within I_EFFECT:CHANGE_WEATHER
 
| type
 
| type
Line 364: Line 343:
  
 
|-
 
|-
| {{text anchor|IE_REMOVE_WEATHER}}
+
| {{text anchor|IE_REMOVE_WEATHER}}{{version|0.47.01}}
 
| Within I_EFFECT:CHANGE_WEATHER
 
| Within I_EFFECT:CHANGE_WEATHER
 
| type
 
| type
Line 382: Line 361:
  
 
|-
 
|-
| {{text anchor|IE_PROPEL_FORCE}}
+
| {{text anchor|IE_PROPEL_FORCE}}{{version|0.47.01}}
 
| Within I_EFFECT:PROPEL_UNIT
 
| Within I_EFFECT:PROPEL_UNIT
 
| amount
 
| amount
Line 388: Line 367:
  
 
|-
 
|-
| {{text anchor|IE_ITEM}}
+
| {{text anchor|IE_ITEM}}{{version|0.47.01}}
 
| Within I_EFFECT:CREATE_ITEM
 
| Within I_EFFECT:CREATE_ITEM
 
| <probability>:<quantity>:[[item token]]:[[material token]]
 
| <probability>:<quantity>:[[item token]]:[[material token]]
Line 394: Line 373:
  
 
|-
 
|-
| {{text anchor|IE_ITEM_QUALITY}}
+
| {{text anchor|IE_ITEM_QUALITY}}{{version|0.47.01}}
 
| Within I_EFFECT:CREATE_ITEM
 
| Within I_EFFECT:CREATE_ITEM
 
| <[[Item_quality|quality]]> OR <minimum [[Item_quality|quality]]>:<maximum [[Item_quality|quality]]>
 
| <[[Item_quality|quality]]> OR <minimum [[Item_quality|quality]]>:<maximum [[Item_quality|quality]]>
Line 407: Line 386:
  
 
|-
 
|-
| {{text anchor|IE_SET_QUALITY}}
+
| {{text anchor|IE_SET_QUALITY}}{{version|0.47.01}}
 
| Within I_EFFECT:CHANGE_ITEM_QUALITY
 
| Within I_EFFECT:CHANGE_ITEM_QUALITY
 
| [[Interaction_token#IE_ITEM_QUALITY|quality level]]
 
| [[Interaction_token#IE_ITEM_QUALITY|quality level]]
Line 413: Line 392:
  
 
|-
 
|-
| {{text anchor|IE_CHANGE_QUALITY}}
+
| {{text anchor|IE_CHANGE_QUALITY}}{{version|0.47.01}}
 
| Within I_EFFECT:CHANGE_ITEM_QUALITY
 
| Within I_EFFECT:CHANGE_ITEM_QUALITY
 
| amount
 
| amount
Line 419: Line 398:
  
 
|-
 
|-
| {{text anchor|CREATURE}}
+
| {{text anchor|CREATURE}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
 
| <creature token>:<caste token>
 
| <creature token>:<caste token>
Line 425: Line 404:
  
 
|-
 
|-
| {{text anchor|IE_CREATURE_FLAG}}
+
| {{text anchor|IE_CREATURE_FLAG}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
 
| <[[Interaction_token#Creature_and_Caste_Flags|creature flag]]>
 
| <[[Interaction_token#Creature_and_Caste_Flags|creature flag]]>
| When this token is added to a random creature summoning effect, it narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]]. This token may be used multiple times per interaction effect; creatures which lack any of the indicated flags will never be summoned.
+
| Any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] may be summoned. This token may be used multiple times per interaction effect; it appears that any creature with at least one of the indicated flags will be counted as a valid option.
  
 
|-
 
|-
| {{text anchor|IE_FORBIDDEN_CREATURE_FLAG}}
+
| {{text anchor|IE_FORBIDDEN_CREATURE_FLAG}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
 
| <[[Interaction_token#Creature_and_Caste_Flags|creature flag]]>
 
| <[[Interaction_token#Creature_and_Caste_Flags|creature flag]]>
| When this token is added to a random creature summoning effect, any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] will be excluded from the selection. This token may be used multiple times per interaction effect; creatures which possess any of the indicated flags will never be summoned.
+
| Any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|creature flag]] will not be summoned. This token may be used multiple times per interaction effect; any creature with at least one of the indicated flags is forbidden.
  
 
|-
 
|-
| {{text anchor|IE_CREATURE_CASTE_FLAG}}
+
| {{text anchor|IE_CREATURE_CASTE_FLAG}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
 
| <[[Interaction_token#Creature_and_Caste_Flags|caste flag]]>
 
| <[[Interaction_token#Creature_and_Caste_Flags|caste flag]]>
| When this token is added to a random creature summoning effect, it narrows down the selection to creatures which have the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. This token may be used multiple times per interaction effect; creatures which lack any of the indicated flags will never be summoned.
+
| Any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]] may be summoned. This token may be used multiple times per interaction effect; it appears that any creature with at least one of the indicated flags will be counted as a valid option.
  
 
|-
 
|-
| {{text anchor|IE_FORBIDDEN_CREATURE_CASTE_FLAG}}
+
| {{text anchor|IE_FORBIDDEN_CREATURE_CASTE_FLAG}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
 
| <[[Interaction_token#Creature_and_Caste_Flags|caste flag]]>
 
| <[[Interaction_token#Creature_and_Caste_Flags|caste flag]]>
| When this token is added to a random creature summoning effect, it excludes any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]]. This token may be used multiple times per interaction effect; creatures which possess any of the indicated flags will never be summoned.
+
| Any creature with the specified [[Interaction_token#Creature_and_Caste_Flags|caste flag]] will not be summoned. This token may be used multiple times per interaction effect; any creature with at least one of the indicated flags is forbidden.
  
 
|-
 
|-
| {{text anchor|IE_HAVE_FAST_EFFORTLESS_GAIT_SPEED}}
+
| {{text anchor|IE_HAVE_FAST_EFFORTLESS_GAIT_SPEED}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
| <minimum [[Gait#Speed|gait speed]]>
+
|  
| When this token is added to a random creature summoning effect, it 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]]). [http://www.bay12forums.com/smf/index.php?topic=169696.msg8243222#msg8243222]
+
| Exists in the string dump; presumably narrows the random summoning choices to creatures whose normal/slow/slower gait is relatively fast, though this has yet to be tested.
  
 
|-
 
|-
| {{text anchor|IE_ALL_SLOW_EFFORTLESS_GAIT_SPEED}}
+
| {{text anchor|IE_ALL_SLOW_EFFORTLESS_GAIT_SPEED}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
| <maximum [[Gait#Speed|gait speed]]>
+
|  
| When this token is added to a random creature summoning effect, it 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]
+
| Exists in the string dump; presumably narrows the random summoning choices to creatures whose normal gait is relatively slow, though this has yet to be tested.
  
 
|-
 
|-
| {{text anchor|IE_TIME_RANGE}}
+
| {{text anchor|IE_TIME_RANGE}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
 
| <minimum [[Time|ticks]]>:<maximum [[Time|ticks]]>
 
| <minimum [[Time|ticks]]>:<maximum [[Time|ticks]]>
Line 467: Line 446:
  
 
|-
 
|-
| {{text anchor|IE_MAKE_PET_IF_POSSIBLE}}
+
| {{text anchor|IE_MAKE_PET_IF_POSSIBLE}}{{version|0.47.01}}
 
| Within I_EFFECT:SUMMON_UNIT
 
| Within I_EFFECT:SUMMON_UNIT
 
|
 
|
Line 531: Line 510:
 
| {{text anchor|USAGE_HINT}}
 
| {{text anchor|USAGE_HINT}}
 
| Usage hint token
 
| Usage hint token
| Indicates when and how CPU-controlled creatures will use the interaction. If no hint is specified in fortress mode, the interaction will be performed at the every opportunity in combat. Multiple usage hints may be specified. Valid values:
+
| Indicates when and how CPU-controlled creatures will use the interaction. If no hint is specified, the interaction will be used whenever a valid target is available{{verify}}. Multiple usage hints may be specified. Valid values:
 
* '''GREETING''' - Creatures will target 'friendly' creatures, usually at random.
 
* '''GREETING''' - Creatures will target 'friendly' creatures, usually at random.
 
* '''ATTACK''' - Targets enemy creatures in combat.  If the interaction specifies SELF_ONLY, CPU-controlled creatures will never use it.
 
* '''ATTACK''' - Targets enemy creatures in combat.  If the interaction specifies SELF_ONLY, CPU-controlled creatures will never use it.
* '''DEFEND''' - Used in combat. Creature will target itself.
+
* '''DEFEND'''{{version|0.47.01}} - Used in combat. Creature will target itself.
 
* '''FLEEING''' - Used when fleeing an enemy.  Creature will target itself.
 
* '''FLEEING''' - Used when fleeing an enemy.  Creature will target itself.
 
* '''CLEAN_SELF''' - Creature targets itself when its body is covered with [[contaminant]]s.
 
* '''CLEAN_SELF''' - Creature targets itself when its body is covered with [[contaminant]]s.
Line 540: Line 519:
 
* '''NEGATIVE_SOCIAL_RESPONSE''' - Used when a creature is expressing contempt (for example, to a murderer). This is used in the default spitting interaction, for example.
 
* '''NEGATIVE_SOCIAL_RESPONSE''' - Used when a creature is expressing contempt (for example, to a murderer). This is used in the default spitting interaction, for example.
 
* '''TORMENT''' - This is also used in the default spitting interaction, and is presumably used in a similar context.
 
* '''TORMENT''' - This is also used in the default spitting interaction, and is presumably used in a similar context.
* '''MINOR_BLESSING''' - Used in divination dice blessings. Targets the roller.
+
* '''MINOR_BLESSING'''{{version|0.47.01}} - Used in divination dice blessings. Targets the roller.
* '''MEDIUM_BLESSING''' - Used in divination dice blessings. Targets the roller.
+
* '''MEDIUM_BLESSING'''{{version|0.47.01}} - Used in divination dice blessings. Targets the roller.
* '''MINOR_CURSE''' - Used in divination dice curses. Targets the roller.
+
* '''MINOR_CURSE'''{{version|0.47.01}} - Used in divination dice curses. Targets the roller.
* '''MEDIUM_CURSE''' - Used in divination dice curses. Targets the roller.
+
* '''MEDIUM_CURSE'''{{version|0.47.01}} - Used in divination dice curses. Targets the roller.
 
* '''MAJOR_CURSE''' - Used in disturbance and deity curses.  Targets the tomb disturber/temple defiler.
 
* '''MAJOR_CURSE''' - Used in disturbance and deity curses.  Targets the tomb disturber/temple defiler.
  
Line 722: Line 701:
 
| Shoots a [[Item_token#GLOB|solid glob]] of spinning substance at the target, leaving a symbol similar to broken arrows, if it misses. Essentially a projectile weapon. If the [[Interaction_token#WAIT_PERIOD|cooldown rate]] is short enough, some creatures with this breath attack will not move, preferring instead to hold position and shoot globs at their enemies, even when they are right next to them.
 
| Shoots a [[Item_token#GLOB|solid glob]] of spinning substance at the target, leaving a symbol similar to broken arrows, if it misses. Essentially a projectile weapon. If the [[Interaction_token#WAIT_PERIOD|cooldown rate]] is short enough, some creatures with this breath attack will not move, preferring instead to hold position and shoot globs at their enemies, even when they are right next to them.
 
|-
 
|-
| {{text anchor|SHARP_ROCK}}
+
| {{text anchor|SHARP_ROCK}}{{version|0.47.01}}
 
| MATERIAL
 
| MATERIAL
 
| Just like [[Interaction_token#SOLID_GLOB|SOLID_GLOB]], but more harmful, as it shoots a sharpened [[Item_token#ROCK|solid chunk]] of material instead.
 
| Just like [[Interaction_token#SOLID_GLOB|SOLID_GLOB]], but more harmful, as it shoots a sharpened [[Item_token#ROCK|solid chunk]] of material instead.
Line 829: Line 808:
 
HAS_ANY_CANNOT_BREATHE_AIR
 
HAS_ANY_CANNOT_BREATHE_AIR
 
HAS_ANY_CANNOT_BREATHE_WATER
 
HAS_ANY_CANNOT_BREATHE_WATER
HAS_ANY_CAN_SWIM
+
HAS_ANY_CAN_SWIM - currently unusable due to a bug
 
HAS_ANY_CARNIVORE
 
HAS_ANY_CARNIVORE
 
HAS_ANY_COMMON_DOMESTIC
 
HAS_ANY_COMMON_DOMESTIC
Line 873: Line 852:
 
LOOSE_CLUSTERS
 
LOOSE_CLUSTERS
 
MATES_TO_BREED
 
MATES_TO_BREED
MUNDANE
+
MUNDANE - currently unusable due to a bug
 
OCCURS_AS_ENTITY_RACE
 
OCCURS_AS_ENTITY_RACE
 
SAVAGE
 
SAVAGE

Please note that all contributions to Dwarf Fortress Wiki are considered to be released under the GFDL & MIT (see Dwarf Fortress Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following CAPTCHA:

Cancel Editing help (opens in new window)

This page is a member of 1 hidden category: