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 "Item token"
Jump to navigation
Jump to search
(→Standard Item Tokens: minor change, specified what the "dominant material" returned by corpses normally was) |
m (Add more descriptions for items that vary based on materials) |
||
Line 25: | Line 25: | ||
| 5 || {{text anchor|WOOD}} || NONE || Wooden [[log]]s. | | 5 || {{text anchor|WOOD}} || NONE || Wooden [[log]]s. | ||
|- | |- | ||
− | | 6 || {{text anchor|DOOR}} || NONE || [[Door]]s. | + | | 6 || {{text anchor|DOOR}} || NONE || [[Door]]s and glass portals. |
|- | |- | ||
| 7 || {{text anchor|FLOODGATE}} || NONE || [[Floodgate]]s. | | 7 || {{text anchor|FLOODGATE}} || NONE || [[Floodgate]]s. | ||
Line 35: | Line 35: | ||
| 10 || {{text anchor|CHAIN}} || NONE || [[Chain]]s and [[rope]]s. | | 10 || {{text anchor|CHAIN}} || NONE || [[Chain]]s and [[rope]]s. | ||
|- | |- | ||
− | | 11 || {{text anchor|FLASK}} || NONE || [[Flask]]s. | + | | 11 || {{text anchor|FLASK}} || NONE || [[Flask]]s, vials, and waterskins. |
|- | |- | ||
− | | 12 || {{text anchor|GOBLET}} || NONE || [[Goblet]]s. | + | | 12 || {{text anchor|GOBLET}} || NONE || [[Goblet]]s, mugs, and cups. |
|- | |- | ||
| 13 || {{text anchor|INSTRUMENT}} || item_instrument.txt || Musical [[instrument]]s. | | 13 || {{text anchor|INSTRUMENT}} || item_instrument.txt || Musical [[instrument]]s. | ||
Line 45: | Line 45: | ||
| 15 || {{text anchor|WINDOW}} || NONE || Glass [[window]]s. | | 15 || {{text anchor|WINDOW}} || NONE || Glass [[window]]s. | ||
|- | |- | ||
− | | 16 || {{text anchor|CAGE}} || NONE || [[Cage]]s. | + | | 16 || {{text anchor|CAGE}} || NONE || [[Cage]]s and terrariums. |
|- | |- | ||
| 17 || {{text anchor|BARREL}} || NONE || [[Barrel]]s. | | 17 || {{text anchor|BARREL}} || NONE || [[Barrel]]s. | ||
Line 55: | Line 55: | ||
| 20 || {{text anchor|TABLE}} || NONE || [[Table]]s. | | 20 || {{text anchor|TABLE}} || NONE || [[Table]]s. | ||
|- | |- | ||
− | | 21 || {{text anchor|COFFIN}} || NONE || [[Coffin]]s. | + | | 21 || {{text anchor|COFFIN}} || NONE || [[Coffin]]s, caskets, and sarcophagi. |
|- | |- | ||
| 22 || {{text anchor|STATUE}} || NONE || [[Statue]]s. | | 22 || {{text anchor|STATUE}} || NONE || [[Statue]]s. | ||
Line 111: | Line 111: | ||
| 48 || {{text anchor|FISH}} || NONE || Prepared [[fish]]. Material is CREATURE_ID:CASTE. | | 48 || {{text anchor|FISH}} || NONE || Prepared [[fish]]. Material is CREATURE_ID:CASTE. | ||
|- | |- | ||
− | | 49 || {{text anchor|FISH_RAW}} || NONE || | + | | 49 || {{text anchor|FISH_RAW}} || NONE || Freshly-caught [[fish]]. Material is CREATURE_ID:CASTE. |
|- | |- | ||
| 50 || {{text anchor|VERMIN}} || NONE || Live [[vermin]]. Material is CREATURE_ID:CASTE. | | 50 || {{text anchor|VERMIN}} || NONE || Live [[vermin]]. Material is CREATURE_ID:CASTE. | ||
Line 125: | Line 125: | ||
| 55 || {{text anchor|PLANT_GROWTH}} || growth ID || Plant growths. Subtype is the GROWTH's identifier within the [[plant token|plant raws]] (e.g. "LEAVES" or "FLOWERS" for most trees) | | 55 || {{text anchor|PLANT_GROWTH}} || growth ID || Plant growths. Subtype is the GROWTH's identifier within the [[plant token|plant raws]] (e.g. "LEAVES" or "FLOWERS" for most trees) | ||
|- | |- | ||
− | | 56 || {{text anchor|THREAD}} || NONE || [[Thread]] | + | | 56 || {{text anchor|THREAD}} || NONE || [[Thread]] (made at the [[farmer's workshop]]), [[web]]s (collected or undisturbed), and [[strand extactor|strands extracted]] from [[raw adamantine|suitable stones]]. Standard dimension = 15000. |
|- | |- | ||
| 57 || {{text anchor|CLOTH}} || NONE || [[Cloth]] made at the [[loom]]. Standard dimension = 10000. | | 57 || {{text anchor|CLOTH}} || NONE || [[Cloth]] made at the [[loom]]. Standard dimension = 10000. | ||
Line 151: | Line 151: | ||
| 68 || {{text anchor|DRINK}} || NONE || [[Alcohol]]ic drinks. Standard dimension = 150. | | 68 || {{text anchor|DRINK}} || NONE || [[Alcohol]]ic drinks. Standard dimension = 150. | ||
|- | |- | ||
− | | 69 || {{text anchor|POWDER_MISC}} || NONE || Powders such as [[flour]], [[ | + | | 69 || {{text anchor|POWDER_MISC}} || NONE || Powders such as [[flour]], [[dye]], [[sand]], or [[gypsum plaster]]. Standard dimension = 150. |
|- | |- | ||
| 70 || {{text anchor|CHEESE}} || NONE || Pieces of [[cheese]]. | | 70 || {{text anchor|CHEESE}} || NONE || Pieces of [[cheese]]. | ||
Line 165: | Line 165: | ||
| 75 || {{text anchor|ROCK}} || NONE || Small rocks (usually [[Knapper|sharpened]] and/or [[Thrower|thrown]] in [[adventurer mode]]). | | 75 || {{text anchor|ROCK}} || NONE || Small rocks (usually [[Knapper|sharpened]] and/or [[Thrower|thrown]] in [[adventurer mode]]). | ||
|- | |- | ||
− | | 76 || {{text anchor|PIPE_SECTION}} || NONE || [[Pipe section]]s. | + | | 76 || {{text anchor|PIPE_SECTION}} || NONE || [[Pipe section]]s and glass tubes. |
|- | |- | ||
| 77 || {{text anchor|HATCH_COVER}} || NONE || [[Hatch cover]]s. | | 77 || {{text anchor|HATCH_COVER}} || NONE || [[Hatch cover]]s. | ||
Line 185: | Line 185: | ||
| 85 || {{text anchor|TOOL}} || item_tool.txt || [[Tool]]s. | | 85 || {{text anchor|TOOL}} || item_tool.txt || [[Tool]]s. | ||
|- | |- | ||
− | | 86 || {{text anchor|SLAB}} || NONE || [[Slab]]s. | + | | 86 || {{text anchor|SLAB}} || NONE || [[Slab]]s, memorials, and shop signs. |
|- | |- | ||
| 87 || {{text anchor|EGG}} || NONE || [[Egg]]s. Material is CREATURE_ID:CASTE. | | 87 || {{text anchor|EGG}} || NONE || [[Egg]]s. Material is CREATURE_ID:CASTE. |
Revision as of 20:03, 11 November 2020
v50.14 · v0.47.05 This article is about the current version of DF.Note that some content may still need to be updated. |
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 the item, made more specific by material tokens. Most item tokens do not have a subtype; for these, either NO_SUBTYPE or NONE must be specified.
Nearly all items are made of a material, though several types expect a creature ID and caste ID (e.g. ANT:SOLDIER) instead.
Actually defining an item in the item raws is done with item definition tokens.
Standard Item Tokens
# | Token | Subtype | Description |
---|---|---|---|
0 | BAR | NONE | Bars, such as metal, fuel, or soap. Standard dimension = 150. |
1 | SMALLGEM | NONE | Cut gemstones usable in the 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 and glass portals. |
7 | FLOODGATE | NONE | Floodgates. |
8 | BED | NONE | Beds. |
9 | CHAIR | NONE | Chairs and thrones. |
10 | CHAIN | NONE | Chains and ropes. |
11 | FLASK | NONE | Flasks, vials, and waterskins. |
12 | GOBLET | NONE | Goblets, mugs, and cups. |
13 | INSTRUMENT | item_instrument.txt | Musical instruments. |
14 | TOY | item_toy.txt | Toys. |
15 | WINDOW | NONE | Glass windows. |
16 | CAGE | NONE | Cages and terrariums. |
17 | BARREL | NONE | Barrels. |
18 | BUCKET | NONE | Buckets. |
19 | ANIMALTRAP | NONE | Animal traps. |
20 | TABLE | NONE | Tables. |
21 | COFFIN | NONE | Coffins, caskets, and sarcophagi. |
22 | STATUE | NONE | Statues. |
23 | CORPSE | NONE | Corpses. Does not have a material that can be specified for reactions, but GET_MATERIAL_FROM_REAGENT will return the "dominant" material. (Normally flesh) |
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, default), 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 that can be specified for reactions, but GET_MATERIAL_FROM_REAGENT will return the "dominant" 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 | Freshly-caught 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 | PLANT_GROWTH | growth ID | Plant growths. Subtype is the GROWTH's identifier within the plant raws (e.g. "LEAVES" or "FLOWERS" for most trees) |
56 | THREAD | NONE | Thread (made at the farmer's workshop), webs (collected or undisturbed), and strands extracted from suitable stones. Standard dimension = 15000. |
57 | CLOTH | NONE | Cloth made at the loom. Standard dimension = 10000. |
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. Standard dimension = 150. |
69 | POWDER_MISC | NONE | Powders such as flour, dye, sand, or gypsum plaster. Standard dimension = 150. |
70 | CHEESE | NONE | Pieces of cheese. |
71 | FOOD | item_food.txt | Prepared meals. |
72 | LIQUID_MISC | NONE | Liquids such as water, lye, and extracts. Standard dimension = 150. |
73 | COIN | NONE | Coins. |
74 | GLOB | NONE | Fat, tallow, pastes/pressed objects, and small bits of molten rock/metal. Standard dimension = 150. |
75 | ROCK | NONE | Small rocks (usually sharpened and/or thrown in adventurer mode). |
76 | PIPE_SECTION | NONE | Pipe sections and glass tubes. |
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, memorials, and shop signs. |
87 | EGG | NONE | Eggs. Material is CREATURE_ID:CASTE. |
88 | BOOK | NONE | Books. |
89 | SHEET | NONE | Sheets. Paper, papyrus, or parchment. Used for making quires and scrolls. |
90 | BRANCH | NONE | Branches plucked from trees, used for making stone axes in adventurer mode. |
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 | 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 any type possible to make with the specified material, normally the types FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET, however GEM is also possible for some materials and there may be other possible results. The output depends entirely on the material used, and incredibly unusual materials may produce nothing at all, although most vanilla materials will produce GEMs at the very least. |
Related Tokens
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>:###]. |