Editing User:JT/Token Wishlist

==Creature Tokens==

===Reproductive Tokens===

=====''[OFFSPRING:mateid:offspringid:min:max:gestation:weighting]''=====

: '''Arguments:'''
:* ''mateid'': The creature ID of the species with which this being can reproduce.
:* ''offspringid'': The creature ID of the species which is produced by a successful mating with the above creature ID, or NOTHING to denote that there is a possibility/potential desire to be mated with by the given creature type but no chance of conception.
:* ''min'': The minimum size of the litter of OFFSPRING.
:* ''max'': The maximum size of the litter of OFFSPRING.
:* ''gestation'': The number of days of gestation.  Gestation period is calculated from this number &plusmn;5%.
:* ''weighting'': In the event of more than one OFFSPRING tag for a given mate type, the weighting determines the odds that a particular offspring is produced.

: Allows a ''female'' member of the species to be impregnated by a ''male'' member of the given mate type.  This tag allows for complex intraspecies and interspecies reproductive capability, vastly expanding the existing functionality for creature breeding in the game.

: In all cases, the OFFSPRING tag applies to the ''female'' of the species, for object-orientedness.  That is, a female of a species specifies which creature types can impregnate it.  If the species has no gender, it is assumed that the entire species is "female" for purposes of this token.

: If no OFFSPRING tag is found for a species it is assumed to have the "implicit tag" [OFFSPRING:owntype:owntype:1:1:270:1], meaning that the species can reproduce with other members of its own species.  The various existing tags (LITTERSIZE, MULTIPLE_LITTER_RARE, etc.) all serve to modify the implicit tag, but have no effect if the creature defines any explicit OFFSPRING tags.  The implicit tag does not appear for any species with the NOGENDER or NOREPRODUCTION tags; if you wish for a non-gendered species to reproduce you must specifically provide OFFSPRING tags to that effect.  ''N.b.'', a creature with explicit tags which do not include its own creature ID will be incapable of reproduction with its own species; this allows folklore versions of nymphs which can reproduce successfully only with human males, for instance.

: If an OFFSPRING tag exists, but the creature is also IMPOTENT towards that creature type, then the creature has no interest and any reproduction would have to be forced.  See IMPOTENT tag for further detail.

: ''Examples:''
: (Mermaid)
:: [OFFSPRING:MERMAN:MERMAID:1:1:270:5]
:: [OFFSPRING:MERMAN:MERMAN:1:1:270:1]
:: The above tags, applied to the CREATURE:MERMAID, give the MERMAID the ability to reproduce with a CREATURE:MERMAN.  The mermaid will have a 1 in 6 chance of producing a merman, and a 5 in 6 chance of producing a mermaid.

: (Horse)
:: [OFFSPRING:HORSE:HORSE:1:1:340:5]
:: [OFFSPRING:DONKEY:MULE:1:1:340:1]
:: [OFFSPRING:MULE:NOTHING:0:0:0:1]
:: The above tags, applied to the CREATURE:HORSE, allow the female horse to reproduce with a male horse to produce a foal of either gender (the CREATURE:HORSE has no [MALE] or [FEMALE] tag and thus has gender randomly assigned when it is birthed).  The horse can also be impregnated by a male CREATURE:DONKEY and will produce mules.  Finally, the mare is willing to engage in reproductive behaviour with a CREATURE:MULE, but conception is impossible (the rare instances of fertile mules are ignored for purposes of gameplay).  The mare will prefer to mate with stallions; if there is one stallion and one male donkey available, the mare will mate with the stallion 83% of the time if it can&mdash;if an animal caretaker wishes to produce mules, the animal caretaker would have to husband the mare and the donkey specifically in some fashion.

: (Human)
:: [OFFSPRING:HUMAN:HUMAN:1:1:270:98]
:: [OFFSPRING:HUMAN:HUMAN:2:2:270:2]
:: [OFFSPRING:ORC:HALFORC:1:1:270:1]
:: Humans will give birth to a single child most of the time.  Approximately 2% of the time, a human mother will give birth to twins.  Human females can also be impregnated by male orcs, who will cause the human female to produce half-orc offspring of random gender.  See also IMPOTENT tag for unwillingness to mate, however.

=====''[MALEOFFSPRING:mateid:offspringid:min:max:gestation:weighting]''=====

: '''Arguments:''' as per OFFSPRING tag

: The MALEOFFSPRING tag is a variant of the OFFSPRING tag which allows a ''male'' member of the species to be impregnated by ''any'' gender of the specified ''mateid'' creature type.  If there is a reciprocal case of OFFSPRING and MALEOFFSPRING tags, denoting that either of the partners can be impregnated by the other, then the impregnated partner is chosen randomly.

: This tag is used extremely rarely and is intended for cases where a male host can be impregnated in some fashion by another lifeform.  It is chiefly useful for hermaphroditic species (species with male and female genitals) which are still somewhat identifiable as either male or female.

=====''[FEMALEOFFSPRING:mateid:offspringid:min:max:gestation:weighting]''=====

