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 v0.31:Item 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.

You are editing a page for an older version of Dwarf Fortress ("Main" is the current version, not "v0.31"). Please make sure you intend to do this. If you are here by mistake, see the current page instead.

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|Superior|01:24, 8 July 2013 (UTC)}}
+
{{av}}{{Quality|Fine}}
{{av}}Item tokens are the first part in defining the target item in reactions, containing the item type and subtype. They determine the most basic form of item, and made more specific by [[material token]]s.  Most item tokens use NO_SUBTYPE or NONE for subtype.
 
  
Nearly all items are made of a [[Material token|material]], though several types expect a creature ID and caste ID (e.g. [[Ant|ANT:SOLDIER]]) instead; unfortunately, this is broken in versions prior to v0.43.03{{bug|4973}} and treats the caste as if it were "NONE".
+
Item tokens are the first part in defining the target item in reactions, containing the ITEM_TOKEN and ITEM_SUBTYPE. They determine the most basic form of item, and made more specific by {{l|Matgloss token|matgloss tokens}}.  Most item tokens use NO_SUBTYPE or NONE for subtype.
 
 
==Standard Item Tokens==
 
  
 
{| {{prettytable}} class="sortable"
 
{| {{prettytable}} class="sortable"
 
|- bgcolor="#ddd"
 
|- bgcolor="#ddd"
! # !! Token !! Subtype !! Description
+
! ID !! Token !! Description
|-
 
| 0 || BAR || NONE || [[Bar]]s, such as [[metal]], [[fuel]], or [[soap]].
 
|-
 
| 1 || SMALLGEM || NONE || Cut [[gem]]stones usable in [[jeweler's workshop]]
 
 
|-
 
|-
| 2 || BLOCKS || NONE || [[Block]]s of any kind.
+
| 0 || BAR || {{L|Bar}}s, such as metal, fuel, or soap.
 
|-
 
|-
| 3 || ROUGH || NONE || Rough [[gem]]stones or raw [[glass]].
+
| 1 || SMALLGEM || Cut {{L|gem}}stones usable in jeweler's workshop
 
|-
 
|-
| 4 || BOULDER / STONE || NONE || Raw mined [[stone]].
+
| 2 || BLOCKS || {{L|Block}}s of any kind.
 
|-
 
|-
| 5 || WOOD || NONE || Wooden [[log]]s.
+
| 3 || ROUGH || Rough {{L|gem}}stones.
 
|-
 
|-
| 6 || DOOR || NONE || [[Door]]s.
+
| 4 || BOULDER / STONE || Raw mined {{L|stone}}.
 
|-
 
|-
| 7 || FLOODGATE || NONE || [[Floodgate]]s.
+
| 5 || WOOD || Wooden {{L|log}}s.
 
|-
 
|-
| 8 || BED || NONE || [[Bed]]s.
+
| 6 || DOOR || {{L|Door}}s.
 
|-
 
|-
| 9 || CHAIR || NONE || [[Chair]]s and thrones.
+
| 7 || FLOODGATE || {{L|Floodgate}}s.
 
|-
 
|-
| 10 || CHAIN || NONE || [[Chain]]s and [[rope]]s.
+
| 8 || BED || {{L|Bed}}s.
 
|-
 
|-
| 11 || FLASK || NONE || [[Flask]]s.
+
| 9 || CHAIR || {{L|Chair}}s and thrones.
 
|-
 
|-
| 12 || GOBLET || NONE || [[Goblet]]s.
+
| 10 || CHAIN || {{L|Chain}}s and ropes.
 
|-
 
|-
| 13 || INSTRUMENT || item_instrument.txt || Musical [[instrument]]s.
+
| 11 || FLASK || {{L|Flask}}s.
 
|-
 
|-
| 14 || TOY || item_toy.txt || [[Toy]]s.
+
| 12 || GOBLET || {{L|Goblet}}s, cups (wooden), and mugs (rock).
 
|-
 
|-
| 15 || WINDOW || NONE || Glass [[window]]s.
+
| 13 || INSTRUMENT || Musical {{L|instrument}}s.  Subtypes come from item_instrument.
 
|-
 
|-
| 16 || CAGE || NONE || [[Cage]]s.
+
| 14 || TOY || {{L|Toy}}s.  Subtypes come from item_toy.
 
|-
 
|-
| 17 || BARREL || NONE || [[Barrel]]s.
+
| 15 || WINDOW || {{L|Window}}s.
 
|-
 
|-
| 18 || BUCKET || NONE || [[Bucket]]s.
+
| 16 || CAGE || {{L|Cage}}s.
 
|-
 
|-
| 19 || ANIMALTRAP || NONE || [[Animal trap]]s.
+
| 17 || BARREL || {{L|Barrel}}s.
 
|-
 
|-
| 20 || TABLE || NONE || [[Table]]s.
+
| 18 || BUCKET || {{L|Bucket}}s.
 
|-
 
|-
| 21 || COFFIN || NONE || [[Coffin]]s.
+
| 19 || ANIMALTRAP || {{L|Animal trap}}s.
 
|-
 
|-
| 22 || STATUE || NONE || [[Statue]]s.
+
| 20 || TABLE || {{L|Table}}s.
 
|-
 
|-
| 23 || CORPSE || NONE || [[Corpse]]s. Does not have a material.
+
| 21 || COFFIN || {{L|Coffin}}s and caskets.
 
|-
 
|-
| 24 || WEAPON || item_weapon.txt || [[Weapon]]s.
+
| 22 || STATUE || {{L|Statue}}s.
 
|-
 
|-
| 25 || ARMOR || item_armor.txt || [[Armor]] and clothing worn on the upper body.
+
| 23 || CORPSE || {{L|Corpse|Dead things}}.
 
|-
 
|-
| 26 || SHOES || item_shoes.txt || Armor and clothing worn on the feet.
+
| 24 || WEAPON || {{L|Weapon}}s. Subtypes come from item_weapon.
 
|-
 
|-
| 27 || SHIELD || item_shield.txt || [[Shield]]s and bucklers.
+
| 25 || ARMOR || {{L|Armor}} and clothing worn on the upper body.  Subtypes come from item_armor.
 
|-
 
|-
| 28 || HELM || item_helm.txt || Armor and clothing worn on the head.
+
| 26 || SHOES || Armor and clothing worn on the feet.  Subtypes come from item_shoes.
 
|-
 
|-
| 29 || GLOVES || item_gloves.txt || Armor and clothing worn on the hands.
+
| 27 || SHIELD || {{L|Shield}}s and bucklers.  Subtypes come from item_shield.
 
|-
 
|-
| 30 || BOX || NONE || [[Container|Chest]]s (wood), coffers (stone), boxes (glass), and bags (cloth or leather).
+
| 28 || HELM || Armor and clothing worn on the head.  Subtypes come from item_helm.
 
|-
 
|-
| 31 || BIN || NONE || [[Bin]]s.
+
| 29 || GLOVES || Clothing worn on the hands.  Subtypes come from item_gloves.
 
|-
 
|-
| 32 || ARMORSTAND || NONE || [[Armor stand]]s.
+
| 30 || BOX || {{L|Container|Chest}}s (wood), coffers (stone), boxes (glass), and bags (cloth or leather).
 
|-
 
|-
| 33 || WEAPONRACK || NONE || [[Weapon rack]]s.
+
| 31 || BIN || {{L|Bin}}s.
 
|-
 
|-
| 34 || CABINET || NONE || [[Cabinet]]s.
+
| 32 || ARMORSTAND || {{L|Armor stand}}s.
 
|-
 
|-
| 35 || FIGURINE || NONE || [[Figurine]]s.
+
| 33 || WEAPONRACK || {{L|Weapon rack}}s.
 
|-
 
|-
| 36 || AMULET || NONE || [[Amulet]]s.
+
| 34 || CABINET || {{L|Cabinet}}s.
 
|-
 
|-
| 37 || SCEPTER || NONE || [[Scepter]]s.
+
| 35 || FIGURINE || {{L|Figurine}}s.
 
|-
 
|-
| 38 || AMMO || item_ammo.txt || [[Ammunition]] for hand-held weapons.
+
| 36 || AMULET || {{L|Amulet}}s.
 
|-
 
|-
| 39 || CROWN || NONE || [[Crown]]s.
+
| 37 || SCEPTER || {{L|Scepter}}s.
 
|-
 
|-
| 40 || RING || NONE || [[Ring]]s.
+
| 38 || AMMO || {{L|Ammunition}} for hand-held weapons.  Subtypes come from item_ammo.
 
|-
 
|-
| 41 || EARRING || NONE || [[Earring]]s.
+
| 39 || CROWN || {{L|Crown}}s.
 
|-
 
|-
| 42 || BRACELET || NONE || [[Bracelet]]s.
+
| 40 || RING || {{L|Ring}}s.
 
|-
 
|-
| 43 || GEM || NONE || Large [[gem]]s.
+
| 41 || EARRING || {{L|Earring}}s.
 
|-
 
|-
| 44 || ANVIL || NONE || [[Anvil]]s.
+
| 42 || BRACELET || {{L|Bracelet}}s.
 
|-
 
|-
| 45 || CORPSEPIECE || NONE || [[Body part]]s. Does not have a material.
+
| 43 || GEM || Large {{L|gem}}s.
 
|-
 
|-
| 46 || REMAINS || NONE || Dead [[vermin]] bodies. Material is CREATURE_ID:CASTE.
+
| 44 || ANVIL || {{L|Anvil}}s.
 
|-
 
|-
| 47 || MEAT || NONE || Butchered [[meat]].
+
| 45 || CORPSEPIECE || {{L|Body part}}s.
 
|-
 
|-
| 48 || FISH || NONE || Prepared [[fish]]. Material is CREATURE_ID:CASTE.
+
| 46 || REMAINS || Dead vermin bodies.
 
|-
 
|-
| 49 || FISH_RAW || NONE || Unprepared [[fish]]. Material is CREATURE_ID:CASTE.
+
| 47 || MEAT || Butchered {{L|meat}}.
 
|-
 
|-
| 50 || VERMIN || NONE || Live [[vermin]]. Material is CREATURE_ID:CASTE.
+
| 48 || FISH || Prepared {{L|fish}}.
 
|-
 
|-
| 51 || PET || NONE || Tame [[vermin]]. Material is CREATURE_ID:CASTE.
+
| 49 || FISH_RAW || Unprepared fish.
 
|-
 
|-
| 52 || SEEDS || NONE || [[Seed]]s from plants.
+
| 50 || VERMIN || Live {{L|vermin}}.
 
|-
 
|-
| 53 || PLANT || NONE || [[Plant]]s.
+
| 51 || PET || Tame vermin.
 
|-
 
|-
| 54 || SKIN_TANNED || NONE || [[Leather]].
+
| 52 || SEEDS || {{L|Seed}}s from plants.
 
|-
 
|-
| 55 || LEAVES || NONE || Leaves, usually from [[quarry bush]]es.
+
| 53 || PLANT || {{L|Plant}}s.
 
|-
 
|-
| 56 || THREAD || NONE || [[Thread]] gathered from webs or made at the [[farmer's workshop]].
+
| 54 || SKIN_TANNED || {{L|Leather|Tanned skins}}.
 
|-
 
|-
| 57 || CLOTH || NONE || [[Cloth]] made at the [[loom]].
+
| 55 || LEAVES || Leaves from certain plants after processing.
 
|-
 
|-
| 58 || TOTEM || NONE || Skull [[totem]]s.
+
| 56 || THREAD || {{L|Thread}} gathered from webs or made at the farmer's workshop.
 
|-
 
|-
| 59 || PANTS || item_pants.txt || Armor and clothing worn on the legs.
+
| 57 || CLOTH || {{L|Cloth}} made at the loom.
 
|-
 
|-
| 60 || BACKPACK || NONE || [[Backpack]]s.
+
| 58 || TOTEM || {{L|Totem}}s.
 
|-
 
|-
| 61 || QUIVER || NONE || [[Quiver]]s.
+
| 59 || PANTS || Armor and clothing worn on the legs.  Subtypes come from item_pants.
 
|-
 
|-
| 62 || CATAPULTPARTS || NONE || [[Catapult]] parts.
+
| 60 || BACKPACK || {{L|Backpack}}s.
 
|-
 
|-
| 63 || BALLISTAPARTS || NONE || [[Ballista]] parts.
+
| 61 || QUIVER || {{L|Quiver}}s.
 
|-
 
|-
| 64 || SIEGEAMMO || item_siegeammo.txt || Siege engine ammunition.
+
| 62 || CATAPULTPARTS || {{L|Catapult}} parts.
 
|-
 
|-
| 65 || BALLISTAARROWHEAD || NONE || Ballista arrow heads.
+
| 63 || BALLISTAPARTS || {{L|Ballista}} parts.
 
|-
 
|-
| 66 || TRAPPARTS || NONE || [[Mechanism]]s.
+
| 64 || SIEGEAMMO || Siege ammo.  Subtypes come from item_siegeammo.
 
|-
 
|-
| 67 || TRAPCOMP || item_trapcomp.txt || [[Trap component]]s.
+
| 65 || BALLISTAARROWHEAD || Arrow heads for ballista bolts.
 
|-
 
|-
| 68 || DRINK || NONE || [[Alcohol]]ic drinks.
+
| 66 || TRAPPARTS || {{L|Mechanisms}}.
 
|-
 
|-
| 69 || POWDER_MISC || NONE || Powders such as [[flour]], [[gypsum plaster]], [[dye]], or [[sand]].
+
| 67 || TRAPCOMP || {{L|Trap component}}s.  Subtypes come from item_trapcomp.
 
|-
 
|-
| 70 || CHEESE || NONE || Pieces of [[cheese]].
+
| 68 || DRINK || {{L|Alcohol|Liquids}} from brewed plants.
 
|-
 
|-
| 71 || FOOD || item_food.txt || [[Prepared meal]]s.
+
| 69 || POWDER_MISC || Powders such as {{L|flour}}, {{L|gypsum plaster}}, {{L|dye}}, or {{L|sand}}
 
|-
 
|-
| 72 || LIQUID_MISC || NONE || Liquids such as [[water]], [[lye]], and extracts.
+
| 70 || CHEESE || {{L|Cheese}}s.
 
|-
 
|-
| 73 || COIN || NONE || [[Coin]]s.
+
| 71 || FOOD || {{L|Prepared meal}}s.
 
|-
 
|-
| 74 || GLOB || NONE || [[Fat]], [[tallow]], pastes/pressed objects, and small bits of molten rock/metal.
+
| 72 || LIQUID_MISC || Liquids such as {{L|water}}, {{L|lye}}, and extracts.
 
|-
 
|-
| 75 || ROCK || NONE || Small rocks (usually [[Knapper|sharpened]] and/or [[Thrower|thrown]] in [[adventurer mode]]).
+
| 73 || COIN || {{L|Coin}}s.
 
|-
 
|-
| 76 || PIPE_SECTION || NONE || [[Pipe section]]s.
+
| 74 || GLOB || {{L|Fat}}, {{L|tallow}} and small bits of molten rock/metal.
 
|-
 
|-
| 77 || HATCH_COVER || NONE || [[Hatch cover]]s.
+
| 75 || ROCK || Pebbles (more useful in {{L|Thrower|adventure mode}}.)
 
|-
 
|-
| 78 || GRATE || NONE || [[Grate]]s.
+
| 76 || PIPE_SECTION || {{L|Pipe section}}s.
 
|-
 
|-
| 79 || QUERN || NONE || [[Quern]]s.
+
| 77 || HATCH_COVER || {{L|Hatch cover}}s.
 
|-
 
|-
| 80 || MILLSTONE || NONE || [[Millstone]]s.
+
| 78 || GRATE || {{L|Grate}}s.
 
|-
 
|-
| 81 || SPLINT || NONE || [[Splint]]s.
+
| 79 || QUERN || {{L|Quern}}s.
 
|-
 
|-
| 82 || CRUTCH || NONE || [[Crutch]]es.
+
| 80 || MILLSTONE || {{L|Millstone}}s.
 
|-
 
|-
| 83 || TRACTION_BENCH || NONE || [[Traction bench]]es.
+
| 81 || SPLINT || {{L|Splint}}s.
 
|-
 
|-
| 84 || ORTHOPEDIC_CAST || NONE || [[Cast]]s.
+
| 82 || CRUTCH || {{L|Crutch}}es.
 
|-
 
|-
| 85 || TOOL || item_tool.txt || [[Tool]]s.
+
| 83 || TRACTION_BENCH || {{L|Traction bench}}es.
 
|-
 
|-
| 86 || SLAB || NONE || [[Slab]]s.
+
| 84 || ORTHOPEDIC_CAST || {{L|Cast}}s.
 
|-
 
|-
| 87 || EGG || NONE || [[Egg]]s. Material is CREATURE_ID:CASTE.
+
| 85 || TOOL || Adventurer mode peasant and {{L|night creature}} tools. Subtypes come from item_tool.
 
|}
 
|}
 
==Limited/Special Use Item Tokens==
 
 
In several specific locations, the values below can be substituted for the item type and subtype (and be followed directly by the [[material token]]).
 
 
{| {{prettytable}}
 
|- style='background-color:#ddd'
 
! Token
 
! Subtype
 
! Valid Uses
 
! Description
 
 
|-
 
| ANY_CRAFT
 
| NONE
 
| [[Reaction]] [REAGENT]
 
| Matches FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET.
 
 
|-
 
| ANY_RAW_MATERIAL
 
| NONE
 
| [[Reaction]] [REAGENT]
 
| Matches POWDER_MISC, BAR, BOULDER, or GLOB.
 
 
|-
 
| CRAFTS
 
| NONE
 
| [[Reaction]] [PRODUCT]
 
| Produces 1-3 items of type FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET.
 
 
|}
 
 
==Related Tokens==
 
 
These tokens are not Item Tokens at all, but can take the place of them in some circumstances.
 
 
{| {{prettytable}}
 
|- style='background-color:#ddd'
 
! Token
 
! Subtype
 
! Valid Uses
 
! Description
 
 
|- 
 
| METAL_ORE 
 
| Metal 
 
| [[Reaction]] [REAGENT] 
 
| Matches a BOULDER item made of a material having [METAL_ORE:<Metal>:###].
 
 
|}
 
 
==See Also==
 
*[[Material token]]
 
*[[Reactions]]
 
  
 
{{Category|Tokens}}
 
{{Category|Tokens}}
 
{{Category|Modding}}
 
{{Category|Modding}}

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)