Editing v0.31:Armor token

{{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.

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==
{| {{prettytable}}
|- bgcolor="#999999"
! Token
! Arguments
! Usage
! Description

|-
| NAME
| singular:plural
| All
| What this item will be called ingame.

|-
| PREPLURAL
| <phrase> of
| ITEM_ARMOR<br />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<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.

|-
| VALUE
| num
| ITEM_ARMOR<br />ITEM_GLOVES<br />ITEM_SHOES<br />ITEM_SHIELD<br />ITEM_HELM
| Unused. Defaults to -1.

|-
| ARMORLEVEL
|
0 - clothing<br>
1 - leather<br>
2 - chain<br>
3 - plate
| All
| What category this item falls under. Defaults to 1 for shields, 0 for everything else.

|-
| UPSTEP
| value, MAX
| ITEM_GLOVES<br />ITEM_SHOES<br />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.{{version|0.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,{{version|0.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<br />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<br />ITEM_GLOVES<br />ITEM_SHOES<br />ITEM_HELM<br />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. <font color="red">Required</font>.

|-
| SOFT
| 
| All
| 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.

|-
| HARD
| 
| All
| Item does not {{L|wear}} when worn.  Opposite of [SOFT].  No tag defaults to [HARD].

|-
| METAL
| 
| All
| Item can be made with metal. Randomly generated equipped armor will always be made out of metal whenever possible.

|-
| BARRED
| 
| All
| Can be crafted out of bone. Randomly generated equipped armor will never be made out of bone.

|-
| SCALED
| 
| All
| Can be crafted from shell. Randomly generated equipped armor will never be made of shell.

|-
| LEATHER
| 
| All
| 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
| Only one shaped piece of clothing can be worn on a single body slot at a time.

|-
| CHAIN_METAL_TEXT
| 
| All
| Metal versions of this item will have "chain" added between the material and item name.

|-
| STRUCTURAL_ELASTICITY_WOVEN_THREAD
|
| All
| 

|-
| STRUCTURAL_ELASTICITY_CHAIN_METAL
| 
| All
| 

|-
| STRUCTURAL_ELASTICITY_CHAIN_ALL
| 
| All
| Seems to make blunt attacks more damaging. Further testing is needed.

|-
| LAYER_SIZE
| value
| All
| What the size of this item in question is, when it is put on. See {{L|Armor}} for more on item sizes and layering. Defaults to 10.

|-
| LAYER_PERMIT
| value
| All
| 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. Defaults to 10.

|-
| LAYER
| UNDER, OVER, ARMOR, COVER
| All
| 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
| 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.

|}

{{Category|Modding}}
{{Category|Tokens}}
@@ Line 1: / Line 1: @@
 {{Quality|Exceptional|08:43, 9 June 2010 (UTC)}}{{av}}
-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.
+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.
 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.
@@ Line 45: / Line 45: @@
 - plate
 | All
-| What category this item falls under. Defaults to 1 for shields, 0 for everything else. Clothing-category armor is subject to [[wear]].
+| What category this item falls under. Defaults to 1 for shields, 0 for everything else.
 |-
@@ Line 86: / Line 86: @@
 | SOFT
 |
-| All but ITEM_SHIELD
+| All
-| 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.
+| 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.
 |-
 | HARD
 |
-| All but ITEM_SHIELD
+| All
-| Unknown function. No tag defaults to [HARD].
+| Item does not {{L|wear}} when worn.  Opposite of [SOFT].  No tag defaults to [HARD].
 |-
 | METAL
 |
-| All but ITEM_SHIELD
+| All
 | Item can be made with metal. Randomly generated equipped armor will always be made out of metal whenever possible.
@@ Line 104: / Line 104: @@
 | BARRED
 |
-| All but ITEM_SHIELD
+| All
 | Can be crafted out of bone. Randomly generated equipped armor will never be made out of bone.
@@ Line 110: / Line 110: @@
 | SCALED
 |
-| All but ITEM_SHIELD
+| All
 | Can be crafted from shell. Randomly generated equipped armor will never be made of shell.
@@ Line 116: / Line 116: @@
 | LEATHER
 |
-| All but ITEM_SHIELD
+| All
 | 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
 |
-| All but ITEM_SHIELD
+| All
 | Only one shaped piece of clothing can be worn on a single body slot at a time.
@@ Line 128: / Line 128: @@
 | CHAIN_METAL_TEXT
 |
-| All but ITEM_SHIELD
+| All
 | Metal versions of this item will have "chain" added between the material and item name.
@@ Line 134: / Line 134: @@
 | STRUCTURAL_ELASTICITY_WOVEN_THREAD
 |
-| All but ITEM_SHIELD
+| All
 |
@@ Line 140: / Line 140: @@
 | STRUCTURAL_ELASTICITY_CHAIN_METAL
 |
-| All but ITEM_SHIELD
+| All
 |
@@ Line 146: / Line 146: @@
 | STRUCTURAL_ELASTICITY_CHAIN_ALL
 |
-| All but ITEM_SHIELD
+| All
 | Seems to make blunt attacks more damaging. Further testing is needed.
@@ Line 152: / Line 152: @@
 | LAYER_SIZE
 | value
-| All but ITEM_SHIELD
+| All
-| 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.
+| What the size of this item in question is, when it is put on. See {{L|Armor}} for more on item sizes and layering. Defaults to 10.
 |-
 | LAYER_PERMIT
 | value
-| All but ITEM_SHIELD
+| All
-| 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.
+| 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. Defaults to 10.
 |-
 | LAYER
 | UNDER, OVER, ARMOR, COVER
-| All but ITEM_SHIELD
+| All
 | 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.
@@ Line 170: / Line 170: @@
 | COVERAGE
 | % value
-| All but ITEM_SHIELD
+| All
 | 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.