Creature variation token - Revision history

Zippy at 16:12, 2 April 2024

2024-04-02T16:12:02Z

OddballJoe: (awb), typos fixed: decribed → described

2023-01-28T21:31:34Z

(awb), typos fixed: decribed → described

Putnam3145: /* Arguments and conditional tokens */ what the heck is that

2023-01-13T19:01:15Z

Arguments and conditional tokens: what the heck is that

Voliol: put new example in its own section

2023-01-09T10:08:57Z

put new example in its own section

Silverwing235: /* Arguments and conditional tokens */ typos

2023-01-08T00:14:12Z

Arguments and conditional tokens: typos

Alpacalypse at 22:35, 7 January 2023

2023-01-07T22:35:36Z

Alpacalypse at 22:06, 7 January 2023

2023-01-07T22:06:47Z

Alpacalypse: Added a detailed example combining all the previous tokens an arguments, as well as a step-by-step explanation of how it works

2023-01-07T22:00:17Z

Added a detailed example combining all the previous tokens an arguments, as well as a step-by-step explanation of how it works

LethosorBot: Tagging v50 page (983/4888)

2022-12-21T00:25:19Z

Tagging v50 page (983/4888)

LethosorBot: LethosorBot moved page DF2014:Creature variation token to Creature variation token: Migrating v50 page (808/4618) (content)

2022-12-20T03:17:27Z

LethosorBot moved page DF2014:Creature variation token to Creature variation token: Migrating v50 page (808/4618) (content)

@@ Line 1: / Line 1: @@
-{{migrated article}}
+{{Quality|Exceptional}}
 {{av}}
 {{Modding}}

@@ Line 197: / Line 197: @@
           [APPLY_CREATURE_VARIATION:CREATURE_EDIT:X:CNAME:cow:bovine:super-cow:cowtastic:FC:7|0|1:MYEL]
-This will change the cow creature file so that the cows are now called "super-cows", which can be decribed as "cowtastic", are white colored and produce "super-cow's milk", and it will also change the color of the bulls to yellow.
+This will change the cow creature file so that the cows are now called "super-cows", which can be described as "cowtastic", are white colored and produce "super-cow's milk", and it will also change the color of the bulls to yellow.
 Here is a step-by-step explanation of what is happening in order of the arguments:

@@ Line 160: / Line 160: @@
 as the tokens added to the target creature.
-The conditional tags ({{token|CV_NEW_CTAG|cv}}/{{token|CV_ADD_CTAG|cv}}, {{token|CV_REMOVE_CTAG|cv}} and {{token|CV_CONVERT_CTAG|cv}}) are copies of CV_NEW_TAG/CV_ADD_TAG, CV_REMOVE_TAG and CV_CONVERT_TAG, except they only work if a numbered argument of APPLY_CREATURE_VARIATION has an arbitrary value. E.g. [CV_NEW_TOKEN:2:HUMANOID:CAN_SPEAK] will only add [CAN_SPEAK] if argument number two is "HUMANOID".
+The conditional tags ({{token|CV_NEW_CTAG|cv}}/{{token|CV_ADD_CTAG|cv}}, {{token|CV_REMOVE_CTAG|cv}} and {{token|CV_CONVERT_CTAG|cv}}) are copies of CV_NEW_TAG/CV_ADD_TAG, CV_REMOVE_TAG and CV_CONVERT_TAG, except they only work if a numbered argument of APPLY_CREATURE_VARIATION has an arbitrary value. E.g. [CV_ADD_CTAG:2:HUMANOID:CAN_SPEAK] will only add [CAN_SPEAK] if argument number two is "HUMANOID".
 <sup>1</sup>Functionally. Up to 65537=2<sup>16</sup>+1 arguments have been tested, with no problems other than a long load time.

