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.

Editing 40d:Body token

Jump to navigation Jump to search

Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.

You are editing a page for an older version of Dwarf Fortress ("Main" is the current version, not "40d"). Please make sure you intend to do this. If you are here by mistake, see the current page instead.

The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.

Latest revision Your text
Line 1: Line 1:
−
{{quality|Exceptional|21:17, 30 March 2011 (UTC)}}{{av}}
+
[[Category:Modding]]{{Old|0.23.130.23a}}
−
{{Category|Modding}}
 
  
−
'''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 [[creature token#B|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.
 
−
 
−
== Convention ==
 
−
 
−
The convention in the unmodded raw object data in Dwarf Fortress is to make the centre of mass the core of the creature.  All other body parts then attach to this central mass, or to those body parts that attach to this central mass.  Creating chains of attachments in this fashion produces limbs. If a part is listed before a part that it is attached to is, this can create strange bugs, such as the creatures instantly suffocating.
 
−
 
−
While it is possible to use the CON token to connect to a specific body part ID even if it is in another template, it is convention within the default raw object data to use a CONTYPE if the connected part is in another template, for safety.  Otherwise, a creature must have both templates within its BODY token to prevent unpredictable behaviour when the creature is used during world generation or simulated during gameplay.
 
  
 
==Basic Syntax==
 
==Basic Syntax==
Line 32: Line 18:
 
==Body==
 
==Body==
  
−
{| {{prettytable}}
+
{| border="1" cellpadding="2" width="100%"
−
|- bgcolor="#ddd"
+
! width="20%" | Token
−
! Token
+
! width="20%" | Arguments
−
! Arguments
+
! width="60%" | Description
−
! Description
 
  
 
|-
 
|-
Line 50: Line 35:
 
* match
 
* match
 
* replacement
 
* replacement
−
| Replaces all occurrences of "match" in the creature's body parts with "replacement".  E.g., the Body Token [BODYGLOSS:TENTACLE:leg:tentacle], used by the Creature Token [BODYGLOSS:TENTACLE], will cause any "right leg" to appear as "right tentacle".  Testing required: would "brain legend" appear as "brain tentacleend"?{{verify}}
+
| Replaces all occurrences of "match" in the creature's body parts with "replacement".  E.g., the Body Token [BODYGLOSS:TENTACLE:leg:tentacle], used by the Creature Token [BODYGLOSS:TENTACLE], will cause any "right leg" to appear as "right tentacle".  Testing required: would "brain legend" appear as "brain tentacleend"?
  
 
|-
 
|-
Line 58: Line 43:
 
==Body Parts==
 
==Body Parts==
  
−
{| {{prettytable}}
+
{| border="1" cellpadding="2" width="100%"
−
|- bgcolor="#ddd"
+
! width="20%" | Token
−
! Token
+
! width="20%" | Arguments
−
! Arguments
+
! width="60%" | Description
−
! Description
+
 
 +
|-
 +
| APERTURE
 +
|
 +
| Unknown effect.  An opening in the body, apparently, but no known purpose.
  
 
|-
 
|-
Line 68: Line 57:
 
|
 
|
 
* id
 
* id
−
* name
+
| The internal object ID of the body part.  Unlike many other tokens in the game, the id of the BP does not need to be unique, though it does need to be unique within the BODY template.
−
| The internal object ID of the body part.  Unlike many other tokens in the game, the id of the BP does not need to be unique throughout all of the raw object files, though it does need to be unique within the BODY it is in, as well as within the set of body templates used by any given creature.
 
  
 
|-
 
|-
−
| UPPERBODY
+
| BREATHE
 
|  
 
|  
−
| The body part is the "core" of the creature; when the upperbody body part is destroyed, the creature is blown apart.
+
| The body part is necessary to breathe.  If the body part is destroyed, the creature can suffocate.
−
A creature doesn't die until an UPPERBODY, HEAD, or LOWERBODY is destroyed, so a creature without one or all of these
 
−
can't be killed*.  UPPERBODYs aren't redundant, once one is destroyed the creature dies.  Body parts with [CONTYPE:UPPERBODY] will be connected to these.
 
−
*most creatures can also be killed indirectly by suffocation or blood loss. (or brain damage?).
 
  
 
|-
 
|-
−
| LOWERBODY
+
| CIRCULATION
−
|
+
|  
−
| The body part is another part of the "core" of the creature.  When the lowerbody body part is destroyed, the creature is bisected.  A creature doesn't die until an UPPERBODY, HEAD, or LOWERBODY is destroyed, so a creature without one or all of these can't be killed*.  LOWERBODYs aren't redundant, once one is destroyed the creature dies.  Body parts with [CONTYPE:LOWERBODY] will be connected to these.
+
| If this body part is destroyed, the creature will bleed to death?
−
*most creatures can also be killed indirectly by suffocation or blood loss. (or brain damage?).
 
−
 
 
−
|-
 
−
| HEAD
 
−
|
 
−
| Vital bodypart. If severed, creature dies.  A creature doesn't die until an UPPERBODY, HEAD, or LOWERBODY is destroyed, so a creature without one or all of these can't be killed*.  HEADs aren't redundant, once one is destroyed the creature dies.  Body parts with [CONTYPE:HEAD] will be connected to these.
 
−
*most creatures can also be killed indirectly by suffocation or blood loss. (or brain damage?).
 
  
 
|-
 
|-
Line 95: Line 73:
 
|
 
|
 
* id
 
* id
−
| The specific body part ''object ID'' to which this body part attaches.  This tag is optional.  Interesting effects can be created by leaving unconnected body parts.  If an invalid ID is given, the body part is unconnected.  This can lead to interesting bugs.
+
| The specific body part ''object ID'' to which this body part attaches.
  
 
|-
 
|-
Line 101: Line 79:
 
|
 
|
 
* type
 
* type
−
| The body part ''token type'' to which this body part attaches - valid values are UPPERBODY, LOWERBODY, HEAD, GRASP, and STANCE. Note that if the creature has more than one body part with that token type each of them will get its own additional body part attached.  For example, if a creature has two upper bodies (two torsos) and a lower body, the CONTYPE:UPPERBODY means that the two upper torsos are connected to the lower torso by default.  This tag is optional.  Interesting effects can be created by leaving unconnected body parts.
+
| The body part ''token type'' to which this body part attaches.
  
 
|-
 
|-
−
| LIMB
+
| DIGIT
−
|
+
|
−
| The body part is usable for [[wrestling]] (i.e. can grab, lock, choke, etc.).
+
| Is a finger/toe.  Unknown effect.
 +
 
 +
|-
 +
| EMBEDDED
 +
|  
 +
| The body part is embedded into the body -- it is external, but is not shown until injured. Compare INTERNAL. Can be gouged out?
 +
 
 +
|-
 +
| FLIER
 +
|
 +
| The body part is necessary for the creature to fly, and damage to the body part will ground the creature.
  
 
|-
 
|-
−
| THROAT
+
| GRASP
 
|  
 
|  
−
| Can be strangled with [[wrestling]] to cause winding, unconsciousness, and eventual death. Strangely, even creatures with the NOBREATHE token can be rendered unconscious (but not dead) by strangulation.
+
| The body part can be used to hold items (if the creature has the EQUIPS token) or [[wrestling|wrestle]].
  
 
|-
 
|-
−
| JOINT
+
| GUTS
 
|  
 
|  
−
| Can be broken by [[wrestling]].
+
| Can be disembowelled?
  
 
|-
 
|-
−
| SKELETON
+
| HEAD
 
|
 
|
−
| Prevents game code from removing this bodypart when the creature is converted to skeletal undead.
+
| Vital bodypart. If severed, creature dies.
  
 
|-
 
|-
−
| THOUGHT
+
| HEAR
 
|  
 
|  
−
| Necessary for the creature to think.  Without a working brain, the creature dies unless it has the NOTHOUGHT Creature Token. Also seems to apply the effects of NERVOUS.
+
| Unknown effect.  Presumably allows the creature to listen.
  
 
|-
 
|-
−
| NERVOUS
+
| INTERNAL
 
|  
 
|  
−
| Causes pain when destroyed and appears to stop a part from healing over time. However, it will heal normally if creature is NOTHOUGHT. Other effects?
+
| The body part is an internal organ and is not visible until injured.
  
 
|-
 
|-
−
| GRASP
+
| JOINT
 
|  
 
|  
−
| The body part can be used to hold items (if the creature has the EQUIPS token) or [[wrestling|wrestle]]. Body parts with [CONTYPE:GRASP] will be connected to these.
+
| Can be broken by [[wrestling]] (possibly falling damage in a future version).
  
 
|-
 
|-
−
| FLIER
+
| LEFT
 
|  
 
|  
−
| The body part is necessary for the creature to fly, and damage to the body part will ground the creature.
+
| The body part is on the left side of the creature and is thus vulnerable to attacks from the left side.
  
 
|-
 
|-
−
| STANCE
+
| LIMB
 
|
 
|
−
| The body part is used to keep the creature standing; injury to the body part will cause the creature to collapse. It also makes the body part act like a foot, and can be problematic as the body part can be armored by a boot.  STANCE body parts that are unconnected to the root (have no CON tag) do not count towards keeping the creature standing (NOTE: if '''any''' [STANCE] body parts are unconnected to root, the creature may fall over.  Further testing required).  Body parts with [CONTYPE:STANCE] will be connected to these.
+
| The body part is usable for [[wrestling]] (i.e. can grab, lock, choke, etc).
  
 
|-
 
|-
−
| SIGHT
+
| LOWERBODY
 
|
 
|
−
| Allows creatures to see; creatures without this tag on any part of their bodies cannot see for the purposes of aiming missile weapons (though apparently can find and kill mad adventurers fairly well with melee attacks).  May need more testing.
+
| The body part is another part of the "core" of the creature.  When the lowerbody body part is destroyed, the creature is bisected.
  
 
|-
 
|-
−
| HEAR
+
| MOUTH
−
|  
+
|
−
| Unknown effect.  Presumably allows the creature to listen. Also makes earrings equippable.
+
| Allows the creature to eat?
  
 
|-
 
|-
−
| SMELL
+
| NERVOUS
 
|  
 
|  
−
| Unknown effect.  Presumably allows creature to smell.
+
| Causes pain when destroyed.  Other effects?
  
 
|-
 
|-
−
| EMBEDDED
+
| RIGHT
 
|  
 
|  
−
| The body part is embedded into the body -- it is external and can be gouged out. This does not make a part invisible.
+
| The body part is on the right side of the creature and is thus vulnerable to attacks from the right side.
  
 
|-
 
|-
−
| APERTURE
+
| SIGHT
−
|  
+
|
−
| An opening in the body. Cannot be destroyed except by destroying the part is attached to.
+
| Allows creatures to see; creatures without this tag on any part of their bodies cannot see for the purposes of aiming missile weapons (though apparently can find and kill mad adventurers fairly well with melee attacks).  May need more testing.
  
 
|-
 
|-
−
| SMALL
+
| SKELETON
−
|  
+
|
−
| Unknown effect.  Reduces chance to hit? Also will cloak body parts much like the [INTERNAL] or the [EMBEDDED] tags will. Allows body parts to be pinched.  In 40d it appears that body parts are visible unless [SMALL], even if they are [INTERNAL] or [EMBEDDED].  If the root (first BP) of the creature is [SMALL], it will not be targeted until all other parts have been severed or torn off.
+
| Prevents game code from removing this bodypart when the creature is converted to skeletal undead.
  
 
|-
 
|-
−
| INTERNAL
+
| SMALL
 
|  
 
|  
−
| The body part is an internal organ and is not visible until injured.  In 40d, it appears that the [SMALL] tag is what actually makes organs invisible, and that non-SMALL internal organs are visible even before being damaged.
+
| Unknown effect.  Reduces chance to hit?
  
 
|-
 
|-
−
| BREATHE
+
| SMELL
 
|  
 
|  
−
| The body part is necessary to breathe.  If the body part is destroyed, the creature can suffocate unless it has the NOBREATHE token. The NOBREATHE token also causes the part to heal normally.
+
| Unknown effect.  Presumably allows creature to smell.
  
 
|-
 
|-
−
| CIRCULATION
+
| STANCE
−
|  
+
|
−
| If this body part is destroyed, the creature will bleed to death?
+
| The body part is used to keep the creature standing; injury to the body part will cause the creature to collapse.
  
 
|-
 
|-
−
| GUTS
+
| THOUGHT
 
|  
 
|  
−
| To be thought of like intestines. Can be disemboweled, causing a slow painful death from heavy bleeding.
+
| Necessary for the creature to think. Without a working brain, the creature dies unless it has the NOTHOUGHT Creature Token.
  
 
|-
 
|-
−
| RIGHT
+
| THROAT
 
|  
 
|  
−
| The body part is on the right side of the creature and is thus vulnerable to attacks from the right side.
+
| Can be strangled with [[wrestling]] to cause winding, unconsciousness, and eventual death.
  
 
|-
 
|-
−
| LEFT
+
| UPPERBODY
 
|  
 
|  
−
| The body part is on the left side of the creature and is thus vulnerable to attacks from the left side.
+
| The body part is the "core" of the creature; when the upperbody body part is destroyed, the creature is blown apart.
  
 
|-
 
|-
−
| DIGIT
+
|}
−
|
 
−
| Is a finger/toe.  Unknown effect.  DIGITs '''may''' only be damaged when their connected body part is damaged, they do not appear to be valid targets for damage otherwise.
 
  
−
|-
 
−
| MOUTH
 
−
|
 
−
| Unknown effect. Does not allow creature to eat.  Often tied to a creature's attacks, so this may be the primary use of the tag.
 
−
|}
 
  
 
==Body Part Types==
 
==Body Part Types==
  
−
Legal token types for use with the Attack Token "BYTYPE" argument:
+
Legal token types for use with the Attack Token "BYTYPE" argument or for the Body Token "CONTYPE" argument:
  
 
* APERTURE
 
* APERTURE
−
* BREATHE
+
* BREATHE?
−
* CIRCULATION
+
* CIRCULATION?
−
* DIGIT
+
* DIGIT?
−
* FLIER
+
* FLIER?
 
* GRASP
 
* GRASP
−
* GUTS
+
* GUTS?
−
* HEAD
+
* HEAD?
 
* HEAR
 
* HEAR
−
* JOINT
+
* JOINT?
−
* LIMB
+
* LIMB?
−
* LOWERBODY
+
* LOWERBODY?
 
* MOUTH
 
* MOUTH
−
* NERVOUS
+
* NERVOUS?
 
* SMELL
 
* SMELL
 
* STANCE
 
* STANCE
 
* THOUGHT
 
* THOUGHT
−
* UPPERBODY
+
* UPPERBODY?
−
 
 
−
==Example==
 
−
 
 
−
An [[elephant]] is composed of a large number of body parts, but only includes a small list of templates.  When an elephant asks for the following 15 templates in its CREATURE:ELEPHANT token:
 
−
[BODY:QUADRUPED:TAIL:2EYES:2EARS:TRUNK:2LUNGS:HEART:GUTS:ORGANS:THROAT:NECK:SPINE:BRAIN:MOUTH:2TUSKS]
 
−
 
 
−
...it gets all of the following 35 body parts:
 
−
 
 
−
QUADRUPED:
 
−
  - upper body
 
−
  - lower body
 
−
  - head
 
−
  - right front leg
 
−
  - left front leg
 
−
  - right front foot
 
−
  - left front foot
 
−
  - right rear leg
 
−
  - left rear leg
 
−
  - right rear foot
 
−
  - left rear foot
 
−
TAIL:
 
−
  - tail
 
−
2EYES:
 
−
  - right eye
 
−
  - left eye
 
−
2EARS:
 
−
  - right ear
 
−
  - left ear
 
−
TRUNK:
 
−
  - trunk
 
−
2LUNGS:
 
−
  - right lung
 
−
  - left lung
 
−
HEART:
 
−
  - heart
 
−
GUTS:
 
−
  - guts
 
−
ORGANS:
 
−
  - liver
 
−
  - stomach
 
−
  - pancreas
 
−
  - spleen
 
−
  - right kidney
 
−
  - left kidney
 
−
THROAT:
 
−
  - throat
 
−
NECK:
 
−
  - neck
 
−
SPINE:
 
−
  - upper spine
 
−
  - lower spine
 
−
BRAIN:
 
−
  - brain
 
−
MOUTH:
 
−
  - mouth
 
−
2TUSKS:
 
−
  - right tusk
 
−
  - left tusk
 
−
 
 
−
The body part tree of the elephant, after connections are made, is as follows:
 
−
 
 
−
+ upper body
 
−
  - heart
 
−
  - upper spine
 
−
  - right lung
 
−
  - left lung
 
−
  + head
 
−
    - brain
 
−
    - mouth
 
−
    - trunk
 
−
    - right tusk
 
−
    - left tusk
 
−
    - right eye
 
−
    - left eye
 
−
    - right ear
 
−
    - left ear
 
−
    - neck
 
−
    - throat
 
−
  + right front leg
 
−
    - right front foot
 
−
  + left front leg
 
−
    - left front foot
 
−
  + lower body
 
−
    - lower spine
 
−
    - guts
 
−
    - tail
 
−
    - liver
 
−
    - stomach
 
−
    - pancreas
 
−
    - spleen
 
−
    - right kidney
 
−
    - left kidney
 
−
    + right rear leg
 
−
      - right rear foot
 
−
    + left rear leg
 
−
      - left rear foot
 
−
 
 
−
To understand how the above connections are determined (for example, why "lower spine" knows that it goes in "lower body", why "heart" knows that it goes in "upper body", etc.) refer to the CONTYPE tag.
 
  
−
{{Category|Modding}}
+
Entries suffixed with a question mark are untested and should not be considered final.  Entries with no question mark are tested and valid.
−
{{Category|Tokens}}
 

Please note that all contributions to Dwarf Fortress Wiki are considered to be released under the GFDL & MIT (see Dwarf Fortress Wiki:Copyrights for details). If you do not want your writing to be edited mercilessly and redistributed at will, then do not submit it here.
You are also promising us that you wrote this yourself, or copied it from a public domain or similar free resource. Do not submit copyrighted work without permission!

To protect the wiki against automated edit spam, we kindly ask you to solve the following CAPTCHA:

Cancel Editing help (opens in new window)

Templates used on this page:

Retrieved from "https://dwarffortresswiki.org/index.php/40d:Body_token"