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.
 
 
|-
 
|-
| 3 || ROUGH || NONE || Rough [[gem]]stones or raw [[glass]].
+
| 0 || BAR || {{L|Bar}}s, such as metal, fuel, or soap.
 
|-
 
|-
| 4 || BOULDER / STONE || NONE || Raw mined [[stone]].
+
| 1 || SMALLGEM || Cut {{L|gem}}stones usable in jeweler's workshop
 
|-
 
|-
| 5 || WOOD || NONE || Wooden [[log]]s.
+
| 2 || BLOCKS || {{L|Block}}s of any kind.
 
|-
 
|-
| 6 || DOOR || NONE || [[Door]]s.
+
| 3 || ROUGH || Rough {{L|gem}}stones.
 
|-
 
|-
| 7 || FLOODGATE || NONE || [[Floodgate]]s.
+
| 4 || BOULDER / STONE || Raw mined {{L|stone}}.
 
|-
 
|-
| 8 || BED || NONE || [[Bed]]s.
+
| 5 || WOOD || Wooden {{L|log}}s.
 
|-
 
|-
| 9 || CHAIR || NONE || [[Chair]]s and thrones.
+
| 6 || DOOR || {{L|Door}}s.
 
|-
 
|-
| 10 || CHAIN || NONE || [[Chain]]s and [[rope]]s.
+
| 7 || FLOODGATE || {{L|Floodgate}}s.
 
|-
 
|-
| 11 || FLASK || NONE || [[Flask]]s.
+
| 8 || BED || {{L|Bed}}s.
 
|-
 
|-
| 12 || GOBLET || NONE || [[Goblet]]s.
+
| 9 || CHAIR || {{L|Chair}}s and thrones.
 
|-
 
|-
| 13 || INSTRUMENT || item_instrument.txt || Musical [[instrument]]s.
+
| 10 || CHAIN || {{L|Chain}}s and ropes.
 
|-
 
|-
| 14 || TOY || item_toy.txt || [[Toy]]s.
+
| 11 || FLASK || {{L|Flask}}s.
 
|-
 
|-
| 15 || WINDOW || NONE || Glass [[window]]s.
+
| 12 || GOBLET || {{L|Goblet}}s, cups (wooden), and mugs (rock).
 
|-
 
|-
| 16 || CAGE || NONE || [[Cage]]s.
+
| 13 || INSTRUMENT || Musical {{L|instrument}}s.  Subtypes come from item_instrument.
 
|-
 
|-
| 17 || BARREL || NONE || [[Barrel]]s.
+
| 14 || TOY || {{L|Toy}}s.  Subtypes come from item_toy.
 
|-
 
|-
| 18 || BUCKET || NONE || [[Bucket]]s.
+
| 15 || WINDOW || {{L|Window}}s.
 
|-
 
|-
| 19 || ANIMALTRAP || NONE || [[Animal trap]]s.
+
| 16 || CAGE || {{L|Cage}}s.
 
|-
 
|-
| 20 || TABLE || NONE || [[Table]]s.
+
| 17 || BARREL || {{L|Barrel}}s.
 
|-
 
|-
| 21 || COFFIN || NONE || [[Coffin]]s.
+
| 18 || BUCKET || {{L|Bucket}}s.
 
|-
 
|-
| 22 || STATUE || NONE || [[Statue]]s.
+
| 19 || ANIMALTRAP || {{L|Animal trap}}s.
 
|-
 
|-
| 23 || CORPSE || NONE || [[Corpse]]s. Does not have a material.
+
| 20 || TABLE || {{L|Table}}s.
 
|-
 
|-
| 24 || WEAPON || item_weapon.txt || [[Weapon]]s.
+
| 21 || COFFIN || {{L|Coffin}}s and caskets.
 
|-
 
|-
| 25 || ARMOR || item_armor.txt || [[Armor]] and clothing worn on the upper body.
+
| 22 || STATUE || {{L|Statue}}s.
 
|-
 
