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.

Tool token

From Dwarf Fortress Wiki
Revision as of 08:23, 4 December 2015 by Aranna (talk | contribs) (Attempted to clarify the arguments a bit more on the DEFAULT_IMPROVEMENT based on info from the file changes in v0.42.01)
Jump to navigation Jump to search
This article is about the current version of DF.
Note that some content may still need to be updated.

Token Arguments Description
NAME
  • singular
  • plural
Name of the tool. Required.
BONE_MATv0.42.01 Permits the tool to be made from any bone.
CERAMIC_MATv0.42.01 Permits the tool to be made from any ceramic material.
GLASS_MATv0.42.01 Permits the tool to be made from any glass.
HARD_MAT Permits the tool to be made from any "hard" material, such as stone.
LEATHER_MATv0.42.01 Permits the tool to be made from any leather.
METAL_MAT Permits the tool to be made from any metal.
METAL_WEAPON_MAT Permits the tool to be made from any weapons-grade metal.
SHEET_MATv0.42.01 Permits the tool to be made from any "sheet" material, such as papyrus, paper, and parchment.
SHELL_MATv0.42.01 Permits the tool to be made from any shell.
SILK_MATv0.42.01 Permits the tool to be made from any silk.
SOFT_MAT Permits the tool to be made from any "soft" material, such as leather.
STONE_MATv0.42.01 Permits the tool to be made from any stone.
THREAD_PLANT_MATv0.42.01 Permits the tool to be made from any "plant fibre" material, such as pig tails.
WOOD_MAT Permits the tool to be made from any wood.
INCOMPLETE_ITEMv0.42.01 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_IMPROVEMENTv0.42.01
  • <imp type> (improvement type?)
  • possibly specific type or part token
  • tool mat flag like HARD_MAT or SILK_MAT
UNKNOWN (I assume it puts the improvement on by default). Used on scrolls: [DEFAULT_IMPROVEMENT:SPECIFIC:ROLLERS:HARD_MAT]
UNIMPROVABLE Prevents the tool from being improved. Used on honeycombs, (scroll rollers, book bindings, and quires.)v0.42.01
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_JOBv0.42.01 According to Toady, "only custom reactions are used to make this item". Found on scroll and quire.
TOOL_USE
  • tool use, see below
Defines the task performed using the tool.
FURNITURE Allows item to be stored in a furniture stockpile.
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
  • Skill token
The skill to determine effectiveness in melee with this tool. Required for weapons.
RANGED
  • Skill token
  • Ammo item token
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
1 LIQUID_SCOOP ladle
2 GRIND_POWDER_RECEPTACLE mortar
3 GRIND_POWDER_GRINDER pestle
4 MEAT_CARVING carving knife
5 MEAT_BONING boning knife
6 MEAT_SLICING slicing knife
7 MEAT_CLEAVING meat cleaver
8 HOLD_MEAT_FOR_CARVING carving fork
9 MEAL_CONTAINER bowl
10 NEST_BOX nest box
11 LIQUID_CONTAINER jug
12 FOOD_STORAGE large pot
13 HIVE hive
14 SMALL_OBJECT_STORAGE pouch
15 TRACK_CART minecart
16 HEAVY_OBJECT_HAULING wheelbarrow
17 STAND_AND_WORK_ABOVE stepladder
18? ROLL_UP_SHEETv0.42.01 scroll rollersv0.42.01
19? PROTECT_FOLDED_SHEETSv0.42.01 book bindingv0.42.01
20? CONTAIN_WRITINGv0.42.01 scroll & quirev0.42.01
21? BOOKCASEv0.42.01 bookcasev0.42.01