@@ Line 162: / Line 162: @@
 The conditional tags ({{token|CV_NEW_CTAG|cv}}/{{token|CV_ADD_CTAG|cv}}, {{token|CV_REMOVE_CTAG|cv}} and {{token|CV_CONVERT_CTAG|cv}}) are copies of CV_NEW_TAG/CV_ADD_TAG, CV_REMOVE_TAG and CV_CONVERT_TAG, except they only work if a numbered argument of APPLY_CREATURE_VARIATION has an arbitrary value. E.g. [CV_NEW_TOKEN:2:HUMANOID:CAN_SPEAK] will only add [CAN_SPEAK] if argument number two is "HUMANOID".
 The following is an example of a creature variation, demonstrating most of the tokens and arguments mentioned above; with an explanation of how you would use it to change the properties of a cow.
@@ Line 205: / Line 208: @@
 * We need to choose three digits but they need to be separated by ":". Using this character here will move us onto the next argument, so we separate the digits with "|" instead choosing "7|0|1" (white), for a white cow (not necessarily represented by the graphics).
 * The next argument has multiple CTAGs numbered "9", but with different arguments. Either option will use [SELECT_CASTE:MALE] but we can choose between the argument MRED or MYEL. We have chosen MYEL which adds the tag [CASTE_COLOR:6:0:1] (yellow) for us, giving the male caste (in this case a bull) yellow as a caste color.
 ==See Also==

@@ Line 201: / Line 201: @@
 * "CNAME" does match the second CTAG so we are changing the name of a caste which matches arguments !ARG3 & !ARG4, as well as looking for specific liquids with state names that contain !ARG3 followed by the characters "'s milk".
 * Using arguments 3 & 4 we look for a caste name that matches "cow:cows:bovine" and any liquid name or adjective that matches "cow's milk".
-* The caste name and liquids do exitst so !ARG5 & !ARG6 now declare what we want to change these names to; in this case the caste name "super-cow:super-cows:cowtastic" and liquid name and adjective "super-cow's milk".
+* The caste name and liquids do exist, so !ARG5 & !ARG6 now declare what we want to change these names to; in this case the caste name "super-cow:super-cows:cowtastic" and liquid name and adjective "super-cow's milk".
 * Now we declare that we want CTAG argument 7 to match "FC" which means we will select the [FEMALE] caste and add a color to it which is decided by the next argument !ARG8.
-* We need to choose three digits but they need to be serperated by ":". Using this character here will move us onto the next argument, so we separate the digits with "|" instead choosing "7|0|1" (white), for a white cow (not necessarily represented by the graphics).
+* We need to choose three digits but they need to be separated by ":". Using this character here will move us onto the next argument, so we separate the digits with "|" instead choosing "7|0|1" (white), for a white cow (not necessarily represented by the graphics).
 * The next argument has multiple CTAGs numbered "9", but with different arguments. Either option will use [SELECT_CASTE:MALE] but we can choose between the argument MRED or MYEL. We have chosen MYEL which adds the tag [CASTE_COLOR:6:0:1] (yellow) for us, giving the male caste (in this case a bull) yellow as a caste color.