: '''Arguments:''' as per OFFSPRING tag

: The FEMALEOFFSPRING tag is another variant which allows a ''female'' member of the species to be impregnated by ''any'' gender of the specified ''mateid'' creature type.  This allows for females to be impregnated by "females" of the other creature type, which is not otherwise possible with the MALEOFFSPRING or OFFSPRING tags.

=====''[GESTATION:gestation]''=====

: '''Arguments:'''
:* ''gestation'': The number of days of gestation, as per the OFFSPRING tag.

: Affects the "default" gestation of the creature for the purposes of its implicit OFFSPRING tag if the creature does not explicitly define one.

=====''[IMPOTENT_ALL]'' / ''[IMPOTENT:creaturetype]''=====

: '''Arguments:'''
:* ''creaturetype'': The type of creature with which this creature has no urge to mate.

: The creature has no urge to mate.  It is still fertile, given an OFFSPRING tag (or the implicit OFFSPRING tag), and can thus be impregnated; however, males are impotent and females are unwilling, meaning that the creature does not represent a successful species.

: If it is possible to be fertilised by another species which ''does'' have the urge to mate, via an OFFSPRING tag, then it can still reproduce if a member of the other species presents itself.  In other words, if one creature type has IMPOTENT towards a second creature type, but the second creature type does not circularly have IMPOTENT towards the first, then the second creature type is still interested in mating with the first creature type.

: To Toady: The latter possibility would represent forced reproduction, which may be contrary to your moral integrity and may thus (at your option) remain unimplemented (rendering the existence of this tag moot); in such a case, an IMPOTENT tag in either direction would represent impossibility of reproduction or copulation (as opposed to OFFSPRING:PARTNER:NOTHING which represents willingness to mate, including the happy thoughts acquired from engaging in the reproductive act, but no successful offspring).

: ''Example:''
: (Human)
:: [IMPOTENT:ORC]
:: Human males are not interested in impregnating orc females, regardless of the possibility to do so, nor are human females interested in being impregnated by orc males.

=====''[NOREPRODUCTION]''=====

: Implies IMPOTENT_ALL and eliminates the implicit OFFSPRING tag.

: Effectively, this means that the creature will be completely unwilling to mate and completely unable to produce offspring if it does.  If the creature includes any user-defined OFFSPRING or MALEOFFSPRING tags, the creature may still be impregnated by those means; however, it will not wittingly do so.

=====''[NOGENDER]''=====

: (Existing tag NO_GENDER revised to NOGENDER to be consistent, with clarifications as follows) The species has a "neuter" gender.  This eliminates the implicit OFFSPRING tag, to allow for the existence of magical constructs and sterile breeds.  The user may still add an OFFSPRING tag manually to allow the creature to reproduce (or desire to reproduce) in a sexual fashion.

=====''[BOTH_IMPREGNATED]''=====

: If there exists a circular OFFSPRING/MALEOFFSPRING/FEMALEOFFSPRING link between the two partners engaged in a reproductive act&mdash;for instance if the male can be impregnated by the female and the female can be impregnated by the male&mdash;then both partners will become impregnated after the act given this tag.

: With this tag:
:* In a heterosexual encounter with circular fertility, both will be impregnated.
:* In a homosexual encounter with circular fertility, both will be impregnated.
:* If only one partner may become impregnated, only that partner becomes impregnated.
:* If neither partner may become impregnated, then that remains true.

:Without this tag:
:* In a heterosexual encounter with circular fertility, the female will be impregnated.
:* In a homosexual encounter with circular fertility, the impregnated partner is selected randomly.
:* If only one partner may become impregnated, that partner becomes impregnated.
:* If neither partner may become impregnated, then that remains true.

=====''[OVIPAROUS:gestation]''=====

: '''Arguments:'''
:* ''gestation'': The number of days that the eggs remain inside the parent before being laid to complete the remainder of their gestation time from the OFFSPRING tag.

: The creature does not produce live offspring (as a mammal does), but rather lays eggs a short while after impregnation.  Once laid, these eggs grow and hatch without the mother's intervention, although depending on the climate they may need to be kept warm or cool in some fashion.  Further tags may be needed to represent the species' nesting behaviour (e.g., turtles burying their eggs, birds sitting on their eggs, etc.).

=====''[EXTERNAL_FERTILIZE]''=====

: A modifier tag for OVIPAROUS, this indicates that the creature lays eggs without having sexual intercourse; the male of the species fertilises the eggs externally (such as in the case of a spawning salmon) at or before the ''gestation'' time of the OVIPAROUS tag.  If the eggs are not fertilised before the ''gestation'' given in OVIPAROUS, they shrivel or rot (depending on whether they are soft eggs or hard eggs).

=====''[HARD_EGGS:armour]''=====

: '''Arguments:'''
:* ''armour'': The natural DAMBLOCK rating of the eggs produced by this creature.

: The eggs of this creature are hard-shelled as opposed to soft-shelled.

=====''[EGGEXTRACT_*]''=====

