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 "v0.31:Armor token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(UPSTEP is *not* permitted on body armor)
(A bunch of these tokens are not valid on shields)
 
(11 intermediate revisions by 6 users not shown)
Line 1: Line 1:
 
{{Quality|Exceptional|08:43, 9 June 2010 (UTC)}}{{av}}
 
{{Quality|Exceptional|08:43, 9 June 2010 (UTC)}}{{av}}
  
The tokens for all types of {{l|armor}} on all slots, including {{l|shield}}s. Usage column gives information on what types of armor the token might be restricted to.
+
The tokens for all types of [[armor]] on all slots, including [[shield]]s. Usage column gives information on what types of '''armor''' the token might be restricted to.
  
These tokens can only be placed within an ITEM_ARMOR, ITEM_GLOVES, ITEM_SHOES, ITEM_SHIELD, ITEM_HELM, or ITEM_PANTS object definition.
+
These tokens can only be placed within an ITEM_ARMOR, ITEM_GLOVES, ITEM_SHOES, ITEM_SHIELD, ITEM_HELM, or ITEM_PANTS object definition, most do not function in weapon objects.
  
 
==Tokens==
 
==Tokens==
Line 29: Line 29:
 
| adjective
 
| adjective
 
| ITEM_ARMOR<br />ITEM_PANTS
 
| ITEM_ARMOR<br />ITEM_PANTS
|  
+
| If the item has no material associated with it (e.g. stockpile menus and trade negotiations), this will be displayed in its place. Used for leather armor.
  
 
|-
 
|-
Line 35: Line 35:
 
| num
 
| num
 
| ITEM_ARMOR<br />ITEM_GLOVES<br />ITEM_SHOES<br />ITEM_SHIELD<br />ITEM_HELM
 
| ITEM_ARMOR<br />ITEM_GLOVES<br />ITEM_SHOES<br />ITEM_SHIELD<br />ITEM_HELM
| Unused
+
| Unused. Defaults to -1.
  
 
|-
 
|-
 
| ARMORLEVEL
 
| ARMORLEVEL
 
|
 
|
omitted - clothing<br>
+
0 - clothing<br>
 
1 - leather<br>
 
1 - leather<br>
 
2 - chain<br>
 
2 - chain<br>
 
3 - plate
 
3 - plate
 
| All
 
| All
| What category this item falls under. Lack of this tag makes this item clothes level.
+
| What category this item falls under. Defaults to 1 for shields, 0 for everything else. Clothing-category armor is subject to [[wear]].
  
 
|-
 
|-
Line 75: Line 75:
 
| value
 
| value
 
| ITEM_SHIELD
 
| ITEM_SHIELD
| Affects the block chance of the shield.
+
| Affects the block chance of the shield. Defaults to 10.
  
 
|-
 
|-
Line 81: Line 81:
 
| value
 
| value
 
| All
 
| All
| How much material is needed to make the item. Most important with bars. The number of bars required to make the item is the value divided by three.
+
| How much material is needed to make the item. Most important with bars. The number of bars required to make the item is the value divided by three. <font color="red">Required</font>.
  
 
|-
 
|-
 
| SOFT
 
| SOFT
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
| Item can {{L|wear}} when worn.  Opposite of [HARD]. Randomly generated equipped armor will have an equal probability of being made of leather or cloth, when this token is present and [METAL] is absent.
+
| Randomly generated equipped armor will have an equal probability of being made of leather or cloth, when this token is present and [METAL] is absent. Further uses of this tag are unknown.
  
 
|-
 
|-
 
| HARD
 
| HARD
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
| Item does not {{L|wear}} when worn.  Opposite of [SOFT]. No tag defaults to [HARD].
+
| Unknown function. No tag defaults to [HARD].
  
 
|-
 
|-
 
| METAL
 
| METAL
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
 
| Item can be made with metal. Randomly generated equipped armor will always be made out of metal whenever possible.
 
| Item can be made with metal. Randomly generated equipped armor will always be made out of metal whenever possible.
  
Line 104: Line 104:
 
| BARRED
 
| BARRED
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
 
| Can be crafted out of bone. Randomly generated equipped armor will never be made out of bone.
 
| Can be crafted out of bone. Randomly generated equipped armor will never be made out of bone.
  
Line 110: Line 110:
 
| SCALED
 
| SCALED
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
 
| Can be crafted from shell. Randomly generated equipped armor will never be made of shell.
 
| Can be crafted from shell. Randomly generated equipped armor will never be made of shell.
  
Line 116: Line 116:
 
| LEATHER
 
| LEATHER
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
 
| Item can be made from leather. Randomly generated equipped armor with [LEATHER] will not be made of cloth, unless [SOFT] is also present.
 
| Item can be made from leather. Randomly generated equipped armor with [LEATHER] will not be made of cloth, unless [SOFT] is also present.
  
Line 122: Line 122:
 