|-
| 26 || SHOES || item_shoes.txt || Armor and clothing worn on the feet.
+
| 23 || CORPSE || {{L|Corpse|Dead things}}.
 
|-
 
|-
| 27 || SHIELD || item_shield.txt || [[Shield]]s and bucklers.
+
| 24 || WEAPON || {{L|Weapon}}s.  Subtypes come from item_weapon.
 
|-
 
|-
| 28 || HELM || item_helm.txt || Armor and clothing worn on the head.
+
| 25 || ARMOR || {{L|Armor}} and clothing worn on the upper body.  Subtypes come from item_armor.
 
|-
 
|-
| 29 || GLOVES || item_gloves.txt || Armor and clothing worn on the hands.
+
| 26 || SHOES || Armor and clothing worn on the feet.  Subtypes come from item_shoes.
 
|-
 
|-
| 30 || BOX || NONE || [[Container|Chest]]s (wood), coffers (stone), boxes (glass), and bags (cloth or leather).
+
| 27 || SHIELD || {{L|Shield}}s and bucklers.  Subtypes come from item_shield.
 
|-
 
|-
| 31 || BIN || NONE || [[Bin]]s.
+
| 28 || HELM || Armor and clothing worn on the head.  Subtypes come from item_helm.
 
|-
 
|-
| 32 || ARMORSTAND || NONE || [[Armor stand]]s.
+
| 29 || GLOVES || Clothing worn on the hands.  Subtypes come from item_gloves.
 
|-
 
|-
| 33 || WEAPONRACK || NONE || [[Weapon rack]]s.
+
| 30 || BOX || {{L|Container|Chest}}s (wood), coffers (stone), boxes (glass), and bags (cloth or leather).
 
|-
 
|-
| 34 || CABINET || NONE || [[Cabinet]]s.
+
| 31 || BIN || {{L|Bin}}s.
 
|-
 
|-
| 35 || FIGURINE || NONE || [[Figurine]]s.
+
| 32 || ARMORSTAND || {{L|Armor stand}}s.
 
|-
 
|-
| 36 || AMULET || NONE || [[Amulet]]s.
+
| 33 || WEAPONRACK || {{L|Weapon rack}}s.
 
|-
 
|-
| 37 || SCEPTER || NONE || [[Scepter]]s.
+
| 34 || CABINET || {{L|Cabinet}}s.
 
|-
 
|-
| 38 || AMMO || item_ammo.txt || [[Ammunition]] for hand-held weapons.
+
| 35 || FIGURINE || {{L|Figurine}}s.
 
|-
 
|-
| 39 || CROWN || NONE || [[Crown]]s.
+
| 36 || AMULET || {{L|Amulet}}s.
 
|-
 
|-
| 40 || RING || NONE || [[Ring]]s.
+
| 37 || SCEPTER || {{L|Scepter}}s.
 
|-
 
|-
| 41 || EARRING || NONE || [[Earring]]s.
+
| 38 || AMMO || {{L|Ammunition}} for hand-held weapons.  Subtypes come from item_ammo.
 
|-
 
|-
| 42 || BRACELET || NONE || [[Bracelet]]s.
+
| 39 || CROWN || {{L|Crown}}s.
 
|-
 
|-
| 43 || GEM || NONE || Large [[gem]]s.
+
| 40 || RING || {{L|Ring}}s.
 
|-
 
|-
| 44 || ANVIL || NONE || [[Anvil]]s.
+
| 41 || EARRING || {{L|Earring}}s.
 
|-
 
|-
| 45 || CORPSEPIECE || NONE || [[Body part]]s. Does not have a material.
+
| 42 || BRACELET || {{L|Bracelet}}s.
 
|-
 
|-
| 46 || REMAINS || NONE || Dead [[vermin]] bodies. Material is CREATURE_ID:CASTE.
+
| 43 || GEM || Large {{L|gem}}s.
 
|-
 
|-
| 47 || MEAT || NONE || Butchered [[meat]].
+
| 44 || ANVIL || {{L|Anvil}}s.
 
|-
 