: The eggs of the creature can be prepared as an extract or consumed directly to be used as an extract of the appropriate type.  For instance, [EGGEXTRACT_PARALYZE] would cause paralysis in any species that consumed the egg, and the eggs could also be crushed and applied to arrows to allow them to be used as paralysis arrows.

=====''[EGG_SPECHEAT]'' / ''[EGG_LAYERING]'' / ''[EGG_BOILING_POINT]'' / etc.=====

: The temperature flags as they apply to the eggs.  Note that once the eggs die, they do not develop further, but depending on circumstance they might not rot (e.g., if collected as food and stored in a food stockpile).

=====''[OVIPOSITOR]''=====

: The species injects its eggs into the eggs' nest (whether that "nest" is a womb, its partner, or an unwilling host), effectively meaning that the female impregnates the male instead of vice-versa.  This applies only to seahorses in the case of non-PARASITE_EGG and non-SAPOTROPH_EGG reproduction and is thus not a very critical feature.

=====''[PARASITE_EGG]''=====

: The species lays its eggs inside the living body of another creature, which carries the eggs to term.  The eggs then hatch and the baby attacks the other creature from the inside in order to get out.  Contrary to what you might expect, this isn't meant to imply the ''Alien'' style of breeding, but rather the form of breeding exhibited by some forms of wasps.  Imagine the horror of being stung by a giant wasp with a paralytic stinger, who then injects her eggs into your body until they hatch and eat their way out!  Implies OVIPOSITOR.

=====''[SAPOTROPH_EGG]''=====

: The species lays its eggs inside the corpse of another creature, which carries the eggs to term.  The eggs then hatch and the baby emerges from the corpse.  Implies OVIPOSITOR.

=====''[PREGNANT_PERMANENT]''=====

: Once impregnated by a given other creature, the creature is thereafter permanently impregnated by that creature and will continuously produce offspring from that genetic material after each successive delivery.  If another partner impregnates it, it will then continously produce offspring from its new partner (the new partner having effectively replaced the genetic material from the first partner with its own).  Unless genetic traits from specific parents are introduced, the new partner must be of a different creature type for this replacement to have any effect.

: This method of reproduction is most often seen in queen ants and queen bees of the insect order of hymenoptera.  The queen maintains as much of her mate's DNA as required to fertilize her own offspring once the male has impregnated her during her mating flight.

: You could assign this variable to rats, since rats are born pregnant.  (Yes, that's a joke.)

=====''[INVOLUNTARY_EGGS]''=====

: If an OVIPAROUS creature has this tag, it is not allowed to choose whether or not to lay eggs; it must lay eggs at every reproductive cycle, even if they are not fertilized.

: If the creature lays an egg uselessly, it will receive a bad thought (if it lays an egg usefully, it will receive a good thought).  Good living conditions can make up for the bad thoughts from failing to reproduce.

: An unfertilised egg will remain intact once laid, but can rot naturally just like any other food item left to its own devices.

=====''[ASEXUAL:offspringid:min:max:gestation:weighting]''=====

: The creature reproduces asexually and does not need another creature to fertilise it or otherwise provide genetic material.

===General Tokens===

=====''[INNATESKILL:skillid:level]''=====

: '''Arguments:'''
:* ''skillid'': The skill possessed.
:* ''level'': The level of the skill.

: This adjustment to the INNATESWIM skill would allow creatures always to possess a minimum level of a given skill.

: ''Example:''
: (Kobold)
:: [INNATESKILL:AMBUSHER:2]
:: Kobolds are natural at sneaking.  Each one is an "Ambusher" (as opposed to "Novice Ambusher" at rank 1 or "Dabbling Ambusher" at rank 0).

===Examples===

* To allow females to be impregnated only by males, use OFFSPRING.
* To allow males to be impregnated by males or females or neuters, use MALEOFFSPRING.
* To allow males to be impregnated only by females, use OFFSPRING, and use OVIPOSITOR on both the male and female -- the male fertilizes the female's eggs, then the female inserts those eggs into the male's womb (implied via OVIPOSITOR).
* To allow females to be impregnated by males or females or neuters, use FEMALEOFFSPRING.
* To allow neuter-gendered beings to reproduce, use OFFSPRING.
* There is, at this time, no syntax for allowing a male to be impregnated only by a male.
* To make a hen which lays eggs regardless of whether it has been impregnated by a rooster, use [OVIPAROUS][INVOLUNTARY_EGGS].  If it lays eggs which have not been fertilized, the eggs are worthless (from a reproductive standpoint) and will rot.  They can be eaten as food.
* To make a [http://insects.tamu.edu/fieldguide/cimg329.html parasitic wasp]-like creature which lays eggs inside other creatures at will, use [OVIPAROUS][PARASITE_EGG].
* If you want the above-mentioned parasitic wasp to squirt out its egg if it cannot do so inside another creature (due to lack of supply of other creatures), also include [INVOLUNTARY_EGGS] and the wasp will occasionally lay an egg (to die) in the open.  This will piss it off, and you don't want to piss off a wasp.