DF2014:Weapon token

From Dwarf Fortress Wiki
Jump to navigation Jump to search
This article is about the current version of DF.

Weapon tokens define weapons. These tokens can only be placed within an ITEM_WEAPON object definition, and most do not function in armor objects.

Tokens[edit]

Token Arguments Description
NAME
  • singular
  • plural
Name of the weapon. Required.
ADJECTIVE
  • adjective
Adjective of the weapon, e.g. the "large" in "large copper dagger".
SIZE / WEIGHT
  • size
Volume of weapon in mL or cubic cm. Defaults to 100.
SHOOT_FORCE
  • value
The amount of force used when firing projectiles - velocity is presumably determined by the projectile's mass. Defaults to 0.
SHOOT_MAXVEL
  • value
The maximum speed a fired projectile can have.
SKILL The skill to determine effectiveness in melee with this weapon. Defaults to MACE. Skill of AXE will allow it to be used to chop down trees. Skill of MINER will allow it to be used for mining. Outsider adventurers (or regular ones with no points in offensive skills) will receive a weapon with the SPEAR skill, selected at random if multiple ones have been modded in. All adventurers will also start with a weapon using the DAGGER skill, again selected at random if multiple such weapons exist.
RANGED Makes this 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 weapon two-handed. Defaults to 50000.
MINIMUM_SIZE
  • size
Minimum body size (in cm^3) to use the weapon at all (multigrasp required until TWO_HANDED value). Defaults to 40000.
CAN_STONE Allows the weapon to be made at a craftsdwarf's workshop from a sharp ([MAX_EDGE:10000] or higher) stone (i.e. obsidian) plus a wood log.
TRAINING Restricts this weapon to being made of wood.
MATERIAL_SIZE
  • value
Number of bar units needed for forging, as well as the amount gained from melting. Required.
ATTACK_PREPARE_AND_RECOVER
  • Preparation time
  • Recovery time
Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.
ATTACK_FLAG_BAD_MULTIATTACK Multiple strikes with this attack cannot be performed effectively.
ATTACK_FLAG_INDEPENDENT_MULTIATTACK Multiple strikes with this attack can be performed with no penalty.
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. Contact area is usually high for slashing and low for bludgeoning, piercing, and poking. Penetration value tends to be low for slashing and high for stabbing. Penetration is ignored if attack is BLUNT. Required.