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:Item token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(mapped exact ID values as they would be used in memory hacking (e.g. examining strange mood requirements))
m
 
(38 intermediate revisions by 6 users not shown)
Line 1: Line 1:
{{av}}{{Quality|Fine}}
+
{{Quality|Superior|01:24, 8 July 2013 (UTC)}}
 +
{{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.
  
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.
+
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".
 +
 
 +
==Standard Item Tokens==
  
 
{| {{prettytable}} class="sortable"
 
{| {{prettytable}} class="sortable"
 
|- bgcolor="#ddd"
 
|- bgcolor="#ddd"
! ID !! Token !! Description
+
! # !! Token !! Subtype !! 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 || Bars, such as metal, fuel, or soap.
+
| 3 || ROUGH || NONE || Rough [[gem]]stones or raw [[glass]].
 
|-
 
|-
| 1 || SMALLGEM || Cut gemstones usable in jeweler's workshop
+
| 4 || BOULDER / STONE || NONE || Raw mined [[stone]].
 
|-
 
|-
| 2 || BLOCKS || Blocks of any kind.
+
| 5 || WOOD || NONE || Wooden [[log]]s.
 
|-
 
|-
| 3 || ROUGH || Rough gemstones.
+
| 6 || DOOR || NONE || [[Door]]s.
 
|-
 
|-
| 4 || BOULDER / STONE || Raw mined stone.
+
| 7 || FLOODGATE || NONE || [[Floodgate]]s.
 
|-
 
|-
| 5 || WOOD || Wooden logs.
+
| 8 || BED || NONE || [[Bed]]s.
 
|-
 
|-
| 6 || DOOR || Doors.
+
| 9 || CHAIR || NONE || [[Chair]]s and thrones.
 
|-
 
|-
| 7 || FLOODGATE || Floodgates.
+
| 10 || CHAIN || NONE || [[Chain]]s and [[rope]]s.
 
|-
 
|-
| 8 || BED || Beds.
+
| 11 || FLASK || NONE || [[Flask]]s.
 
|-
 
|-
| 9 || CHAIR || Chairs and thrones.
+
| 12 || GOBLET || NONE || [[Goblet]]s.
 
|-
 
|-
| 10 || CHAIN || Chains and ropes.
+
| 13 || INSTRUMENT || item_instrument.txt || Musical [[instrument]]s.
 
|-
 
|-
| 11 || FLASK || Flasks.
+
| 14 || TOY || item_toy.txt || [[Toy]]s.
 
|-
 
|-
| 12 || GOBLET || Goblets, cups (wooden), and mugs (rock).
+
| 15 || WINDOW || NONE || Glass [[window]]s.
 
|-
 
|-
| 13 || INSTRUMENT || Musical instruments.  Subtypes come from item_instrument.
+
| 16 || CAGE || NONE || [[Cage]]s.
 
|-
 
|-
| 14 || TOY || Toys.  Subtypes come from item_toy.
+
| 17 || BARREL || NONE || [[Barrel]]s.
 
|-
 
|-
| 15 || WINDOW || Windows.
+
| 18 || BUCKET || NONE || [[Bucket]]s.
 
|-
 
|-
| 16 || CAGE || Cages.
+
| 19 || ANIMALTRAP || NONE || [[Animal trap]]s.
 
|-
 
|-
| 17 || BARREL || Barrels.
+
| 20 || TABLE || NONE || [[Table]]s.
 
|-
 
|-
| 18 || BUCKET || Buckets.
+
| 21 || COFFIN || NONE || [[Coffin]]s.
 
|-
 
|-
| 19 || ANIMALTRAP || Traps for animals.
+
| 22 || STATUE || NONE || [[Statue]]s.
 
|-
 
|-
| 20 || TABLE || Tables.
+
| 23 || CORPSE || NONE || [[Corpse]]s. Does not have a material.
 
|-
 
|-
| 21 || COFFIN || Coffins and caskets.
+
| 24 || WEAPON || item_weapon.txt || [[Weapon]]s.
 
|-
 
|-
| 22 || STATUE || Statues.
+
| 25 || ARMOR || item_armor.txt || [[Armor]] and clothing worn on the upper body.
 
|-
 
|-
| 23 || CORPSE || Dead things.
+
| 26 || SHOES || item_shoes.txt || Armor and clothing worn on the feet.
 
|-
 
|-
| 24 || WEAPON || Weapons. Subtypes come from item_weapon.
+
| 27 || SHIELD || item_shield.txt || [[Shield]]s and bucklers.
 
|-
 
|-
| 25 || ARMOR || 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 || Shields 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 || Chests (wood), coffers (stone), boxes (glass), and bags (cloth or leather).
+
| 33 || WEAPONRACK || NONE || [[Weapon rack]]s.
 
|-
 
|-
| 31 || BIN || Bins.
+
| 34 || CABINET || NONE || [[Cabinet]]s.
 
|-
 
|-
| 32 || ARMORSTAND || Armor stands.
+
| 35 || FIGURINE || NONE || [[Figurine]]s.
 
|-
 
|-
| 33 || WEAPONRACK || Weapon racks.
+
| 36 || AMULET || NONE || [[Amulet]]s.
 
|-
 
|-
| 34 || CABINET || Cabinets.
+
| 37 || SCEPTER || NONE || [[Scepter]]s.
 
|-
 
|-
| 35 || FIGURINE || Figurines.
+
| 38 || AMMO || item_ammo.txt || [[Ammunition]] for hand-held weapons.
 
|-
 
|-
| 36 || AMULET || Amulets.
+
| 39 || CROWN || NONE || [[Crown]]s.
 
|-
 
|-
| 37 || SCEPTER || Scepters.
+
| 40 || RING || NONE || [[Ring]]s.
 
|-
 
|-
| 38 || AMMO || Ammunition for hand-held weapons.  Subtypes come from item_ammo.
+
| 41 || EARRING || NONE || [[Earring]]s.
 
|-
 
|-
| 39 || CROWN || Crowns.
+
| 42 || BRACELET || NONE || [[Bracelet]]s.
 
|-
 
|-
| 40 || RING || Rings.
+
| 43 || GEM || NONE || Large [[gem]]s.
 
|-
 
|-
| 41 || EARRING || Earrings.
+
| 44 || ANVIL || NONE || [[Anvil]]s.
 
|-
 
|-
| 42 || BRACELET || Bracelets.
+
| 45 || CORPSEPIECE || NONE || [[Body part]]s. Does not have a material.
 
|-
 
|-
| 43 || GEM || Large gems.
+
| 46 || REMAINS || NONE || Dead [[vermin]] bodies. Material is CREATURE_ID:CASTE.
 
|-
 
|-
| 44 || ANVIL || Anvils.
+
| 47 || MEAT || NONE || Butchered [[meat]].
 
|-
 
|-
| 45 || CORPSEPIECE || Body parts.
+
| 48 || FISH || NONE || Prepared [[fish]]. Material is CREATURE_ID:CASTE.
 
|-
 
|-
| 46 || REMAINS || Dead vermin bodies. Material is a creature ID.
+
| 49 || FISH_RAW || NONE || Unprepared [[fish]]. Material is CREATURE_ID:CASTE.
 
|-
 
|-
| 47 || MEAT || Butchered meat. Material is a creature ID.
+
| 50 || VERMIN || NONE || Live [[vermin]]. Material is CREATURE_ID:CASTE.
 
|-
 
|-
| 48 || FISH || Prepared fish. Material is a creature ID.
+
| 51 || PET || NONE || Tame [[vermin]]. Material is CREATURE_ID:CASTE.
 
|-
 
|-
| 49 || FISH_RAW || Unprepared fish. Material is a creature ID.
+
| 52 || SEEDS || NONE || [[Seed]]s from plants.
 
|-
 
|-
| 50 || VERMIN || Small pseudo-creatures. Material is a creature ID.
+
| 53 || PLANT || NONE || [[Plant]]s.
 
|-
 
|-
| 51 || PET || Tame vermin. Material is a creature ID.
+
| 54 || SKIN_TANNED || NONE || [[Leather]].
 
|-
 
|-
| 52 || SEEDS || Seeds from plants.
+
| 55 || LEAVES || NONE || Leaves, usually from [[quarry bush]]es.
 
|-
 
|-
| 53 || PLANT || Plants. Material is a plant ID.
+
| 56 || THREAD || NONE || [[Thread]] gathered from webs or made at the [[farmer's workshop]].
 
|-
 
|-
| 54 || SKIN_TANNED || 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 || 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 || Cloth made at the loom.
+
| 60 || BACKPACK || NONE || [[Backpack]]s.
 
|-
 
|-
| 58 || TOTEM || Totems.
+
| 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 || Backpacks.
+
| 63 || BALLISTAPARTS || NONE || [[Ballista]] parts.
 
|-
 
|-
| 61 || QUIVER || Quivers.
+
| 64 || SIEGEAMMO || item_siegeammo.txt || Siege engine ammunition.
 
|-
 
|-
| 62 || CATAPULTPARTS || Catapult parts.
+
| 65 || BALLISTAARROWHEAD || NONE || Ballista arrow heads.
 
|-
 
|-
| 63 || BALLISTAPARTS || 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 || Mechanisms.
+
| 69 || POWDER_MISC || NONE || Powders such as [[flour]], [[gypsum plaster]], [[dye]], or [[sand]].
 
|-
 
|-
| 67 || TRAPCOMP || Weapons for traps only.  Subtypes come from item_trapcomp.
+
| 70 || CHEESE || NONE || Pieces of [[cheese]].
 
|-
 
|-
| 68 || DRINK || Liquids from brewed plants.
+
| 71 || FOOD || item_food.txt || [[Prepared meal]]s.
 
|-
 
|-
| 69 || POWDER_MISC || Powders such as flour, plaster, dye, or sand
+
| 72 || LIQUID_MISC || NONE || Liquids such as [[water]], [[lye]], and extracts.
 
|-
 
|-
| 70 || CHEESE || Cheeses.
+
| 73 || COIN || NONE || [[Coin]]s.
 
|-
 
|-
| 71 || FOOD || Prepared food.
+
| 74 || GLOB || NONE || [[Fat]], [[tallow]], pastes/pressed objects, and small bits of molten rock/metal.
 
|-
 
|-
| 72 || LIQUID_MISC || Miscellaneous liquids such as lye.
+
| 75 || ROCK || NONE || Small rocks (usually [[Knapper|sharpened]] and/or [[Thrower|thrown]] in [[adventurer mode]]).
 
|-
 
|-
| 73 || COIN || Coins.
+
| 76 || PIPE_SECTION || NONE || [[Pipe section]]s.
 
|-
 
|-
| 74 || GLOB || Fat, 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 || Pipe sections.
+
| 79 || QUERN || NONE || [[Quern]]s.
 
|-
 
|-
| 77 || HATCH_COVER || Hatch covers.
+
| 80 || MILLSTONE || NONE || [[Millstone]]s.
 
|-
 
|-
| 78 || GRATE || Grates.
+
| 81 || SPLINT || NONE || [[Splint]]s.
 
|-
 
|-
| 79 || QUERN || Querns.
+
| 82 || CRUTCH || NONE || [[Crutch]]es.
 
|-
 
|-
| 80 || MILLSTONE || Millstones.
+
| 83 || TRACTION_BENCH || NONE || [[Traction bench]]es.
 
|-
 
|-
| 81 || SPLINT || Splints.
+
| 84 || ORTHOPEDIC_CAST || NONE || [[Cast]]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
 +
 
 
|-
 
|-
| 82 || CRUTCH || Crutches.
+
| ANY_CRAFT
 +
| NONE
 +
| [[Reaction]] [REAGENT]
 +
| Matches FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET.
 +
 
 
|-
 
|-
| 83 || TRACTION_BENCH || Traction benches.
+
| ANY_RAW_MATERIAL
 +
| NONE
 +
| [[Reaction]] [REAGENT]
 +
| Matches POWDER_MISC, BAR, BOULDER, or GLOB.
 +
 
 
|-
 
|-
| 84 || ORTHOPEDIC_CAST || Casts.
+
| 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}}

Latest revision as of 13:53, 2 May 2020

This article is about an older version of DF.

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 tokens. Most item tokens use NO_SUBTYPE or NONE for subtype.

Nearly all items are made of a material, though several types expect a creature ID and caste ID (e.g. ANT:SOLDIER) instead; unfortunately, this is broken in versions prior to v0.43.03Bug:4973 and treats the caste as if it were "NONE".

Standard Item Tokens[edit]

# Token Subtype Description
0 BAR NONE Bars, such as metal, fuel, or soap.
1 SMALLGEM NONE Cut gemstones usable in jeweler's workshop
2 BLOCKS NONE Blocks of any kind.
3 ROUGH NONE Rough gemstones or raw glass.
4 BOULDER / STONE NONE Raw mined stone.
5 WOOD NONE Wooden logs.
6 DOOR NONE Doors.
7 FLOODGATE NONE Floodgates.
8 BED NONE Beds.
9 CHAIR NONE Chairs and thrones.
10 CHAIN NONE Chains and ropes.
11 FLASK NONE Flasks.
12 GOBLET NONE Goblets.
13 INSTRUMENT item_instrument.txt Musical instruments.
14 TOY item_toy.txt Toys.
15 WINDOW NONE Glass windows.
16 CAGE NONE Cages.
17 BARREL NONE Barrels.
18 BUCKET NONE Buckets.
19 ANIMALTRAP NONE Animal traps.
20 TABLE NONE Tables.
21 COFFIN NONE Coffins.
22 STATUE NONE Statues.
23 CORPSE NONE Corpses. Does not have a material.
24 WEAPON item_weapon.txt Weapons.
25 ARMOR item_armor.txt Armor and clothing worn on the upper body.
26 SHOES item_shoes.txt Armor and clothing worn on the feet.
27 SHIELD item_shield.txt Shields and bucklers.
28 HELM item_helm.txt Armor and clothing worn on the head.
29 GLOVES item_gloves.txt Armor and clothing worn on the hands.
30 BOX NONE Chests (wood), coffers (stone), boxes (glass), and bags (cloth or leather).
31 BIN NONE Bins.
32 ARMORSTAND NONE Armor stands.
33 WEAPONRACK NONE Weapon racks.
34 CABINET NONE Cabinets.
35 FIGURINE NONE Figurines.
36 AMULET NONE Amulets.
37 SCEPTER NONE Scepters.
38 AMMO item_ammo.txt Ammunition for hand-held weapons.
39 CROWN NONE Crowns.
40 RING NONE Rings.
41 EARRING NONE Earrings.
42 BRACELET NONE Bracelets.
43 GEM NONE Large gems.
44 ANVIL NONE Anvils.
45 CORPSEPIECE NONE Body parts. Does not have a material.
46 REMAINS NONE Dead vermin bodies. Material is CREATURE_ID:CASTE.
47 MEAT NONE Butchered meat.
48 FISH NONE Prepared fish. Material is CREATURE_ID:CASTE.
49 FISH_RAW NONE Unprepared fish. Material is CREATURE_ID:CASTE.
50 VERMIN NONE Live vermin. Material is CREATURE_ID:CASTE.
51 PET NONE Tame vermin. Material is CREATURE_ID:CASTE.
52 SEEDS NONE Seeds from plants.
53 PLANT NONE Plants.
54 SKIN_TANNED NONE Leather.
55 LEAVES NONE Leaves, usually from quarry bushes.
56 THREAD NONE Thread gathered from webs or made at the farmer's workshop.
57 CLOTH NONE Cloth made at the loom.
58 TOTEM NONE Skull totems.
59 PANTS item_pants.txt Armor and clothing worn on the legs.
60 BACKPACK NONE Backpacks.
61 QUIVER NONE Quivers.
62 CATAPULTPARTS NONE Catapult parts.
63 BALLISTAPARTS NONE Ballista parts.
64 SIEGEAMMO item_siegeammo.txt Siege engine ammunition.
65 BALLISTAARROWHEAD NONE Ballista arrow heads.
66 TRAPPARTS NONE Mechanisms.
67 TRAPCOMP item_trapcomp.txt Trap components.
68 DRINK NONE Alcoholic drinks.
69 POWDER_MISC NONE Powders such as flour, gypsum plaster, dye, or sand.
70 CHEESE NONE Pieces of cheese.
71 FOOD item_food.txt Prepared meals.
72 LIQUID_MISC NONE Liquids such as water, lye, and extracts.
73 COIN NONE Coins.
74 GLOB NONE Fat, tallow, pastes/pressed objects, and small bits of molten rock/metal.
75 ROCK NONE Small rocks (usually sharpened and/or thrown in adventurer mode).
76 PIPE_SECTION NONE Pipe sections.
77 HATCH_COVER NONE Hatch covers.
78 GRATE NONE Grates.
79 QUERN NONE Querns.
80 MILLSTONE NONE Millstones.
81 SPLINT NONE Splints.
82 CRUTCH NONE Crutches.
83 TRACTION_BENCH NONE Traction benches.
84 ORTHOPEDIC_CAST NONE Casts.
85 TOOL item_tool.txt Tools.
86 SLAB NONE Slabs.
87 EGG NONE Eggs. Material is CREATURE_ID:CASTE.

Limited/Special Use Item Tokens[edit]

In several specific locations, the values below can be substituted for the item type and subtype (and be followed directly by the material token).

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[edit]

These tokens are not Item Tokens at all, but can take the place of them in some circumstances.

Token Subtype Valid Uses Description
METAL_ORE Metal Reaction [REAGENT] Matches a BOULDER item made of a material having [METAL_ORE:<Metal>:###].

See Also[edit]