v0.31:Body token

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

Body tokens are one of the fundamental parts of creatures, and determine their bodily structure. There are two major types of body tokens: body templates (BODY) and body parts (BP).

A creature uses the BODY creature token to list all of the body templates it includes. Each part listed in each template is then included in the creature. In other words: a creature lists the body templates it is made of. Each body template contains a set of body parts. Each body part specifies which other body part it is attached to.

Body parts can connect specifically to another body part, or generally to any body part of a certain category. These connections are handled by the CON and CONTYPE body part tokens respectively.

Body parts can be renamed with a bodygloss, allowing someone to reuse an existing template instead of defining a similar template with only the names of the body parts changed.

Token Arguments Description
BP
  • ID
  • name
  • pluralized name
"STP stands for "Standard Plural" and it just adds an 's' to the singular word to save some typing. If you don't add something in that slot, the body part won't even load." --Toady. Note that this can cause confusing issues when porting from 40d to 2010. Make sure you add your pluralizations!
UPPERBODY None Flags the body part as being able to wear upper body clothing like coats, breastplates etc. If an upper body is chopped off, the creature dies. Multiple upperbody parts aren't redundant. All default creatures with bodies have the upperbody as the root of the body tree, making it impossible to chop off.
LOWERBODY None Flags the body part as being able to wear lower body clothing like skirts, pants, etc. If a lower body is chopped off, the creature dies. Multiple lowerbody parts aren't redundant.
HEAD None Flags the body part as being able to wear head clothing like hats, helms, etc. If all heads are chopped off, the creature dies. Multiple heads are redundant - for example, hydras can survive with several missing heads.
CON
  • value
Connects the body part to a specific other body part
CON_CAT
  • value
Connects the body part to all other body parts having the specified CATEGORY
CONTYPE
  • value
Connects the body part to all other body parts having the specified type token. Valid values are UPPERBODY, LOWERBODY, HEAD, GRASP, or STANCE.
LIMB None Body part is a limb. It can be used to initiate certain types of wrestling moves. If it is located between an UPPERBODY part and a GRASP body part, it is eligible to be covered by certain types of armor (body armors and gauntlets). If it is located between a LOWERBODY part and a STANCE body part, it is eligible to be covered by other types of armor (Leg armors like pants, etc; trailing body armors like mail shirts and robes; and high boots).
THROAT Body part can be strangled.
JOINT Body part is a joint that may be broken by wrestling.
SKELETON Body part is part of the creature's skeleton.
THOUGHT None Most creatures die if all bodyparts with this tag have sustained damage to a FUNCTIONAL tissue or been outright destroyed (chopped off). Creatures will not die if they have NO_THOUGHT_CENTER_FOR_MOVEMENT (and/or NOTHOUGHT?)
NERVOUS Body part is necessary for motor function. Damage will impair movement and also disallow creature from sparring in Fortress mode.
GRASP None Creature can wield a picked-up weapon with body part, and can use the part to initiate a wider variety of wrestling moves. When creatures are spawned with a weapon and shield, one GRASP part will hold a weapon while all others will hold shields.
FLIER None Flags the body part as being need for flight. Damage to a certain number of FLIER body parts will prevent the creature from flying. Note that a creature can only fly if the creature has the FLIER tag in its creature definition, and that a flying creature does not actually need any FLIER body parts. This tags only purpose is to identify body parts which will cause a creature to lose the ability to fly, if they are damaged.
UNDER_PRESSURE None Makes the body part pop out of edge attack wounds. Used on guts. Body part shows up as "~" when spilled/popped out.
TOTEMABLE None Makes the body part makeable into totems at a craftsdwarf's workshop.
VERMIN_BUTCHER_ITEM None Allows the item to be obtained from butchered or rotted vermin.
STANCE Allows the creature to stand. Damage or loss of these body parts will cause creature to fall over.
SIGHT None Body part is used to see with. If the creature has no SIGHT body parts, or if all its sight body parts are damaged or destroyed, it can't see unless it has the EXTRAVISION tag in its creature def.
HEAR Body part is used to hear. No known effects.
SMELL None Body part is used to smell. No known function. (could possibly control reactions to miasma in fortress mode?)
EMBEDDED None Body part with this tag is on the surface of parent body part. ie: eye and mouth on head. It can be gouged.
APERTURE Marks body part as an opening in the body. This body part cannot be destroyed except by destroying the part it is attached to.
SMALL None "SMALL means that the part isn't displayed as part of the overall displayed body part lists. They can't be splinted. They are more often targeted for torture (although those situations might not occur anymore). They are removed in skeletons if they aren't specifically skeletons/joints/digits/apertures. They are more easily lost in world gen duels. They are the only gougable/pinchable parts. SMALL is an old tag, so it has accumulated some weird functions which'll get split off over time. " --Toady
INTERNAL Marks the body part as inside the body. Needs [SMALL] tag as well to not be targetable by attacks.
BREATHE Body part is used to breathe. If all body parts with [BREATHE] are damaged or destroyed, the creature will suffocate unless it has the NOBREATHE tag in its creature def.
CIRCULATION Body part is responsible for blood circulation. Exact effects not known.
GUTS None Body parts marked with this tag make the creature nauseous and vomit when hit.
RIGHT None Marks body part as on the right side of the body and vulnerable to attacks from the right. Used in conjunction with tags in the b_detail_plan_default raw.
LEFT None Marks body part as on the left side of the body and vulnerable to attacks from the left. Used in conjunction with tags in the b_detail_plan_default raw.
DIGIT
CONNECTOR Body part is used to connect other body parts together. Used for the neck and lower spine.
SOCKET Allows the body part to be easily knocked out. Used on teeth.
MOUTH
CATEGORY
  • ID
Assigns the body part to a user-defined category. Used by CON_CAT to attach to other body parts.
DEFAULT_RELSIZE
  • Size
This command establishes the relative size of body parts within a creature. The numbers have no absolute meaning or units.
NUMBER
  • value
In theory, the number lets you stack identical body parts. These can be individually damaged by wounds, but you don't have to define them explicitly one by one. If you don't give them individual names (see teeth) they'll be preceded by ordinal numbers (first, second, etc).

HOWEVER, this tag appears to be non-functional.

INDIVIDUAL_NAME
  • name
  • plural
Adding individual names tells the game what to call each individual part in a NUMBERed bodypart. This command replaces "first upper front tooth" for example.