| SHAPED
 
| SHAPED
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
 
| Only one shaped piece of clothing can be worn on a single body slot at a time.
 
| Only one shaped piece of clothing can be worn on a single body slot at a time.
  
Line 128: Line 128:
 
| CHAIN_METAL_TEXT
 
| CHAIN_METAL_TEXT
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
 
| Metal versions of this item will have "chain" added between the material and item name.
 
| Metal versions of this item will have "chain" added between the material and item name.
  
Line 134: Line 134:
 
| STRUCTURAL_ELASTICITY_WOVEN_THREAD
 
| STRUCTURAL_ELASTICITY_WOVEN_THREAD
 
|
 
|
| All
+
| All but ITEM_SHIELD
 
|  
 
|  
  
Line 140: Line 140:
 
| STRUCTURAL_ELASTICITY_CHAIN_METAL
 
| STRUCTURAL_ELASTICITY_CHAIN_METAL
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
 
|  
 
|  
  
Line 146: Line 146:
 
| STRUCTURAL_ELASTICITY_CHAIN_ALL
 
| STRUCTURAL_ELASTICITY_CHAIN_ALL
 
|  
 
|  
| All
+
| All but ITEM_SHIELD
|  
+
| Seems to make blunt attacks more damaging. Further testing is needed.
  
 
|-
 
|-
 
| LAYER_SIZE
 
| LAYER_SIZE
 
| value
 
| value
| All
+
| All but ITEM_SHIELD
| What the size of this item in question is, when it is put on. See {{L|Armor}} for more on item sizes and layering.
+
| What the size of this item in question is, when it is put on. See [[Armor]] for more on item sizes and layering. Defaults to 10.
  
 
|-
 
|-
 
| LAYER_PERMIT
 
| LAYER_PERMIT
 
| value
 
| value
| All
+
| All but ITEM_SHIELD
| The maximum number of items allowed on that body slot. If the body slot's layer value is over this, no more of this item can be put on. See {{L|Armor}} for more on item sizes and layering.
+
| The maximum number of items allowed on that body slot. If the body slot's layer value is over this, no more of this item can be put on. See [[Armor]] for more on item sizes and layering. Defaults to 10.
  
 
|-
 
|-
 
| LAYER
 
| LAYER
 
| UNDER, OVER, ARMOR, COVER
 
| UNDER, OVER, ARMOR, COVER
| All
+
| All but ITEM_SHIELD
| How this item is layered. The [LAYER_PERMIT:#] of a [LAYER:ARMOR] item overrides the [LAYER_PERMIT:#] of other items on the same ITEM_<name1>, unless it is a [LAYER:COVER] items.
+
| How this item is layered. The [LAYER_PERMIT:#] of a [LAYER:ARMOR] item overrides the [LAYER_PERMIT:#] of other items on the same ITEM_<name1>, unless it is a [LAYER:COVER] items. Defaults to UNDER.
  
 
|-
 
|-
 
| COVERAGE
 
| COVERAGE
 
| % value
 
| % value
| All
+
| All but ITEM_SHIELD
| Coverage determines how often attacks and contaminants get through clothes.  Armor with a 5% coverage value, for example, will be near useless because 95% of attacks will bypass it compleatly.  Temperature effects are also influenced by coverage.
+
| Coverage determines how often attacks and contaminants get through clothes.  Armor with a 5% coverage value, for example, will be near useless because 95% of attacks will bypass it completely.  Temperature effects are also influenced by coverage. Defaults to 100.
  
 
|}
 
|}

Latest revision as of 03:03, 23 January 2012

This article is about an older version of DF.

The tokens for all types of armor on all slots, including shields. Usage column gives information on what types of armor the token might be restricted to.

These tokens can only be placed within an ITEM_ARMOR, ITEM_GLOVES, ITEM_SHOES, ITEM_SHIELD, ITEM_HELM, or ITEM_PANTS object definition, most do not function in weapon objects.

Tokens[edit]

Token Arguments Usage Description
NAME singular:plural All What this item will be called ingame.
PREPLURAL <phrase> of ITEM_ARMOR
ITEM_PANTS
Changes the plural form of this item to "<phrase of> item". Primarily pertains to the stock screens. Example, "suits of" platemail, "pairs of" trousers, etc.
MATERIAL_PLACEHOLDER adjective ITEM_ARMOR
ITEM_PANTS
If the item has no material associated with it (e.g. stockpile menus and trade negotiations), this will be displayed in its place. Used for leather armor.
VALUE num ITEM_ARMOR
ITEM_GLOVES
ITEM_SHOES
ITEM_SHIELD
ITEM_HELM
Unused. Defaults to -1.
ARMORLEVEL

0 - clothing
1 - leather
2 - chain
3 - plate

