v0.31:Body token

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

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.
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?)
HEAD	None	Flags the body part as being able to wear head clothing like hats, helms, etc.
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.
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).
RIGHT
LEFT
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.
SIGHT	None	Body part is used to see with. If the creature has no SIGHT body parts, or if all it's sight body parts are damaged or destroyed, it can't see unless it has the EXTRAVISION tag in its creature def.
EMBEDDED		is on the surface of parent body part, like eye and mouth are on head.
SMALL		"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
SMELL	None	No known function. Could possibly control reactions to miasma in fortress mode?
HEAR
BREATHE
INTERNAL
MOUTH
APERTURE
CIRCULATION
GUTS
UNDER_PRESSURE		Used to get the guts to pop out.
JOINT
THROAT
NERVOUS
SKELETON
DIGIT
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.
SOCKET
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.
STANCE
CON	value
CONTYPE	value
CATEGORY	value
DEFAULT_RELSIZE	Size	This command establishes the relative size of body parts within a creature. The numbers have no absolute meaning or units.