DF2014:Creature variation token
|This article is about the current version of DF.|
Creature variations are used to create creatures which are derived from another already-existing creature without having to duplicate every single token. They are defined as CREATURE_VARIATION objects, and the default variations are defined in c_variation_default.txt
From the raws:
Order of application: Remove tags are applied starting from the bottom, then convert tags from the bottom, then add tags from the top.
Arguments: If APPLY_CREATURE_VARIATION in the creature raws sends in arguments, you can use them below as !ARG1, !ARG2, etc. The GAIT variations below have some examples. In the creature raws, if an argument is of the form "5|6", for example, it'll be converted to "5:6" in the creature variation, so you can handle variable-token arguments with the | character.
Conditional tags: Change TAG to CTAG and add, for example, CV_REMOVE_CTAG:1:YES:<regular stuff> to require !ARG1 to be YES to execute the changes.
||Adds a new token to the creature's variant.|
||Alias for CV_NEW_TAG.|
||Removes a token from the creature's variant.|
||As CV_NEW_TAG, but only activates if !ARG(num) is YES, e.g. CV_NEW_CTAG:1:YES:<regular stuff> to require !ARG1 to be YES to execute the changes.|
||Alias for CV_NEW_CTAG.|
||As CV_REMOVE_TAG with conditions as described above.|
|CV_CONVERT_TAG||Begins altering tokens within the creature's variant using the CVCT_MASTER, CVCT_TARGET, and CVCT_REPLACEMENT tokens below. If a variation template contains multiple CV_CONVERT_TAG blocks for the same CVCT_MASTER, the replacements will be applied in reverse order.|
||Specifies the token that will be modified.|
||Locates the specified parameter within the token specified by CVCT_MASTER.|
||Replaces the parameter specified by CVCT_TARGET within the token specified by CVCT_MASTER. If no replacement is specified, the target will simply be removed.|
|CV_CONVERT_CTAG||As CV_CONVERT_TAG with conditions.|