← Older revision		Revision as of 22:00, 7 January 2023
Line 161:		Line 161:

	The conditional tags ({{token\|CV_NEW_CTAG\|cv}}/{{token\|CV_ADD_CTAG\|cv}}, {{token\|CV_REMOVE_CTAG\|cv}} and {{token\|CV_CONVERT_CTAG\|cv}}) are copies of CV_NEW_TAG/CV_ADD_TAG, CV_REMOVE_TAG and CV_CONVERT_TAG, except they only work if a numbered argument of APPLY_CREATURE_VARIATION has an arbitrary value. E.g. [CV_NEW_TOKEN:2:HUMANOID:CAN_SPEAK] will only add [CAN_SPEAK] if argument number two is "HUMANOID".		The conditional tags ({{token\|CV_NEW_CTAG\|cv}}/{{token\|CV_ADD_CTAG\|cv}}, {{token\|CV_REMOVE_CTAG\|cv}} and {{token\|CV_CONVERT_CTAG\|cv}}) are copies of CV_NEW_TAG/CV_ADD_TAG, CV_REMOVE_TAG and CV_CONVERT_TAG, except they only work if a numbered argument of APPLY_CREATURE_VARIATION has an arbitrary value. E.g. [CV_NEW_TOKEN:2:HUMANOID:CAN_SPEAK] will only add [CAN_SPEAK] if argument number two is "HUMANOID".
		+
		+
		+	The following is an example of a creature variation, demonstrating most of the tokens and arguments mentioned above; with an explanation of how you would use it to change the properties of a cow.
		+
		+	[CREATURE_VARIATION:CREATURE_EDIT]
		+	[CV_CONVERT_CTAG:1:NAME]
		+	[CVCT_MASTER:NAME]
		+	[CVCT_TARGET:!ARG3:!ARG3s:!ARG4]
		+	[CVCT_REPLACEMENT:!ARG5:!ARG5s:!ARG6]
		+	[CV_CONVERT_CTAG:2:CNAME]
		+	[CVCT_MASTER:CASTE_NAME]
		+	[CVCT_TARGET:!ARG3:!ARG3s:!ARG4]
		+	[CVCT_REPLACEMENT:!ARG5:!ARG5s:!ARG6]
		+	[CV_NEW_CTAG:7:FC:SELECT_CASTE:FEMALE]
		+	[CV_NEW_CTAG:7:FC:COLOR:!ARG8]
		+	[CV_CONVERT_TAG]
		+	[CVCT_MASTER:STATE_NAME:LIQUID]
		+	[CVCT_TARGET:!ARG3's milk]
		+	[CVCT_REPLACEMENT:!ARG5's milk]
		+	[CV_CONVERT_TAG]
		+	[CVCT_MASTER:STATE_ADJ:LIQUID]
		+	[CVCT_TARGET:!ARG3's milk]
		+	[CVCT_REPLACEMENT:!ARG5's milk]
		+	[CV_NEW_CTAG:9:MRED:SELECT_CASTE:MALE]
		+	[CV_NEW_CTAG:9:MREL:CASTE_COLOR:4:0:0]
		+	[CV_NEW_CTAG:9:MYEL:SELECT_CASTE:MALE]
		+	[CV_NEW_CTAG:9:MYEL:CASTE_COLOR:6:0:1]
		+
		+	We add the following to a creature file.
		+
		+	[SELECT_CREATURE:COW]
		+	[APPLY_CREATURE_VARIATION:CREATURE_EDIT:X:CNAME:cow:bovine:super-cow:cowtastic:FC:7\|0\|1:MYEL]
		+
		+	This will change the cow creature file so that the cows are now called "super-cows", which can be decribed as "cowtastic", are white colored and produce "super-cow's milk", and it will also change the color of the bulls to yellow.
		+
		+	Here is a step-by-step explanation of what is happening in order of the arguments:
		+
		+	* "X" doesn't match the first CTAG argument of "NAME", so we have decided not to change the overall name of the creature.
		+	* "CNAME" does match the second CTAG so we are changing the name of a caste which matches arguments !ARG3 & !ARG4, as well as looking for specific liquids with state names that contain !ARG3 followed by the characters "'s milk".
		+	* Using arguments 3 & 4 we look for a caste name that matches "cow:cows:bovine" and any liquid name or adjective that matches "cow's milk".
		+	* The caste name and liquids do exitst so !ARG5 & !ARG 6 now declare what we want to change these names to; in this case the caste name "super-cow:super-cows:cowtastic" and liquid name and adjective "super-cow's milk".
		+	* Now we declare that we want CTAG argument 7 to match "FC" which means we will select the [FEMALE] caste and add a color to it which is decided by the next argument !ARG8.
		+	* We need to choose three digits but they need to be serperated by ":". Using this character here will move us onto the next argument, so we separate the digits with "\|" instead choosing "7\|0\|1" (white), for a white cow (not necessarily represented by the graphics).
		+	* This argument has multiple ctags numbered "9", but with different arguments. Either option will use [SELECT_CASTE:MALE] but we can choose between the argument MRED or MYEL. We have chosen MYEL which adds the tag [CASTE_COLOR:6:0:1] (yellow) for us, giving the male caste (in this case a bull) yellow as a caste color.

	<sup>1</sup>Functionally. Up to 65537=2<sup>16</sup>+1 arguments have been tested, with no problems other than a long load time.		<sup>1</sup>Functionally. Up to 65537=2<sup>16</sup>+1 arguments have been tested, with no problems other than a long load time.