All What category this item falls under. Defaults to 1 for shields, 0 for everything else. Clothing-category armor is subject to wear.
UPSTEP value, MAX ITEM_GLOVES
ITEM_SHOES
ITEM_SHIELD
This token functions exactly like LBSTEP but in reverse. How many steps up this item protects. 'Up'is defined as "Connected through a series of one or more body parts with the [LIMB] token to an UPPERBODY part. Gloves and shoes can not protect upper or lower bodies. Example, chausses with an upstep of MAX, protect the the foot and the entire leg, but not the lower body. The same effect could be achieved (on a humanoid) with UPSTEP>=2. Since toes and fingers lack the [LIMB] token, gloves and boots do not protect them. This may be a bug.v0.31.03
UBSTEP value, MAX ITEM_ARMOR How many steps away from upper body the armor protects. Only present on torso armor. When counting steps, ignore any steps through upper or lower body parts(UBSTEP:0 items protect the upper and lower bodies as a result of this). Currently bugged,v0.31.03 high values of UBSTEP will result in the item protecting facial features, fingers, and toes, while leaving those parts that it can not protect unprotected (but still counting them as steps). Torso armor can not protect hands, feet, or heads (parts with [GRASP],[STANCE], or [HEAD] tokens respectively) regardless of the UBSTEP value. UBSTEP can also not protect parts that can be protected by LBSTEP. Example, torso armor with [UBSTEP:1] will protect upper arms, wings, non-[STANCE] tails, the torso, and lower body. However, a torso armor with [UBSTEP:4] or higher will also cover lower arms, fingers, facial features, and toes.
LBSTEP value or MAX ITEM_ARMOR
ITEM_PANTS
How many steps down the armor protects. 'Down' is defined as "Connected through a series of one or more body parts with the [LIMB] token to a body part with the [STANCE] token. [LBSTEP] can not protect feet (parts with the [STANCE] token). When counting steps, ignore any steps through upper or lower body parts. Example, torso armor with a LBSTEP:1 will protect both the lower body and the upper legs in addition to the torso(the lower body step is not counted). Leg armor with LBSTEP:MAX will protect the lower body, the entire legs, but not the feet or toes.
METAL_ARMOR_LEVELS ITEM_ARMOR
ITEM_GLOVES
ITEM_SHOES
ITEM_HELM
ITEM_PANTS
Metal versions of this item count as one ARMORLEVEL higher.
BLOCKCHANCE value ITEM_SHIELD Affects the block chance of the shield. Defaults to 10.
MATERIAL_SIZE value All How much material is needed to make the item. Most important with bars. The number of bars required to make the item is the value divided by three. Required.
SOFT All but ITEM_SHIELD Randomly generated equipped armor will have an equal probability of being made of leather or cloth, when this token is present and [METAL] is absent. Further uses of this tag are unknown.
HARD All but ITEM_SHIELD Unknown function. No tag defaults to [HARD].
METAL All but ITEM_SHIELD Item can be made with metal. Randomly generated equipped armor will always be made out of metal whenever possible.
BARRED All but ITEM_SHIELD Can be crafted out of bone. Randomly generated equipped armor will never be made out of bone.
SCALED All but ITEM_SHIELD Can be crafted from shell. Randomly generated equipped armor will never be made of shell.
LEATHER All but ITEM_SHIELD Item can be made from leather. Randomly generated equipped armor with [LEATHER] will not be made of cloth, unless [SOFT] is also present.
SHAPED All but ITEM_SHIELD Only one shaped piece of clothing can be worn on a single body slot at a time.
CHAIN_METAL_TEXT All but ITEM_SHIELD Metal versions of this item will have "chain" added between the material and item name.
STRUCTURAL_ELASTICITY_WOVEN_THREAD All but ITEM_SHIELD
STRUCTURAL_ELASTICITY_CHAIN_METAL All but ITEM_SHIELD
STRUCTURAL_ELASTICITY_CHAIN_ALL All but ITEM_SHIELD Seems to make blunt attacks more damaging. Further testing is needed.
LAYER_SIZE value All but ITEM_SHIELD What the size of this item in question is, when it is put on. See Armor for more on item sizes and layering. Defaults to 10.
LAYER_PERMIT value All but ITEM_SHIELD The maximum number of items allowed on that body slot. If the body slot's layer value is over this, no more of this item can be put on. See Armor for more on item sizes and layering. Defaults to 10.
LAYER UNDER, OVER, ARMOR, COVER All but ITEM_SHIELD How this item is layered. The [LAYER_PERMIT:#] of a [LAYER:ARMOR] item overrides the [LAYER_PERMIT:#] of other items on the same ITEM_<name1>, unless it is a [LAYER:COVER] items. Defaults to UNDER.
COVERAGE % value All but ITEM_SHIELD Coverage determines how often attacks and contaminants get through clothes. Armor with a 5% coverage value, for example, will be near useless because 95% of attacks will bypass it completely. Temperature effects are also influenced by coverage. Defaults to 100.