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