Tool token

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

v50.14 · v0.47.05 This article is about the current version of DF. Note that some content may still need to be updated. More Info · V

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.
DESCRIPTIONv0.42.01		Allows a string to describe the tool when (v)iewed
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