|-
| 48 || FISH || NONE || Prepared [[fish]]. Material is CREATURE_ID:CASTE.
+
| 45 || CORPSEPIECE || {{L|Body part}}s.
 
|-
 
|-
| 49 || FISH_RAW || NONE || Unprepared [[fish]]. Material is CREATURE_ID:CASTE.
+
| 46 || REMAINS || Dead vermin bodies. Material is a creature ID.
 
|-
 
|-
| 50 || VERMIN || NONE || Live [[vermin]]. Material is CREATURE_ID:CASTE.
+
| 47 || MEAT || Butchered {{L|meat}}. Material is a creature ID.
 
|-
 
|-
| 51 || PET || NONE || Tame [[vermin]]. Material is CREATURE_ID:CASTE.
+
| 48 || FISH || Prepared {{L|fish}}. Material is a creature ID.
 
|-
 
|-
| 52 || SEEDS || NONE || [[Seed]]s from plants.
+
| 49 || FISH_RAW || Unprepared fish. Material is a creature ID.
 
|-
 
|-
| 53 || PLANT || NONE || [[Plant]]s.
+
| 50 || VERMIN || Live {{L|vermin}}. Material is a creature ID.
 
|-
 
|-
| 54 || SKIN_TANNED || NONE || [[Leather]].
+
| 51 || PET || Tame vermin. Material is a creature ID.
 
|-
 
|-
| 55 || LEAVES || NONE || Leaves, usually from [[quarry bush]]es.
+
| 52 || SEEDS || {{L|Seed}}s from plants.
 
|-
 
