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