v0.31:Item token

v50.14 · v0.47 · v0.34 · v0.31.25 · v0.28 · v0.23 This article is about an older version of DF. More Info · V

xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼

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 correctly^Bug: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]	This functions a bit differently from the other tokens. It Seems to call for a stone/boulder (only????) of a material with a [METAL_ORE:<Metal>:<percentage>] token for the metal specified. This token is therefore more specific and seems to fill the role of both the item token and the material token in a reaction reagent. Found in the "(use ore)" versions of smelter reactions.

See Also

• Material token
• Reactions