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.
Difference between revisions of "Creature token"
Jump to navigation
Jump to search
m (→E: added token links) |
m |
||
(161 intermediate revisions by 41 users not shown) | |||
Line 1: | Line 1: | ||
− | {{Quality|Exceptional | + | {{Quality|Exceptional}} |
{{av}} | {{av}} | ||
+ | {{Modding}} | ||
− | + | The <code>[OBJECT:CREATURE]</code> [[token]] begins the definition of a ''Dwarf Fortress'' [[creature]] [[raw file]]. Each creature definition that follows begins with the {{token|creature|c|creature ID}} token, and the creature's exact properties and behavior are then specified by the use of further creature tokens. All known creature tokens are listed below. | |
− | + | Vanilla creature definitions can be found in <code>[[Game folder|<Dwarf Fortress>]]\data\vanilla\vanilla_creatures\</code>. | |
+ | Creature ID is also used with [[graphics token]]s to make customizable [[graphics set]]s. | ||
− | + | The [[caste]] tokens allow defining sub-species within the broader creature definition, including true biological castes and lesser variations, such as sexes. Creature tokens can either be 'Creature' or 'CASTE-only' type which can only be applied to creature or cast respectively, or 'CASTE' which can be applied to both. In the table bellow, creature type distinguish tokens that can be applied to creature only, cast only and both ('creature', 'CASTE-only', and 'CASTE' respectively) | |
− | {{alphabetical TOC}} | + | |
− | + | __NOTOC__ | |
+ | {{clear}} | ||
+ | {{alphabetical TOC|style=margin: 1em auto;}} | ||
==A== | ==A== | ||
Line 22: | Line 26: | ||
| Caste | | Caste | ||
| | | | ||
− | | Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. | + | | Prevents tamed creature from being made available for adoption, instead allowing it to automatically adopt whoever it wants. The basic requirements for adoption are intact, and the creature will only adopt individuals who have a [[preference]] for their species. Used by [[cat]]s in the vanilla game. When {{k|v}}iewing a tame creature with this token, the message "This animal isn't interested in your wishes" will appear instead of "This [adorable] animal can't work" or "This animal is waiting to be trained". |
|- | |- | ||
Line 34: | Line 38: | ||
| Caste | | Caste | ||
| | | | ||
− | | Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them. | + | | Sets the creature to be active during the day, night, and twilight in Adventurer Mode. Seems to be a separate value from {{token|DIURNAL|c}}/{{token|NOCTURNAL|c}}/{{token|CREPUSCULAR|c}}, rather than implying them.{{verify|code}} |
|- | |- | ||
Line 53: | Line 57: | ||
| Caste | | Caste | ||
| | | | ||
− | | Allows a creature to breathe both | + | | Allows a creature to breathe both in and out of [[water]] (unlike {{token|AQUATIC|c}}) - does not prevent drowning in [[magma]]. |
|- | |- | ||
| {{text anchor|APP_MOD_DESC_RANGE}} | | {{text anchor|APP_MOD_DESC_RANGE}} | ||
− | | | + | | Appearance Modifier |
| | | | ||
− | *Range | + | *Range (6 values, low to high) |
− | | [http://www.bay12forums.com/smf/index.php?topic= | + | | Based on info from [http://www.bay12forums.com/smf/index.php?topic=113762.msg3473069#msg3473069 Wannabehero on the forums]: When used with an appearance modifier token (BP_APPEARANCE_MODIFIER or BODY_APPEARANCE_MODIFIER), tells the game what numeric ranges to map to which descriptors. |
+ | |||
+ | The game uses 7 descriptor levels for each modifier, with the center one generally being to omit the thing from the creature description entirely. The six values in APP_MOD_DESC_RANGE define the boundaries between each described range. If this is not specified it uses the numbers 10:50:95:105:150:190. | ||
|- | |- | ||
| {{text anchor|APP_MOD_GENETIC_MODEL}} | | {{text anchor|APP_MOD_GENETIC_MODEL}} | ||
− | | | + | | Appearance Modifier |
| | | | ||
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX) | *Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX) | ||
Line 71: | Line 77: | ||
|- | |- | ||
| {{text anchor|APP_MOD_IMPORTANCE}} | | {{text anchor|APP_MOD_IMPORTANCE}} | ||
− | | | + | | Appearance Modifier |
| | | | ||
*number | *number | ||
Line 78: | Line 84: | ||
|- | |- | ||
| {{text anchor|APP_MOD_NOUN}} | | {{text anchor|APP_MOD_NOUN}} | ||
− | | | + | | Appearance Modifier |
| | | | ||
*noun | *noun | ||
Line 86: | Line 92: | ||
|- | |- | ||
| {{text anchor|APP_MOD_RATE}} | | {{text anchor|APP_MOD_RATE}} | ||
− | | | + | | Appearance Modifier |
| | | | ||
*Rate (integer) | *Rate (integer) | ||
Line 102: | Line 108: | ||
| Caste | | Caste | ||
| | | | ||
− | * | + | *creature variation ID |
− | | Applies the specified [[creature variation token|creature variation]]. | + | *(optional) any amount of arbitrary arguments |
+ | | Applies the specified [[creature variation token|creature variation]]. See [[Creature_variation_token#Arguments_and_conditional_tokens]] for how the subsequent arguments may be used. | ||
|- | |- | ||
Line 133: | Line 140: | ||
| Caste | | Caste | ||
| | | | ||
− | | Prevents the creature from attacking or | + | | Prevents the creature from attacking or frightening creatures with the {{Token|NATURAL|c}} tag. |
|- | |- | ||
Line 140: | Line 147: | ||
| | | | ||
*token | *token | ||
− | + | *selection criteria (it's complicated) | |
− | *selection criteria | ||
− | |||
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens | | Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens | ||
'''Example:'''<br /> | '''Example:'''<br /> | ||
Line 156: | Line 161: | ||
*exported wealth | *exported wealth | ||
*created wealth | *created wealth | ||
− | | Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start | + | | Specifies when a [[megabeast]] or [[semi-megabeast]] will attack the fortress. The attacks will start occurring when all of the requirements are met. Setting a value to 0 disables the trigger. |
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==B== | ==B== | ||
Line 198: | Line 201: | ||
| Caste | | Caste | ||
| | | | ||
− | | The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers | + | | The creature is non-aggressive by default, and will never automatically be engaged by companions or soldiers, running away from any creatures that are not friendly to it, and will only defend itself if it becomes enraged. Can be thought of as the counterpoint of the {{token|LARGE_PREDATOR|c}} tag. When tamed, animals with this tag will be useless for fortress defense. |
+ | |||
+ | This and {{token|TRADE_CAPACITY|c}} are required for {{token|PACK_ANIMAL|c}} to function properly, if an animal contains the aforementioned requirements without this tag: items loaded by the merchants will be dropped upon departure. | ||
|- | |- | ||
Line 219: | Line 224: | ||
| Caste | | Caste | ||
| | | | ||
− | | Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable as a creature of the night. | + | | Causes [[vampire]]-like behaviour; the creature will suck the [[Creature_token#BLOOD|blood]] of unconscious victims when its [[Syndrome#TIME_SINCE_SUCKED_BLOOD|thirst for blood]] grows sufficiently large. When controlling the creature in adventure mode, this can be done at will. Seems to be required to make the creature denouncable (in-world) as a creature of the night. |
|- | |- | ||
Line 231: | Line 236: | ||
This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs. | This is the body from a [[purring maggot]]. It creates a body with head, a heart, some guts, a brain, and a mouth. That's all a maggot needs. | ||
− | '''If the body is left undefined, the creature will | + | The body parts need to be listed in an order such that any parent part appears before its connected children. For example [BODY:HEART:BODY_WITH_HEAD_FLAG] produces a "Body Token Recognized But Could Not Connect: HEART" error because HEART can't find any UPPERBODY(s) to connect to. Switching the order to [BODY:BODY_WITH_HEAD_FLAG:HEART] fixes the problem because now the UPPERBODY is created before the HEART tries to connect to it. |
+ | |||
+ | '''If the body is left undefined, the creature (or caste) will be tagged as [DOES_NOT_EXIST].''' {{verify}} | ||
|- | |- | ||
Line 257: | Line 264: | ||
*PlanName | *PlanName | ||
*Arguments | *Arguments | ||
− | | | + | | Loads a plan from listed OBJECT:BODY_DETAIL_PLAN files, such as b_detail_plan_default.txt. Mass applies USE_MATERIAL_TEMPLATE, mass alters RELSIZE, alters body part positions, and will allow tissue layers to be defined. Tissue layers are defined in order of skin to bone here. |
'''Example:'''<br /> | '''Example:'''<br /> | ||
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br /> | [BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br /> | ||
Line 325: | Line 332: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==C== | ==C== | ||
Line 378: | Line 383: | ||
| Caste | | Caste | ||
| | | | ||
− | | Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures. | + | | Allows the creature to open [[door]]s that are set to be unpassable for pets. In adventure mode, creatures lacking this token will be unable to pass through door tiles except whilst these are occupied by other creatures. Not currently useful in Fortress mode as doors can no longer be set unpassable for pets.{{version|50.03}} |
|- | |- | ||
Line 384: | Line 389: | ||
| Caste | | Caste | ||
| | | | ||
− | | Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. | + | | Creature ''only'' eats [[meat]]. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Does not seem to affect the diet of the adventurer in adventure mode. |
|- | |- | ||
Line 432: | Line 437: | ||
*plural | *plural | ||
*adjective | *adjective | ||
− | | | + | | While {{token|NAME|c}} describes the name of the species, {{token|CASTE_NAME|c}} names individuals of the species. Unlike other caste-specific descriptions, this token is required, even for creatures without separate castes. If left undefined, the creature will not show up in the [[arena]] and members of the species will be labeled as "nothing". |
|- | |- | ||
Line 456: | Line 461: | ||
*'character' or tile number | *'character' or tile number | ||
| Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}. | | Caste-specific {{token|CREATURE_SOLDIER_TILE|c}}. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 482: | Line 480: | ||
| | | | ||
*Varies | *Varies | ||
− | | Specifies details | + | | Specifies interaction details following a {{token|CAN_DO_INTERACTION|c}} token. See [[interaction token]]. |
|- | |- | ||
Line 503: | Line 501: | ||
| | | | ||
*integer | *integer | ||
− | | Age at which creature is considered an adult | + | | Age at which creature is considered an adult - one can think of this as the duration of the [[children|child]] stage. Allows the creature's offspring to be rendered fully tame if [[animal trainer|trained]] during their childhood. |
|- | |- | ||
Line 511: | Line 509: | ||
*singular | *singular | ||
*plural | *plural | ||
− | | Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}. | + | | Defines a new name for a creature in the child state at the caste level. For non-caste-specific child names, see {{token|GENERAL_CHILD_NAME|c}}. |
|- | |- | ||
Line 519: | Line 517: | ||
*min | *min | ||
*max | *max | ||
− | | The minimum/maximum numbers of how many creatures per spawned cluster. | + | | The minimum/maximum numbers of how many creatures per spawned cluster. Vermin fish with this token in combination with temperate ocean and river biome tokens [http://www.bay12forums.com/smf/index.php?topic=51864.msg1122319#msg1122319 will perform seasonal migrations]. Defaults to 1:1 if not specified. |
|- | |- | ||
Line 570: | Line 568: | ||
|- | |- | ||
| {{text anchor|COPY_TAGS_FROM}} | | {{text anchor|COPY_TAGS_FROM}} | ||
− | | | + | | Special |
| | | | ||
− | * | + | *creature ID |
− | | Copies | + | | Copies another specified creature. This will override any definitions made before it; essentially, it makes this creature identical to the other one, which can then be modified. Often used in combination with {{token|APPLY_CREATURE_VARIATION|c}} to import standard variations from a file. The vanilla [[giant animal]]s and [[animal person|animal people]]s are examples of this token combination. |
+ | |||
+ | |- | ||
+ | | {{text anchor|CREATURE}} | ||
+ | | Creature | ||
+ | | | ||
+ | *creature ID | ||
+ | | A unique, arbitrary identifier that begins the definition of each new creature, and is used to reference the creature in other tokens and raws. | ||
|- | |- | ||
Line 580: | Line 585: | ||
| | | | ||
*classname | *classname | ||
− | | An arbitrary creature classification. Can be set to anything, but only | + | | An arbitrary creature classification. Can be set to anything, but the only vanilla uses are GENERAL_POISON (used in syndromes), EDIBLE_GROUND_BUG (used as targets for {{token|GOBBLE_VERMIN_CLASS|c}}), MAMMAL, and POISONOUS (both used for kobold pet eligibility). A single creature can have multiple classes. |
+ | The full list of tokens that use creature classes is: | ||
+ | |||
+ | * Creature tokens: {{token|GOBBLE_VERMIN_CLASS|c}}, {{token|GOBBLE_VERMIN_CLASS|c}} | ||
+ | * Interaction tokens: {{token|IT_AFFECTED_CLASS|in}}, {{token|IT_IMMUNE_CLASS|in}} | ||
+ | * Animal definition (Entity) tokens: {{token|ANIMAL_CLASS|e}}, {{token|ANIMAL_FORBIDDEN_CLASS|e}} | ||
+ | * Position (Entity) token: {{token|ALLOWED_CLASS|po}} | ||
+ | * Syndrome tokens: {{token|SYN_AFFECTED_CLASS|sy}}, {{token|SYN_IMMUNE_CLASS|sy}}, {{token|CE_SENSE_CREATURE_CLASS|sy}} | ||
|- | |- | ||
| {{text anchor|CREATURE_SOLDIER_TILE}} | | {{text anchor|CREATURE_SOLDIER_TILE}} | ||
Line 618: | Line 630: | ||
| Caste | | Caste | ||
| | | | ||
− | | Allows a creature to [[Steals items|steal things]] (apparently, of the highest value it can find). It will attempt to grab an item of value and immediately make its way to the map's edge, where it will disappear with it. If the creature goes on rampages in worldgen, it will often steal items instead of attacking - [[kea]] birds are infamous for this. Trained and tame instances of the creature will no longer display this behavior. Also, makes the creature unable to drop hauled items until it enters combat. | + | | Allows a creature to [[Steals items|steal things]] (apparently, of the highest value it can find). It will attempt to grab an item of value and immediately make its way to the map's edge, where it will disappear with it. If a creature with any of the CURIOUSBEAST tokens carries anything off the map, even if it is a caravan's pack animal, it will be reported as stealing everything it carries. If the creature goes on rampages in worldgen, it will often steal items instead of attacking - [[kea]] birds are infamous for this. Trained and tame instances of the creature will no longer display this behavior. Also, makes the creature unable to drop hauled items until it enters combat. |
|- | |- | ||
Line 635: | Line 647: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==D== | ==D== | ||
Line 651: | Line 661: | ||
| Caste | | Caste | ||
| | | | ||
− | | Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}} | + | | Found on generated [[demon]]s. Marks the caste to be used in the initial wave after breaking into the [[underworld]], and by the demon civilizations created during world-gen breachings{{verify}}. |
|- | |- | ||
Line 658: | Line 668: | ||
| | | | ||
*text | *text | ||
− | | A brief description of the creature type. | + | | A brief description of the creature type, as displayed when viewing the creature's description/[[Thoughts and preferences|thoughts & preferences]] screen. |
|- | |- | ||
Line 664: | Line 674: | ||
| Caste | | Caste | ||
| | | | ||
− | | | + | | Causes the creature to die upon attacking. Used by [[honey bee]]s to simulate them dying after using their stingers. |
|- | |- | ||
Line 671: | Line 681: | ||
| | | | ||
*integer | *integer | ||
− | | Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode. | + | | Increases experience gain during adventure mode. Creatures with a difficulty of 11 or higher are not assigned for quests in adventure mode. |
|- | |- | ||
Line 683: | Line 693: | ||
| Caste | | Caste | ||
| | | | ||
− | | The creature hunts vermin by diving from the air. On tame creatures it | + | | The creature hunts vermin by diving from the air. On tame creatures, it has the same effect as {{token|HUNTS_VERMIN|c}}. Found on [[peregrine falcon]]s. |
|- | |- | ||
Line 694: | Line 704: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==E== | ==E== | ||
Line 712: | Line 720: | ||
*[[item token]] | *[[item token]] | ||
*[[material token]] (ANY_HARD_STONE can be used for the material) | *[[material token]] (ANY_HARD_STONE can be used for the material) | ||
− | | Defines the item that the creature drops upon being butchered. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}. | + | | Defines the item that the creature drops upon being [[butcher|butchered]]. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}. |
|- | |- | ||
Line 719: | Line 727: | ||
| | | | ||
*gem shape | *gem shape | ||
− | | The shape of the creature's extra butchering drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}. | + | | The shape of the creature's extra [[butcher|butchering]] drop. Used with {{token|EXTRA_BUTCHER_OBJECT|c}}. |
|- | |- | ||
Line 727: | Line 735: | ||
* <[[material token]]> | * <[[material token]]> | ||
* <[[Material_definition_token#Material_States|material state]]> | * <[[Material_definition_token#Material_States|material state]]> | ||
− | | | + | | Defines the material composition of [[egg]]s laid by the creature. [[creature_token#LAYS_EGGS|Egg-laying]] creatures in the default game define this 3 times, using LOCAL_CREATURE_MAT:EGGSHELL, LOCAL_CREATURE_MAT:EGG_WHITE, and then LOCAL_CREATURE_MAT:EGG_YOLK. Eggs will be made out of eggshell. Edibility is determined by tags on whites or yolk, but they otherwise do not exist. |
|- | |- | ||
Line 734: | Line 742: | ||
| | | | ||
*size | *size | ||
− | | Determines the size of | + | | Determines the size of laid [[egg]]s. Doesn't affect hatching or cooking, but bigger eggs will be heavier, and may take longer to be hauled depending on the hauler's strength. |
|- | |- | ||
Line 740: | Line 748: | ||
| Creature | | Creature | ||
| | | | ||
− | | Makes the creature appear as a large | + | | Makes the creature appear as a large 3×3 [[wagon]] responsible for carrying trade goods, pulled by two {{token|WAGON_PULLER|c}} creatures and driven by a merchant. |
|- | |- | ||
Line 752: | Line 760: | ||
| Creature | | Creature | ||
| | | | ||
− | | | + | | The creature is considered evil and will only show up in evil biomes. Civilizations with {{token|USE_EVIL_ANIMALS|e}} can domesticate them regardless of exotic status. Has no effect on cavern creatures except to restrict taming. A civilization with evil creatures can colonise evil areas. |
|- | |- | ||
Line 760: | Line 768: | ||
* BY_CATEGORY, BY_TYPE, BY_TOKEN | * BY_CATEGORY, BY_TYPE, BY_TOKEN | ||
* TYPE, CATEGORY, or TOKEN | * TYPE, CATEGORY, or TOKEN | ||
− | | The creature drops an additional object when butchered | + | | The creature drops an additional object when [[butcher|butchered]], as defined by {{token|EBO_ITEM|c}} and {{token|EBO_SHAPE|c}}. Used for [[gizzard stone]]s in default creatures. For some materials, needs to be defined after caste definitions with SELECT_CASTE:ALL{{Bug|6355}} |
|- | |- | ||
Line 773: | Line 781: | ||
| Caste | | Caste | ||
| | | | ||
− | | | + | | The creature can see regardless of whether it has working eyes and has full 360 degree vision, making it impossible to strike the creature from a blind spot in combat. Invisible creatures will also be seen, namely [[intelligent undead]] using a "vanish" power. |
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==F== | ==F== | ||
Line 798: | Line 804: | ||
| Caste | | Caste | ||
| | | | ||
− | | Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions, it caused these creatures to crawl out of chasms and underground rivers. | + | | Found on [[Animal people#Subterranean animal people|subterranean animal-man]] tribals. Currently defunct. In previous versions{{verify}}, it caused these creatures to crawl out of chasms and underground rivers. |
|- | |- | ||
Line 804: | Line 810: | ||
| Caste | | Caste | ||
| | | | ||
− | | Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. | + | | Found on [[forgotten beast]]s. Presumably makes it act as such, initiating underground attacks on fortresses, or leads to the pop-up message upon encountering one{{verify}}. Hides the creature from displaying in a world_sites_and_pops file. Does not create historical figures like generated forgotten beasts do. |
+ | |||
+ | Requires specifying a {{token|BIOME|c}} in which the creature will live, and both surface and subterranean biomes are allowed. Does not stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will not spawn. Appears to be incompatible with {{token|DEMON|c}} even if used in separate castes. | ||
|- | |- | ||
Line 836: | Line 844: | ||
| | | | ||
*temperature | *temperature | ||
− | | The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] | + | | The creature's body is constantly at this temperature, heating up or cooling the surrounding area. Alters the temperature of the creature's inventory and all adjacent tiles, [[Temperature|with all the effects that this implies]] - may trigger wildfires at high enough values. Also makes the creature immune to extreme heat or cold, as long as the temperature set is not harmful to the materials that the creature is made from. Corpses and body parts of creatures with a fixed temperature maintain their temperature even after death. |
Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode. | Note that temperatures of 12000 and higher may cause [[path|pathfinding]] issues in fortress mode. | ||
Line 857: | Line 865: | ||
| | | | ||
*number, max 100 | *number, max 100 | ||
− | | Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading. | + | | Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. Also affects the chance of a creature being brought in a caravan for trading. |
+ | This value is used multiply to determine the rarity of animal populations. A creature with [FREQUENCY:50] will appear in 50% of valid biomes, and be present in 50% of the area within those biomes. | ||
+ | When a [[Creature token#CLUSTER_NUMBER|cluster]] spawns, the game effectively considers all creatures that can possibly appear and uses the FREQUENCY value as a ''weight'' - for example, if there are three creatures with frequencies 10/25/50, the creature with [FREQUENCY:50] will appear approximately 58.8% of the time. Defaults to 50 if not specified. Not to be confused with {{token|POP_RATIO|c}}. | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==G== | ==G== | ||
Line 884: | Line 892: | ||
* <energy expenditure> | * <energy expenditure> | ||
* <gait flag(s)> | * <gait flag(s)> | ||
− | | Defines a gait by which the creature can move. See [[Gait]] for more information. | + | | Defines a gait by which the creature can move. See [[Gait]] for more information. Specifically, you likely want to use one of the existing STANDARD_X_GAITS creature variations, as described in [[Gait#Gaits_and_Modding|this subsection]]. |
* <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait | * <max speed> indicates the maximum [[Gait#Speed|speed]] achievable by a creature using this gait | ||
Line 1,023: | Line 1,031: | ||
| Special | | Special | ||
| | | | ||
− | | When using tags from an existing creature, inserts new tags | + | | When using tags from an existing creature, inserts new tags ''before'' the specified tag. |
|- | |- | ||
Line 1,050: | Line 1,058: | ||
| | | | ||
*number | *number | ||
− | | The creature is a grazer | + | | The creature is a grazer - if tamed in fortress mode, it needs a pasture to survive. The higher the number, the less frequently it needs to eat in order to live. Not used since 0.40.12, replaced by {{token|STANDARD_GRAZER|c}} to fix {{bugl|4113}}. |
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==H== | ==H== | ||
Line 1,071: | Line 1,077: | ||
*type | *type | ||
*probability | *probability | ||
− | | Defines certain behaviors for the creature. The habit types are COLLECT_TROPHIES | + | | Defines certain behaviors for the creature. The habit types are: |
+ | *COLLECT_TROPHIES | ||
+ | *COOK_PEOPLE | ||
+ | *COOK_VERMIN | ||
+ | *GRIND_VERMIN | ||
+ | *COOK_BLOOD | ||
+ | *GRIND_BONE_MEAL | ||
+ | *EAT_BONE_PORRIDGE | ||
+ | *USE_ANY_MELEE_WEAPON | ||
+ | *GIANT_NEST | ||
+ | *COLLECT_WEALTH. | ||
+ | These require the creature to have a {{token|LAIR|c}} to work properly, and also don't seem to work on creatures who are not a {{token|SEMIMEGABEAST|c}}, {{token|MEGABEAST|c}}, or{{token|NIGHT_CREATURE_HUNTER|c}}. | ||
|- | |- | ||
Line 1,091: | Line 1,108: | ||
| | | | ||
| The creature has a shell. Seemingly no longer used - holdover from previous versions. | | The creature has a shell. Seemingly no longer used - holdover from previous versions. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 1,119: | Line 1,129: | ||
| Caste | | Caste | ||
| | | | ||
− | | Creature hunts and kills nearby vermin. | + | | Creature hunts and kills nearby [[vermin]], randomly walking between places with food laying on the ground or in stockpiles, to check for possible [VERMIN_EATER] vermin, but they'll kill any other vermin too. Do not include this creature token on an intelligent entity that you intend to play as in fortress mode because it will prevent them from feeding themselves. |
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==I== | ==I== | ||
Line 1,151: | Line 1,159: | ||
| Caste | | Caste | ||
| | | | ||
− | | The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on | + | | The creature radiates [[fire]]. It will ignite, and potentially completely destroy, items the creature is standing on. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of any flammable materials (specifically ones that could be ignited by magma). |
|- | |- | ||
Line 1,157: | Line 1,165: | ||
| Caste | | Caste | ||
| | | | ||
− | | Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}} | + | | Alias for {{token|CAN_SPEAK|c}} + {{token|CAN_LEARN|c}}. |
|- | |- | ||
Line 1,165: | Line 1,173: | ||
* [[item token]] | * [[item token]] | ||
* [[material token]] | * [[material token]] | ||
− | | Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). | + | | Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, stone, pool of liquid, etc.). [[Ethics]] may prevent actually using the item in jobs or reactions. |
|- | |- | ||
Line 1,175: | Line 1,183: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==L== | ==L== | ||
Line 1,193: | Line 1,199: | ||
*type | *type | ||
*probability | *probability | ||
− | | Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are SIMPLE_BURROW | + | | Found on megabeasts, semimegabeasts, and night creatures. The creature will seek out sites of this type and take them as lairs. The lair types are: |
+ | *SIMPLE_BURROW | ||
+ | *SIMPLE_MOUND | ||
+ | *WILDERNESS_LOCATION | ||
+ | *SHRINE | ||
+ | *LABYRINTH | ||
|- | |- | ||
Line 1,220: | Line 1,231: | ||
| Caste | | Caste | ||
| | | | ||
− | | Will attack | + | | Will attack other creatures that are smaller than it. In [[fortress mode]], only one group of "large predators" (possibly two groups on "savage" maps) will appear on any given map. In [[adventurer mode]], large predators will try to ambush and attack you (and your party will attack them back). When tamed, large predators tend to be much more aggressive to enemies than non-large predators, making them a good choice for an animal army. They may go on rampages in worldgen, and adventurers may receive quests to kill them. Also, they can be mentioned in the intro paragraph when starting a fortress e.g. "ere the wolves get hungry." |
+ | A single biome supports 7 large predator species, picking randomly and rolling a d100 under its {{token|FREQUENCY|c}} to add it until all 7 slots are filled. | ||
+ | |||
+ | Incompatible with {{token|PACK_ANIMAL|c}} on a technicality, if included: hauled items are likely to be dropped upon entering the map (even if {{token|TRADE_CAPACITY|c}} is present) in contrast to when the merchants depart. | ||
|- | |- | ||
Line 1,226: | Line 1,240: | ||
| Creature | | Creature | ||
| | | | ||
− | | | + | | This is the core requisite tag allowing the creature to spawn as a wild animal in the appropriate biomes. Requires specifying a {{token|BIOME|c}} in which the creature will spawn. Does not require specifying a frequency, population number, or cluster number. |
+ | |||
+ | This tag stacks with {{token|MEGABEAST|c}}, {{token|SEMIMEGABEAST|c}}, or {{token|NIGHT_CREATURE_HUNTER|c}}; if used with one of these tags, the creature will spawn as both a boss and as a wild animal. This tag does not stack with {{token|FEATURE_BEAST|c}} and if both are used the creature will not spawn. This tag is unaffected by {{token|DEMON|c}}. | ||
|- | |- | ||
Line 1,232: | Line 1,248: | ||
| Caste | | Caste | ||
| | | | ||
− | | Creature lays | + | | Creature lays [[egg]]s instead of giving birth to live young. |
|- | |- | ||
Line 1,240: | Line 1,256: | ||
* [[item token]] | * [[item token]] | ||
* [[material token]] | * [[material token]] | ||
− | | Creature lays | + | | Creature lays the specified item instead of regular eggs. |
|- | |- | ||
Line 1,254: | Line 1,270: | ||
| Caste | | Caste | ||
| | | | ||
− | | | + | | A vermin featuring this tag will remain visible to an adventurer, even at night, and from a distance. Ostensibly bugged as of v0.47.05. |
|- | |- | ||
Line 1,266: | Line 1,282: | ||
| Caste | | Caste | ||
| | | | ||
− | | Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. | + | | Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz."). Used by [[Serpent man|serpent men]] and [[Reptile man|reptile men]] in the vanilla game. C's with the same pronunciation (depending on the word) are not affected by this token. |
|- | |- | ||
Line 1,274: | Line 1,290: | ||
* minimum | * minimum | ||
* maximum | * maximum | ||
− | | Determines the number of offspring per one birth. | + | | Determines the number of offspring per one birth; default 1-3, not used in vanilla raws. See also {{token|MULTIPLE_LITTER_RARE|c}}. |
|- | |- | ||
− | | {{text anchor|LOCAL_POPS_CONTROLLABLE | + | | {{text anchor|LOCAL_POPS_CONTROLLABLE}} |
| Creature | | Creature | ||
| | | | ||
Line 1,283: | Line 1,299: | ||
|- | |- | ||
− | | {{text anchor|LOCAL_POPS_PRODUCE_HEROES | + | | {{text anchor|LOCAL_POPS_PRODUCE_HEROES}} |
| | | | ||
| | | | ||
Line 1,292: | Line 1,308: | ||
| Caste | | Caste | ||
| | | | ||
− | | Lets a creature open | + | | Lets a creature open [[door]]s that are set to forbidden in fortress mode. |
|- | |- | ||
Line 1,308: | Line 1,324: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==M== | ==M== | ||
Line 1,324: | Line 1,338: | ||
| Caste | | Caste | ||
| | | | ||
− | | | + | | According to Toady One, this is completely interchangeable with {{token|AT_PEACE_WITH_WILDLIFE|c}} and might have been used in very early versions of the game by wandering wizards or the ent-type tree creatures that used to be animated by elves. [http://www.bay12forums.com/smf/index.php?topic=169696.msg8316954#msg8316954] |
|- | |- | ||
Line 1,336: | Line 1,350: | ||
| Caste | | Caste | ||
| | | | ||
− | | | + | | Makes the creature biologically male. Usually declared inside a caste. |
|- | |- | ||
Line 1,350: | Line 1,364: | ||
| | | | ||
*material id | *material id | ||
− | | Begins defining a new material. | + | | Begins defining a new local material. Follow this with standard material definition tokens to define the material. |
|- | |- | ||
Line 1,380: | Line 1,394: | ||
| Caste | | Caste | ||
| | | | ||
− | | Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. | + | | Makes the creature slowly stroll around, unless it's in combat or performing a job. If combined with {{token|CAN_LEARN|c}}, will severely impact their [[pathfinding]] and lead the creature to move extremely slowly when not performing any task. Problematically applies to animal people based on the animal and war trained animals{{bug|9588}}. |
|- | |- | ||
Line 1,388: | Line 1,402: | ||
| A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details. | | A 'boss' creature. A small number of the creatures are created during worldgen, their histories and descendants (if any) will be tracked in worldgen (as opposed to simply 'spawning'), and they will occasionally go on rampages, potentially leading to worship if they attack the same place multiple times. Their presence and number will also influence age names. When appearing in fortress mode, they will have a pop-up message announcing their arrival. They will remain hostile to military even after being tamed.{{bug|10731}} See [[megabeast]] page for more details. | ||
− | Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. | + | Requires specifying a {{token|BIOME|c}} in which the creature will live. Subterranean biomes appear to not be allowed. Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical bosses and as wild animals. |
|- | |- | ||
Line 1,471: | Line 1,485: | ||
| Caste | | Caste | ||
| | | | ||
− | | Makes the species usually produce a single offspring per birth, | + | | Makes the species usually produce a single offspring per birth, with a 1/500 chance of using the {{token|LITTERSIZE|c}} as usual. Requires {{token|FEMALE|c}}. |
|- | |- | ||
Line 1,480: | Line 1,494: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==N== | ==N== | ||
Line 1,499: | Line 1,511: | ||
*plural | *plural | ||
*adjective | *adjective | ||
− | | The generic name for any creature of this type - will be used | + | | The generic name for any creature of this type - will be used for referring to the species in the abstract, such as the default material prefix. For labeling individual creatures, {{token|CASTE_NAME|c}} is necessary. If left undefined, the creature will be labeled as "nothing" by the game. |
+ | |||
+ | Some examples of adjective use: | ||
+ | * "super''dwarven'' strength" | ||
+ | * "the ''dwarven'' hillocks of X" | ||
+ | * Deity species as in "''feline'' deity" | ||
+ | * Megabeast attacks in worldgen. One with multiple dragons being a "''draconic'' rampage" | ||
|- | |- | ||
Line 1,528: | Line 1,546: | ||
|- | |- | ||
− | | {{text anchor|NIGHT_CREATURE_EXPERIMENTER | + | | {{text anchor|NIGHT_CREATURE_EXPERIMENTER}} |
| Caste | | Caste | ||
| | | | ||
− | | Found on some [[necromancer]]s. Creatures with this tag | + | | Found on some [[necromancer]]s. Creatures with this tag may periodically "perform horrible experiments" offscreen, during which they can use creature-targeting interactions with an <code>[[Interaction_token#I_SOURCE|[I_SOURCE:EXPERIMENT]]]</code> tag on living creatures in their area. Worlds are generated with a list of procedurally-generated experiments, allowing necromancers to turn living people and animals into [[Infected_ghoul|ghouls]] and [[Experiment|other experimental creatures]], and these will automatically be available to all experimenters; it does not appear possible to prevent this. You can mod in your own custom experiment interactions, but these are used very infrequently due to the large number of generated experiments. |
|- | |- | ||
Line 1,538: | Line 1,556: | ||
| | | | ||
| Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings. | | Found on [[night troll]]s and [[werebeast]]s. Implies that the creature is a [[night creature]], and shows its description in [[legends mode]] entry. The creature is always hostile and will start [[no quarter]] combat with any nearby creatures, except for members of its own race. Note that this tag does not override the creature's normal behavior in [[fortress mode]] except for the aforementioned aggression, and doesn't prevent the creature from fleeing the battles it started. It also removes the creature's materials from stockpile settings list, making them be stored there regardless of settings. | ||
+ | |||
+ | Does stack with {{token|LARGE_ROAMING|c}} and if both are used the creature will spawn as both historical hunters and as wild animals; this requires specifying a {{token|BIOME|c}} in which the creature will live, and subterranean biomes are allowed. | ||
This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible). | This tag causes the usual behaviour of werebeasts in worldgen, that is, fleeing towns upon being cursed and conducting raids from a lair. If this tag is absent from a deity curse, the accursed will simply be driven out of towns in a similar manner to [[vampire]]s. When paired with SPOUSE_CONVERTER, a very small population of the creature will be created during worldgen (sometimes only a single individual will be created), and their histories will be tracked (that is, they will not spawn spontaneously later, they must either have children or convert other creatures to increase their numbers). The creature will settle in a lair and go on rampages during worldgen. It will actively attempt to seek out potential conversion targets to abduct, convert, and have children with (if possible). | ||
|- | |- | ||
− | | {{text anchor|NIGHT_CREATURE_NIGHTMARE | + | | {{text anchor|NIGHT_CREATURE_NIGHTMARE}} |
| Caste | | Caste | ||
| | | | ||
Line 1,575: | Line 1,595: | ||
| Caste | | Caste | ||
| | | | ||
− | | Creature does not need to [[food|eat]]. | + | | Creature does not need to [[food|eat]]. Seems to cause worldgen crashes if it is part of an entity with [[entity_token#PERMITTED_JOB|[PERMITTED_JOB:FISHERMAN]]]{{verify}} |
|- | |- | ||
Line 1,587: | Line 1,607: | ||
| Caste | | Caste | ||
| | | | ||
− | | | + | | The creature is biologically sexless. Makes the creature unable to [[breeding|breed]]. |
|- | |- | ||
Line 1,677: | Line 1,697: | ||
| Caste | | Caste | ||
| | | | ||
− | | Creature doesn't feel fear and will never flee from battle. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature. | + | | Creature doesn't feel fear and will never flee from battle, and will be immune to [[ghost]]s' attempts to 'scare it to death'. Additionally, it causes [[bogeyman|bogeymen]] and [[nightmare]]s to become friendly towards the creature. |
|- | |- | ||
Line 1,683: | Line 1,703: | ||
| Caste | | Caste | ||
| | | | ||
− | | Creature will not | + | | Creature will not be hunted or fed to wild beasts. |
|- | |- | ||
Line 1,746: | Line 1,766: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==O== | ==O== | ||
Line 1,763: | Line 1,781: | ||
| | | | ||
*number | *number | ||
− | | How easy the creature is to [[smell]]. The higher the number, the easier the creature | + | | How easy the creature is to [[smell]]. The higher the number, the easier the creature is to sniff out. Defaults to 50. Vanilla creatures have values from 0 (undetectable) to 90 (noticeable by humans and dwarves). |
|- | |- | ||
Line 1,770: | Line 1,788: | ||
| | | | ||
*string | *string | ||
− | | What the creature | + | | What the creature [[smell]]s like. If no odor string is defined, the creature name (not the caste name) is used. |
|- | |- | ||
Line 1,776: | Line 1,794: | ||
| Caste | | Caste | ||
| | | | ||
− | | Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the NOT_LIVING token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token. | + | | Is hostile to all creatures except undead and other non-living ones and will show {{DFtext|Opposed to life|0:1}} in the [[unit list]]. Used by [[undead]] in the vanilla game. Functions without the {{token|NOT_LIVING|c}} token, and seems to imply said token as well. Undead will not be hostile to otherwise-living creatures given this token. Living creatures given this token will attack living creatures that lack it, while ignoring other living creatures that also have this token. |
|- | |- | ||
Line 1,784: | Line 1,802: | ||
*MALE/FEMALE | *MALE/FEMALE | ||
*disinterested chance | *disinterested chance | ||
− | * | + | *casual chance |
− | * | + | *strong chance |
− | | Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will become lovers | + | | Determines caste's likelihood of having sexual attraction to certain sexes. Values default to 75:20:5 for the same sex and 5:20:75 for the opposite sex. The first value indicates how likely to be entirely uninterested in the sex, the second decides if the creature will be able to become lovers with that sex, the third decides whether they will be able to marry in worldgen and post-worldgen world activities (which implies being able to become lovers). Marriage seems to be able to happen in fort mode play regardless, as long as they are lovers first. |
|- | |- | ||
− | | {{text anchor|OUTSIDER_CONTROLLABLE | + | | {{text anchor|OUTSIDER_CONTROLLABLE}} |
| Caste | | Caste | ||
| | | | ||
− | | Lets you play as an outsider of this species in adventure mode. | + | | Lets you play as an [[Adventurer_mode_character_creation#Outsider|outsider]] of this species in adventure mode. |
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==P== | ==P== | ||
Line 1,812: | Line 1,828: | ||
| Caste | | Caste | ||
| | | | ||
− | | Allows the creature to be used as a pack animal. | + | | Allows the creature to be used as a pack animal. Used by [[trading|merchants]] without wagons and adventurers. Also prevents creature from dropping hauled items on its own -- do ''not'' use for player-controllable creatures! May lead to the creature being domesticated during worldgen, even if it doesn't have {{token|COMMON_DOMESTIC|c}}. |
+ | |||
+ | Creatures with this tag but without {{token|BENIGN|c}}, and/or with {{token|LARGE_PREDATOR|c}} leads to hauled items being dropped. | ||
|- | |- | ||
Line 1,818: | Line 1,836: | ||
| Caste | | Caste | ||
| | | | ||
− | | The creature is immune to all paralyzing special attacks. | + | | The creature is immune to all [[Syndrome#CE_PARALYSIS|paralyzing]] special attacks. |
|- | |- | ||
Line 1,825: | Line 1,843: | ||
| | | | ||
| Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now. | | Used to control the bat riders with paralyze-dart blowguns that flew through the 2D chasm. Doesn't do anything now. | ||
+ | |||
+ | |- | ||
+ | | {{text anchor|PCG_LAYERING}} | ||
+ | | Creature | ||
+ | | | ||
+ | *[[Procedural graphics layer|Layering type]] | ||
+ | | Adds a layer to the current {{token|PROCEDURAL_CREATURE_GRAPHICS|c}} definition. | ||
|- | |- | ||
Line 1,830: | Line 1,855: | ||
| Caste | | Caste | ||
| | | | ||
− | | In earlier versions, creature would generate | + | | In earlier versions, creature would generate [[pearl]]s. Does nothing in the current version.{{verify}} |
|- | |- | ||
Line 1,837: | Line 1,862: | ||
| | | | ||
*value | *value | ||
− | | Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles. | + | | Controls the ability of [[vermin]] to find a way into containers when they are eating food from your stockpiles. |
+ | |||
+ | Objects made of most materials (e.g. metal) roll a number from 0-100, and if the resulting number is greater than the penetrate power, their contents escape for the time being. Objects made of [[wood]], [[leather]], [[amber]], or [[coral]] roll 0-95, and items made of [[cloth]] roll 0-90. | ||
|- | |- | ||
Line 1,853: | Line 1,880: | ||
| Caste | | Caste | ||
| | | | ||
− | | Allows the creature to be tamed in Fortress mode. | + | | Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prerequisite for all other working animal roles. Civilizations that encounter it in worldgen will tame and domesticate it for their own use. Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. However, you can solve these problems using the popular plugin [https://dffd.bay12games.com/file.php?id=13095| Dwarf Therapist], which is completely unaffected by the tag. |
|- | |- | ||
Line 1,859: | Line 1,886: | ||
| Caste | | Caste | ||
| | | | ||
− | | Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]). | + | | Allows the creature to be [[Animal_trainer|tamed]] in Fortress mode. Prequisite for all other working animal roles. Civilizations cannot domesticate it in worldgen, with certain exceptions. More difficult to tame?{{verify}} Adding this to civilization members will classify them as pets instead of citizens, with all the [[Fun|problems]] that entails. ([[Gremlin|Example]]). |
|- | |- | ||
Line 1,873: | Line 1,900: | ||
| | | | ||
*value | *value | ||
− | | Divides the creature's PETVALUE by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune. | + | | Divides the creature's {{token|PETVALUE|c}} by the specified number. Used by [[honey bee]]s to prevent a single hive from being worth a fortune. |
|- | |- | ||
Line 1,895: | Line 1,922: | ||
*higher | *higher | ||
*highest | *highest | ||
− | | Sets up a physical attribute's range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000. | + | | Sets up a [[Attribute#Body_attributes|physical attribute]]'s range of values (0-5000). All physical attribute ranges default to 200:700:900:1000:1100:1300:2000. |
|- | |- | ||
Line 1,906: | Line 1,933: | ||
*rust counter rate | *rust counter rate | ||
*demotion counter rate | *demotion counter rate | ||
− | | Physical attribute gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE. | + | | [[Attribute#Body_attributes|Physical attribute]] gain/decay rates. Lower numbers in the last three slots make decay occur faster. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE. |
|- | |- | ||
Line 1,914: | Line 1,941: | ||
*BY_TYPE, BY_CATEGORY, or BY_TOKEN | *BY_TYPE, BY_CATEGORY, or BY_TOKEN | ||
*body type, category, or token | *body type, category, or token | ||
− | | Adds a body part group to selected body part group. Presumably used immediately after SET_BP_GROUP. | + | | Adds a body part group to selected body part group. Presumably used immediately after {{token|SET_BP_GROUP|c}}. |
|- | |- | ||
Line 1,921: | Line 1,948: | ||
| | | | ||
*material | *material | ||
− | | Adds a material to selected materials. Used immediately after SELECT_MATERIAL. | + | | Adds a material to selected materials. Used immediately after {{token|SELECT_MATERIAL|c}}. |
|- | |- | ||
Line 1,927: | Line 1,954: | ||
| Caste | | Caste | ||
| | | | ||
− | *number | + | *number (max 100000) |
− | | Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY. | + | | Weighted population of caste; Lower is rarer. Not to be confused with {{token|FREQUENCY|c}}. A weight of 0 will not prevent a caste from spawning. |
|- | |- | ||
Line 1,942: | Line 1,969: | ||
| Caste | | Caste | ||
| | | | ||
− | | Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. Requires CAN_SPEAK to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc). | + | | Allows the being to represent itself as a deity, allowing it to become the leader of a civilized group. Used by unique demons in the vanilla game. Requires {{token|CAN_SPEAK|c}} to actually do anything more than settle at a location (e.g. write books, lead armies, profane temples). Doesn't appear to do anything for creatures that are already civilized. Once the creature ascends to a position of leadership, it will proceed to act as a standard ruler for their entity and fulfill the same functions (hold tournaments, tame creatures, etc.). |
|- | |- | ||
Line 1,950: | Line 1,977: | ||
*string | *string | ||
| Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences. | | Sets what other creatures [[Preferences|prefer]] about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random. Creatures lacking a PREFSTRING token will never appear under another's preferences. | ||
+ | |||
+ | |- | ||
+ | | {{text anchor|PROCEDURAL_CREATURE_GRAPHICS}} | ||
+ | | Creature | ||
+ | | | ||
+ | * [[Graphics_token#Basic_creature_sprite_types|Sprite type]] or Caste then sprite type | ||
+ | | Makes the creature have procedural graphics built for it, like forgotten beasts/demons/titans/experiments. Must be associated with PCG_LAYERING tokens. | ||
|- | |- | ||
Line 1,958: | Line 1,992: | ||
*singular | *singular | ||
*plural | *plural | ||
− | | The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use CASTE_PROFESSION_NAME instead. | + | | The generic name for members of this profession, at the creature level. In order to give members of specific castes different names for professions, use {{token|CASTE_PROFESSION_NAME|c}} instead. |
|- | |- | ||
Line 1,973: | Line 2,007: | ||
* <[[material token]]> | * <[[material token]]> | ||
* <[[Material_definition_token#Material_States|material state]]> | * <[[Material_definition_token#Material_States|material state]]> | ||
− | | The creature has pus. Specifies the stuff secreted by infected wounds. | + | | The creature has pus. Specifies the stuff secreted by [[Health_care#Infection|infected wounds]]. |
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==R== | ==R== | ||
Line 2,003: | Line 2,035: | ||
*singular | *singular | ||
*plural | *plural | ||
− | | What creature's remains are called. | + | | What the creature's [[remains]] are called. |
|- | |- | ||
Line 2,009: | Line 2,041: | ||
| Caste | | Caste | ||
| | | | ||
− | | What color the creature's remains are. | + | | What color the creature's [[remains]] are. |
|- | |- | ||
Line 2,015: | Line 2,047: | ||
| Caste | | Caste | ||
| | | | ||
− | | Goes with VERMIN_BITE and DIE_WHEN_VERMIN_BITE, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites. | + | | Goes with {{token|VERMIN_BITE|c}} and {{token|DIE_WHEN_VERMIN_BITE|c}}, the vermin creature will leave remains on death when biting. Leaving this tag out will cause the creature to disappear entirely after it bites. |
|- | |- | ||
Line 2,028: | Line 2,060: | ||
| | | | ||
*material token | *material token | ||
− | | Removes a material from | + | | Removes a material from the creature. |
|- | |- | ||
Line 2,035: | Line 2,067: | ||
| | | | ||
*tissue token | *tissue token | ||
− | | Removes a tissue from | + | | Removes a tissue from the creature. |
|- | |- | ||
Line 2,047: | Line 2,079: | ||
*Second person cancel retract text | *Second person cancel retract text | ||
*Third person cancel retract text | *Third person cancel retract text | ||
− | | The creature will retract into | + | | The creature will retract into the specified body part(s) when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part(s). When one of the specified body part is severed off, the creature automatically unretracts and cannot retract anymore. More than one body part can be selected by using BY_TYPE or BY_CATEGORY. |
− | Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game. | + | Second-person descriptions are used for adventurer mode natural ability. "<pro_pos>" can be used in the descriptions, being replaced with the proper pronoun (or lack thereof) in-game. |
− | Undead curled up creatures are buggy{{bug|11463}}{{bug|10519}}. | + | Undead curled up creatures are buggy, specifically those that retract into their upper bodies: [[echidna]]s, [[hedgehog]]s and [[pangolin]]s.{{bug|11463}}{{bug|10519}} The upper body is prevented from collapsing by a separate body part (the middle spine), which cannot be attacked when the creature is retracted. See {{token|PREVENTS_PARENT_COLLAPSE|bo}}. Living creatures eventually succumb to blood loss, but undead creatures do not. Giant creatures also take a very long time to bleed out. |
|- | |- | ||
| {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}} | | {{text anchor|RETURNS_VERMIN_KILLS_TO_OWNER}} | ||
| | | | ||
| | | | ||
− | | Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires HUNTS_VERMIN | + | | Cat behavior. If it kills a vermin creature and has an owner, it carries the remains in its mouth and drops them at their feet. Requires {{token|HUNTS_VERMIN|c}}. |
|- | |- | ||
Line 2,074: | Line 2,106: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==S== | ==S== | ||
Line 2,130: | Line 2,160: | ||
*<[[material token]]> | *<[[material token]]> | ||
| Selects a locally defined material. Can be ALL. | | Selects a locally defined material. Can be ALL. | ||
+ | |||
+ | |- | ||
+ | | {{text anchor|SELECT_TISSUE}} | ||
+ | | Creature | ||
+ | | | ||
+ | *tissue token | ||
+ | | Selects a tissue for editing. | ||
|- | |- | ||
Line 2,153: | Line 2,190: | ||
*category, type, or token | *category, type, or token | ||
| Begins a selection of body parts. | | Begins a selection of body parts. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 2,229: | Line 2,248: | ||
|- | |- | ||
− | | {{text anchor| | + | | {{text anchor|SLAIN_CASTE_SPEECH}} |
| Caste | | Caste | ||
− | | | + | | |
− | + | *[[Speech file|text set]] | |
+ | | Caste-specific {{token|SLAIN_SPEECH|c}}. | ||
|- | |- | ||
− | | {{text anchor|SMALL_REMAINS}} | + | | {{text anchor|SLAIN_SPEECH}} |
+ | | Creature | ||
+ | | | ||
+ | *[[Speech file|text set]] | ||
+ | | Boasting speeches relating to killing this creature. Examples include [[text_dwarf.txt/raw|text_dwarf.txt]] (<code>[SLAIN_SPEECH:SLAIN_DWARF]</code>) and text_elf.txt (<code>[SLAIN_SPEECH:SLAIN_ELF]</code>) in data\vanilla\vanilla_creatures\objects. | ||
+ | |||
+ | |- | ||
+ | | {{text anchor|SLOW_LEARNER}} | ||
+ | | Caste | ||
+ | | | ||
+ | | Shorthand for {{token|CAN_LEARN|c}} + <code>[[Creature_token#SKILL_LEARN_RATES|[SKILL_LEARN_RATES:50]]]</code>.{{verify}} Used by a number of 'primitive' creatures (like [[ogre]]s, [[giant]]s and [[troglodyte]]s) in the vanilla game. Applicable to player races. Prevents a player from recruiting nobility, even basic ones. Subterranean creatures with this token combined with {{token|EVIL|c}} will become servants of goblins in their civilizations, in the style of [[troll]]s. | ||
+ | |||
+ | |- | ||
+ | | {{text anchor|SMALL_REMAINS}} | ||
| Caste | | Caste | ||
| | | | ||
Line 2,245: | Line 2,278: | ||
| | | | ||
*value | *value | ||
− | | Determines how keen a creature's sense of smell is | + | | Determines how keen a creature's sense of smell is - lower is better. At 10000, a creature cannot smell at all. |
|- | |- | ||
Line 2,270: | Line 2,303: | ||
* Out of sight reads "You hear '''a loud bark'''" | * Out of sight reads "You hear '''a loud bark'''" | ||
with the text in bold being the description arguments of the token. | with the text in bold being the description arguments of the token. | ||
+ | |||
+ | |- | ||
+ | | {{text anchor|SOURCE_HFID}} | ||
+ | | Creature | ||
+ | | | ||
+ | *Integer | ||
+ | | Found on generated [[angel]]s. This is the historical figure ID of the deity with which the angel is associated. Since HFIDs are not predictable before worldgen, this isn't terribly usable in mods. | ||
|- | |- | ||
Line 2,278: | Line 2,318: | ||
* Plant/creature ID | * Plant/creature ID | ||
| Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available. | | Creature will only appear in biomes with this plant or creature available. Grazers given a specific type of grass (such as [[panda]]s and [[bamboo]]) will only eat that grass and nothing else, risking starvation if there's none available. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 2,320: | Line 2,339: | ||
|- | |- | ||
− | | {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER | + | | {{text anchor|SPREAD_EVIL_SPHERES_IF_RULER}} |
| Caste | | Caste | ||
| | | | ||
Line 2,338: | Line 2,357: | ||
|- | |- | ||
− | | {{text anchor|STRANGE_MOODS | + | | {{text anchor|STRANGE_MOODS}} |
| Caste | | Caste | ||
| | | | ||
Line 2,347: | Line 2,366: | ||
| Caste | | Caste | ||
| | | | ||
− | | Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] | + | | Gives the creature knowledge of any secrets with <code>[[Interaction_token#IS_SECRET|[SUPERNATURAL_LEARNING_POSSIBLE]]]</code> that match its [[Creature_token#SPHERE|spheres]] and also prevents it from becoming a [[vampire]] or [[werebeast]]. Other effects are unknown. |
|- | |- | ||
Line 2,362: | Line 2,381: | ||
|- | |- | ||
− | | {{text anchor|SYNDROME_DILUTION_FACTOR | + | | {{text anchor|SYNDROME_DILUTION_FACTOR}} |
| Caste | | Caste | ||
| <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage> | | <[[Syndrome#SYN_IDENTIFIER|syndrome identifier]]>:<percentage> | ||
Line 2,368: | Line 2,387: | ||
|} | |} | ||
− | + | {{alphabetical TOC|style=margin: 1em auto;}} | |
− | {{alphabetical TOC}} | ||
− | |||
==T== | ==T== | ||
Line 2,392: | Line 2,409: | ||
| Caste | | Caste | ||
| | | | ||
− | | The creature's | + | | The creature's [[web]]s can catch larger creatures. |
|- | |- | ||
Line 2,399: | Line 2,416: | ||
| | | | ||
*name | *name | ||
− | | Begins defining a tissue in the creature file. | + | | Begins defining a tissue in the creature file. Follow this with standard tissue definition tokens to define the tissue properties. |
|- | |- | ||
− | | {{text anchor| | + | | {{text anchor|TISSUE_LAYER}} |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| Caste | | Caste | ||