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 "Tool token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
m
(→‎Tokens: Hyperlinks)
 
(11 intermediate revisions by 8 users not shown)
Line 1: Line 1:
{{Quality|Superior|12:23, 18 May 2015 (UTC)}}
+
{{Quality|Superior}}
 
{{av}}
 
{{av}}
 +
{{Modding}}
  
 +
{{clear}}
 +
 +
==Tokens==
 
{| {{prettytable}}
 
{| {{prettytable}}
 
|- bgcolor="#999999"
 
|- bgcolor="#999999"
Line 16: Line 20:
  
 
|-
 
|-
| {{text anchor|BONE_MAT}}{{version|0.42.01}}
+
| {{text anchor|BONE_MAT}}
 
|
 
|
| Permits the tool to be made from any bone.
+
| Permits the tool to be made from any [[bone]]. Default jobs for [[bone]] tools can only be performed by work order. {{bug|12689}}
  
 
|-
 
|-
| {{text anchor|CERAMIC_MAT}}{{version|0.42.01}}
+
| {{text anchor|CERAMIC_MAT}}
 
|
 
|
| Permits the tool to be made from any ceramic material.
+
| Permits the tool to be made from any material that {{token|IS_CERAMIC|md}}.
  
 
|-
 
|-
| {{text anchor|DESCRIPTION}}{{version|0.42.01}}
+
| {{text anchor|DESCRIPTION}}
 
|
 
|
| Allows a string to describe the tool when {{key|v}}iewed. The text box can accommodate up to 325 characters until it cuts off, but the spacing of actual sentences puts the realistic limit closer to 300.
+
| Allows a string to describe the tool when {{key|v}}iewed. The text box can accommodate up to 325 characters until it cuts off, but the spacing of actual sentences puts the realistic limit closer to 300.  Multiple DESCRIPTION tokens can be used in the same tool definition, with each appearing on a new line.
  
 
|-
 
|-
| {{text anchor|GLASS_MAT}}{{version|0.42.01}}
+
| {{text anchor|GLASS_MAT}}
 
|
 
|
| Permits the tool to be made from any glass.
+
| Permits the tool to be made from any [[glass]].
  
 
|-
 
|-
 
| {{text anchor|HARD_MAT}}
 
| {{text anchor|HARD_MAT}}
 
|
 
|
| Permits the tool to be made from anything with the [ITEMS_HARD] token, such as wood, stone or metal.
+
| Permits the tool to be made from anything with the {{token|ITEMS_HARD|md}} token, such as [[wood]], [[stone]] or [[metal]].
  
 
|-
 
|-
| {{text anchor|LEATHER_MAT}}{{version|0.42.01}}
+
| {{text anchor|LEATHER_MAT}}
 
|
 
|
| Permits the tool to be made from any leather.
+
| Permits the tool to be made from any [[leather]].
  
 
|-
 
|-
 
| {{text anchor|METAL_MAT}}
 
| {{text anchor|METAL_MAT}}
 
|
 
|
| Permits the tool to be made from anything with the [IS_METAL] token.
+
| Permits the tool to be made from anything with the {{token|IS_METAL|md}} token.
  
 
|-
 
|-
 
| {{text anchor|METAL_WEAPON_MAT}}
 
| {{text anchor|METAL_WEAPON_MAT}}
 
|
 
|
| Permits the tool to be made from any metal with the [ITEMS_WEAPON] token.
+
| Permits the tool to be made from any [[metal]] with the {{token|ITEMS_WEAPON|md}} token.
  
 
|-
 
|-
| {{text anchor|SHEET_MAT}}{{version|0.42.01}}
+
| {{text anchor|SHEET_MAT}}
 
|
 
|
| Permits the tool to be made from any "sheet" material, such as papyrus, paper, and parchment. Connected to the PAPER_SLURRY/PAPER_PLANT reaction classes?{{verify}}
+
| Permits the tool to be made from any [[sheet]] material, such as papyrus, paper, and parchment. Connected to the PAPER_SLURRY/PAPER_PLANT reaction classes?{{verify}}
  
 
|-
 
|-
| {{text anchor|SHELL_MAT}}{{version|0.42.01}}
+
| {{text anchor|SHELL_MAT}}
 
|
 
|
| Permits the tool to be made from any shell.
+
| Permits the tool to be made from any [[shell]].
  
 
|-
 
|-
| {{text anchor|SILK_MAT}}{{version|0.42.01}}
+
| {{text anchor|SILK_MAT}}
 
|
 
|
| Permits the tool to be made from any silk.
+
| Permits the tool to be made from any [[silk]].
  
 
|-
 
|-
 
| {{text anchor|SOFT_MAT}}
 
| {{text anchor|SOFT_MAT}}
 
|
 
|
| Permits the tool to be made from any material with the [ITEMS_SOFT] token, such as leather or textiles.
+
| Permits the tool to be made from any material with the {{token|ITEMS_SOFT|md}} token, such as leather or textiles.
  
 
|-
 
|-
| {{text anchor|STONE_MAT}}{{version|0.42.01}}
+
| {{text anchor|STONE_MAT}}
 
|
 
|
| Permits the tool to be made from any stone. Presumably connected to the [IS_STONE] token.
+
| Permits the tool to be made from any stone. Presumably connected to the {{token|IS_STONE|md}} token.
  
 
|-
 
|-
| {{text anchor|THREAD_PLANT_MAT}}{{version|0.42.01}}
+
| {{text anchor|THREAD_PLANT_MAT}}
 
|
 
|
| Permits the tool to be made from any plant fiber, such as pig tails.
+
| Permits the tool to be made from any [[plant fiber]], such as [[pig tail]]s.
  
 
|-
 
|-
 
| {{text anchor|WOOD_MAT}}
 
| {{text anchor|WOOD_MAT}}
 
|
 
|
| Permits the tool to be made from any wood.
+
| Permits the tool to be made from any [[wood]].
  
 
|-
 
|-
| {{text anchor|INCOMPLETE_ITEM}}{{version|0.42.01}}
+
| {{text anchor|INCOMPLETE_ITEM}}
 
|
 
|
 
| According to Toady, "Won't be used in world gen libraries (to differentiate scrolls from quires). Also put it on bindings, rollers, instr. pieces for completeness/future use".  Used on scroll rollers, book bindings, and quires.
 
| According to Toady, "Won't be used in world gen libraries (to differentiate scrolls from quires). Also put it on bindings, rollers, instr. pieces for completeness/future use".  Used on scroll rollers, book bindings, and quires.
  
 
|-
 
|-
| {{text anchor|DEFAULT_IMPROVEMENT}}{{version|0.42.01}}
+
| {{text anchor|DEFAULT_IMPROVEMENT}}
 
|
 
|
 
*improvement type and subtype (latter only really applicable to SPECIFIC)
 
*improvement type and subtype (latter only really applicable to SPECIFIC)
*tool material flag like HARD_MAT or SILK_MAT
+
*tool material flag like {{token|HARD_MAT|tool}} or {{token|SILK_MAT|tool}}
 
| Items that appear in the wild come standard with this kind of improvement. Used on scrolls: [DEFAULT_IMPROVEMENT:SPECIFIC:ROLLERS:HARD_MAT]
 
| Items that appear in the wild come standard with this kind of improvement. Used on scrolls: [DEFAULT_IMPROVEMENT:SPECIFIC:ROLLERS:HARD_MAT]
 
Currently bugged, the effect is also applied to everything made in-game. This causes scrolls to have two sets of rollers, for example.
 
Currently bugged, the effect is also applied to everything made in-game. This causes scrolls to have two sets of rollers, for example.
Line 106: Line 110:
 
| {{text anchor|UNIMPROVABLE}}
 
| {{text anchor|UNIMPROVABLE}}
 
|
 
|
| Prevents the tool from being improved.  Used on honeycombs, (scroll rollers, book bindings, and quires.){{version|0.42.01}}
+
| Prevents the tool from being [[decoration|improved]].  Used on honeycombs, scroll rollers, book bindings, and quires.
  
 
|-
 
|-
Line 112: Line 116:
 
|
 
|
 
*num
 
*num
| Defines the item value of the tool. <font color="red">Required.</font>
+
| Defines the [[Value|item value]] of the tool. <font color="red">Required.</font>
  
 
|-
 
|-
Line 126: Line 130:
  
 
|-
 
|-
| {{text anchor|NO_DEFAULT_JOB}}{{version|0.42.01}}
+
| {{text anchor|NO_DEFAULT_JOB}}
 
|  
 
|  
 
| According to Toady, "only custom reactions are used to make this item". Found on [[scroll]]s and [[quire]]s.  
 
| According to Toady, "only custom reactions are used to make this item". Found on [[scroll]]s and [[quire]]s.  
Line 133: Line 137:
 
| {{text anchor|TOOL_USE}}
 
| {{text anchor|TOOL_USE}}
 
|  
 
|  
*tool use, see below
+
*[[Tool token#Valid tool uses|tool use, see below]]
 
| Defines the task performed using the tool.
 
| Defines the task performed using the tool.
  
Line 139: Line 143:
 
| {{text anchor|FURNITURE}}
 
| {{text anchor|FURNITURE}}
 
|
 
|
| Allows item to be stored in a furniture stockpile.
+
| Allows item to be stored in a [[Stockpile#Furniture Storage|furniture stockpile]], and default jobs (unless disabled with {{token|NO_DEFAULT_JOB|tool}}) are considered [[furniture]]-making tasks instead of [[Finished good|crafts]].
 +
 
 +
The jobs for wood and stone will be done at the [[carpenter's workshop]] or [[stoneworker's workshop]] instead of the [[craftsdwarf's workshop]]. Likewise, the jobs for metal tools will use the [[blacksmith]] skill instead of [[metal crafter]].
  
 
|-
 
|-
| {{text anchor|SHAPE_CATEGORY}}{{version|0.47.01}}
+
| {{text anchor|SHAPE_CATEGORY}}
 
|
 
|
 
*shape category
 
*shape category
|
+
| Category of shapes to choose from for the tool as defined by the [[Descriptor shape token#CATEGORY|CATEGORY]] token in descriptor_shape_standard.txt or a custom descriptor definition.
  
 
|-
 
|-
| {{text anchor|USES_FACE_IMAGE_SET}}{{version|0.47.01}}
+
| {{text anchor|USES_FACE_IMAGE_SET}}
 
|
 
|
 
| Used on dice.
 
| Used on dice.
Line 162: Line 168:
 
|  
 
|  
 
*size
 
*size
| Volume of tool in mL or cubic centimeters. <font color="red">Required.</font>
+
| [[Size|Volume]] of tool in mL or cubic centimeters. <font color="red">Required.</font>
  
 
|-
 
|-
Line 168: Line 174:
 
|
 
|
 
*amount
 
*amount
| How much the item can contain. Defaults to 0.
+
| How much the item can [[Size#Items|contain]]. Defaults to 0.
  
 
|-
 
|-
Line 185: Line 191:
 
| {{text anchor|SKILL}}
 
| {{text anchor|SKILL}}
 
|  
 
|  
*Skill token
+
*[[Skill token]]
 
| The skill to determine effectiveness in melee with this tool. <font color="red">Required for weapons.</font>
 
| The skill to determine effectiveness in melee with this tool. <font color="red">Required for weapons.</font>
  
Line 191: Line 197:
 
| {{text anchor|RANGED}}
 
| {{text anchor|RANGED}}
 
|  
 
|  
*Skill token
+
*[[Skill token]]
 
*Ammo item token
 
*Ammo item token
 
| Makes this tool a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.
 
| Makes this tool a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.
Line 211: Line 217:
 
|  
 
|  
 
*value
 
*value
| Number of bar units needed for forging, as well as the amount gained from melting. <font color="red">Required for weapons.</font>
+
| Number of [[bar]] units needed for forging, as well as the amount gained from [[Melt item|melting]]. <font color="red">Required for weapons.</font>
  
 
|-
 
|-
Line 226: Line 232:
 
|}
 
|}
  
Valid tool uses (and the default tools used for these tasks) are as follows:
+
{{text anchor|Valid tool uses}} (and the default tools used for these tasks) are as follows:
 
{| class="wikitable sortable"
 
{| class="wikitable sortable"
 
|- bgcolor="#999999"
 
|- bgcolor="#999999"
Line 253: Line 259:
 
| 9 || MEAL_CONTAINER || bowl || adventure mode decoration / weapon
 
| 9 || MEAL_CONTAINER || bowl || adventure mode decoration / weapon
 
|-
 
|-
| 10 || NEST_BOX || [[nest box]] || for your birds to lay eggs
+
| 10 || LIQUID_CONTAINER || [[jug]] || can store honey or oil
 
|-
 
|-
| 11 || LIQUID_CONTAINER || [[jug]] || can store honey or oil
+
| 11 || FOOD_STORAGE || [[large pot]] || can store beer
 
|-
 
|-
| 12 || FOOD_STORAGE || [[large pot]] || can store beer
+
| 12 || HIVE || [[hive]] || can make honey
 
|-
 
|-
| 13 || HIVE || [[hive]] || can make honey
+
| 13 || NEST_BOX || [[nest box]] || for your birds to lay eggs
 
|-
 
|-
 
| 14 || SMALL_OBJECT_STORAGE || [[pouch]] || adventure mode coin purse
 
| 14 || SMALL_OBJECT_STORAGE || [[pouch]] || adventure mode coin purse
Line 269: Line 275:
 
| 17 || STAND_AND_WORK_ABOVE || [[stepladder]] || allows gathering fruit from trees
 
| 17 || STAND_AND_WORK_ABOVE || [[stepladder]] || allows gathering fruit from trees
 
|-
 
|-
| 18 || ROLL_UP_SHEET{{version|0.42.01}} || scroll rollers{{version|0.42.01}} ||  
+
| 18 || ROLL_UP_SHEET || scroll rollers ||  
 
|-
 
|-
| 19 || PROTECT_FOLDED_SHEETS{{version|0.42.01}} || book binding{{version|0.42.01}} ||
+
| 19 || PROTECT_FOLDED_SHEETS || book binding ||
 
|-
 
|-
| 20 || CONTAIN_WRITING{{version|0.42.01}} || scroll & quire{{version|0.42.01}} ||
+
| 20 || CONTAIN_WRITING || scroll & quire ||
 
|-
 
|-
| 21 || BOOKCASE{{version|0.42.01}} || [[bookcase]]{{version|0.42.01}} ||
+
| 21 || BOOKCASE || [[bookcase]] ||
 
|-
 
|-
| 22 || DISPLAY_OBJECT{{version|0.44.01}} || [[pedestal]] & [[display case]]{{version|0.44.01}} || for museums
+
| 22 || DISPLAY_OBJECT || [[pedestal]] & [[display case]] || for museums
 
|-
 
|-
| ? || PLACE_OFFERING{{version|0.47.01}} || [[altar]]{{version|0.47.01}} || for (eventually) offering sacrifices
+
| 23 || PLACE_OFFERING || [[altar]] || for (eventually) offering sacrifices
 
|-
 
|-
| ? || DIVINATION{{version|0.47.01}} || [[dice]]{{version|0.47.01}} ||  
+
| 24 || DIVINATION || [[dice]] ||  
 
|-
 
|-
| ? || GAMES_OF_CHANCE{{version|0.47.01}} || dice{{version|0.47.01}} ||  
+
| 25 || GAMES_OF_CHANCE || dice||  
  
 
|}
 
|}

Latest revision as of 18:49, 17 May 2024

This article is about the current version of DF.
Note that some content may still need to be updated.


Tokens[edit]

Token Arguments Description
NAME
  • singular
  • plural
Name of the tool. Required.
BONE_MAT Permits the tool to be made from any bone. Default jobs for bone tools can only be performed by work order. Bug:12689
CERAMIC_MAT Permits the tool to be made from any material that [IS_CERAMIC].
DESCRIPTION Allows a string to describe the tool when viewed. The text box can accommodate up to 325 characters until it cuts off, but the spacing of actual sentences puts the realistic limit closer to 300. Multiple DESCRIPTION tokens can be used in the same tool definition, with each appearing on a new line.
GLASS_MAT Permits the tool to be made from any glass.
HARD_MAT Permits the tool to be made from anything with the [ITEMS_HARD] token, such as wood, stone or metal.
LEATHER_MAT Permits the tool to be made from any leather.
METAL_MAT Permits the tool to be made from anything with the [IS_METAL] token.
METAL_WEAPON_MAT Permits the tool to be made from any metal with the [ITEMS_WEAPON] token.
SHEET_MAT Permits the tool to be made from any sheet material, such as papyrus, paper, and parchment. Connected to the PAPER_SLURRY/PAPER_PLANT reaction classes?[Verify]
SHELL_MAT Permits the tool to be made from any shell.
SILK_MAT Permits the tool to be made from any silk.
SOFT_MAT Permits the tool to be made from any material with the [ITEMS_SOFT] token, such as leather or textiles.
STONE_MAT Permits the tool to be made from any stone. Presumably connected to the [IS_STONE] token.
THREAD_PLANT_MAT Permits the tool to be made from any plant fiber, such as pig tails.
WOOD_MAT Permits the tool to be made from any wood.
INCOMPLETE_ITEM According to Toady, "Won't be used in world gen libraries (to differentiate scrolls from quires). Also put it on bindings, rollers, instr. pieces for completeness/future use". Used on scroll rollers, book bindings, and quires.
DEFAULT_IMPROVEMENT
  • improvement type and subtype (latter only really applicable to SPECIFIC)
  • tool material flag like [HARD_MAT] or [SILK_MAT]
Items that appear in the wild come standard with this kind of improvement. Used on scrolls: [DEFAULT_IMPROVEMENT:SPECIFIC:ROLLERS:HARD_MAT]

Currently bugged, the effect is also applied to everything made in-game. This causes scrolls to have two sets of rollers, for example.

UNIMPROVABLE Prevents the tool from being improved. Used on honeycombs, scroll rollers, book bindings, and quires.
VALUE
  • num
Defines the item value of the tool. Required.
TILE
  • num
Defines the tile used to represent the tool. Required.
INVERTED_TILE The background of the tile will be colored, instead of the foreground.
NO_DEFAULT_JOB According to Toady, "only custom reactions are used to make this item". Found on scrolls and quires.
TOOL_USE Defines the task performed using the tool.
FURNITURE Allows item to be stored in a furniture stockpile, and default jobs (unless disabled with [NO_DEFAULT_JOB]) are considered furniture-making tasks instead of crafts.

The jobs for wood and stone will be done at the carpenter's workshop or stoneworker's workshop instead of the craftsdwarf's workshop. Likewise, the jobs for metal tools will use the blacksmith skill instead of metal crafter.

SHAPE_CATEGORY
  • shape category
Category of shapes to choose from for the tool as defined by the CATEGORY token in descriptor_shape_standard.txt or a custom descriptor definition.
USES_FACE_IMAGE_SET Used on dice.
ADJECTIVE
  • adjective
Adjective preceding the material name (e.g. "large copper dagger")
SIZE / WEIGHT
  • size
Volume of tool in mL or cubic centimeters. Required.
CONTAINER_CAPACITY
  • amount
How much the item can contain. Defaults to 0.
SHOOT_FORCE
  • value
Required for weapons.
SHOOT_MAXVEL
  • value
Required for weapons.
SKILL The skill to determine effectiveness in melee with this tool. Required for weapons.
RANGED Makes this tool a ranged weapon that uses the specified ammo. The specified skill determines accuracy in ranged combat.
TWO_HANDED
  • size
Creatures under this size (in cm^3) must use the tool two-handed. Required for weapons.
MINIMUM_SIZE
  • size
Minimum body size (in cm^3) to use the tool at all (multigrasp required until TWO_HANDED value) Required for weapons.
MATERIAL_SIZE
  • value
Number of bar units needed for forging, as well as the amount gained from melting. Required for weapons.
ATTACK
  • attacktype:BLUNT or EDGE
  • contact_area:value
  • penetration_size:value
  • verb2nd:string
  • verb3rd:string
  • noun:string
  • velocity_multiplier:value
You can have many ATTACK tags and one will be randomly selected for each attack, with EDGE attacks 100 times more common than BLUNT attacks. Required for weapons.

Valid tool uses (and the default tools used for these tasks) are as follows:

ID Token Usage
0 LIQUID_COOKING cauldron adventure mode decoration / weapon
1 LIQUID_SCOOP ladle adventure mode decoration / weapon
2 GRIND_POWDER_RECEPTACLE mortar adventure mode decoration / weapon
3 GRIND_POWDER_GRINDER pestle adventure mode decoration / weapon
4 MEAT_CARVING carving knife adventure mode decoration / weapon
5 MEAT_BONING boning knife adventure mode decoration / weapon
6 MEAT_SLICING slicing knife adventure mode decoration / weapon
7 MEAT_CLEAVING meat cleaver adventure mode decoration / weapon
8 HOLD_MEAT_FOR_CARVING carving fork adventure mode decoration / weapon
9 MEAL_CONTAINER bowl adventure mode decoration / weapon
10 LIQUID_CONTAINER jug can store honey or oil
11 FOOD_STORAGE large pot can store beer
12 HIVE hive can make honey
13 NEST_BOX nest box for your birds to lay eggs
14 SMALL_OBJECT_STORAGE pouch adventure mode coin purse
15 TRACK_CART minecart item hauling / weapon
16 HEAVY_OBJECT_HAULING wheelbarrow allows hauling items faster
17 STAND_AND_WORK_ABOVE stepladder allows gathering fruit from trees
18 ROLL_UP_SHEET scroll rollers
19 PROTECT_FOLDED_SHEETS book binding
20 CONTAIN_WRITING scroll & quire
21 BOOKCASE bookcase
22 DISPLAY_OBJECT pedestal & display case for museums
23 PLACE_OFFERING altar for (eventually) offering sacrifices
24 DIVINATION dice
25 GAMES_OF_CHANCE dice