|-
| 56 || THREAD || NONE || [[Thread]] gathered from webs or made at the [[farmer's workshop]].
+
| 53 || PLANT || {{L|Plant}}s. Material is a plant ID.
 
|-
 
|-
| 57 || CLOTH || NONE || [[Cloth]] made at the [[loom]].
+
| 54 || SKIN_TANNED || {{L|Leather|Tanned skins}}.
 
|-
 
|-
| 58 || TOTEM || NONE || Skull [[totem]]s.
+
| 55 || LEAVES || Leaves from certain plants after processing.
 
|-
 
|-
| 59 || PANTS || item_pants.txt || Armor and clothing worn on the legs.
+
| 56 || THREAD || {{L|Thread}} gathered from webs or made at the farmer's workshop.
 
|-
 
|-
| 60 || BACKPACK || NONE || [[Backpack]]s.
+
| 57 || CLOTH || {{L|Cloth}} made at the loom.
 
|-
 
|-
| 61 || QUIVER || NONE || [[Quiver]]s.
+
| 58 || TOTEM || {{L|Totem}}s.
 
|-
 
|-
| 62 || CATAPULTPARTS || NONE || [[Catapult]] parts.
+
| 59 || PANTS || Armor and clothing worn on the legs.  Subtypes come from item_pants.
 
|-
 
|-
| 63 || BALLISTAPARTS || NONE || [[Ballista]] parts.
+
| 60 || BACKPACK || {{L|Backpack}}s.
 
|-
 
|-
| 64 || SIEGEAMMO || item_siegeammo.txt || Siege engine ammunition.
+
| 61 || QUIVER || {{L|Quiver}}s.
 
|-
 
|-
| 65 || BALLISTAARROWHEAD || NONE || Ballista arrow heads.
+
| 62 || CATAPULTPARTS || {{L|Catapult}} parts.
 
|-
 
|-
| 66 || TRAPPARTS || NONE || [[Mechanism]]s.
+
| 63 || BALLISTAPARTS || {{L|Ballista}} parts.
 
|-
 
|-
| 67 || TRAPCOMP || item_trapcomp.txt || [[Trap component]]s.
+
| 64 || SIEGEAMMO || Siege ammo. Subtypes come from item_siegeammo.
 
|-
 
|-
| 68 || DRINK || NONE || [[Alcohol]]ic drinks.
+
| 65 || BALLISTAARROWHEAD || Arrow heads for ballista bolts.
 
|-
 
|-
| 69 || POWDER_MISC || NONE || Powders such as [[flour]], [[gypsum plaster]], [[dye]], or [[sand]].
+
| 66 || TRAPPARTS || {{L|Mechanisms}}.
 
|-
 
|-
| 70 || CHEESE || NONE || Pieces of [[cheese]].
+
| 67 || TRAPCOMP || {{L|Trap component}}s.  Subtypes come from item_trapcomp.
 
|-
 
|-
| 71 || FOOD || item_food.txt || [[Prepared meal]]s.
+
| 68 || DRINK || {{L|Alcohol|Liquids}} from brewed plants.
 
|-
 
|-
| 72 || LIQUID_MISC || NONE || Liquids such as [[water]], [[lye]], and extracts.
+
| 69 || POWDER_MISC || Powders such as {{L|flour}}, {{L|gypsum plaster}}, {{L|dye}}, or {{L|sand}}
 
|-
 
|-
| 73 || COIN || NONE || [[Coin]]s.
+
| 70 || CHEESE || {{L|Cheese}}s.
 
|-
 
|-
| 74 || GLOB || NONE || [[Fat]], [[tallow]], pastes/pressed objects, and small bits of molten rock/metal.
+
| 71 || FOOD || {{L|Prepared meal}}s.
 
|-
 
|-
| 75 || ROCK || NONE || Small rocks (usually [[Knapper|sharpened]] and/or [[Thrower|thrown]] in [[adventurer mode]]).
+
| 72 || LIQUID_MISC || Liquids such as {{L|water}}, {{L|lye}}, and extracts.
 
|-
 
|-
| 76 || PIPE_SECTION || NONE || [[Pipe section]]s.
+
| 73 || COIN || {{L|Coin}}s.
 
|-
 
|-
| 77 || HATCH_COVER || NONE || [[Hatch cover]]s.
+
| 74 || GLOB || {{L|Fat}}, {{L|tallow}} and small bits of molten rock/metal.
 
|-
 
|-
| 78 || GRATE || NONE || [[Grate]]s.
+
| 75 || ROCK || Pebbles (more useful in {{L|Thrower|adventure mode}}.)
 
|-
 
|-
| 79 || QUERN || NONE || [[Quern]]s.
+
| 76 || PIPE_SECTION || {{L|Pipe section}}s.
 
|-
 
|-
| 80 || MILLSTONE || NONE || [[Millstone]]s.
+
| 77 || HATCH_COVER || {{L|Hatch cover}}s.
 
|-
 
|-
| 81 || SPLINT || NONE || [[Splint]]s.
+
| 78 || GRATE || {{L|Grate}}s.
 
|-
 
|-
| 82 || CRUTCH || NONE || [[Crutch]]es.
+
| 79 || QUERN || {{L|Quern}}s.
 
|-
 
|-
| 83 || TRACTION_BENCH || NONE || [[Traction bench]]es.
+
| 80 || MILLSTONE || {{L|Millstone}}s.
 
|-
 
|-
| 84 || ORTHOPEDIC_CAST || NONE || [[Cast]]s.
+
| 81 || SPLINT || {{L|Splint}}s.
|-
 
| 85 || TOOL || item_tool.txt || [[Tool]]s.
 
|-
 
| 86 || SLAB || NONE || [[Slab]]s.
 
|-
 
| 87 || EGG || NONE || [[Egg]]s. Material is CREATURE_ID:CASTE.
 
|}
 
 
 
==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
+
| 82 || CRUTCH || {{L|Crutch}}es.
| NONE
 
| [[Reaction]] [REAGENT]
 
| Matches FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET.
 
 
 
 
|-
 
|-
| ANY_RAW_MATERIAL
+
| 83 || TRACTION_BENCH || {{L|Traction bench}}es.
| NONE
 
| [[Reaction]] [REAGENT]
 
| Matches POWDER_MISC, BAR, BOULDER, or GLOB.
 
 
 
 
|-
 
|-
| CRAFTS
+
| 84 || ORTHOPEDIC_CAST || {{L|Cast}}s.
| 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)