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"
Jump to navigation
Jump to search
m (→Limited/Special Use Item Tokens: reword a bit - these are direct substitutes for the item type/subtype, which means you still specify the material normally) |
m |
||
(18 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | {{ | + | {{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. | ||
− | + | 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== | ==Standard Item Tokens== | ||
Line 7: | Line 8: | ||
{| {{prettytable}} class="sortable" | {| {{prettytable}} class="sortable" | ||
|- bgcolor="#ddd" | |- bgcolor="#ddd" | ||
− | ! # !! Token !! Description | + | ! # !! Token !! Subtype !! Description |
|- | |- | ||
− | | 0 || BAR || | + | | 0 || BAR || NONE || [[Bar]]s, such as [[metal]], [[fuel]], or [[soap]]. |
|- | |- | ||
− | | 1 || SMALLGEM || Cut | + | | 1 || SMALLGEM || NONE || Cut [[gem]]stones usable in [[jeweler's workshop]] |
|- | |- | ||
− | | 2 || BLOCKS || | + | | 2 || BLOCKS || NONE || [[Block]]s of any kind. |
|- | |- | ||
− | | 3 || ROUGH || Rough | + | | 3 || ROUGH || NONE || Rough [[gem]]stones or raw [[glass]]. |
|- | |- | ||
− | | 4 || BOULDER / STONE || Raw mined | + | | 4 || BOULDER / STONE || NONE || Raw mined [[stone]]. |
|- | |- | ||
− | | 5 || WOOD || Wooden | + | | 5 || WOOD || NONE || Wooden [[log]]s. |
|- | |- | ||
− | | 6 || DOOR || | + | | 6 || DOOR || NONE || [[Door]]s. |
|- | |- | ||
− | | 7 || FLOODGATE || | + | | 7 || FLOODGATE || NONE || [[Floodgate]]s. |
|- | |- | ||
− | | 8 || BED || | + | | 8 || BED || NONE || [[Bed]]s. |
|- | |- | ||
− | | 9 || CHAIR || | + | | 9 || CHAIR || NONE || [[Chair]]s and thrones. |
|- | |- | ||
− | | 10 || CHAIN || | + | | 10 || CHAIN || NONE || [[Chain]]s and [[rope]]s. |
|- | |- | ||
− | | 11 || FLASK || | + | | 11 || FLASK || NONE || [[Flask]]s. |
|- | |- | ||
− | | 12 || GOBLET || | + | | 12 || GOBLET || NONE || [[Goblet]]s. |
|- | |- | ||
− | | 13 || INSTRUMENT || Musical | + | | 13 || INSTRUMENT || item_instrument.txt || Musical [[instrument]]s. |
|- | |- | ||
− | | 14 || TOY || | + | | 14 || TOY || item_toy.txt || [[Toy]]s. |
|- | |- | ||
− | | 15 || WINDOW || | + | | 15 || WINDOW || NONE || Glass [[window]]s. |
|- | |- | ||
− | | 16 || CAGE || | + | | 16 || CAGE || NONE || [[Cage]]s. |
|- | |- | ||
− | | 17 || BARREL || | + | | 17 || BARREL || NONE || [[Barrel]]s. |
|- | |- | ||
− | | 18 || BUCKET || | + | | 18 || BUCKET || NONE || [[Bucket]]s. |
|- | |- | ||
− | | 19 || ANIMALTRAP || | + | | 19 || ANIMALTRAP || NONE || [[Animal trap]]s. |
|- | |- | ||
− | | 20 || TABLE || | + | | 20 || TABLE || NONE || [[Table]]s. |
|- | |- | ||
− | | 21 || COFFIN || | + | | 21 || COFFIN || NONE || [[Coffin]]s. |
|- | |- | ||
− | | 22 || STATUE || | + | | 22 || STATUE || NONE || [[Statue]]s. |
|- | |- | ||
− | | 23 || CORPSE || | + | | 23 || CORPSE || NONE || [[Corpse]]s. Does not have a material. |
|- | |- | ||
− | | 24 || WEAPON || | + | | 24 || WEAPON || item_weapon.txt || [[Weapon]]s. |
|- | |- | ||
− | | 25 || ARMOR || | + | | 25 || ARMOR || item_armor.txt || [[Armor]] and clothing worn on the upper body. |
|- | |- | ||
− | | 26 || SHOES || Armor and clothing worn on the feet | + | | 26 || SHOES || item_shoes.txt || Armor and clothing worn on the feet. |
|- | |- | ||
− | | 27 || SHIELD || | + | | 27 || SHIELD || item_shield.txt || [[Shield]]s and bucklers. |
|- | |- | ||
− | | 28 || HELM || Armor and clothing worn on the head | + | | 28 || HELM || item_helm.txt || Armor and clothing worn on the head. |
|- | |- | ||
− | | 29 || GLOVES || Armor and clothing worn on the hands | + | | 29 || GLOVES || item_gloves.txt || Armor and clothing worn on the hands. |
|- | |- | ||
− | | 30 || BOX || | + | | 30 || BOX || NONE || [[Container|Chest]]s (wood), coffers (stone), boxes (glass), and bags (cloth or leather). |
|- | |- | ||
− | | 31 || BIN || | + | | 31 || BIN || NONE || [[Bin]]s. |
|- | |- | ||
− | | 32 || ARMORSTAND || | + | | 32 || ARMORSTAND || NONE || [[Armor stand]]s. |
|- | |- | ||
− | | 33 || WEAPONRACK || | + | | 33 || WEAPONRACK || NONE || [[Weapon rack]]s. |
|- | |- | ||
− | | 34 || CABINET || | + | | 34 || CABINET || NONE || [[Cabinet]]s. |
|- | |- | ||
− | | 35 || FIGURINE || | + | | 35 || FIGURINE || NONE || [[Figurine]]s. |
|- | |- | ||
− | | 36 || AMULET || | + | | 36 || AMULET || NONE || [[Amulet]]s. |
|- | |- | ||
− | | 37 || SCEPTER || | + | | 37 || SCEPTER || NONE || [[Scepter]]s. |
|- | |- | ||
− | | 38 || AMMO || | + | | 38 || AMMO || item_ammo.txt || [[Ammunition]] for hand-held weapons. |
|- | |- | ||
− | | 39 || CROWN || | + | | 39 || CROWN || NONE || [[Crown]]s. |
|- | |- | ||
− | | 40 || RING || | + | | 40 || RING || NONE || [[Ring]]s. |
|- | |- | ||
− | | 41 || EARRING || | + | | 41 || EARRING || NONE || [[Earring]]s. |
|- | |- | ||
− | | 42 || BRACELET || | + | | 42 || BRACELET || NONE || [[Bracelet]]s. |
|- | |- | ||
− | | 43 || GEM || Large | + | | 43 || GEM || NONE || Large [[gem]]s. |
|- | |- | ||
− | | 44 || ANVIL || | + | | 44 || ANVIL || NONE || [[Anvil]]s. |
|- | |- | ||
− | | 45 || CORPSEPIECE || | + | | 45 || CORPSEPIECE || NONE || [[Body part]]s. Does not have a material. |
|- | |- | ||
− | | 46 || REMAINS || Dead | + | | 46 || REMAINS || NONE || Dead [[vermin]] bodies. Material is CREATURE_ID:CASTE. |
|- | |- | ||
− | | 47 || MEAT || Butchered | + | | 47 || MEAT || NONE || Butchered [[meat]]. |
|- | |- | ||
− | | 48 || FISH || Prepared | + | | 48 || FISH || NONE || Prepared [[fish]]. Material is CREATURE_ID:CASTE. |
|- | |- | ||
− | | 49 || FISH_RAW || Unprepared fish. | + | | 49 || FISH_RAW || NONE || Unprepared [[fish]]. Material is CREATURE_ID:CASTE. |
|- | |- | ||
− | | 50 || VERMIN || Live | + | | 50 || VERMIN || NONE || Live [[vermin]]. Material is CREATURE_ID:CASTE. |
|- | |- | ||
− | | 51 || PET || Tame vermin. | + | | 51 || PET || NONE || Tame [[vermin]]. Material is CREATURE_ID:CASTE. |
|- | |- | ||
− | | 52 || SEEDS || | + | | 52 || SEEDS || NONE || [[Seed]]s from plants. |
|- | |- | ||
− | | 53 || PLANT || | + | | 53 || PLANT || NONE || [[Plant]]s. |
|- | |- | ||
− | | 54 || SKIN_TANNED || | + | | 54 || SKIN_TANNED || NONE || [[Leather]]. |
|- | |- | ||
− | | 55 || LEAVES || Leaves from | + | | 55 || LEAVES || NONE || Leaves, usually from [[quarry bush]]es. |
|- | |- | ||
− | | 56 || THREAD || | + | | 56 || THREAD || NONE || [[Thread]] gathered from webs or made at the [[farmer's workshop]]. |
|- | |- | ||
− | | 57 || CLOTH || | + | | 57 || CLOTH || NONE || [[Cloth]] made at the [[loom]]. |
|- | |- | ||
− | | 58 || TOTEM || Skull | + | | 58 || TOTEM || NONE || Skull [[totem]]s. |
|- | |- | ||
− | | 59 || PANTS || Armor and clothing worn on the legs | + | | 59 || PANTS || item_pants.txt || Armor and clothing worn on the legs. |
|- | |- | ||
− | | 60 || BACKPACK || | + | | 60 || BACKPACK || NONE || [[Backpack]]s. |
|- | |- | ||
− | | 61 || QUIVER || | + | | 61 || QUIVER || NONE || [[Quiver]]s. |
|- | |- | ||
− | | 62 || CATAPULTPARTS || | + | | 62 || CATAPULTPARTS || NONE || [[Catapult]] parts. |
|- | |- | ||
− | | 63 || BALLISTAPARTS || | + | | 63 || BALLISTAPARTS || NONE || [[Ballista]] parts. |
|- | |- | ||
− | | 64 || SIEGEAMMO || Siege engine ammunition | + | | 64 || SIEGEAMMO || item_siegeammo.txt || Siege engine ammunition. |
|- | |- | ||
− | | 65 || BALLISTAARROWHEAD || | + | | 65 || BALLISTAARROWHEAD || NONE || Ballista arrow heads. |
|- | |- | ||
− | | 66 || TRAPPARTS || | + | | 66 || TRAPPARTS || NONE || [[Mechanism]]s. |
|- | |- | ||
− | | 67 || TRAPCOMP || | + | | 67 || TRAPCOMP || item_trapcomp.txt || [[Trap component]]s. |
|- | |- | ||
− | | 68 || DRINK || | + | | 68 || DRINK || NONE || [[Alcohol]]ic drinks. |
|- | |- | ||
− | | 69 || POWDER_MISC || Powders such as | + | | 69 || POWDER_MISC || NONE || Powders such as [[flour]], [[gypsum plaster]], [[dye]], or [[sand]]. |
|- | |- | ||
− | | 70 || CHEESE || Pieces of | + | | 70 || CHEESE || NONE || Pieces of [[cheese]]. |
|- | |- | ||
− | | 71 || FOOD || | + | | 71 || FOOD || item_food.txt || [[Prepared meal]]s. |
|- | |- | ||
− | | 72 || LIQUID_MISC || Liquids such as | + | | 72 || LIQUID_MISC || NONE || Liquids such as [[water]], [[lye]], and extracts. |
|- | |- | ||
− | | 73 || COIN || | + | | 73 || COIN || NONE || [[Coin]]s. |
|- | |- | ||
− | | 74 || GLOB || | + | | 74 || GLOB || NONE || [[Fat]], [[tallow]], pastes/pressed objects, and small bits of molten rock/metal. |
|- | |- | ||
− | | 75 || ROCK || Small rocks ( | + | | 75 || ROCK || NONE || Small rocks (usually [[Knapper|sharpened]] and/or [[Thrower|thrown]] in [[adventurer mode]]). |
|- | |- | ||
− | | 76 || PIPE_SECTION || | + | | 76 || PIPE_SECTION || NONE || [[Pipe section]]s. |
|- | |- | ||
− | | 77 || HATCH_COVER || | + | | 77 || HATCH_COVER || NONE || [[Hatch cover]]s. |
|- | |- | ||
− | | 78 || GRATE || | + | | 78 || GRATE || NONE || [[Grate]]s. |
|- | |- | ||
− | | 79 || QUERN || | + | | 79 || QUERN || NONE || [[Quern]]s. |
|- | |- | ||
− | | 80 || MILLSTONE || | + | | 80 || MILLSTONE || NONE || [[Millstone]]s. |
|- | |- | ||
− | | 81 || SPLINT || | + | | 81 || SPLINT || NONE || [[Splint]]s. |
|- | |- | ||
− | | 82 || CRUTCH || | + | | 82 || CRUTCH || NONE || [[Crutch]]es. |
|- | |- | ||
− | | 83 || TRACTION_BENCH || | + | | 83 || TRACTION_BENCH || NONE || [[Traction bench]]es. |
|- | |- | ||
− | | 84 || ORTHOPEDIC_CAST || | + | | 84 || ORTHOPEDIC_CAST || NONE || [[Cast]]s. |
|- | |- | ||
− | | 85 || TOOL || | + | | 85 || TOOL || item_tool.txt || [[Tool]]s. |
|- | |- | ||
− | | 86 || SLAB || | + | | 86 || SLAB || NONE || [[Slab]]s. |
|- | |- | ||
− | | 87 || EGG || | + | | 87 || EGG || NONE || [[Egg]]s. Material is CREATURE_ID:CASTE. |
|} | |} | ||
− | |||
==Limited/Special Use Item Tokens== | ==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 | + | 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}} | {| {{prettytable}} | ||
|- style='background-color:#ddd' | |- style='background-color:#ddd' | ||
! Token | ! Token | ||
− | ! | + | ! Subtype |
! Valid Uses | ! Valid Uses | ||
! Description | ! Description | ||
Line 201: | Line 201: | ||
| ANY_CRAFT | | ANY_CRAFT | ||
| NONE | | NONE | ||
− | | | + | | [[Reaction]] [REAGENT] |
| Matches FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET. | | Matches FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET. | ||
Line 207: | Line 207: | ||
| ANY_RAW_MATERIAL | | ANY_RAW_MATERIAL | ||
| NONE | | NONE | ||
− | | | + | | [[Reaction]] [REAGENT] |
| Matches POWDER_MISC, BAR, BOULDER, or GLOB. | | Matches POWDER_MISC, BAR, BOULDER, or GLOB. | ||
Line 213: | Line 213: | ||
| CRAFTS | | CRAFTS | ||
| NONE | | NONE | ||
− | | | + | | [[Reaction]] [PRODUCT] |
| Produces 1-3 items of type FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET. | | 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>:###]. |