Dwarf Fortress Wiki - User contributions [en]

Main Page/Quote/list

2016-01-02T07:01:59Z

JT:

<noinclude>
To add a quote to this list, place it on its own line above the last line.
#{{#rreplace:</noinclude>
I can't put my finger on it. Something about this [[Fire|‼]]Cat tallow roast[[Fire|‼]] tastes funny.
Toady withdraws from society. Toady has begun a [[Strange mood|mysterious]] [[Dwarf Fortress|construction]]!
Let us never forget the last words of Inod the Stoker, [http://archive.dwarffortresswiki.net/index.php/Fortress_Paintrag#1056 "Aaah! Gorillas!"]
[[Children|Newborn]] Zuglar Baldnessgranite prefers to consume Gorilla. A sure sign of his unparalleled strength!
[http://www.somethingawful.com/d/video-game-article/duke-nukem-image.php In an unrelated article] - I had no idea elephants could bounce that high!
[[Toady]] looses a roaring laughter, [[Fey|fell]] and terrible! Toady has butchered a spammer!
The critical question is this: do elf bones yield more crossbow bolts than the average number of bolts necessary to kill an elf?
"Dwarf Fortress" ... "Like chess, only with short people that can catch on [[fire]] like [[clothing|rags]] soaked in tar, and lots of [[booze]]." ... "Like chess."
Dwarf Fortress has taught me that all the world's problems would be substantially reduced had our parent civilizations never minted more than four stacks of [[coins]].
[[Booze]] does all the work in forts. Dwarves are just booze exoskeletons.
My unconscious and bleeding [[mayor]] just mandated the construction of some goods.
I can just imagine a [[wagon]] throwing a tantrum and tossing all its contents at people.
Döbesh Udosdeb has been ecstatic lately. He was forced to eat a friend to survive. He enjoyed a truly decadent meal.
Iron [[screw pump]] exercise equipment. Pump iron and get superdwarvenly strong!
The violence, aggression, pain, madness, sadness of the ASCII characters never ceases to amaze me...
Wait, you're MAKING animals?<br>—''Torak''<br>At this moment, yes, I am smelting cows.<br>—''Spiders Everywhere''
"Didn't you read the manual? He he he he... the manual... ..."<br>--[[Toady One]]
(Compared to real-world years) Dwarven years are shorter.<br>--Sowelu<br>Very fitting to dwarves, I must add.<br>--Sean Mirrsen
[[Magma]] is not a [[water]] source. Dwarves can't drink it or supply it to their wounded.<br>--[[User:AlienChickenPie|AlienChickenPie]]
"[B]oats are the enemy of tiles. And tiles are the enemy of boats."<br>--[[Toady One]]
"I went through and fixed a few places where forbidden/on fire weren't being respected for next time. Burning milkable creatures were still a problem for example."<br>--[[Toady One]]
"You have been processed! Go forth, now, and edit!"<br>--[[User:Savok|Savok]]
"What happened in 1048?" "Jreengus occurred."
Making rock instruments isn't nearly as awesome as it sounds --Shandrunn
The cyclops I was quested to kill had a thousand year history of badassery, and all of that without the leg it lost in the Year 3 (a dwarf bit it off... I should probably deal with that). --[[Toady One]]
[FIREIMMUNE] makes them think that [[magma]] is safe but doesn't actually make them fireproof. This can lead to some rather interesting results.
Endok Cerolneth has begun a mysterious construction!<br>Endok Cerolneth, Planter has given birth to a girl.
"Incendia sunt socia vestra, armaque vestra, fortesque Montis Domi." "Magma is your ally, your weapon, the strength of the Mountain-Home." --Eita
"Stopped people from giving quests to kill themselves." --[[Toady One]]
"...And I simply doubt we have a need for 7 fishery workers. On top of that, a second soap maker. The hell IS soap?!" --Zero
"This is a terrible pun. All craftsdwarfship is of the poorest quality." - [http://www.bay12forums.com/smf/index.php?topic=21449.msg239558#msg239558 Soup_alex]
"The default mental state of a dwarf is madness. Sanity is a temporary condition - a PRIVILEGE you have to EARN!" --[[User:Fedor|Fedor]]
"Why get normal cats? I buy lolcats in the embark screen. Much more fun to engrave about them." --Yanlin
"Dwarf Fortress taught me it was okay to make a suit out of my neighbour's skin, as long as I gave it a name."
"Got rid of world gen crash during succession after death of prolific long-standing position holders with inbred descendants" --[[Toady One]]
"There was a typo in the siegers' campfire code. When the fires went out, so did the game." --[[Toady One]]
"Hey, what does that flashing red and orange text mean? What? Why is there smoke everywhere? Oh god, are those BABIES on fire?" --[[User:StrawberryBunny|StrawberryBunny]]
"It's never 'just a game' when you're losing."<br>--George Carlin (if he played Dwarf Fortress)
Not that building a bridge out of soap makes much sense to begin with anyway.
Note that while you cannot milk larger animals yourself, civilizations can still milk animals "off screen" for your benefit.
Tosid Idenarzes likes tentacle demons for their corrupt intentions. "There! Now we've covered all of the seven deadly sins."
"Litast Idenudesh, baby, is throwing a tantrum! Inod Litastrilem, Mayor, has lost consciousness. Inod Litastrilem, Mayor, has bled to death."
Bug 000780 [adventure mode][crime] - town guard becomes a criminal after getting an adventurer's stolen weapon stuck in his body
"Udib Toblumaid, Axedwarf, cancels sparring in Barracks: too insane." [[User:Ben jamm1n|Ben jamm1n]]
Kosoth Cilobonol, Bone Carver cancels Drink: Unconscious.
Sizir the Snail of Bait is a deity of The Fresh Towers. Sizir most often takes the form of a female dwarf and is associated with jealousy.
Sibrek Tanbim likes Limestone, Tin, Smoky Quartz, the color crimson, bolts, scepters, anvils, and rock blocks for their lack of quality levels.
There are 5 articles in category Lore: [[Armok]], [[Cave Adaptation]], [[Elephant]], [[Philosopher]], and [[Vomit]].
There is nothing to catch in the magma pipe.
Bug 000563 [dwarf mode][justice] - mayor ordered himself beaten for failing to make crystal glass objects
If cow cheese is made from cow's milk, what is dwarven cheese made of?
Bugs are opportunities to cause unprecedented amounts of destruction. --Zorgn
"You know, Urist, you've got a mind like an +Ash Trap+."--[[User:Destor|Destor]]
'''Zander J:''' "Is there a way to stop immigration without setting the population cap?"<br>'''Yanlin:''' "Magma."
An animal trainer just suddenly stopped working and hid himself in a workshop. He's probably going to make a wardog out of rock and goblin skulls.
Bug 000597 [creatures] - flying creatures give birth in midair, leading to tragedy.
'''Urdim Kutamèrith, Pump Operator, has created Rakusttenshed, a Glumprong blowgun!''' <br> Urdim, you are a freaking idiot.
<Forkez> I don't get the game, but I do get that tunnels flooded with water is a bad thing.
"If you give a dwarf a fire, he will be warm for a night. If you set a dwarf on fire, he will be warm for the rest of his life."
"Since the Elves said they won't let me cut down any trees, I bought 50 of their logs instead."
Do not make a trading race that breathes fire.<br/><br/>I REPEAT, DON'T!! EVER!!
Dwarf Fortress: Because burning elves are funny.
The carp has drowned.
There's one thing a dwarf needs, and that's stones. And alcohol... and magma... but mainly stones.
"I swear to god once I saw a dwarf who was labeled as being Strong, Very Agile, Very Tough... and ''Clean''. But it was probably just a bad dream."
Urist McRandy has been ecstatic lately. He brought somebody to bed lately.
"Dwarven children kidnapped and incorporated into goblin society might sh... shave."<br> --Toady One
Bug 000871 [projectiles] - babies fall to death when born on stairs
Bug 001031 [adventure mode][inventory] - a merchant pack animal caught at an old dwarf site during adv mode was wearing a full set of clothes
"[[Magma]] solves everything. [[Fire]] just ruins the [[booze]]." -sonerohi
You can't yet strangle people with the exposed guts, though I suppose that's now within reach. --[[Toady One]]
Look, there are roving clumps of sentient lava outside, ... This isn't going to get better. --PTTG??
...and the only surviving dwarf is a noble who has mandated the construction of crowns and clear glass items to the empty halls. --PTTG??
Adil Idenlocun is conflicted: "When possible he prefers to consume purring maggot, Dwarven ale and Dwarven syrup. He absolutely detests purring maggots."
"I had to leave just before I tested the dwarf with the boiling gold blood." -- Toady the Great One
Urdim Zatinod has been quite content lately. She has lost an annoying friend to tragedy lately.
I added two levers. One opens the magma. The other sets free all the cats. --Someone in Headshoots
"As Manbaspecut, Human Merchant is stricken by melancholy!" "Muskox has gone stark raving mad!" I think something is wrong with the human caravan...
"Somebody needs to build an active volcano inside a fortress inside an active volcano." --Boksi
It has stats. It can be killed.
Bug 000432 [dwarf mode][items] - Bones pop out of coffins.
Thanks. I wish I had known that about three forts ago.
If I ''remembered'' what the damn lever did, I'd ''pull'' it! <...pulls lever anyway...>
Sarvesh Ralrubal likes olivine, olivine and olivine.
"So let me get this straight. We managed to destroy a dwarven civilization while only managing a single town??"
Kara Mase, the Glory of Amusing: Engraved on the wall is an image of a dwarf and an elf. The dwarf is committing a depraved act on the elf.
Once saw a water skin with red beryl spikes. I still wonder how you would drink from that.
Watching a kobold thief be chased by batman is very satisfying.
Kol Tölunimush has been ecstatic lately. He killed somebody by accident while sparring recently. He took joy in slaughter lately. He has lost a lover to tragedy lately. He has witnessed death. He had a satisfying sparring session recently.
There was kind of a violent explosion of boiling human blood when I was testing a human vs a magma man in the arena... it was a little weird, but I guess that's okay. --[[Toady One]]
Mew? <br />Chop!
"If Dwarf Fortress geology is to be believed, then the Earth's core is made of microcline and demons."
'They're firing arrows at us! Quickly! Raise the babies!!' -Urdim McSquadLeader, mother of 8
It started raining, then all my dwarves outside started bleeding to death. On inspection their upper bodies were missing.
It seems that a fresh recruit given a crossbow and a quiver with ammo in it will opt to run up to the enemy and bash them with the crossbow.
Bug introduced in the latest version: Firemen can have their flames severed. These flames then just lie around the place.
You stab Iron Man in the right leg from behind with your adamantine short sword, breaking away a piece of the gas and shattering the iron!<br>The Beak Dog is caught in a burst of Iron Man gas!<br>Beak Dog vomits into the Iron Man gas.
Urist McDairy, Milker cancels store item in stockpile: handling dangerous creature
Ildomushat, Fish Cleaner, cancels Clean Self: Could not find path.
Losing is [[Fun]]!!!<br>--The Motto of Dwarf Fortress
I hate walking under dwarven archways. You never know how many mechanized crossbows they have hidden underneath those damn things.
"Bibo ergo sum. I drink, therefore I am."<br />-- Dwarven Philosopher
This is a menacing iron spike. This object menaces with spikes of iron.
Kogsak is a deity of The Helpful Diamond. Kogsak most often takes the form of a dwarf and is associated with fortresses.
The Forgotten Beast pushes The Wrestler in the head, bruising the muscle, driving the skull through the brain, and tearing apart the brain! The Wrestler has been struck down!
Goblin Chops at the Diagnostician in the right leg, damaging the muscle! Urist McHouse is Unconscious!
Limul Itebdesis, trader has been Possessed. Limul Itebdesis, trader has created Stodir Isethlolor, a Mortgage-Backed Security!
The heart wound ended up being a guy getting shot in the arm, dropping his crossbow, running over to the opposing line, and jabbing his stack of bolts into somebody's chest.
Giant mole has stolen a preserved prepared giant mole lung!<br>''"Hey, I want my grandfather back!"''
"You must construct additional barrels!" - [[User:Speed112]]
All I want is a major river next to a volcano with flux, sand and bituminous coal.
Do not taunt magma.
I bury my pets in gold coffins and my nobles in wood coffins. Pets before people, I say.--[[KingAuggie]]
[the cavern] is basically like the surface, except underground
The fortress' randomly generated name was "Greatestfailure".
"You stab the Human Thresher in the mouth with your large copper dagger, tearing the left cheek!" "The large copper dagger has lodged firmly in the wound!"
"The best way to determine how dangerous a fortress is, is to make only one dwarf with the burial job, and nothing else: the lower his social skills, the more dangerous the fortress is - [[User:Rhenaya|Rhenaya]]"
"Before retiring in the evening, heed my words and give yourself to volcanos" - Ted Usmokatra, law-giver
Upon coming of age, about 8, Urist McYoung Made an artifact, became mayor and promptly mandated the construction of slade goods.
Dwarf Fortress: You've already lost.
A sober fortress makes even a mental hospital seem like a pleasant place to live.
A typical Dwarven nightmare consists of running out of booze or getting a beard lopped off in an accident.
There are two ways of dealing with goblins in a tree. One is by marksdwarves. The other is by flooding the world with magma.
Portal and Dwarf Fortress share a mystical trend. It is !!Science!!.
The were-capybara is only one of the myriad lunatic monsters that terrorize the living. -- Threetoe
The only time I ever saw the stupid thing fly, was to cross the aqueduct, to the beer hall. -- Fredd
(On artifacts) I got a flint door, called The Noiseless Odors. -- Nyxalinth
So apparently she became queen before becoming a twilight freak wife. Fascinating. -- Samuel
The zombies in a necromancer's tower became suspicious after the necromancer failed to age -- Toady One
Got a few barrels of beetle ichor and duck blood, gave some pig cheese in exchange. Made a present of three coffins to the queen.
I'd have to look back to see if it wants the physical or metaphysical id on the corpse. -- Toady One
The Sasquatch corpse has lodged firmly in the wound! The goblin has been struck down!
[22:57:46] <Dik_> How do I wash myself up from blood?<br>[23:06:20] <Dik_> How the fuck do I get out of the river?
No, you're not getting that leg back. In fact, that creature over there is going to pick your leg up and beat you to death with it. You won't respawn.
My refuse pile just woke up and ate my dwarves, who in turn got up themselves and started eating the other dwarves.
{{bugl|2264|cat=nocat}} - Adv. Mode travel (near oceans) teleports player underground and turns them into an underground creature
{{bugl|5921|cat=nocat}} - Biting dwarves in minecarts infinitely increases combat range
Fort flooded. So that's what an aquifer is. -- Exelixi
Axedwarf looks surprised by the ferocity of Spearmasters onslaught. Spearmaster charges at Axedwarf. Spearmaster stabs axedwarf in the left eye with his +Adamantine spear+, lightly tapping the target.
In 4, the Castle of Fortune of the Tombs of Gold constructed the Hell of Taxing in Entrancedcrafts.
I also got started on jumping. My first jump was off by a factor of 100, so I flew against a cliff and blew apart. I'm still working on it. -- Toady One
Mukca: Seek this place and kill Cenäth Certaindrives the giant.<br>Knowing no mercy, Cenäth stole Fisher berry wine!
We shall build a tower so tall, we will mine the very stars themselves!
Ingish Såkzulbomrek, Miner cancels Report Crime: Dangerous terrain.
You have struck limonite! Oddom Nishdanman, Furnace Operator cancels Smelt Limonite Ore: needs limonite.
{{bugl|4753|cat=nocat}} [Creatures]: Rodent men have no skin
{{bugl|0040|cat=nocat}} [Dwarf Mode -- Jobs, Items]: "Dwarf cancels Make Cloth Item: Needs 10000 plant cloth"
{{bugl|5531|cat=nocat}} [Creatures]: Legless animal men can kick
{{bugl|1588|cat=nocat}} [Creatures]: Creature with 1 eye and 2 eyelids
"This is my reward for not letting us all die. I have to deal with the Nobility."<br />-- Captain Ironblood, the mayor of Nist Akath
The king of my dwarves appointed a visiting merchant's yak as the general of the army while I was trading. -- [[Toady One]]
I'd like to think they bonded over their sinister ancestors (or the strange childhood coincidence of having younger siblings gobbled up by different werebuffalo in the same year).
They just walk around without a head until they realize that they should suffocate. -- Urist Da Vinci
Most of yesterday I spent trying to be robbed by bandits, but they kept looking away from me and forgetting I was there. -- [[Toady One]]
Today's success was to have a crying mother spit on me and call me a murderer. -- [[Toady One]]
You monster! Killing too many children at once will make everyone sad. You need to kill them slowly so nobody notices.
Dwarven... "Child Care": It's like regular childcare, except with more dogs, and less care.
You: How have things been? Tulon Tunlikot, Mayor: Well, let's see... we've got the army on the march, beasts, bandits and bone-chilling horror.
{{bugl|6722|cat=nocat}}: Manager climbs a tree instead of going to office when management jobs are assigned
{{bugl|5971|cat=nocat}}: Fat dwarves eating causes lag
{{bugl|6817|cat=nocat}}: "Behold, mortal. I am a diving being."
It was inevitable.
Weresquirrel Ceru Uzushimdo has come! A large Squirrel twisted into humanoid form. It is crazed for blood and flesh. Its eyes glow orange. Its sandy taupe hair is very curly. Now you will know why you fear the night.
I don't think the Elves in my DF game are too happy... I've modded them so that their body temperature causes nearby trees to burst into flames. --Evil One
Dwarf Fortress: Teaching methods of genocide against merpeople because their bones are worth 6000{{db}}.
No one has gone missing or died. The year is still young.
From release notes 0.40.11: Stopped overuse of plant structure tag causing people to say they preferred to eat trees
Stopped dwarves from trying to clean their own missing or internal body parts. --[[Toady One]]
The game actually has a first-person message about being scuttled, just in case you should happen to be playing as a wagon. --Halfling
Engraved on the wall is a well-designed image of a dwarf and hamsters. The dwarf is surrounded by the hamsters. The dwarf looks terrified.
Spring is coming, oh no, prepare the coffins! --Garath
Welcome to Dwarf Fortress. Where peaceful death of old age is something nobody sees coming. --Sirbug
Stopped zombies from interrupting your sleep to ask if they can help you with something. -- [[Toady One]]
"I died." "The Weather looks to be fine today." "I heard that I died."
I had a dwarven hero try to kill a bronze colossus seven times, and each time he lost.... After the third duel, he began worshipping his enemy. -- [[Toady One]]
I also grabbed somebody's exposed guts and did the only thing you can do with them currently, which is pinch them. -- [[Toady One]]
The dabbling surgeon moved between repairing the compound fracture and trying to stop bleeding from malpractice. -- [[Toady One]]
Large mobs of groundhogs can still kill things they wouldn't normally kill.
The poor thing died with the message "<name> has condensed." -- [[Toady One]]
In addition, Atheli devoured three cows, four horses, five mules, a donkey, six dogs, two cats, and a rhesus macaque and fox while tormenting the elves. -- [[Toady One]]
The titan was given a position in their pantheon, though it would still show up every few years to kick down somebody's house. -- [[Toady One]]
Large animals can put an unskilled [[gelder]] in the hospital. --[[Toady One]]
I have my little invisible help-wanted ads for [the dwarves] to look through now, followed by a little invisible pick-best-applicants procedure. --[[Toady One]]
You punch Human 2 in the right eye from behind with your left hand and the injured part explodes into gore! <br>Human 2: Greetings. My name is Human 2.
It seems I've just delivered you into the arms of crashing and despair. --[[Toady One]]
Chopping down the tree [is] effective, insofar as you do not care whether the dwarves live or die.
Knowing no mercy, [http://imgur.com/hoGQZoX Nikot] stole a cherry! This vile fiend even murdered Mafi Fanggorge!
[[Scamps]] added two lines of code today. They didn't compile. --[[Toady One]]
The crash happened when the night creature tried to come up with things to say to potential shoppers. --[[Toady One]]
Obok Kelzokum is interested near his own fine [[Bed]]. "I was near to my own Bed. How incredibly interesting!"
Wait, wait, wait. Why the hell do you have a raven stockpile? --[http://www.bay12forums.com/smf/index.php?topic=108371.msg3235825#msg3235825 peskyninja]
You can modify chickens so that, instead of laying eggs, they lay ''live bees''. Dwarf Fortress: crimes against nature simulator. --[http://tvtropes.org/pmwiki/pmwiki.php/VideoGame/DwarfFortress TVTropes]
Ah well. Who knew the first Dwarf to go to space was a useless [[fisherdwarf]].
I launched 4 dwarves into the air with a bridge and only 3 came down.
If you are working with [[magma|central heating]], make sure the "hot" pipe and the "cold" pipe don't mix, or your heating system will likely not work as intended.
It's no longer called magma when it reaches the surface... and melts a hundred goblins.
Dwarves are like squirrels, but instead of acorns it's booze.
Carp are to be feared, worshipped, and roasted.
It's easier to buy out a caravan than it is to take the time to shop.
I had a fortress where roughly 90% of the engravings were of buckets, buckets surrounded by dwarves, and buckets surrounded by screaming dwarves. --[http://dfstories.com/buckets/ taran]
Led Zanzustash dove into the rapids, and climbed out a day later. He had several injuries, some broken bones, and a missing finger, but he had done it: he saved a barrel of booze that was nearly destroyed (the baby died).
"In a time before time, I killed me." -Human with nothing else to [[Adventurer_mode#Talking|gossip]] about
There is currently a minor problem in that the veteran demons fighting in the corpse factory have failed to die in the 2 year battle and have become legendary unkillable gods of war. I may have misjudged this possible outcome. -- Loud Whispers
Added the Giant Adder to dwarven menu. --TheCrazyHamsteR
"What's the purpose of adding [[feather tree]]s to the game? To make good pillows", I think. --TheCrazyHamsteR
In a time before time, somebody attacked somebody.
Dwarf Fortress: [[Undead|Respawning after death]] is even more [[fun]].
"I tried to carve 'god hates this place' into the mountain. Unfortunately, Athlete's footnote got stuck in the 'a' of 'place' and starved to death"
The resulting party killed 20 dwarves, crippled 2 more and the remaining 9 managed to get along and have a nice party.
If your dwarves start melting or slugmen explode whenever it rains, then it's a good indication it's too hot. --UberNube
What you see as an increase in population, the surrounding beasts simply see as a more stable food supply. --Taupe, [http://www.bay12forums.com/smf/index.php?topic=144852.0/ DoomForests]
That's right, the undead ravens killed the entirety of the hidden fun stuff. --Loud Whispers
"Astesh Savotsazir, Stray Kitten (Tame) has adopted Ingish Rimtaruzol, Siege Engineer."
Dwarf Fortress, flinging dwarves into space using a drawbridge since 2006.
Sometimes the best trophy is your own head.
I like to think that the other pole [of the world] was destroyed by a dwarven experiment gone right. --GMDev
Unfortunately for Urist McDeadman, the budget no longer allowed for personal mausoleums for every dwarf, as had previously been standard.
Nil Aliscatten cancels make Charcoal: dangerous terrain.
A Kobold Thief has made off with +Kobold Cage+!
OH GOD I'M BEING EATEN BY A SNAIL, WHAT AN UNEXPECTED AND SORT OF IRONIC TWIST! --Max, [http://www.bay12forums.com/smf/index.php?topic=144852.0/ DoomForests]
"In the early spring of 500, the rain monster was struck down by the banshee of drought Scrapedrent in The Hellish Marshes."
Deler Kulinkeskal, Weaver is exhilarated after being attacked. "I was attacked. How exhilarating!"
I wonder how the elves can eat these... *licks a leaf*
Greetings. My name is TRANS_NAME].
Well, someone already managed to drink their sword.
How is my dining room possibly this full of badgers? -Skid
I just drafted a Llama into my army and it already killed a [[roc]] by itself. -Ashameron
Stopped cats from dying of alcohol poisoning after walking over damp tavern floors and cleaning themselves. --[[Toady One]]
{{bugl|8977|cat=nocat}} [Diplomacy] -- Merchant caravans get stuck in tree.
Each time a pile of wool becomes alive and attacks my dwarves I think it doesn't want to end as worn clothes. --TheCrazyHamsteR
Erith also gets kudos for killing a demon by eating it to death. --Loud Whispers
I (somehow) wield a marble coffin that I fill with the corpses of all I have slain (to make an already heavy object even heavier) in one hand, and the other holds a book made out out of fucking platinum. The book can crush skulls, and the coffin grows ever stronger and now that is has a few dead dragons in it, it sends people flying a mile backwards to explode in a pile of gore. Gore which I then place into the coffin. -- Wwolin
Jump into a deep pit and let your body experience overwhelming kinetic energy. --TheCrazyHamsteR
The Herbalist has become enraged!<br>Kadol Imushothil, Herbalist: "I got into an argumnent with Kol Kissrazors. I am so angry!"
Stozu Ägusnodub, Goblin Woodcutter (to Dang Kutsmobnozam, Goblin Diagnoser): "Not a half hour ago I attacked me."

<noinclude>|(\n)|$1#}}</noinclude>

File talk:Palace of Seducing.PNG

2015-10-29T19:13:15Z

JT:

There is so much wrong with this. --[[User:Iban|Iban]] 21:48, 18 January 2010 (UTC)

:Where can I get some of those Ruthlesspants? They sound pretty cool. [[User:Garanis|Garanis]] 21:55, 6 April 2010 (UTC)

Can't believe I never saw this one before, but I'm laughing my butt off at the "you look like a mighty warrior" "i'm four!" exchange. --[[User:JT|JT]] ([[User talk:JT|talk]]) 19:13, 29 October 2015 (UTC)

File talk:Oceanside-202-05.jpg

2015-06-25T03:19:50Z

JT:

OH GOD JPEG. --[[User:GreyMario|GreyMaria]] 05:16, 20 October 2009 (UTC)

Somebody let someone play a bloodline game with graphics? Dear god, that image is horrid. --[[User:Squirrelloid|Squirrelloid]] 05:36, 20 October 2009 (UTC)

This image doesn't seem particularly enlightening or impressive. Why is it on the main page? [[User:Gigacannon|Gigacannon]] 22:10, 28 December 2010 (UTC)

I'm just trying to figure out... is that infinitely-spread vomit (it happens...), or just a tunnel through a large lode? If the former, it should be made more obvious; if the latter, then I agree that this is completely pointless. --[[User:JT|JT]] ([[User talk:JT|talk]]) 03:19, 25 June 2015 (UTC)

DF2014 Talk:Stepladder

2014-10-27T18:52:02Z

JT: Created page with "=="Any passing dwarf"== (Haven't played the new version yet, due to DFHack incompatibility.) "Any passing dwarf" seems to be inaccurate, especially since Toady did so much wo..."

=="Any passing dwarf"==

(Haven't played the new version yet, due to DFHack incompatibility.) "Any passing dwarf" seems to be inaccurate, especially since Toady did so much work on fixing hauling labours in recent versions. Would it actually be Food Hauling, or some other hauling labour? --[[User:JT|JT]] ([[User talk:JT|talk]]) 18:52, 27 October 2014 (UTC)

User talk:173.34.52.58

2014-09-18T05:42:22Z

JT: Created page with "All rodents are mammals. =) http://en.wiktionary.org/wiki/mammal --~~~~"

All rodents are mammals. =)

http://en.wiktionary.org/wiki/mammal

--[[User:JT|JT]] ([[User talk:JT|talk]]) 05:42, 18 September 2014 (UTC)

User:JT/Toadmod

2014-08-21T04:58:04Z

JT:

Yes, importing this into your game will require you to generate a new world.

Warning: This file is good only for versions prior to 0.34. It's on my list of things to update.

==creature_toadmod.txt==
<pre>creature_toadmod

[OBJECT:CREATURE]

whitebelly stream toad
[CREATURE:WHITEBELLY_STREAM_TOAD]
[NAME:whitebelly stream toad:whitebelly stream toads:whitebelly stream toad]
[TILE:249][COLOR:7:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:150:300]
[SPEED:2900][NATURAL][PET]
[PETVALUE:6]
[NOT_BUTCHERABLE]
[PREFSTRING:pale undersides]
[NOCTURNAL]
[BIOME:RIVER_TROPICAL_FRESHWATER]
[BIOME:POOL_TROPICAL_FRESHWATER]
[BIOME:FOREST_TROPICAL_MOIST_BROADLEAF]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

long-fingered stream toad
[CREATURE:LONGFINGER_STREAM_TOAD]
[NAME:long-fingered stream toad:long-fingered stream toads:long-fingered stream toad]
[TILE:249][COLOR:6:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:100:200]
[SPEED:2900][NATURAL][PET]
[PETVALUE:5]
[NOT_BUTCHERABLE]
[PREFSTRING:brown toes]
[NOCTURNAL]
[BIOME:RIVER_TROPICAL_FRESHWATER]
[BIOME:POOL_TROPICAL_FRESHWATER]
[BIOME:FOREST_TROPICAL_MOIST_BROADLEAF]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

pygmy false toad
[CREATURE:PYGMY_FALSE_TOAD]
[NAME:pygmy false toad:pygmy false toads:pygmy false toad]
[TILE:249][COLOR:6:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:50:100]
[SPEED:2900][NATURAL][PET]
[PETVALUE:7]
[NOT_BUTCHERABLE]
[PREFSTRING:tiny yellow spots]
[NOCTURNAL]
[BIOME:MOUNTAIN]
[BIOME:RIVER_TROPICAL_FRESHWATER]
[BIOME:RIVER_TEMPERATE_FRESHWATER]
[BIOME:FOREST_TROPICAL_MOIST_BROADLEAF]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

tiny stream toad
[CREATURE:TINY_STREAM_TOAD]
[NAME:tiny stream toad:tiny stream toads:tiny stream toad]
[TILE:249][COLOR:1:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:150:300]
[SPEED:2900][NATURAL][PET]
[PETVALUE:6]
[NOT_BUTCHERABLE]
[PREFSTRING:teensy weensy croaks]
[NOCTURNAL]
[BIOME:RIVER_TROPICAL_FRESHWATER]
[BIOME:POOL_TROPICAL_FRESHWATER]
[BIOME:FOREST_TROPICAL_MOIST_BROADLEAF]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

ornate stream toad
[CREATURE:ORNATE_STREAM_TOAD]
[NAME:ornate stream toad:ornate stream toads:ornate stream toad]
[TILE:249][COLOR:6:0:1]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:50:100]
[SPEED:2900][NATURAL][PET]
[PETVALUE:9]
[NOT_BUTCHERABLE]
[PREFSTRING:yellow tummy spots]
[NOCTURNAL]
[BIOME:MOUNTAIN]
[BIOME:RIVER_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

coastal plain toad
[CREATURE:COASTAL_PLAIN_TOAD]
[NAME:coastal plain toad:coastal plain toads:coastal plain toad]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:150:300]
[SPEED:2900][NATURAL][PET]
[PETVALUE:5]
[NOT_BUTCHERABLE]
[PREFSTRING:cute hops]
[NOCTURNAL]
[BIOME:OCEAN_TROPICAL]
[BIOME:SWAMP_TROPICAL_SALTWATER]
[BIOME:MARSH_TROPICAL_SALTWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

red spotted toad
[CREATURE:RED_SPOTTED_TOAD]
[NAME:red spotted toad:red spotted toads:red spotted toad]
[TILE:249][COLOR:4:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:100:200]
[SPEED:2900][NATURAL][PET]
[PETVALUE:7]
[NOT_BUTCHERABLE]
[PREFSTRING:cricket noises]
[NOCTURNAL]
[BIOME:DESERT_ROCK]
[BIOME:GRASSLAND_TROPICAL]
[BIOME:POOL_TROPICAL_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

desert toad
[CREATURE:DESERT_TOAD]
[NAME:desert toad:desert toads:desert toad]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:75:150]
[SPEED:2900][NATURAL][PET]
[PETVALUE:8]
[NOT_BUTCHERABLE]
[PREFSTRING:tenacity]
[NOCTURNAL]
[BIOME:DESERT_ROCK]
[BIOME:DESERT_SAND]
[BIOME:DESERT_BADLAND]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

spadefoot toad
[CREATURE:SPADEFOOT_TOAD]
[NAME:spadefoot toad:spadefoot toads:spadefoot toad]
[TILE:249][COLOR:6:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:150:300]
[SPEED:2900][NATURAL][PET]
[PETVALUE:8]
[NOT_BUTCHERABLE]
[PREFSTRING:round bodies]
[PREFSTRING:digging claws]
[NOCTURNAL]
[BIOME:FOREST_TEMPERATE_BROADLEAF]
[BIOME:FOREST_TEMPERATE_CONIFER]
[BIOME:SHRUBLAND_TEMPERATE]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:GRASSLAND_TEMPERATE]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

narrowmouth toad
[CREATURE:NARROWMOUTH_TOAD]
[NAME:narrowmouth toad:narrowmouth toads:narrowmouth toad]
[TILE:249][COLOR:0:0:1]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:3]
[NOT_BUTCHERABLE]
[PREFSTRING:nasal calls]
[NOCTURNAL]
[BIOME:FOREST_TEMPERATE_BROADLEAF]
[BIOME:SHRUBLAND_TEMPERATE]
[BIOME:SAVANNA_TEMPERATE]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

bullfrog
[CREATURE:BULLFROG]
[NAME:bullfrog:bullfrogs:bullfrog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:350:700]
[SPEED:2900][NATURAL][PET]
[PETVALUE:10]
[NOT_BUTCHERABLE]
[PREFSTRING:fecundity]
[NOCTURNAL]
[BIOME:LAKE_TEMPERATE_FRESHWATER]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:RIVER_TEMPERATE_FRESHWATER]
[BIOME:SWAMP_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

bronze frog
[CREATURE:BRONZE_FROG]
[NAME:bronze frog:bronze frogs:bronze frog]
[TILE:249][COLOR:6:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:9]
[NOT_BUTCHERABLE]
[PREFSTRING:brown skin]
[NOCTURNAL]
[BIOME:LAKE_TEMPERATE_FRESHWATER]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:RIVER_TEMPERATE_FRESHWATER]
[BIOME:SWAMP_TEMPERATE_FRESHWATER]
[BIOME:LAKE_TROPICAL_FRESHWATER]
[BIOME:POOL_TROPICAL_FRESHWATER]
[BIOME:RIVER_TROPICAL_FRESHWATER]
[BIOME:SWAMP_TROPICAL_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

green frog
[CREATURE:GREEN_FROG]
[NAME:green frog:green frogs:green frog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:8]
[NOT_BUTCHERABLE]
[PREFSTRING:green skin]
[NOCTURNAL]
[BIOME:LAKE_TEMPERATE_FRESHWATER]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:RIVER_TEMPERATE_FRESHWATER]
[BIOME:SWAMP_TEMPERATE_FRESHWATER]
[BIOME:LAKE_TROPICAL_FRESHWATER]
[BIOME:POOL_TROPICAL_FRESHWATER]
[BIOME:RIVER_TROPICAL_FRESHWATER]
[BIOME:SWAMP_TROPICAL_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

leopard frog
[CREATURE:LEOPARD_FROG]
[NAME:leopard frog:leopard frogs:leopard frog]
[TILE:249][COLOR:6:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:150:300]
[SPEED:2900][NATURAL][PET]
[PETVALUE:8]
[NOT_BUTCHERABLE]
[PREFSTRING:leopard spots]
[NOCTURNAL]
[BIOME:SAVANNA_TEMPERATE]
[BIOME:GRASSLAND_TEMPERATE]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

pickerel frog
[CREATURE:PICKEREL_FROG]
[NAME:pickerel frog:pickerel frogs:pickerel frog]
[TILE:249][COLOR:6:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:125:250]
[SPEED:2900][NATURAL][PET]
[PETVALUE:9]
[NOT_BUTCHERABLE]
[PREFSTRING:deadliness]
[NOCTURNAL]
[BIOME:SAVANNA_TEMPERATE]
[BIOME:GRASSLAND_TEMPERATE]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[EXTRACT:pickerel poison:15:0:1]
[EXTRACT_ANTIDOTE:pickerel antidote:25:0:0:50]
[EXTRACT_PARALYSIS_INTERMITTENT]
[SWIMS_INNATE][SWIM_SPEED:2500]

wood frog
[CREATURE:WOOD_FROG]
[NAME:wood frog:wood frogs:wood frog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:6]
[NOT_BUTCHERABLE]
[PREFSTRING:resistance to freezing]
[NOCTURNAL]
[BIOME:GRASSLAND_TEMPERATE]
[BIOME:FOREST_TEMPERATE_CONIFER]
[BIOME:FOREST_TEMPERATE_BROADLEAF]
[BIOME:FOREST_TAIGA]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

cricket frog
[CREATURE:CRICKET_FROG]
[NAME:cricket frog:cricket frogs:cricket frog]
[TILE:249][COLOR:6:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:150:300]
[SPEED:2900][NATURAL][PET]
[PETVALUE:3]
[NOT_BUTCHERABLE]
[PREFSTRING:pebble size]
[NOCTURNAL]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

greenhouse frog
[CREATURE:GREENHOUSE_FROG]
[NAME:greenhouse frog:greenhouse frogs:greenhouse frog]
[TILE:249][COLOR:6:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:4]
[NOT_BUTCHERABLE]
[PREFSTRING:tiny size]
[NOCTURNAL]
[BIOME:FOREST_TROPICAL_MOIST_BROADLEAF]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

canyon treefrog
[CREATURE:CANYON_TREEFROG]
[NAME:canyon treefrog:canyon treefrogs:canyon treefrog]
[TILE:249][COLOR:7:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:75:150]
[SPEED:2900][NATURAL][PET]
[PETVALUE:6]
[NOT_BUTCHERABLE]
[PREFSTRING:camouflage]
[NOCTURNAL]
[BIOME:MOUNTAIN]
[BIOME:FOREST_TEMPERATE_BROADLEAF]
[BIOME:DESERT_ROCK]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

squirrel treefrog
[CREATURE:SQUIRREL_TREEFROG]
[NAME:squirrel treefrog:squirrel treefrogs:squirrel treefrog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:4]
[NOT_BUTCHERABLE]
[PREFSTRING:bright green skin]
[NOCTURNAL]
[BIOME:GRASSLAND_TEMPERATE]
[BIOME:FOREST_TEMPERATE_BROADLEAF]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

green treefrog
[CREATURE:GREEN_TREEFROG]
[NAME:green treefrog:green treefrogs:green treefrog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:10]
[NOT_BUTCHERABLE]
[PREFSTRING:domesticability]
[NOCTURNAL]
[BIOME:LAKE_TEMPERATE_FRESHWATER]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:FOREST_TEMPERATE_BROADLEAF]
[BIOME:MARSH_TEMPERATE_FRESHWATER]
[BIOME:SWAMP_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

birdvoiced treefrog
[CREATURE:BIRDVOICED_TREEFROG]
[NAME:birdvoiced treefrog:birdvoiced treefrogs:birdvoiced treefrog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:150:300]
[SPEED:2900][NATURAL][PET]
[PETVALUE:7]
[NOT_BUTCHERABLE]
[PREFSTRING:chirping]
[NOCTURNAL]
[BIOME:MARSH_TEMPERATE_FRESHWATER]
[BIOME:SWAMP_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

gray treefrog
[CREATURE:GRAY_TREEFROG]
[NAME:gray treefrog:gray treefrogs:gray treefrog]
[TILE:249][COLOR:7:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:8]
[NOT_BUTCHERABLE]
[PREFSTRING:ability to change colors]
[NOCTURNAL]
[BIOME:LAKE_TEMPERATE_FRESHWATER]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:FOREST_TEMPERATE_BROADLEAF]
[BIOME:MARSH_TEMPERATE_FRESHWATER]
[BIOME:SWAMP_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

pinewoods treefrog
[CREATURE:PINEWOODS_TREEFROG]
[NAME:pinewoods treefrog:pinewoods treefrogs:pinewoods treefrog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:5]
[NOT_BUTCHERABLE]
[PREFSTRING:long and short calls]
[NOCTURNAL]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:FOREST_TEMPERATE_CONIFEROUS]
[BIOME:SWAMP_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

upland chorus frog
[CREATURE:UPLAND_CHORUS_FROG]
[NAME:upland chorus frog:upland chorus frogs:upland chorus frog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:150:300]
[SPEED:2900][NATURAL][PET]
[PETVALUE:5]
[NOT_BUTCHERABLE]
[PREFSTRING:secretive ways]
[NOCTURNAL]
[BIOME:SAVANNA_TEMPERATE]
[BIOME:SAVANNA_TROPICAL]
[BIOME:GRASSLAND_TEMPERATE]
[BIOME:GRASSLAND_TROPICAL]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:POOL_TROPICAL_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

ornate chorus frog
[CREATURE:ORNATE_CHORUS_FROG]
[NAME:toad:toads:toad]
[TILE:249][COLOR:7:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:250:500]
[SPEED:2900][NATURAL][PET]
[PETVALUE:6]
[NOT_BUTCHERABLE]
[PREFSTRING:metalworking noises]
[NOCTURNAL]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[BIOME:POOL_TROPICAL_FRESHWATER]
[BIOME:SWAMP_TEMPERATE_FRESHWATER]
[BIOME:SWAMP_TROPICAL_FRESHWATER]
[BIOME:MARSH_TEMPERATE_FRESHWATER]
[BIOME:MARSH_TROPICAL_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]

little grass frog
[CREATURE:LITTLE_GRASS_FROG]
[NAME:little grass frog:little grass frogs:little grass frog]
[TILE:249][COLOR:2:0:0]
[VERMIN_GROUNDER][FREQUENCY:100][VERMIN_HATEABLE]
[AMPHIBIOUS][SMALL_REMAINS][NO_WINTER][UNDERSWIM]
[POPULATION_NUMBER:50:100]
[SPEED:2900][NATURAL][PET]
[PETVALUE:5]
[NOT_BUTCHERABLE]
[PREFSTRING:record tininess]
[NOCTURNAL]
[BIOME:POOL_TEMPERATE_FRESHWATER]
[STANDARD_FLESH]
[SWIMS_INNATE][SWIM_SPEED:2500]</pre>

Creature Token

2014-08-14T21:41:17Z

JT: was double-redirecting to "creature tokens" which was in 0.34 namespace, therefore auto-redirecting to proper page but in wrong namespace

#REDIRECT [[Creature token]]

Creature token

2014-08-13T05:44:27Z

JT: see talk page for reasoning behind clarification

{{Migrated_article}}
{{av}}{{Quality|Exceptional}}

A full list of all known creature tokens.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants. It appears that the basic requirements for adoption are intact; for example, the creature is more likely to adopt an owner which likes creatures of that species.{{verify}}

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Creature needs alcohol to get through the working day, choosing to drink booze instead of water if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| {{text anchor|ALTTILE}}
| Creature
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Instead of charging relentlessly at prey, a creature with this tag will wait till the prey is within a few squares before charging.{{verify}}

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe with or without [[water]]. Implies [AQUATIC].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Caste
|
*Range
| [http://www.bay12forums.com/smf/index.php?topic=60554.msg1766793#msg1766793 Forum post describing how description ranges work]

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Caste
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

|-
| {{text anchor|APP_MOD_IMPORTANCE}}
| Caste
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| {{text anchor|APP_MOD_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| {{text anchor|APP_MOD_RATE}}
| Caste
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Special
|
*CV TEMPLATE NAME
| Applies the specified [[creature variation token|creature variation]].

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies the effects of all pending [[#CV_ADD_TAG|CV_ADD_TAG]] and [[#CV_REMOVE_TAG|CV_REMOVE_TAG]] tokens that have been defined in the current creature.

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Creature can breathe in water, but air-drowns on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Does not appear in arena mode list.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Can be kept in artificial hives by beekeepers.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Does not attack or frighten creatures with the NATURAL tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
| pop:exported wealth:created wealth
| Specifies when a [[megabeast]] will attack the fortress.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|BABY}}
| Caste
| integer
| Age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
| [[Whale]]s and [[Sea nettle jellyfish|jellyfish]] have this. Controls the beaching frequency of the creature.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, but may lash out if agitated or disturbed.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[Biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Seems to be required to make the creature denouncable as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
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.

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
| PlanName, PlanName:type:type:type:etc.
| loads a plan 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 />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A [[Purring maggot|maggot]] would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
| years:days:size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a [[minotaur]]. His birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old he would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) he would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.

|-
| {{text anchor|BODYGLOSS}}
| Caste
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies CARNIVORE and has the same worldgen problem.

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains skills and can have professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can talk. Note that it is not necessary for a creature to gain social skills. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste {{Verify}}
|
| Creature cannot climb, even if it has free grasps.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot jump.

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Alias for NOT_LIVING

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open doors.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Currently bugged in worldgen -- exclusively carnivore civilizations always starve out. Goblins and kobolds live off raw exceptions. Civilizations with [NO_EAT] token will still starve to death.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a caste.

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific ALT_TILE. Requires CASTE_TILE.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific COLOR.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific GLOWCOLOR.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific GLOWTILE.

|-
| {{text anchor|CASTE_NAME}}
| Caste
| singular:plural:adjective
| Caste-specific NAME.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific PROFESSION_NAME.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
| 'character' or tile number
| Caste-specific SOLDIER_ALTTILE. Requires CASTE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
| 'character' or tile number
| Caste-specific CREATURE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
| speech file
| Caste-specific SPEECH.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific CREATURE_TILE.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
| Varies
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
| integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
| integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage.

|-
| {{text anchor|CHILDNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of eggs laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
| foreground:background:brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| Any civilization with USE_COMMON_DOMESTIC tag (humans, dwarves) has domesticated this creature by default and always has access to it, even without any wild populations. Useless without PET, PACK_ANIMAL, WAGON_PULLER or MOUNT tags and invalid on FANCIFUL creatures. Requires NATURAL tag?{{verify}}

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used for mussels, for one.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is 'berserk' and will attack all other creatures, except members of its own species that ALSO have the CRAZED tag.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes) and EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens). A single creature can have multiple classes. Eligibility for certain entity positions can also be permitted or restricted by this tag.

|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets if the creature is active at twilight.

|-
| {{text anchor|CURIOUSBEAST_EATER}}
| Caste
|
| Allows a creature to steal and eat edible items from a site.

|-
| {{text anchor|CURIOUSBEAST_GUZZLER}}
| Caste
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to steal things (apparently the highest value it can find). If the creature goes on rampages in worldgen, it will often steal items instead of attacking. Kea birds are infamous for this.

|-
| {{text anchor|CV_ADD_TAG}}
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|DESCRIPTION}}
| Caste
| text
| A brief description of the creature type.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Dies upon attacking. Used for [[bee]] stings.

|-
| {{text anchor|DIFFICULTY}}
| Caste
| integer
| Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets if the creature is active in day.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| Found on [[peregrine falcon]]s. The creature hunts vermin by diving from the air. Does not seem to work on tame creatures.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Creature does not actually exist; used for a few [[fanciful]] creatures of myth.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|EBO_ITEM}}
| Caste
| [[item token]]:[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being butchered. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
| gem shape
| The shape of the extra item of the creature upon butchering. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will 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.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of eggs.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Civilizations with USE_EVIL_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when butchered (typically a gizzard stone), defined by EBO_ITEM and EBO_SHAPE.

|-
| {{text anchor|EXTRACT}}
| Caste
|
* [[material token]]
| Defines a creature extract which can be obtained via [[small animal dissection]].

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with {{token|COMMON_DOMESTIC|c}}

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on subterranean animal-man tribals.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|FEMALE}}
| Caste
|
| The creature is female and can bear young. Usually determined inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| The creature is immune to FIREBALL and FIREJET attacks.

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| The creature is immune to DRAGONFIRE attacks. Implies {{token|FIREIMMUNE|c}}.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| Needs to be cleaned at a fishery

|-
| {{text anchor|FIXED_TEMP}}
| Caste
| temperature
| The natural heat generated by the creature.

|-
| {{text anchor|FLEEQUICK}}
| Caste
|
| Determines how soon a creature flees in a losing battle. Creatures with this tag will flee at the first sign of resistance.

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. 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}}.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|GAIT}}
| Unknown
|
* type (WALK, CLIMB, SWIM, CRAWL, or FLY)
* gait name
* full speed
* build up time:max turning speed:start speed (or NO_BUILD_UP for instant use)
* energy use
* Optional flags:
** LAYERS_SLOW - if gait is slowed by increased weight
** STRENGTH - if gait is affected by strength stat
** AGILITY - if gait is affected by agility stat
** STEALTH_SLOWS:penalty - if gait is slowed by being stealthed
| Defines a gait at which the creature can move. See [[Gait]] for more information.

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
| singular:plural
| BABYNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
| singular:plural
| CHILDNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
| A:B
| Attacks against the creature have their force modified by A/B. For example, 1:2 will halve the force of an attack made against the creature. {{verify}}

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) [[titan]]s, [[Demon]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Creature can get infections from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| This creature's wounds can become infected if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's GLOWTILE.

|-
| {{text anchor|GLOWTILE}}
| Creature
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| {{text anchor|GNAWER}}
| Caste
| verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood). A former bug was fixed which prevented their escape{{bug|6117}} from non-artifact traps, but currently all gnawers brought onto the map by the elven caravans will automatically escape almost instantaneously from their wooden animal traps{{bug|6343}}.

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
| class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
| creature:caste
| The creature eats a specified vermin.

|-
| {{text anchor|GO_TO_END}}
| Special
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

|-
| {{text anchor|GO_TO_START}}
| Special
|
| When using tags from an existing creature, inserts new tags at the beginning of the creature.

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags after the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes. [[unicorn]]s for example. Civilizations with USE_GOOD_ANIMALS can domesticate them regardless of exotic status. Presumably has no effect on cavern creatures.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
| value
| The value determines how rapidly grass is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
| target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| 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. See [[Pasture]] for details on its issues.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|HABIT}}
| Caste
| type:probability
| 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, and COLLECT_WEALTH. These require the creature to have a lair to work properly, and also don't seem to work on creatures who are not (SEMI)MEGABEASTs or NIGHT_CREATURE_HUNTERs.

|-
| {{text anchor|HABIT_NUM}}
| Caste
| number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".<sup>[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]]</sup> All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

|-
| {{text anchor|HASSHELL}}
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

|-
| {{text anchor|HFID}}
| Creature
| Integer (generic token?)
| Found on generated [[angel]]s. Seemingly identifies a historical figure with said hist figure ID, possibly to associate it with hist figure.

|-
| {{text anchor|HIVE_PRODUCT}}
| Creature
|
*number
*[[time]]
*[[item token]]s
| What product is harvested from [[Beekeeping industry|beekeeping]].

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
| Default 'NONE'. The creature's normal body [[temperature]]

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby vermin.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in Fortress Mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen)

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates fire. It will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of certain materials. Due to a bug, however, they will only escape from [[artifact]]s.{{bug|6117}}

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for [CAN_SPEAK] + [CAN_LEARN].

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc.).

|-
| {{text anchor|ITEMCORPSE_QUALITY}}
| Caste
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|LAIR}}
| Caste
| type: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, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure 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."

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays eggs instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays a particular item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| Creature has ligaments in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| The creature will generate light, such as in adventurer mode at night.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz.")

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the range of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| {{text anchor|LOOSE_CLUSTERS}}
| Creature
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
| number
| Determines how well a creature can see in the dark. Higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|MAGICAL}}
| Caste
|
| Unknown.

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| Creature's able to see while covered in magma.

|-
| {{text anchor|MALE}}
| Caste
|
| The creature is male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
See [[Creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new material.{{verify}}

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*A:B
| Set the force multiplier of a specific material against the creature to A/B. For example, 10:1 multiplies the force by 10. {{verify}}

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets if the creature is active in dawn.

|-
| {{text anchor|MAXAGE}}
| Caste
| min:max
| Range of time in years in which death from old age may occur. Once a creature reaches the min value, it has a random chance each season of dying from old age. Unknown if the chance increases with further age.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Gives a creature random movement.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creature 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.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher:highest
| Sets up a mental attribute's range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Mental attribute gain/decay rates. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked in the farmer's workshop. The frequency is the amount of time units the creature needs to "recharge".

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for MISCHIEVOUS.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a mount. No use for the player, but enemy siegers may arrive with cavalry.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a mount, but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste {{Verify}}
|
| Allows the creature to have all-around vision as long as it has multiple heads(?) that can see. {{Verify}}

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets using typical real-world human probabilities. Requires [[Creature_token#FEMALE|FEMALE]]. Compare with [[Creature_token#LITTERSIZE|LITTERSIZE]]. If LITTERSIZE and MULTIPLE_LITTER_RARE are both absent, one offspring is guaranteed per birth.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|NAME}}
| Creature
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. Creatures with AT_PEACE_WITH_WILDLIFE will not fight with them.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of NATURAL.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
| [[Skill_token|Skill token]]:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. A value of 16 is legendary. Requires CAN_LEARN or INTELLIGENT to function in .25 or earlier.

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Found on bogeymen. Creatures with this tag will join other bogeymen in attacking adventurers at night, and will also adopt their other behaviors, such as vanishing in smoke upon being killed. This does not affect the creature's presence elsewhere, such as for generated megabeasts, normal creatures, entity members, etc. Setting the number of bogeyman types to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| 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. If this creature has SPOUSE_CONVERTER, 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 [[werebeast]]s 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.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| This creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become dizzy.

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to eat.

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer fevers.

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| Creature has no gender.

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The affected caste cannot gain any physical skills.

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The affected caste cannot lose any physical skills.

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| This creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| This creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the [THOUGHT] tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| This creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets if the creature is active in night.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| The creature has no emotions, and does not rage.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never run away from battle.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when butchered.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when butchered.

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butcher, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce miasma when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy.{{verify}} If this creature must eat and drink while playing, it WILL die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Cannot be butchered

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead.

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a [THOUGHT] body part to survive. If it does not have NO_THOUGHT_CENTER_FOR_MOVEMENT as well, it will be unable to use any attacks other than the default 'push'. Has the added effect of preventing speech.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==O==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
| number
| How easy the creature is to smell. The higher the number, the easier the creature can be smelled. Zero is odorless. Default is 50.

|-
| {{text anchor|ODOR_STRING}}
| Caste
| string
| What the creature smells like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones. Used for [[Undead]].

|-
| {{text anchor|ORIENTATION}}
| Caste
| MALE/FEMALE:disinterested chance:lover-possible chance:commitment-possible 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.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Currently only used by merchants without wagons. Also prevents creature from dropping hauled items on its own -- do not use for player-controllable creatures!

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all paralyzing special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Unknown. No creatures currently have this token.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate pearls. Does nothing in the current version.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations that encounter it in worldgen will tame and domesticate it for their own use.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations cannot domesticate it in worldgen without certain exceptions. More difficult to tame?{{verify}}

|-
| {{text anchor|PETVALUE}}
| Caste
| value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher: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.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Physical attribute gain/decay rates. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after SET_BP_GROUP.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after SELECT_MATERIAL.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
| min:max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity. 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.

|-
| {{text anchor|PREFSTRING}}
| Creature
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*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.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
| Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes badgers so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| The creature has pus. Specifies the stuff secreted by infected wounds.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
| singular:plural
| What creature's remains are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color creature's remains are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| 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.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from a creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*material token
| Removes a tissue from a creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part.

|-
| {{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 his feet. Requires HUNTS_VERMIN, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventure Mode, spawns vermin edible by this creature in Fortress Mode.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes.

|-
| {{text anchor|SECRETION}}
| Caste
|
* [[material token]]
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
*trigger
| creates a secreted material on given tissue on a given part of the body. Valid triggers are:
*CONTINUOUS
*EXTREME_EMOTION
*EXERTION

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used after SELECT_CASTE.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*caste name, or ALL
| selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*Material token
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as MEGABEAST, but more of them are created during worldgen.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* Creature class
* [[Tilesets|Tile]]
* [[Color|Color]]
| Allows creature to sense creatures with a certain creature class through walls, floors etc. Sense will be with tile and color specified.

|-
| {{text anchor|SET_BP_GROUP}}
| Caste
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| Begins a selection of body parts.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
| [[skill_token]]:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
| percentage
| The rate at which this creature learns all skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
| [[skill_token]]:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
| [[skill_token]]:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
| value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for [CAN_LEARN] + [SKILL_LEARN_RATES:50].{{verify}} Used for ogres and giants. Applicable to player races.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves a "remains" instead of a corpse. Used for vermin.

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
| value
| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature can will only graze or eat the designated plant or creature parts.

|-
| {{text anchor|SPEECH}}
| Creature
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in data\speech.

|-
| {{text anchor|SPEECH_FEMALE}}
| Creature
| speech file
| Boasting speeches relating to killing females of this creature.

|-
| {{text anchor|SPEECH_MALE}}
| Creature
| speech file
| Boasting speeches relating to killing males of this creature.

|-
| {{text anchor|SPHERE}}
| Creature
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the NIGHT_CREATURE_HUNTER tag, it will kidnap SPOUSE_CONVERSION_TARGETs and transform them into the caste of its species with the CONVERTED_SPOUSE tag during worldgen. It may also start families this way.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste {{verify}}
|
| Caste does not require GRASP body parts to climb -- it can climb with STANCE parts instead.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's webs can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
| name
| Begins defining a tissue in the creature file.

|-
| {{text anchor|TITAN}}
| Caste
|
| Found on [[titan]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
| COLOR:freq:COLOR:freq etc.
| Creates a list of color patterns, giving each a relative frequency.

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by stonesense for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be trained as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be trained as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into martial trances.

|-
| {{text anchor|TRAPAVOID}}
| Caste
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. A single argument may be used instead of min and max. Only magma creatures use 4 or 5 in the default raws. [[Demon]]s use only 5:5; user-defined creatures with both this depth and [FLIER] will take part in the initial wave from the HFS alongside generated demons. Without [FLIER], they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| Creature swims under the water and can't be seen. Seems to be a relic from the 2D era.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| Typically found on generated [[demon]]s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be specified in user-defined raws.

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a SKULKING civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|VEGETATION}}
| Caste
|
| The creature is made of swamp stuff. Used for [[grimeling]]s.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
| Vermin bites, and injects something.

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See PENETRATEPOWER. Distinct from VERMIN_ROTTER.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in water and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by fishing.

|-
| {{text anchor|VERMIN_NOROAM}}
| Caste
|
| The creature will not be observed randomly roaming about the map.

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Attracted to rotting stuff left in the open. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud.

|-
| {{text anchor|VERMIN_SOIL_COLONY}}
| Creature
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets if the creature is active in evening.

|-
| {{text anchor|VIEWRANGE}}
| Caste
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste {{Verify}}
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs. The first number is binocular vision, the second is non-binocular vision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create webs, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
| 2nd person:3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
| number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
| interaction
| When this attack lands successfully, an interaction with I_SOURCE:ATTACK will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying properties of previously defined tissues. (See also [[Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.
[SELECT_TISSUE_LAYER:SKIN:BY_TYPE:UPPERBODY]

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
| Sets a tissue layer to be made of a different tissue.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man:<br>
[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
| Seems to set new relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[Body detail plan token]]
*[[Body token]]
*[[Material definition token]]
*[[Syndrome]]
*[[Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

DF2014 Talk:Creature token

2014-08-13T05:43:56Z

JT: /* APPLY_CREATURE_VARIATION versus APPLY_CURRENT_CREATURE_VARIATION */ missing space for preformatted text

{{newpage|type=cp|178.167.254.128}}

== APPLY_CREATURE_VARIATION versus APPLY_CURRENT_CREATURE_VARIATION ==

Based on testing, APPLY_CREATURE_VARIATION has instant effect (in reverse order, as noted elsewhere), whereas APPLY_CURRENT_CREATURE_VARIATION is used to manually apply any creature variation tags, such as CV_ADD_TAG or CV_REMOVE_TAG, that have been manually added to the ''creature'' definition instead of being defined in a ''creature variation''. In other words, APPLY_CURRENT_CREATURE_VARIATION has no effect if you are simply using APPLY_CREATURE_VARIATION to load creature variations. Think of a [[creature variation token|creature variation]] defined in an OBJECT:CREATURE_VARIATION file as a "template", which is applied with APPLY_CREATURE_VARIATION. Think of a "current creature variation" as any manually-defined creature variations that have been added to the creature definition itself, which must be applied to the creature with APPLY_CURRENT_CREATURE_VARIATION after you have made all of the necessary modifications.

For example, the following is a use of APPLY_CREATURE_VARIATION, which takes instantaneous effect without any need for APPLY_CURRENT_CREATURE_VARIATION.:
<span style="color:#f00">[APPLY_CREATURE_VARIATION:REMOVE_STUB_ARMS]</span>

This is an example of the use of APPLY_CURRENT_CREATURE_VARIATION:
[COPY_TAGS_FROM:MY_CREATURE]
<span style="color:#f0f">[CV_REMOVE_TAG:TISSUE_LAYER_UNDER]</span>
[TISSUE_LAYER_UNDER:BY_CATEGORY:BODY:GAS]
[TISSUE_LAYER_UNDER:BY_CATEGORY:WING:GAS]
<span style="color:#f0f">[APPLY_CURRENT_CREATURE_VARIATION]</span>

--[[User:JT|JT]] ([[User talk:JT|talk]]) 05:43, 13 August 2014 (UTC)

DF2014 Talk:Creature token

2014-08-13T05:43:29Z

JT: /* APPLY_CREATURE_VARIATION versus APPLY_CURRENT_CREATURE_VARIATION */ new section

Creature token

2014-08-13T00:45:10Z

JT: MULTIPLE_LITTER_RARE: new description that doesn't seem like it's simply repeating what the token's name is ;-); also incidentally fixed hardlink to DF2012 namespace

{{Migrated_article}}
{{av}}{{Quality|Exceptional}}

A full list of all known creature tokens.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants. It appears that the basic requirements for adoption are intact; for example, the creature is more likely to adopt an owner which likes creatures of that species.{{verify}}

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Creature needs alcohol to get through the working day, choosing to drink booze instead of water if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| {{text anchor|ALTTILE}}
| Creature
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Instead of charging relentlessly at prey, a creature with this tag will wait till the prey is within a few squares before charging.{{verify}}

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe with or without [[water]]. Implies [AQUATIC].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Caste
|
*Range
| [http://www.bay12forums.com/smf/index.php?topic=60554.msg1766793#msg1766793 Forum post describing how description ranges work]

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Caste
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

|-
| {{text anchor|APP_MOD_IMPORTANCE}}
| Caste
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| {{text anchor|APP_MOD_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| {{text anchor|APP_MOD_RATE}}
| Caste
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Special
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies loaded Creature Variation

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Creature can breathe in water, but air-drowns on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Does not appear in arena mode list.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Can be kept in artificial hives by beekeepers.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Does not attack or frighten creatures with the NATURAL tag.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
| pop:exported wealth:created wealth
| Specifies when a [[megabeast]] will attack the fortress.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|BABY}}
| Caste
| integer
| Age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
| [[Whale]]s and [[Sea nettle jellyfish|jellyfish]] have this. Controls the beaching frequency of the creature.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, but may lash out if agitated or disturbed.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[Biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Seems to be required to make the creature denouncable as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
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.

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
| PlanName, PlanName:type:type:type:etc.
| loads a plan 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 />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A [[Purring maggot|maggot]] would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
| years:days:size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a [[minotaur]]. His birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old he would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) he would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.

|-
| {{text anchor|BODYGLOSS}}
| Caste
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies CARNIVORE and has the same worldgen problem.

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains skills and can have professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can talk. Note that it is not necessary for a creature to gain social skills. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste {{Verify}}
|
| Creature cannot climb, even if it has free grasps.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot jump.

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Alias for NOT_LIVING

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open doors.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Currently bugged in worldgen -- exclusively carnivore civilizations always starve out. Goblins and kobolds live off raw exceptions. Civilizations with [NO_EAT] token will still starve to death.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a caste.

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific ALT_TILE. Requires CASTE_TILE.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific COLOR.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific GLOWCOLOR.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific GLOWTILE.

|-
| {{text anchor|CASTE_NAME}}
| Caste
| singular:plural:adjective
| Caste-specific NAME.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific PROFESSION_NAME.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
| 'character' or tile number
| Caste-specific SOLDIER_ALTTILE. Requires CASTE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
| 'character' or tile number
| Caste-specific CREATURE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
| speech file
| Caste-specific SPEECH.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific CREATURE_TILE.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
| Varies
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
| integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
| integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage.

|-
| {{text anchor|CHILDNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of eggs laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
| foreground:background:brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| Any civilization with USE_COMMON_DOMESTIC tag (humans, dwarves) has domesticated this creature by default and always has access to it, even without any wild populations. Useless without PET, PACK_ANIMAL, WAGON_PULLER or MOUNT tags and invalid on FANCIFUL creatures. Requires NATURAL tag?{{verify}}

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used for mussels, for one.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is 'berserk' and will attack all other creatures, except members of its own species that ALSO have the CRAZED tag.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes) and EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens). A single creature can have multiple classes. Eligibility for certain entity positions can also be permitted or restricted by this tag.

|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets if the creature is active at twilight.

|-
| {{text anchor|CURIOUSBEAST_EATER}}
| Caste
|
| Allows a creature to steal and eat edible items from a site.

|-
| {{text anchor|CURIOUSBEAST_GUZZLER}}
| Caste
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to steal things (apparently the highest value it can find). If the creature goes on rampages in worldgen, it will often steal items instead of attacking. Kea birds are infamous for this.

|-
| {{text anchor|CV_ADD_TAG}}
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|DESCRIPTION}}
| Caste
| text
| A brief description of the creature type.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Dies upon attacking. Used for [[bee]] stings.

|-
| {{text anchor|DIFFICULTY}}
| Caste
| integer
| Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets if the creature is active in day.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| Found on [[peregrine falcon]]s. The creature hunts vermin by diving from the air. Does not seem to work on tame creatures.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Creature does not actually exist; used for a few [[fanciful]] creatures of myth.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|EBO_ITEM}}
| Caste
| [[item token]]:[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being butchered. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
| gem shape
| The shape of the extra item of the creature upon butchering. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will 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.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of eggs.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Civilizations with USE_EVIL_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when butchered (typically a gizzard stone), defined by EBO_ITEM and EBO_SHAPE.

|-
| {{text anchor|EXTRACT}}
| Caste
|
* [[material token]]
| Defines a creature extract which can be obtained via [[small animal dissection]].

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with {{token|COMMON_DOMESTIC|c}}

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on subterranean animal-man tribals.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|FEMALE}}
| Caste
|
| The creature is female and can bear young. Usually determined inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| The creature is immune to FIREBALL and FIREJET attacks.

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| The creature is immune to DRAGONFIRE attacks. Implies {{token|FIREIMMUNE|c}}.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| Needs to be cleaned at a fishery

|-
| {{text anchor|FIXED_TEMP}}
| Caste
| temperature
| The natural heat generated by the creature.

|-
| {{text anchor|FLEEQUICK}}
| Caste
|
| Determines how soon a creature flees in a losing battle. Creatures with this tag will flee at the first sign of resistance.

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. 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}}.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|GAIT}}
| Unknown
|
* type (WALK, CLIMB, SWIM, CRAWL, or FLY)
* gait name
* full speed
* build up time:max turning speed:start speed (or NO_BUILD_UP for instant use)
* energy use
* Optional flags:
** LAYERS_SLOW - if gait is slowed by increased weight
** STRENGTH - if gait is affected by strength stat
** AGILITY - if gait is affected by agility stat
** STEALTH_SLOWS:penalty - if gait is slowed by being stealthed
| Defines a gait at which the creature can move. See [[Gait]] for more information.

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
| singular:plural
| BABYNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
| singular:plural
| CHILDNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
| A:B
| Attacks against the creature have their force modified by A/B. For example, 1:2 will halve the force of an attack made against the creature. {{verify}}

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) [[titan]]s, [[Demon]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Creature can get infections from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| This creature's wounds can become infected if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's GLOWTILE.

|-
| {{text anchor|GLOWTILE}}
| Creature
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| {{text anchor|GNAWER}}
| Caste
| verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood). A former bug was fixed which prevented their escape{{bug|6117}} from non-artifact traps, but currently all gnawers brought onto the map by the elven caravans will automatically escape almost instantaneously from their wooden animal traps{{bug|6343}}.

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
| class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
| creature:caste
| The creature eats a specified vermin.

|-
| {{text anchor|GO_TO_END}}
| Special
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

|-
| {{text anchor|GO_TO_START}}
| Special
|
| When using tags from an existing creature, inserts new tags at the beginning of the creature.

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags after the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes. [[unicorn]]s for example. Civilizations with USE_GOOD_ANIMALS can domesticate them regardless of exotic status. Presumably has no effect on cavern creatures.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
| value
| The value determines how rapidly grass is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
| target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| 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. See [[Pasture]] for details on its issues.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|HABIT}}
| Caste
| type:probability
| 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, and COLLECT_WEALTH. These require the creature to have a lair to work properly, and also don't seem to work on creatures who are not (SEMI)MEGABEASTs or NIGHT_CREATURE_HUNTERs.

|-
| {{text anchor|HABIT_NUM}}
| Caste
| number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".<sup>[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]]</sup> All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

|-
| {{text anchor|HASSHELL}}
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

|-
| {{text anchor|HFID}}
| Creature
| Integer (generic token?)
| Found on generated [[angel]]s. Seemingly identifies a historical figure with said hist figure ID, possibly to associate it with hist figure.

|-
| {{text anchor|HIVE_PRODUCT}}
| Creature
|
*number
*[[time]]
*[[item token]]s
| What product is harvested from [[Beekeeping industry|beekeeping]].

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
| Default 'NONE'. The creature's normal body [[temperature]]

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby vermin.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in Fortress Mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen)

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates fire. It will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of certain materials. Due to a bug, however, they will only escape from [[artifact]]s.{{bug|6117}}

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for [CAN_SPEAK] + [CAN_LEARN].

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc.).

|-
| {{text anchor|ITEMCORPSE_QUALITY}}
| Caste
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|LAIR}}
| Caste
| type: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, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure 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."

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays eggs instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays a particular item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| Creature has ligaments in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| The creature will generate light, such as in adventurer mode at night.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz.")

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the range of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| {{text anchor|LOOSE_CLUSTERS}}
| Creature
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
| number
| Determines how well a creature can see in the dark. Higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|MAGICAL}}
| Caste
|
| Unknown.

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| Creature's able to see while covered in magma.

|-
| {{text anchor|MALE}}
| Caste
|
| The creature is male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
See [[Creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new material.{{verify}}

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*A:B
| Set the force multiplier of a specific material against the creature to A/B. For example, 10:1 multiplies the force by 10. {{verify}}

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets if the creature is active in dawn.

|-
| {{text anchor|MAXAGE}}
| Caste
| min:max
| Range of time in years in which death from old age may occur. Once a creature reaches the min value, it has a random chance each season of dying from old age. Unknown if the chance increases with further age.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Gives a creature random movement.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creature 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.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher:highest
| Sets up a mental attribute's range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Mental attribute gain/decay rates. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked in the farmer's workshop. The frequency is the amount of time units the creature needs to "recharge".

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for MISCHIEVOUS.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a mount. No use for the player, but enemy siegers may arrive with cavalry.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a mount, but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste {{Verify}}
|
| Allows the creature to have all-around vision as long as it has multiple heads(?) that can see. {{Verify}}

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes the species usually produce a single offspring per birth, occasionally producing twins or triplets using typical real-world human probabilities. Requires [[Creature_token#FEMALE|FEMALE]]. Compare with [[Creature_token#LITTERSIZE|LITTERSIZE]]. If LITTERSIZE and MULTIPLE_LITTER_RARE are both absent, one offspring is guaranteed per birth.

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|NAME}}
| Creature
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. Creatures with AT_PEACE_WITH_WILDLIFE will not fight with them.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of NATURAL.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
| [[Skill_token|Skill token]]:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. A value of 16 is legendary. Requires CAN_LEARN or INTELLIGENT to function in .25 or earlier.

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Found on bogeymen. Creatures with this tag will join other bogeymen in attacking adventurers at night, and will also adopt their other behaviors, such as vanishing in smoke upon being killed. This does not affect the creature's presence elsewhere, such as for generated megabeasts, normal creatures, entity members, etc. Setting the number of bogeyman types to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| 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. If this creature has SPOUSE_CONVERTER, 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 [[werebeast]]s 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.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| This creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become dizzy.

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to eat.

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer fevers.

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| Creature has no gender.

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The affected caste cannot gain any physical skills.

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The affected caste cannot lose any physical skills.

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| This creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| This creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the [THOUGHT] tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| This creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets if the creature is active in night.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| The creature has no emotions, and does not rage.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never run away from battle.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when butchered.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when butchered.

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butcher, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce miasma when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy.{{verify}} If this creature must eat and drink while playing, it WILL die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Cannot be butchered

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead.

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a [THOUGHT] body part to survive. If it does not have NO_THOUGHT_CENTER_FOR_MOVEMENT as well, it will be unable to use any attacks other than the default 'push'. Has the added effect of preventing speech.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==O==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
| number
| How easy the creature is to smell. The higher the number, the easier the creature can be smelled. Zero is odorless. Default is 50.

|-
| {{text anchor|ODOR_STRING}}
| Caste
| string
| What the creature smells like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones. Used for [[Undead]].

|-
| {{text anchor|ORIENTATION}}
| Caste
| MALE/FEMALE:disinterested chance:lover-possible chance:commitment-possible 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.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Currently only used by merchants without wagons. Also prevents creature from dropping hauled items on its own -- do not use for player-controllable creatures!

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all paralyzing special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Unknown. No creatures currently have this token.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate pearls. Does nothing in the current version.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations that encounter it in worldgen will tame and domesticate it for their own use.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations cannot domesticate it in worldgen without certain exceptions. More difficult to tame?{{verify}}

|-
| {{text anchor|PETVALUE}}
| Caste
| value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher: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.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Physical attribute gain/decay rates. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after SET_BP_GROUP.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after SELECT_MATERIAL.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
| min:max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity. 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.

|-
| {{text anchor|PREFSTRING}}
| Creature
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*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.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
| Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes badgers so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| The creature has pus. Specifies the stuff secreted by infected wounds.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
| singular:plural
| What creature's remains are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color creature's remains are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| 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.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from a creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*material token
| Removes a tissue from a creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part.

|-
| {{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 his feet. Requires HUNTS_VERMIN, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventure Mode, spawns vermin edible by this creature in Fortress Mode.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes.

|-
| {{text anchor|SECRETION}}
| Caste
|
* [[material token]]
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
*trigger
| creates a secreted material on given tissue on a given part of the body. Valid triggers are:
*CONTINUOUS
*EXTREME_EMOTION
*EXERTION

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used after SELECT_CASTE.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*caste name, or ALL
| selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*Material token
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as MEGABEAST, but more of them are created during worldgen.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* Creature class
* [[Tilesets|Tile]]
* [[Color|Color]]
| Allows creature to sense creatures with a certain creature class through walls, floors etc. Sense will be with tile and color specified.

|-
| {{text anchor|SET_BP_GROUP}}
| Caste
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| Begins a selection of body parts.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
| [[skill_token]]:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
| percentage
| The rate at which this creature learns all skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
| [[skill_token]]:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
| [[skill_token]]:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
| value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for [CAN_LEARN] + [SKILL_LEARN_RATES:50].{{verify}} Used for ogres and giants. Applicable to player races.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves a "remains" instead of a corpse. Used for vermin.

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
| value
| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature can will only graze or eat the designated plant or creature parts.

|-
| {{text anchor|SPEECH}}
| Creature
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in data\speech.

|-
| {{text anchor|SPEECH_FEMALE}}
| Creature
| speech file
| Boasting speeches relating to killing females of this creature.

|-
| {{text anchor|SPEECH_MALE}}
| Creature
| speech file
| Boasting speeches relating to killing males of this creature.

|-
| {{text anchor|SPHERE}}
| Creature
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the NIGHT_CREATURE_HUNTER tag, it will kidnap SPOUSE_CONVERSION_TARGETs and transform them into the caste of its species with the CONVERTED_SPOUSE tag during worldgen. It may also start families this way.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste {{verify}}
|
| Caste does not require GRASP body parts to climb -- it can climb with STANCE parts instead.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's webs can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
| name
| Begins defining a tissue in the creature file.

|-
| {{text anchor|TITAN}}
| Caste
|
| Found on [[titan]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
| COLOR:freq:COLOR:freq etc.
| Creates a list of color patterns, giving each a relative frequency.

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by stonesense for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be trained as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be trained as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into martial trances.

|-
| {{text anchor|TRAPAVOID}}
| Caste
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. A single argument may be used instead of min and max. Only magma creatures use 4 or 5 in the default raws. [[Demon]]s use only 5:5; user-defined creatures with both this depth and [FLIER] will take part in the initial wave from the HFS alongside generated demons. Without [FLIER], they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| Creature swims under the water and can't be seen. Seems to be a relic from the 2D era.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| Typically found on generated [[demon]]s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be specified in user-defined raws.

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a SKULKING civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|VEGETATION}}
| Caste
|
| The creature is made of swamp stuff. Used for [[grimeling]]s.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
| Vermin bites, and injects something.

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See PENETRATEPOWER. Distinct from VERMIN_ROTTER.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in water and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by fishing.

|-
| {{text anchor|VERMIN_NOROAM}}
| Caste
|
| The creature will not be observed randomly roaming about the map.

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Attracted to rotting stuff left in the open. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud.

|-
| {{text anchor|VERMIN_SOIL_COLONY}}
| Creature
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets if the creature is active in evening.

|-
| {{text anchor|VIEWRANGE}}
| Caste
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste {{Verify}}
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs. The first number is binocular vision, the second is non-binocular vision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create webs, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
| 2nd person:3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
| number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
| interaction
| When this attack lands successfully, an interaction with I_SOURCE:ATTACK will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying properties of previously defined tissues. (See also [[Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.
[SELECT_TISSUE_LAYER:SKIN:BY_TYPE:UPPERBODY]

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
| Sets a tissue layer to be made of a different tissue.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man:<br>
[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
| Seems to set new relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[Body detail plan token]]
*[[Body token]]
*[[Material definition token]]
*[[Syndrome]]
*[[Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

Level of conflict

2014-08-12T03:25:20Z

JT: horseplay + sparring

{{Quality|Tattered|16:06, 31 July 2014 (UTC)}}
{{av}}

Not all combat is Dwarf Fortress is lethal, to-the-death fighting. Several different '''levels of confict''' exist and are used in different circumstances.

In [[adventurer mode]], you can view the level of combat with any particular enemy with the {{k|l}}ook command.

== Levels ==
The levels revealed in the [[object testing arena]] are as follows:
* No quarter
* Lethal
* Non-lethal
* Brawl
* Training
* Horseplay
* Encounter

One other is commonly found in adventurer mode, despite that strictly speaking, it is not a level of conflict:
* Ally

=== No Quarter ===
An attacker who gives [[wikipedia:no quarter|no quarter]] will refuse to accept [[surrender]] or otherwise spare the life of an opponent, meaning the conflict will not end until either the opponent is dead or the attacker retreats. No-quarter mode is caused by either required kill [[ethic]]s (where surrendering would allow cheating the justice system), fighting with a non-sapient animal (which does not understand the concept of surrender), or the opponent faking surrender (so the attacker will not fall for such tricks again).

=== Lethal ===
Lethal combat is a fight to the death. Drawing weapons will escalate combat into lethality. Although death is likely in this mode of conflict, surrender may be accepted to end the fight.

Combat also escalates to lethal if you attempt to wrestle the opponent's throat (that is, any body part with the THROAT token). There is no way to place a chokehold on someone in Dwarf Fortress without it being considered a lethal fight, even if you intend to release them as soon as they lose consciousness. Although real-world police officers employ chokeholds with non-lethal intent, this is still probably correct behaviour: a real-life police officer will respond with deadly force if you attempt to choke them in return. (Please do not try this at home.)

=== Non-lethal ===
Non-lethal combat is a fight without weapons drawn. Non-lethal fights may end without killing a creature.

=== Brawl ===
A brawl occurs when one person attacks another with fists only, with no wrestling taking place. A common situation in which a brawl can be initiated is by punching someone who has spat at you.

=== Horseplay ===
In horseplay, participants will strike one another but will pull all of their blows, "lightly tapping the target". It has no clear difference from training and no presently known circumstance in which it can be initiated in either adventurer mode or dwarf fortress mode.

=== Training ===
Training is the mode used in sparring. In sparring, participants will use training weapons if they are available, and will "pull" their blows to inflict as little injury as possibly by "lightly tapping the target". A bug{{bug|7519}} related to participants not using their weapons when sparring was fixed in version 0.40.07.

Level of conflict

2014-08-12T02:00:43Z

JT: added brawl and clarified lethal; will still have to test horseplay in the arena to verify what it does (not available in adventure mode, AFAICT), and will have to verify sparring bug has been fixed as of 40.07

{{Quality|Tattered|16:06, 31 July 2014 (UTC)}}
{{av}}

Not all combat is Dwarf Fortress is lethal, to-the-death fighting. Several different '''levels of confict''' exist and are used in different circumstances.

In [[adventurer mode]], you can view the level of combat with any particular enemy with the {{k|l}}ook command.

== Levels ==
The levels revealed in the [[object testing arena]] are as follows:
* No quarter
* Lethal
* Non-lethal
* Brawl
* Training
* Horseplay
* Encounter

One other is commonly found in adventurer mode, despite that strictly speaking, it is not a level of conflict:
* Ally

=== No Quarter ===
An attacker who gives [[wikipedia:no quarter|no quarter]] will refuse to accept [[surrender]] or otherwise spare the life of an opponent, meaning the conflict will not end until either the opponent is dead or the attacker retreats. No-quarter mode is caused by either required kill [[ethic]]s (where surrendering would allow cheating the justice system), fighting with a non-sapient animal (which does not understand the concept of surrender), or the opponent faking surrender (so the attacker will not fall for such tricks again).

=== Lethal ===
Lethal combat is a fight to the death. Drawing weapons will escalate combat into lethality. Although death is likely in this mode of conflict, surrender may be accepted to end the fight.

Combat also escalates to lethal if you attempt to [[wrestle]] any body part with the THROAT token. There is no way to place a chokehold on someone in Dwarf Fortress without it being considered a lethal fight, even if you intend to release them as soon as they lose consciousness. Although real-world police officers employ chokeholds with non-lethal intent, this is still probably correct behaviour: a real-life police officer will respond with deadly force if you attempt to choke them in return. (Please do not try this at home.)

=== Non-lethal ===
Non-lethal combat is a fight without weapons drawn. Non-lethal fights may end without killing a creature.

=== Brawl ===
A brawl occurs when one person attacks another with fists only, with no wrestling taking place. A common situation in which a brawl can be initiated is by punching someone who has spat at you.

=== Training ===
Training is the mode used in sparring. Sparring is currently buggy as weapons are never drawn, as in non-lethal combats and brawls{{bug|7519}}, resulting in weapon-related skills never rising during sparring sessions.

User:JT/Token Wishlist

2014-08-09T11:18:22Z

JT: /* [SLEEP_INVERTED] */

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or ANY for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_NUMBER) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

=====''[SOULMATE]''=====

: This tag causes a species to have only one mate at a time. Once it has found a mate, it will remain with that mate, and it will not reproduce unless its mate is accessible. If its mate is killed or passes away naturally, it will receive an unhappy thought even if it is not an [INTELLIGENT] species, but it will then be capable of finding another mate. Most humanoids demonstrate this behaviour.

=====''[SOULMATE_PERMANENT]''=====

: This tag causes a species to seek only one mate during its lifetime. It will receive an indefinite unhappy thought when its soulmate dies, and will never again seek another mate. Seahorses fit this behaviour.

=====''[SEASONAL_REPRODUCTION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: This tag means that the species is only seasonally fertile, in that it will reproduce only in certain seasons; e.g., [SEASONAL_REPRODUCTION:SPRING]. When a fertile season begins, the animal resumes normal computation of its fertility cycles. When the season ends (and the next season is no longer fertile), the being is suppressed from mating; the fertility cycle counter halts, to resume from where it left off in the next fertile season.

: This allows limiting certain species' reproductive intervals to reduce overpopulation due to year-round reproduction.

: Default is [SEASONAL_REPRODUCTION:ANY].

=====''[TEMPERATE_REPRODUCTION:weather...]''=====

: '''Arguments:'''
:* ''season'': ANY; one or more of SCORCHING, HOT, WARM, TEMPERATE, COOL, COLD, or FREEZING, separated by colons; or a specific temperature range ''min'':''max'' in degrees Urist.

: e.g., [TEMPERATE_REPRODUCTION:ANY], [TEMPERATE_REPRODUCTION:SCORCHING:HOT:WARM], [TEMPERATE_REPRODUCTION:10000:10060]

: In addition to a blacklist based on SEASONAL_REPRODUCTION, a species may also have its fertility blacklist set to certain weather, to prevent it from reproducing in environmental conditions that are hostile to it or its offspring. It is intended more for fortress mode (and ostensibly adventure mode in the far future), to prevent species that have been imported from breeding successfully in hostile environments, as BIOME already serves as an adequate limiter on worldgen populations.

: Default is [TEMPERATE_REPRODUCTION:ANY].

=====''[CONDITIONAL_FERTILITY:population]''=====

: '''Arguments:'''
:* ''population'': The population limit of the species within the region.

: This tag allows a population to be conditionally fertile, based on its population number per unit area; if the population exceeds the specified number, all fertility cycles halt until the population falls. Aside from its metagame usefulness for controlling populations for better frame rates, it represents those species in reality which are genuinely capable of conditional fertility. As with other caps, it is a soft cap -- multiple births in a litter or pre-existing pregnancies can bring the population over the cap.

=====''[REPRODUCTION_FREQUENCY:days:duration]''=====

: '''Arguments:'''
:* ''days'': The number of days between subsequent fertility cycles.
:* ''duration'': The length of days (overlapping with the ''days'' parameter) during which the animal is fertile.

: This controls the frequency of a species' reproductive cycles, blacklisting animals from becoming pregnant outside of their fertility periods.

: For code simplicity, since the oestrus event itself wouldn't simulated (although simulating it would be of particular realism interest for keen-sensed animals, especially bloodthirsty animals like sharks or ''Pitch Black''-style blind predators), it would be easier just to make the "fertile" period begin immediately when the cycle begins, rather than halfway through.

: The default is the standard human 28-day cycle, [REPRODUCTION_FREQUENCY:28:5] -- the female is fertile for 5 days out of every 28-day period. If a fertility check falls on this interval... congratulations!

=====''[REPRODUCTION_SUCCESS:permille]''=====

: '''Arguments:'''
:* ''permille'': Chance of becoming pregnant on a pregnancy check.

: This allows finer control over successful reproduction even when blacklisting based on season, temperature/climate, fertility cycle, and population are taken into account, to allow species that tend to reproduce too quickly to be fine-tuned for greater realism.

: Default is whatever the current pregnancy chance is set to, which is probably buried deeply in the code somewhere...

===General Tokens===

=====''[BRACHIATOR:frequency]]''=====

: Arguments:
:* ''frequency'': Percentage of time preferably spent in trees

: A brachiating creature will prefer to climb and jump versus travelling over open ground, although it will occasionally climb down to ground level during random wandering or foraging, or if there are no more trees available in a given direction. It will also automatically succeed in grasping any tree branch in its own tile, regardless of climbing skill. Intended for chimpanzees and tree squirrels.

=====''[ARBOREAL]]''=====

: An arboreal creature will climb trees during random movement, and will prefer to flee into trees to avoid danger, climbing back down when safe. Intended for cats.

=====''[CLIMBER]''=====

: A climber is similar to an arboreal, but will randomly climb ''any'' surface -- e.g., cliff faces -- rather than trees only.

=====''[GAIT:GLIDE:...]''=====

: A gliding gait (taking the same arguments as a typical gait) gives a creature the ability to glide. It cannot fly up (optionally: unless it builds up momentum?), but can fly laterally or choose to descend faster, decreasing in altitude every 100(?) ticks. A gliding lifeform will also never hurt itself when gliding onto ground level unless it is stunned in mid-air. Intended for flying squirrels.

=====''[FLYING_HEIGHT:height]''=====

: Arguments:
:* ''height'': The desired height for the flying creature to maintain, as a matter of preference.

: This controls the altitude that the creature (caste?) will prefer to maintain. Smaller birds will tend to remain closer to ground level except when a predator threatens them, whereas raptors will prefer to remain higher for better sight lines.

=====''[MIN_AIRSPEED:velocity]''=====

: Arguments:
:* ''velocity'': Minimum airspeed velocity in millimetres per second.

: The creature must maintain the specified airspeed (1000 = Adventure Mode 1.0). If the creature becomes tired due to flight, it will attempt to find somewhere to land.

=====''[STANCE_GRIP:angle]''=====

: Arguments:
:* ''angle'': STANDARD, LATERAL, or INVERTED.

: The creature has the ability to ''grip'' onto any surface with its STANCE parts, but is unable to ''climb''. In other words, it can fly into any tile, then choose to "hold on", and can then choose to "release hold" and fly away, but it cannot move to another tile while holding on.

: If the creature has STANCE_GRIP:STANDARD, it can hold onto its own tile. If the creature has STANCE_GRIP:LATERAL, it can hold onto its own tile or onto any adjacent tile in the eight cardinal directions. If the creature has STANCE_GRIP:INVERTED, it can hold onto its own tile, any adjacent tile, or the tile directly above.

=====''[SLEEP_ROOST]''=====

: The creature will prefer to find tree branches to roost in, preferring higher branches over lower ones. It is able to sleep in tree branches without falling out. Implies STANCE_GRIP:STANDARD (does not imply STANCE_CLIMBER). Intended for most avians.

=====''[SLEEP_STANDING]''=====

: The creature has locking joints that allow it to sleep while standing up, instead of having to lie down. Intended for most equines.

=====''[SLEEP_INVERTED]''=====

: The creature prefers to sleep on ceilings and against wall surfaces in open spaces that are at least 2 Z levels above any floor. It has locking claws that allow it to sleep without falling off the surface it is hanging on. Implies STANCE_GRIP:INVERTED. Intended for bats.

=====''[TUMBLE:altitude]''=====

: Arguments:
:* ''altitude'': The number of Z levels that can be fallen.

: A creature that can tumble can fall the specified number of Z levels without coming to harm. Intended for cats.

=====''[HIBERNATION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: A species which hibernates will not spawn on the map outside of the valid seasons -- it will remain comfortably within the site populations instead. Species which hibernate will automatically go to sleep during fortress mode and remain asleep, requiring no food or water, until the end of the season. At the end of the season, however, they will be set automatically to Hungry and Thirsty and will seek food to eat. (Though many species which hibernate remain awake, and do eat and drink while hibernating, this implementation is far simpler to simulate.)

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=====''[APPLY_CASTE_VARIATION:variation]''=====

: '''Arguments:'''
:* ''variation'': The creature variation to apply to this specific caste (i.e., not affecting any other caste).

: APPLY_CREATURE_VARIATION currently affects all castes, which doesn't suit gender dimorphism too well. It would be great if there were a way to apply a creature variation to the currently selected caste instead of implicitly affecting the "all" caste.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Creature Variation Tokens ==

=====''[CVCT_APPEND:...]'' =====

: '''Arguments:'''
:* ''...'': Colon-separated list of additional parameters to append to end of CVCT_MASTER token's parameters

: As a fundamental improvement on my former ADD_BODY_TAG request, this would make use of existing CVCT functionality to allow appending parameters to existing tokens, with particular intention for use with a CVCT_MASTER:BODY (but fundamentally it should work with any tag, except perhaps for reciprocal creature variation tags). There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers ''unless I replace one of those existing body parts with itself while doing so''); this currently means that your creature variation tag must cover all possible usage scenarios instead of being properly generic -- i.e., instead of simply adding tags to the BODY, it has to target BASIC_1PARTBODY, BASIC_2PARTBODY, HUMANOID, HUMANOID_NECK, HUMANOID_HOOF, HUMANOID_NECK_HOOF, etc., etc.... The proposed new tag would neatly avoid that by allowing you to add any body part scot free, without worrying about what body parts are already there, proviso that you don't create an invalid body (which would simply appear in errorlog.txt as normal).

: Note in particular that this would vastly simplify such things as sheep:

[CREATURE_VARIATION:BASIC_2HORNS]
[CV_CONVERT_TAG]
[CVCT_MASTER:BODY]
[CVCT_APPEND:2HEAD_HORN]

: Instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then a CREATURE_VARIATION could be applied to the male caste, [APPLY_CREATURE_VARIATION:BASIC_2HORNS]. The fact that such a tag would be generically useful for such things as demon variations of humanoids, etc. is also of note.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

The less squicky version of this feature would simply implement the ability to spay/neuter animals or castrate historical figures by flagging the hist fig, without actually requiring all of the naughty bits to be simulated...

User:JT/Token Wishlist

2014-08-09T11:16:43Z

JT: /* [REPRODUCTIVE_CONTRIBUTE] / [REPRODUCTIVE] */ not sure why I didn't think of this first

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or ANY for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_NUMBER) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

=====''[SOULMATE]''=====

: This tag causes a species to have only one mate at a time. Once it has found a mate, it will remain with that mate, and it will not reproduce unless its mate is accessible. If its mate is killed or passes away naturally, it will receive an unhappy thought even if it is not an [INTELLIGENT] species, but it will then be capable of finding another mate. Most humanoids demonstrate this behaviour.

=====''[SOULMATE_PERMANENT]''=====

: This tag causes a species to seek only one mate during its lifetime. It will receive an indefinite unhappy thought when its soulmate dies, and will never again seek another mate. Seahorses fit this behaviour.

=====''[SEASONAL_REPRODUCTION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: This tag means that the species is only seasonally fertile, in that it will reproduce only in certain seasons; e.g., [SEASONAL_REPRODUCTION:SPRING]. When a fertile season begins, the animal resumes normal computation of its fertility cycles. When the season ends (and the next season is no longer fertile), the being is suppressed from mating; the fertility cycle counter halts, to resume from where it left off in the next fertile season.

: This allows limiting certain species' reproductive intervals to reduce overpopulation due to year-round reproduction.

: Default is [SEASONAL_REPRODUCTION:ANY].

=====''[TEMPERATE_REPRODUCTION:weather...]''=====

: '''Arguments:'''
:* ''season'': ANY; one or more of SCORCHING, HOT, WARM, TEMPERATE, COOL, COLD, or FREEZING, separated by colons; or a specific temperature range ''min'':''max'' in degrees Urist.

: e.g., [TEMPERATE_REPRODUCTION:ANY], [TEMPERATE_REPRODUCTION:SCORCHING:HOT:WARM], [TEMPERATE_REPRODUCTION:10000:10060]

: In addition to a blacklist based on SEASONAL_REPRODUCTION, a species may also have its fertility blacklist set to certain weather, to prevent it from reproducing in environmental conditions that are hostile to it or its offspring. It is intended more for fortress mode (and ostensibly adventure mode in the far future), to prevent species that have been imported from breeding successfully in hostile environments, as BIOME already serves as an adequate limiter on worldgen populations.

: Default is [TEMPERATE_REPRODUCTION:ANY].

=====''[CONDITIONAL_FERTILITY:population]''=====

: '''Arguments:'''
:* ''population'': The population limit of the species within the region.

: This tag allows a population to be conditionally fertile, based on its population number per unit area; if the population exceeds the specified number, all fertility cycles halt until the population falls. Aside from its metagame usefulness for controlling populations for better frame rates, it represents those species in reality which are genuinely capable of conditional fertility. As with other caps, it is a soft cap -- multiple births in a litter or pre-existing pregnancies can bring the population over the cap.

=====''[REPRODUCTION_FREQUENCY:days:duration]''=====

: '''Arguments:'''
:* ''days'': The number of days between subsequent fertility cycles.
:* ''duration'': The length of days (overlapping with the ''days'' parameter) during which the animal is fertile.

: This controls the frequency of a species' reproductive cycles, blacklisting animals from becoming pregnant outside of their fertility periods.

: For code simplicity, since the oestrus event itself wouldn't simulated (although simulating it would be of particular realism interest for keen-sensed animals, especially bloodthirsty animals like sharks or ''Pitch Black''-style blind predators), it would be easier just to make the "fertile" period begin immediately when the cycle begins, rather than halfway through.

: The default is the standard human 28-day cycle, [REPRODUCTION_FREQUENCY:28:5] -- the female is fertile for 5 days out of every 28-day period. If a fertility check falls on this interval... congratulations!

=====''[REPRODUCTION_SUCCESS:permille]''=====

: '''Arguments:'''
:* ''permille'': Chance of becoming pregnant on a pregnancy check.

: This allows finer control over successful reproduction even when blacklisting based on season, temperature/climate, fertility cycle, and population are taken into account, to allow species that tend to reproduce too quickly to be fine-tuned for greater realism.

: Default is whatever the current pregnancy chance is set to, which is probably buried deeply in the code somewhere...

===General Tokens===

=====''[BRACHIATOR:frequency]]''=====

: Arguments:
:* ''frequency'': Percentage of time preferably spent in trees

: A brachiating creature will prefer to climb and jump versus travelling over open ground, although it will occasionally climb down to ground level during random wandering or foraging, or if there are no more trees available in a given direction. It will also automatically succeed in grasping any tree branch in its own tile, regardless of climbing skill. Intended for chimpanzees and tree squirrels.

=====''[ARBOREAL]]''=====

: An arboreal creature will climb trees during random movement, and will prefer to flee into trees to avoid danger, climbing back down when safe. Intended for cats.

=====''[CLIMBER]''=====

: A climber is similar to an arboreal, but will randomly climb ''any'' surface -- e.g., cliff faces -- rather than trees only.

=====''[GAIT:GLIDE:...]''=====

: A gliding gait (taking the same arguments as a typical gait) gives a creature the ability to glide. It cannot fly up (optionally: unless it builds up momentum?), but can fly laterally or choose to descend faster, decreasing in altitude every 100(?) ticks. A gliding lifeform will also never hurt itself when gliding onto ground level unless it is stunned in mid-air. Intended for flying squirrels.

=====''[FLYING_HEIGHT:height]''=====

: Arguments:
:* ''height'': The desired height for the flying creature to maintain, as a matter of preference.

: This controls the altitude that the creature (caste?) will prefer to maintain. Smaller birds will tend to remain closer to ground level except when a predator threatens them, whereas raptors will prefer to remain higher for better sight lines.

=====''[MIN_AIRSPEED:velocity]''=====

: Arguments:
:* ''velocity'': Minimum airspeed velocity in millimetres per second.

: The creature must maintain the specified airspeed (1000 = Adventure Mode 1.0). If the creature becomes tired due to flight, it will attempt to find somewhere to land.

=====''[STANCE_GRIP:angle]''=====

: Arguments:
:* ''angle'': STANDARD, LATERAL, or INVERTED.

: The creature has the ability to ''grip'' onto any surface with its STANCE parts, but is unable to ''climb''. In other words, it can fly into any tile, then choose to "hold on", and can then choose to "release hold" and fly away, but it cannot move to another tile while holding on.

: If the creature has STANCE_GRIP:STANDARD, it can hold onto its own tile. If the creature has STANCE_GRIP:LATERAL, it can hold onto its own tile or onto any adjacent tile in the eight cardinal directions. If the creature has STANCE_GRIP:INVERTED, it can hold onto its own tile, any adjacent tile, or the tile directly above.

=====''[SLEEP_ROOST]''=====

: The creature will prefer to find tree branches to roost in, preferring higher branches over lower ones. It is able to sleep in tree branches without falling out. Implies STANCE_GRIP:STANDARD (does not imply STANCE_CLIMBER). Intended for most avians.

=====''[SLEEP_STANDING]''=====

: The creature has locking joints that allow it to sleep while standing up, instead of having to lie down. Intended for most equines.

=====''[SLEEP_INVERTED]''=====

: The creature prefers to sleep on ceilings and against wall surfaces in open spaces that are at 2 Z levels above any floor. It has locking claws that allow it to sleep without falling off the surface it is hanging on. Implies STANCE_GRIP:INVERTED. Intended for bats.

=====''[TUMBLE:altitude]''=====

: Arguments:
:* ''altitude'': The number of Z levels that can be fallen.

: A creature that can tumble can fall the specified number of Z levels without coming to harm. Intended for cats.

=====''[HIBERNATION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: A species which hibernates will not spawn on the map outside of the valid seasons -- it will remain comfortably within the site populations instead. Species which hibernate will automatically go to sleep during fortress mode and remain asleep, requiring no food or water, until the end of the season. At the end of the season, however, they will be set automatically to Hungry and Thirsty and will seek food to eat. (Though many species which hibernate remain awake, and do eat and drink while hibernating, this implementation is far simpler to simulate.)

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=====''[APPLY_CASTE_VARIATION:variation]''=====

: '''Arguments:'''
:* ''variation'': The creature variation to apply to this specific caste (i.e., not affecting any other caste).

: APPLY_CREATURE_VARIATION currently affects all castes, which doesn't suit gender dimorphism too well. It would be great if there were a way to apply a creature variation to the currently selected caste instead of implicitly affecting the "all" caste.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Creature Variation Tokens ==

=====''[CVCT_APPEND:...]'' =====

: '''Arguments:'''
:* ''...'': Colon-separated list of additional parameters to append to end of CVCT_MASTER token's parameters

: As a fundamental improvement on my former ADD_BODY_TAG request, this would make use of existing CVCT functionality to allow appending parameters to existing tokens, with particular intention for use with a CVCT_MASTER:BODY (but fundamentally it should work with any tag, except perhaps for reciprocal creature variation tags). There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers ''unless I replace one of those existing body parts with itself while doing so''); this currently means that your creature variation tag must cover all possible usage scenarios instead of being properly generic -- i.e., instead of simply adding tags to the BODY, it has to target BASIC_1PARTBODY, BASIC_2PARTBODY, HUMANOID, HUMANOID_NECK, HUMANOID_HOOF, HUMANOID_NECK_HOOF, etc., etc.... The proposed new tag would neatly avoid that by allowing you to add any body part scot free, without worrying about what body parts are already there, proviso that you don't create an invalid body (which would simply appear in errorlog.txt as normal).

: Note in particular that this would vastly simplify such things as sheep:

[CREATURE_VARIATION:BASIC_2HORNS]
[CV_CONVERT_TAG]
[CVCT_MASTER:BODY]
[CVCT_APPEND:2HEAD_HORN]

: Instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then a CREATURE_VARIATION could be applied to the male caste, [APPLY_CREATURE_VARIATION:BASIC_2HORNS]. The fact that such a tag would be generically useful for such things as demon variations of humanoids, etc. is also of note.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

The less squicky version of this feature would simply implement the ability to spay/neuter animals or castrate historical figures by flagging the hist fig, without actually requiring all of the naughty bits to be simulated...

User:JT/Token Wishlist

2014-08-09T11:15:04Z

JT: BRACHIATOR, ARBOREAL, CLIMBER, GAIT:GLIDE, FLYING_HEIGHT, MIN_AIRSPEED, STANCE_GRIP, SLEEP_ROOST, SLEEP_STANDING, SLEEP_INVERTED, TUMBLE

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or ANY for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_NUMBER) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

=====''[SOULMATE]''=====

: This tag causes a species to have only one mate at a time. Once it has found a mate, it will remain with that mate, and it will not reproduce unless its mate is accessible. If its mate is killed or passes away naturally, it will receive an unhappy thought even if it is not an [INTELLIGENT] species, but it will then be capable of finding another mate. Most humanoids demonstrate this behaviour.

=====''[SOULMATE_PERMANENT]''=====

: This tag causes a species to seek only one mate during its lifetime. It will receive an indefinite unhappy thought when its soulmate dies, and will never again seek another mate. Seahorses fit this behaviour.

=====''[SEASONAL_REPRODUCTION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: This tag means that the species is only seasonally fertile, in that it will reproduce only in certain seasons; e.g., [SEASONAL_REPRODUCTION:SPRING]. When a fertile season begins, the animal resumes normal computation of its fertility cycles. When the season ends (and the next season is no longer fertile), the being is suppressed from mating; the fertility cycle counter halts, to resume from where it left off in the next fertile season.

: This allows limiting certain species' reproductive intervals to reduce overpopulation due to year-round reproduction.

: Default is [SEASONAL_REPRODUCTION:ANY].

=====''[TEMPERATE_REPRODUCTION:weather...]''=====

: '''Arguments:'''
:* ''season'': ANY; one or more of SCORCHING, HOT, WARM, TEMPERATE, COOL, COLD, or FREEZING, separated by colons; or a specific temperature range ''min'':''max'' in degrees Urist.

: e.g., [TEMPERATE_REPRODUCTION:ANY], [TEMPERATE_REPRODUCTION:SCORCHING:HOT:WARM], [TEMPERATE_REPRODUCTION:10000:10060]

: In addition to a blacklist based on SEASONAL_REPRODUCTION, a species may also have its fertility blacklist set to certain weather, to prevent it from reproducing in environmental conditions that are hostile to it or its offspring. It is intended more for fortress mode (and ostensibly adventure mode in the far future), to prevent species that have been imported from breeding successfully in hostile environments, as BIOME already serves as an adequate limiter on worldgen populations.

: Default is [TEMPERATE_REPRODUCTION:ANY].

=====''[CONDITIONAL_FERTILITY:population]''=====

: '''Arguments:'''
:* ''population'': The population limit of the species within the region.

: This tag allows a population to be conditionally fertile, based on its population number per unit area; if the population exceeds the specified number, all fertility cycles halt until the population falls. Aside from its metagame usefulness for controlling populations for better frame rates, it represents those species in reality which are genuinely capable of conditional fertility. As with other caps, it is a soft cap -- multiple births in a litter or pre-existing pregnancies can bring the population over the cap.

=====''[REPRODUCTION_FREQUENCY:days:duration]''=====

: '''Arguments:'''
:* ''days'': The number of days between subsequent fertility cycles.
:* ''duration'': The length of days (overlapping with the ''days'' parameter) during which the animal is fertile.

: This controls the frequency of a species' reproductive cycles, blacklisting animals from becoming pregnant outside of their fertility periods.

: For code simplicity, since the oestrus event itself wouldn't simulated (although simulating it would be of particular realism interest for keen-sensed animals, especially bloodthirsty animals like sharks or ''Pitch Black''-style blind predators), it would be easier just to make the "fertile" period begin immediately when the cycle begins, rather than halfway through.

: The default is the standard human 28-day cycle, [REPRODUCTION_FREQUENCY:28:5] -- the female is fertile for 5 days out of every 28-day period. If a fertility check falls on this interval... congratulations!

=====''[REPRODUCTION_SUCCESS:permille]''=====

: '''Arguments:'''
:* ''permille'': Chance of becoming pregnant on a pregnancy check.

: This allows finer control over successful reproduction even when blacklisting based on season, temperature/climate, fertility cycle, and population are taken into account, to allow species that tend to reproduce too quickly to be fine-tuned for greater realism.

: Default is whatever the current pregnancy chance is set to, which is probably buried deeply in the code somewhere...

===General Tokens===

=====''[BRACHIATOR:frequency]]''=====

: Arguments:
:* ''frequency'': Percentage of time preferably spent in trees

: A brachiating creature will prefer to climb and jump versus travelling over open ground, although it will occasionally climb down to ground level during random wandering or foraging, or if there are no more trees available in a given direction. It will also automatically succeed in grasping any tree branch in its own tile, regardless of climbing skill. Intended for chimpanzees and tree squirrels.

=====''[ARBOREAL]]''=====

: An arboreal creature will climb trees during random movement, and will prefer to flee into trees to avoid danger, climbing back down when safe. Intended for cats.

=====''[CLIMBER]''=====

: A climber is similar to an arboreal, but will randomly climb ''any'' surface -- e.g., cliff faces -- rather than trees only.

=====''[GAIT:GLIDE:...]''=====

: A gliding gait (taking the same arguments as a typical gait) gives a creature the ability to glide. It cannot fly up (optionally: unless it builds up momentum?), but can fly laterally or choose to descend faster, decreasing in altitude every 100(?) ticks. A gliding lifeform will also never hurt itself when gliding onto ground level unless it is stunned in mid-air. Intended for flying squirrels.

=====''[FLYING_HEIGHT:height]''=====

: Arguments:
:* ''height'': The desired height for the flying creature to maintain, as a matter of preference.

: This controls the altitude that the creature (caste?) will prefer to maintain. Smaller birds will tend to remain closer to ground level except when a predator threatens them, whereas raptors will prefer to remain higher for better sight lines.

=====''[MIN_AIRSPEED:velocity]''=====

: Arguments:
:* ''velocity'': Minimum airspeed velocity in millimetres per second.

: The creature must maintain the specified airspeed (1000 = Adventure Mode 1.0). If the creature becomes tired due to flight, it will attempt to find somewhere to land.

=====''[STANCE_GRIP:angle]''=====

: Arguments:
:* ''angle'': STANDARD, LATERAL, or INVERTED.

: The creature has the ability to ''grip'' onto any surface with its STANCE parts, but is unable to ''climb''. In other words, it can fly into any tile, then choose to "hold on", and can then choose to "release hold" and fly away, but it cannot move to another tile while holding on.

: If the creature has STANCE_GRIP:STANDARD, it can hold onto its own tile. If the creature has STANCE_GRIP:LATERAL, it can hold onto its own tile or onto any adjacent tile in the eight cardinal directions. If the creature has STANCE_GRIP:INVERTED, it can hold onto its own tile, any adjacent tile, or the tile directly above.

=====''[SLEEP_ROOST]''=====

: The creature will prefer to find tree branches to roost in, preferring higher branches over lower ones. It is able to sleep in tree branches without falling out. Implies STANCE_GRIP:STANDARD (does not imply STANCE_CLIMBER). Intended for most avians.

=====''[SLEEP_STANDING]''=====

: The creature has locking joints that allow it to sleep while standing up, instead of having to lie down. Intended for most equines.

=====''[SLEEP_INVERTED]''=====

: The creature prefers to sleep on ceilings and against wall surfaces in open spaces that are at 2 Z levels above any floor. It has locking claws that allow it to sleep without falling off the surface it is hanging on. Implies STANCE_GRIP:INVERTED. Intended for bats.

=====''[TUMBLE:altitude]''=====

: Arguments:
:* ''altitude'': The number of Z levels that can be fallen.

: A creature that can tumble can fall the specified number of Z levels without coming to harm. Intended for cats.

=====''[HIBERNATION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: A species which hibernates will not spawn on the map outside of the valid seasons -- it will remain comfortably within the site populations instead. Species which hibernate will automatically go to sleep during fortress mode and remain asleep, requiring no food or water, until the end of the season. At the end of the season, however, they will be set automatically to Hungry and Thirsty and will seek food to eat. (Though many species which hibernate remain awake, and do eat and drink while hibernating, this implementation is far simpler to simulate.)

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=====''[APPLY_CASTE_VARIATION:variation]''=====

: '''Arguments:'''
:* ''variation'': The creature variation to apply to this specific caste (i.e., not affecting any other caste).

: APPLY_CREATURE_VARIATION currently affects all castes, which doesn't suit gender dimorphism too well. It would be great if there were a way to apply a creature variation to the currently selected caste instead of implicitly affecting the "all" caste.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Creature Variation Tokens ==

=====''[CVCT_APPEND:...]'' =====

: '''Arguments:'''
:* ''...'': Colon-separated list of additional parameters to append to end of CVCT_MASTER token's parameters

: As a fundamental improvement on my former ADD_BODY_TAG request, this would make use of existing CVCT functionality to allow appending parameters to existing tokens, with particular intention for use with a CVCT_MASTER:BODY (but fundamentally it should work with any tag, except perhaps for reciprocal creature variation tags). There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers ''unless I replace one of those existing body parts with itself while doing so''); this currently means that your creature variation tag must cover all possible usage scenarios instead of being properly generic -- i.e., instead of simply adding tags to the BODY, it has to target BASIC_1PARTBODY, BASIC_2PARTBODY, HUMANOID, HUMANOID_NECK, HUMANOID_HOOF, HUMANOID_NECK_HOOF, etc., etc.... The proposed new tag would neatly avoid that by allowing you to add any body part scot free, without worrying about what body parts are already there, proviso that you don't create an invalid body (which would simply appear in errorlog.txt as normal).

: Note in particular that this would vastly simplify such things as sheep:

[CREATURE_VARIATION:BASIC_2HORNS]
[CV_CONVERT_TAG]
[CVCT_MASTER:BODY]
[CVCT_APPEND:2HEAD_HORN]

: Instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then a CREATURE_VARIATION could be applied to the male caste, [APPLY_CREATURE_VARIATION:BASIC_2HORNS]. The fact that such a tag would be generically useful for such things as demon variations of humanoids, etc. is also of note.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

Kennel

2014-07-29T23:40:39Z

JT: and another... should be enough for superior again, and de-migrated

{{Quality|Superior|23:40, 29 July 2014 (UTC)}}

{{Building|name=Kennel|key=k
|job=
1 of
* [[Animal training]]
* [[Trapping]]
|construction=
* [[Building material]] (non-[[economic]])
|construction_job=
1 of
* [[Animal training]]
* [[Small animal dissection]]
* [[Trapping]]
|purpose=
* Capture [[Vermin]]
* [[Tame]] [[Vermin]]
}}

{{av}}

A '''Kennel''' is a large 5x5 [[workshop]] for an [[animal trainer]]. To build a kennel you need one building material ([[wood]], [[stone]], [[metal]] [[bar]]) and a dwarf who has the [[animal training]], [[Animal dissector|small animal dissection]] and/or [[trapping]] [[skill]]s enabled.

''(Note that the '''[[labor]]''' associated with the [[skill]] "[[small animal dissection]]" is used solely at a [[butcher's shop]](namely "Extract from a dead animal"). But that '''skill''' is one of the three that can build a kennel, and is listed as such. Just accept it.)''

Kennels allow the capturing of small animals ([[vermin]]) with an animal trap, like a [[butcher's shop]]. The kennels also allow animal trainers to tame these small animals. In a previous version the taming and training of large animals such as [[dog]]s was also done at a kennel, but these tasks are now performed at an animal training [[activity zone]].

==Kennel Tasks==

===Capture a Live Land Animal===
Requires: An [[animal trap]] and a [[trapper]].

This task directs the trapper to attempt to capture [[vermin]] with the animal trap. The trapper will carry the animal trap around the fortress, chasing actual [[vermin]] creatures that exist in the fortress but are not rendered on the screen, and will catch one once it reaches it. Once the vermin creature is successfully caught, the trap will be dropped, and then hauled to an animal [[stockpile]] by anyone with the [[hauling#Animal_hauling|animal hauling]] labour. Any animal caught in a trap will be identified as "live": for example, a "live rat", a "live rhino lizard", or a "live caphopper". These animals can be eaten by any dwarves as a delicacy, or can be tamed for adoption using the task below.

Note that [[gnawer|gnawing]] vermin will quickly escape from non-artifact wooden animal traps after being caught, and also note that there is no way to enforce using only non-wooden traps to catch gnawers, other than ensuring that they are the only traps available. Wooden animal traps do work fine for non-gnawing vermin.

===Tame a Small Animal===
Requires: An [[animal trainer]] and trapped "live" vermin.

This task is used to tame caged vermin for adoption as pets; if a live vermin is not tamed as a pet, it may eventually be eaten by a dwarf as a form of exotic cuisine (even things that would make most people cringe, such as hamsters, lizards, and worms). Vermin can only be tamed if they are in an animal trap and not a [[cage]]. If a vermin you want to train is in a cage, it can be unassigned from the cage, and a recapture task to put it back into an animal trap will be generated automatically.




{{buildings}}

Kennel

2014-07-29T23:37:57Z

JT: fixed redlink

{{Quality|Fine|22:44, 29 July 2014 (UTC)}}
{{Migrated_article}}

{{Building|name=Kennel|key=k
|job=
1 of
* [[Animal training]]
* [[Trapping]]
|construction=
* [[Building material]] (non-[[economic]])
|construction_job=
1 of
* [[Animal training]]
* [[Small animal dissection]]
* [[Trapping]]
|purpose=
* Capture [[Vermin]]
* [[Tame]] [[Vermin]]
}}

{{av}}

A '''Kennel''' is a large 5x5 [[workshop]] for an [[animal trainer]]. To build a kennel you need one building material ([[wood]], [[stone]], [[metal]] [[bar]]) and a dwarf who has the [[animal training]], [[Animal dissector|small animal dissection]] and/or [[trapping]] [[skills]] enabled.

''(Note that the '''[[labor]]''' associated with the [[skill]] "[[small animal dissection]]" is used solely at a [[butcher's shop]](namely "Extract from a dead animal"). But that '''skill''' is one of the three that can build a kennel, and is listed as such. Just accept it.)''

Kennels allow the capturing of small animals ([[vermin]]) with an animal trap, like a [[butcher's shop]]. The kennels also allow animal trainers to tame these small animals. In a previous version the taming and training of large animals such as [[dog]]s was also done at a kennel, but these tasks are now performed at an animal training [[activity zone]].

==Kennel Tasks==

===Capture a Live Land Animal===
Requires: An [[animal trap]] and a [[trapper]].

This task directs the trapper to attempt to capture [[vermin]] with the animal trap. The trapper will carry the animal trap around the fortress, chasing actual [[vermin]] creatures that exist in the fortress but are not rendered on the screen, and will catch one once it reaches it. Once the vermin creature is successfully caught, the trap will be dropped, and then hauled to an animal [[stockpile]] by anyone with the [[hauling#Animal_hauling|animal hauling]] labour. Any animal caught in a trap will be identified as "live": for example, a "live rat", a "live rhino lizard", or a "live caphopper". These animals can be eaten by any dwarves as a delicacy, or can be tamed for adoption using the task below.

Note that [[gnawer|gnawing]] vermin will quickly escape from non-artifact wooden animal traps after being caught, and also note that there is no way to enforce using only non-wooden traps to catch gnawers, other than ensuring that they are the only traps available. Wooden animal traps do work fine for non-gnawing vermin.

===Tame a Small Animal===
Requires: An [[animal trainer]] and trapped "live" vermin.

This task is used to tame caged vermin for adoption as pets; if a live vermin is not tamed as a pet, it may eventually be eaten by a dwarf as a form of exotic cuisine (even things that would make most people cringe, such as hamsters, lizards, and worms). Vermin can only be tamed if they are in an animal trap and not a [[cage]]. If a vermin you want to train is in a cage, it can be unassigned from the cage, and a recapture task to put it back into an animal trap will be generated automatically.




{{buildings}}

Kennel

2014-07-29T23:10:54Z

JT: my attempts at improvement, also trying to get rid of some of the tutorial/too-offhandedly-casual nature of the article

{{Quality|Fine|22:44, 29 July 2014 (UTC)}}
{{Migrated_article}}

{{Building|name=Kennel|key=k
|job=
1 of
* [[Animal training]]
* [[Trapping]]
|construction=
* [[Building material]] (non-[[economic]])
|construction_job=
1 of
* [[Animal training]]
* [[Small animal dissection]]
* [[Trapping]]
|purpose=
* Capture [[Vermin]]
* [[Tame]] [[Vermin]]
}}

{{av}}

A '''Kennel''' is a large 5x5 [[workshop]] for an [[animal trainer]]. To build a kennel you need one building material ([[wood]], [[stone]], [[metal]] [[bar]]) and a dwarf who has the [[animal training]], [[Animal dissector|small animal dissection]] and/or [[trapping]] [[skills]] enabled.

''(Note that the '''[[labor]]''' associated with the [[skill]] "[[small animal dissection]]" is used solely at a [[butcher's shop]](namely "Extract from a dead animal"). But that '''skill''' is one of the three that can build a kennel, and is listed as such. Just accept it.)''

Kennels allow the capturing of small animals ([[vermin]]) with an animal trap, like a [[butcher's shop]]. The kennels also allow animal trainers to tame these small animals. In a previous version the taming and training of large animals such as [[dogs]] was also done at a kennel, but these tasks are now performed at an animal training [[activity zone]].

==Kennel Tasks==

===Capture a Live Land Animal===
Requires: An [[animal trap]] and a [[trapper]].

This task directs the trapper to attempt to capture [[vermin]] with the animal trap. The trapper will carry the animal trap around the fortress, chasing actual [[vermin]] creatures that exist in the fortress but are not rendered on the screen, and will catch one once it reaches it. Once the vermin creature is successfully caught, the trap will be dropped, and then hauled to an animal [[stockpile]] by anyone with the [[hauling#Animal_hauling|animal hauling]] labour. Any animal caught in a trap will be identified as "live": for example, a "live rat", a "live rhino lizard", or a "live caphopper". These animals can be eaten by any dwarves as a delicacy, or can be tamed for adoption using the task below.

Note that [[gnawer|gnawing]] vermin will quickly escape from non-artifact wooden animal traps after being caught, and also note that there is no way to enforce using only non-wooden traps to catch gnawers, other than ensuring that they are the only traps available. Wooden animal traps do work fine for non-gnawing vermin.

===Tame a Small Animal===
Requires: An [[animal trainer]] and trapped "live" vermin.

This task is used to tame caged vermin for adoption as pets; if a live vermin is not tamed as a pet, it may eventually be eaten by a dwarf as a form of exotic cuisine (even things that would make most people cringe, such as hamsters, lizards, and worms). Vermin can only be tamed if they are in an animal trap and not a [[cage]]. If a vermin you want to train is in a cage, it can be unassigned from the cage, and a recapture task to put it back into an animal trap will be generated automatically.




{{buildings}}

Kennel

2014-07-29T22:44:30Z

JT: Changed quality rating from "Exceptional" to "Fine" using the rating script

Creature token

2014-07-29T22:23:46Z

JT: /* G */ gnawer changes in latest version

{{Migrated_article}}
{{av}}{{Quality|Exceptional}}

A full list of all known creature tokens.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants. It appears that the basic requirements for adoption are intact; for example, the creature is more likely to adopt an owner which likes creatures of that species.{{verify}}

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Creature needs alcohol to get through the working day, choosing to drink booze instead of water if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| {{text anchor|ALTTILE}}
| Creature
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Instead of charging relentlessly at prey, a creature with this tag will wait till the prey is within a few squares before charging.{{verify}}

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe with or without [[water]]. Implies [AQUATIC].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Caste
|
*Range
| [http://www.bay12forums.com/smf/index.php?topic=60554.msg1766793#msg1766793 Forum post describing how description ranges work]

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Caste
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

|-
| {{text anchor|APP_MOD_IMPORTANCE}}
| Caste
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| {{text anchor|APP_MOD_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| {{text anchor|APP_MOD_RATE}}
| Caste
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Special
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies loaded Creature Variation

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Creature can breathe in water, but air-drowns on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Does not appear in arena mode list.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Can be kept in artificial hives by beekeepers.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Does not attack or frighten wildlife.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
| pop:exported wealth:created wealth
| Specifies when a [[megabeast]] will attack the fortress.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|BABY}}
| Caste
| integer
| Age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
| [[Whale]]s and [[Sea nettle jellyfish|jellyfish]] have this. Controls the beaching frequency of the creature.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, but may lash out if agitated or disturbed.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[Biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Seems to be required to make the creature denouncable as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
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.

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
| PlanName, PlanName:type:type:type:etc.
| loads a plan 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 />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A [[Purring maggot|maggot]] would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
| years:days:size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a [[minotaur]]. His birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old he would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) he would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.

|-
| {{text anchor|BODYGLOSS}}
| Caste
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies CARNIVORE and has the same worldgen problem.

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains skills and can have professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can talk. Note that it is not necessary for a creature to gain social skills. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste {{Verify}}
|
| Creature cannot climb, even if it has free grasps.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot jump.

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Alias for NOT_LIVING

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open doors.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Currently bugged in worldgen -- exclusively carnivore civilizations always starve out. Goblins and kobolds live off raw exceptions. Civilizations with [NO_EAT] token will still starve to death.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a caste.

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific ALT_TILE. Requires CASTE_TILE.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific COLOR.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific GLOWCOLOR.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific GLOWTILE.

|-
| {{text anchor|CASTE_NAME}}
| Caste
| singular:plural:adjective
| Caste-specific NAME.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific PROFESSION_NAME.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
| 'character' or tile number
| Caste-specific SOLDIER_ALTTILE. Requires CASTE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
| 'character' or tile number
| Caste-specific CREATURE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
| speech file
| Caste-specific SPEECH.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific CREATURE_TILE.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
| Varies
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
| integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHANGE_FREQUENCY_PERC}}
| Creature
| integer
| Multiplies frequency by a factor of (integer)%.

|-
| {{text anchor|CHILD}}
| Caste
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| {{text anchor|CHILDNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of eggs laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
| foreground:background:brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| Any civilization with USE_COMMON_DOMESTIC tag (humans, dwarves) has domesticated this creature by default and always has access to it, even without any wild populations. Useless without PET, PACK_ANIMAL, WAGON_PULLER or MOUNT tags and invalid on FANCIFUL creatures. Requires NATURAL tag?{{verify}}

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used for mussels, for one.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is 'berserk' and will attack all other creatures, except members of its own species that ALSO have the CRAZED tag.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes) and EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens). A single creature can have multiple classes. Eligibility for certain entity positions can also be permitted or restricted by this tag.

|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets if the creature is active at twilight.

|-
| {{text anchor|CURIOUSBEAST_EATER}}
| Caste
|
| Allows a creature to steal and eat edible items from a site.

|-
| {{text anchor|CURIOUSBEAST_GUZZLER}}
| Caste
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to steal things (apparently the highest value it can find). If the creature goes on rampages in worldgen, it will often steal items instead of attacking. Kea birds are infamous for this.

|-
| {{text anchor|CV_ADD_TAG}}
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|DESCRIPTION}}
| Caste
| text
| A brief description of the creature type.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Dies upon attacking. Used for [[bee]] stings.

|-
| {{text anchor|DIFFICULTY}}
| Caste
| integer
| Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets if the creature is active in day.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| Found on [[peregrine falcon]]s. The creature hunts vermin by diving from the air. Does not seem to work on tame creatures.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Creature does not actually exist; used for a few [[fanciful]] creatures of myth.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|EBO_ITEM}}
| Caste
| [[item token]]:[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being butchered. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
| gem shape
| The shape of the extra item of the creature upon butchering. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will 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.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of eggs.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Civilizations with USE_EVIL_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when butchered (typically a gizzard stone), defined by EBO_ITEM and EBO_SHAPE.

|-
| {{text anchor|EXTRACT}}
| Caste
|
* [[material token]]
| Defines a creature extract which can be obtained via [[small animal dissection]].

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with {{token|COMMON_DOMESTIC|c}}

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on subterranean animal-man tribals.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|FEMALE}}
| Caste
|
| The creature is female and can bear young. Usually determined inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| The creature is immune to FIREBALL and FIREJET attacks.

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| The creature is immune to DRAGONFIRE attacks. Implies {{token|FIREIMMUNE|c}}.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| Needs to be cleaned at a fishery

|-
| {{text anchor|FIXED_TEMP}}
| Caste
| temperature
| The natural heat generated by the creature.

|-
| {{text anchor|FLEEQUICK}}
| Caste
|
| Determines how soon a creature flees in a losing battle. Creatures with this tag will flee at the first sign of resistance.

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. 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}}.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|GAIT}}
| Unknown
|
* type (WALK, CLIMB, SWIM, CRAWL, or FLY)
* gait name
* full speed
* build up time:max turning speed:start speed (or NO_BUILD_UP for instant use)
* energy use
* Optional flags:
** LAYERS_SLOW - if gait is slowed by increased weight
** STRENGTH - if gait is affected by strength stat
** AGILITY - if gait is affected by agility stat
** STEALTH_SLOWS:penalty - if gait is slowed by being stealthed
| Defines a gait at which the creature can move. See [[Gait]] for more information.

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
| singular:plural
| BABYNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
| singular:plural
| CHILDNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
| A:B
| Attacks against the creature have their force modified by A/B. For example, 1:2 will halve the force of an attack made against the creature. {{verify}}

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) [[titan]]s, [[Demon]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Creature can get infections from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| This creature's wounds can become infected if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's GLOWTILE.

|-
| {{text anchor|GLOWTILE}}
| Creature
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| {{text anchor|GNAWER}}
| Caste
| verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made (normally wood). A former bug was fixed which prevented their escape{{bug|6117}} from non-artifact traps, but currently all gnawers brought onto the map by the elven caravans will automatically escape almost instantaneously from their wooden animal traps{{bug|6343}}.

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
| class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
| creature:caste
| The creature eats a specified vermin.

|-
| {{text anchor|GO_TO_END}}
| Special
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

|-
| {{text anchor|GO_TO_START}}
| Special
|
| When using tags from an existing creature, inserts new tags at the beginning of the creature.

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags after the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes. [[unicorn]]s for example. Civilizations with USE_GOOD_ANIMALS can domesticate them regardless of exotic status. Presumably has no effect on cavern creatures.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
| value
| The value determines how rapidly grass is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
| target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| 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. See [[Pasture]] for details on its issues.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|HABIT}}
| Caste
| type:probability
| 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, and COLLECT_WEALTH. These require the creature to have a lair to work properly, and also don't seem to work on creatures who are not (SEMI)MEGABEASTs or NIGHT_CREATURE_HUNTERs.

|-
| {{text anchor|HABIT_NUM}}
| Caste
| number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".<sup>[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]]</sup> All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

|-
| {{text anchor|HASSHELL}}
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

|-
| {{text anchor|HFID}}
| Creature
| Integer (generic token?)
| Found on generated [[angel]]s. Seemingly identifies a historical figure with said hist figure ID, possibly to associate it with hist figure.

|-
| {{text anchor|HIVE_PRODUCT}}
| Creature
|
*number
*[[time]]
*[[item token]]s
| What product is harvested from [[Beekeeping industry|beekeeping]].

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
| Default 'NONE'. The creature's normal body [[temperature]]

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby vermin.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in Fortress Mode (MALE and FEMALE are affected, if one is IMMOBILE no breeding will happen)

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates fire. It will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of certain materials. Due to a bug, however, they will only escape from [[artifact]]s.{{bug|6117}}

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for [CAN_SPEAK] + [CAN_LEARN].

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc.).

|-
| {{text anchor|ITEMCORPSE_QUALITY}}
| Caste
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|LAIR}}
| Caste
| type: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, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure 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."

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays eggs instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays a particular item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| Creature has ligaments in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| The creature will generate light, such as in adventurer mode at night.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz.")

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the range of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| {{text anchor|LOOSE_CLUSTERS}}
| Creature
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
| number
| Determines how well a creature can see in the dark. Higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|MAGICAL}}
| Caste
|
| Unknown.

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| Creature's able to see while covered in magma.

|-
| {{text anchor|MALE}}
| Caste
|
| The creature is male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
See [[Creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new material.{{verify}}

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*A:B
| Set the force multiplier of a specific material against the creature to A/B. For example, 10:1 multiplies the force by 10. {{verify}}

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets if the creature is active in dawn.

|-
| {{text anchor|MAXAGE}}
| Caste
| min:max
| Range of time in years in which death from old age may occur. Once a creature reaches the min value, it has a random chance each season of dying from old age. Unknown if the chance increases with further age.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Gives a creature random movement.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creature 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.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher:highest
| Sets up a mental attribute's range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Mental attribute gain/decay rates. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked in the farmer's workshop. The frequency is the amount of time units the creature needs to "recharge".

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for MISCHIEVOUS.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a mount. No use for the player, but enemy siegers may arrive with cavalry.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a mount, but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste {{Verify}}
|
| Allows the creature to have all-around vision as long as it has multiple heads(?) that can see. {{Verify}}

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes litters with more than one offspring rare. To ensure larger littlers, use [[DF2012:Creature_token#LITTERSIZE|LITTERSIZE]].

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present, and determining whether a creature will attack creatures with the AT_PEACE_WITH_WILDLIFE token.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|NAME}}
| Creature
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. Seems to be the default option and opposite to FANCIFUL.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of NATURAL.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
| [[Skill_token|Skill token]]:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. A value of 16 is legendary. Requires CAN_LEARN or INTELLIGENT to function in .25 or earlier.

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Found on bogeymen. Creatures with this tag will join other bogeymen in attacking adventurers at night, and will also adopt their other behaviors, such as vanishing in smoke upon being killed. This does not affect the creature's presence elsewhere, such as for generated megabeasts, normal creatures, entity members, etc. Setting the number of bogeyman types to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| 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. If this creature has SPOUSE_CONVERTER, 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 [[werebeast]]s 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.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| This creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become dizzy.

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to eat.

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer fevers.

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| Creature has no gender.

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The affected caste cannot gain any physical skills.

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The affected caste cannot lose any physical skills.

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| This creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| This creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the [THOUGHT] tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| This creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets if the creature is active in night.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| The creature has no emotions, and does not rage.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never run away from battle.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when butchered.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when butchered.

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butcher, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce miasma when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy.{{verify}} If this creature must eat and drink while playing, it WILL die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Cannot be butchered

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead.

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a [THOUGHT] body part to survive. If it does not have NO_THOUGHT_CENTER_FOR_MOVEMENT as well, it will be unable to use any attacks other than the default 'push'.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==O==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
| number
| How easy the creature is to smell. The higher the number, the easier the creature can be smelled. Zero is odorless. Default is 50.

|-
| {{text anchor|ODOR_STRING}}
| Caste
| string
| What the creature smells like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones. Used for [[Undead]].

|-
| {{text anchor|ORIENTATION}}
| Caste
| MALE/FEMALE:disinterested chance:lover-possible chance:commitment-possible 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.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Currently only used by merchants without wagons. Also prevents creature from dropping hauled items on its own -- do not use for player-controllable creatures!

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all paralyzing special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Unknown. No creatures currently have this token.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate pearls. Does nothing in the current version.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations that encounter it in worldgen will tame and domesticate it for their own use.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations cannot domesticate it in worldgen without certain exceptions. More difficult to tame?{{verify}}

|-
| {{text anchor|PETVALUE}}
| Caste
| value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher: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.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Physical attribute gain/decay rates. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after SET_BP_GROUP.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after SELECT_MATERIAL.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
| min:max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity. 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.

|-
| {{text anchor|PREFSTRING}}
| Creature
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*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.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
| Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes badgers so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| The creature has pus. Specifies the stuff secreted by infected wounds.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
| singular:plural
| What creature's remains are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color creature's remains are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| 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.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from a creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*material token
| Removes a tissue from a creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part.

|-
| {{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 his feet. Requires HUNTS_VERMIN, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventure Mode, spawns vermin edible by this creature in Fortress Mode.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes.

|-
| {{text anchor|SECRETION}}
| Caste
|
* [[material token]]
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
*trigger
| creates a secreted material on given tissue on a given part of the body. Valid triggers are:
*CONTINUOUS
*EXTREME_EMOTION
*EXERTION

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used after SELECT_CASTE.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*caste name, or ALL
| selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*Material token
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as MEGABEAST, but more of them are created during worldgen.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* Creature class
* [[Tilesets|Tile]]
* [[Color|Color]]
| Allows creature to sense creatures with a certain creature class through walls, floors etc. Sense will be with tile and color specified.

|-
| {{text anchor|SET_BP_GROUP}}
| Caste
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| Begins a selection of body parts.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
| [[skill_token]]:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
| percentage
| The rate at which this creature learns all skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
| [[skill_token]]:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
| [[skill_token]]:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
| value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for [CAN_LEARN] + [SKILL_LEARN_RATES:50].{{verify}} Used for ogres and giants. Applicable to player races.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves a "remains" instead of a corpse. Used for vermin.

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
| value
| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature can will only graze or eat the designated plant or creature parts.

|-
| {{text anchor|SPEECH}}
| Creature
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in data\speech.

|-
| {{text anchor|SPEECH_FEMALE}}
| Creature
| speech file
| Boasting speeches relating to killing females of this creature.

|-
| {{text anchor|SPEECH_MALE}}
| Creature
| speech file
| Boasting speeches relating to killing males of this creature.

|-
| {{text anchor|SPHERE}}
| Creature
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the NIGHT_CREATURE_HUNTER tag, it will kidnap SPOUSE_CONVERSION_TARGETs and transform them into the caste of its species with the CONVERTED_SPOUSE tag during worldgen. It may also start families this way.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste {{verify}}
|
| Caste does not require GRASP body parts to climb -- it can climb with STANCE parts instead.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's webs can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
| name
| Begins defining a tissue in the creature file.

|-
| {{text anchor|TITAN}}
| Caste
|
| Found on [[titan]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
| COLOR:freq:COLOR:freq etc.
| Creates a list of color patterns, giving each a relative frequency.

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by stonesense for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be trained as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be trained as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into martial trances.

|-
| {{text anchor|TRAPAVOID}}
| Caste
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. A single argument may be used instead of min and max. Only magma creatures use 4 or 5 in the default raws. [[Demon]]s use only 5:5; user-defined creatures with both this depth and [FLIER] will take part in the initial wave from the HFS alongside generated demons. Without [FLIER], they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| Creature swims under the water and can't be seen. Seems to be a relic from the 2D era.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| Typically found on generated [[demon]]s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be specified in user-defined raws.

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a SKULKING civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|VEGETATION}}
| Caste
|
| The creature is made of swamp stuff. Used for [[grimeling]]s.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
| Vermin bites, and injects something.

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See PENETRATEPOWER. Distinct from VERMIN_ROTTER.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in water and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by fishing.

|-
| {{text anchor|VERMIN_NOROAM}}
| Caste
|
| The creature will not be observed randomly roaming about the map.

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Attracted to rotting stuff left in the open. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud.

|-
| {{text anchor|VERMIN_SOIL_COLONY}}
| Creature
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets if the creature is active in evening.

|-
| {{text anchor|VIEWRANGE}}
| Caste
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste {{Verify}}
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs. The first number is binocular vision, the second is non-binocular vision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create webs, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
| 2nd person:3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
| number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
| interaction
| When this attack lands successfully, an interaction with I_SOURCE:ATTACK will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying properties of previously defined tissues. (See also [[Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.
[SELECT_TISSUE_LAYER:SKIN:BY_TYPE:UPPERBODY]

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
| Sets a tissue layer to be made of a different tissue.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man:<br>
[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
| Seems to set new relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[Body detail plan token]]
*[[Body token]]
*[[Material definition token]]
*[[Syndrome]]
*[[Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

Storage

2014-07-29T02:06:08Z

JT: pouches

{{Migrated_article}}
{{av}} {{buggy}}
{{Quality|Exceptional|06:09, 29 July 2010 (UTC)}}

{{furniture|name=Container
|tile=Æ
|wood=y
|stone=y
|metal=y
|glass=y
}}

Types of containers the game knows are '''chests''', '''coffers''', '''boxes''', '''cabinets''', '''bags''', '''[[barrel]]s''', '''[[large pot]]s''' and '''[[bin]]s'''. All containers are used to hold items, from personal possessions to [[gem]]s, [[alcohol]], [[quarry bush]] leaves, and even living [[creature]]s, but their use is context-sensitive, so you cannot use your barrels for storing [[coin]]s, but you ''can'' {{key|b}}uild a bag as a dwarf's personal container, analogous to a chest.

Chests, coffers, boxes and bags are subsumed under ''boxes and bags'' in the [[status]] stocks screen, and these can be built as "containers" from the {{key|b}}uilding menu to satisfy the "Needs: X Chests" requirement for nobles. Each other container type has its own entry.

To examine a container's contents when the container is in a stockpile, select the object location with the {{key|k}} key. Then, use {{key|+}} and {{key|-}} until the container is highlighted, then press {{key|enter}}. Press {{key|enter}} again to select the contents, if any. The i{{key|t}}ems command can be used to see items that are stored in a built container. See also, [[stocks]].

== Barrels, bins, bags, pots ==

[[Barrel]]s are [[wood]]en or [[metal]] containers that are useful for storing items in a [[Stockpile#food|food stockpile]] and are used to store [[alcohol]], [[plant]]s, [[seed]] bags, [[meat]], [[fish]], [[dwarven syrup]], [[quarry bush]] leaf bags, [[flour]] bags and [[dye]] bags, cooked food, [[fat]] and [[tallow]], and all [[prepared organs]]. They are made at a [[Carpenter's workshop]] with 1 log or at a [[Forge]] with 3 bars of metal. Barrels can be disabled in a stockpile to prevent haulers from running off with everything else inside to pick up a stray seed.

[[Pot]]s, the larger equivalent of barrels, can be made of wood, stone, clay, glass, or metal. Pots can also be used to store alcohol and other related liquids, though clay pots (earthenware) must be [[glaze]]d to hold liquids. Pots hold twice as much as barrels (60 total units of food) and weigh one fourth as much as a barrel of equivalent material. Except for a few barrel-specific requirements, pots are generally a superior replacement.

[[Bin]]s are containers, again made from wood or metal, used for most non-food items. They are sent to all the other stockpiles (with the exclusion of the [[refuse]], [[stone]] and [[graveyard]] piles) and will hold much larger stacks of items, making organizing those endless piles of +giant cave spider silk socks+ and trade goods much easier to manage. They are made at a [[Carpenter's workshop]] with 1 log or at a [[Forge]] with 3 bars of metal. Bars and blocks will stack into a bin, but not into any other container, so a stockpile with bar/block enabled will default to requesting bins.

Bags are used to store [[seed]]s, [[quarry bush]] leaves, [[mill]] products ([[flour]], [[sugar]], [[dye]]) and [[sand]] ("[[powder]]s"). They are made from [[plant fiber]] (or [[silk]]) [[cloth]], [[leather]], or [[adamantine]]. Bags are used to gather and transport powders the same way [[bucket]]s are used to carry [[water]]. Bags can be placed inside other containers, such as barrels. Bags can be placed as [[furniture]] and then function as [[coffer]]s (see below). They are made at a [[Clothier's shop]] with 1 cloth or at a [[Leather works]] with 1 leather.

Empty barrels, bins and bags can all be stored in a [[furniture]] [[stockpile]].

== Cabinets and "chests" ==

These two containers are both furniture items only. They must be built in rooms assigned to dwarves in order to fulfill the dwarves' room requirements. Cabinets are used to store clothing, and chests are used to store everything else.

Also, the [[hospital]] needs containers for its supply-storage.

A [[stone]] chest is called a '''coffer''', and a [[glass]] chest is called a '''box''', but they are used for the same purpose. Bags can also be built as chests.

Once built as furniture, their contents can be viewed with the {{k|t}} menu.

== Quick Reference ==
{| border = 1 cellspacing="0" cellpadding="5" class="wikitable sortable"
|-
! Container || Stockpile || Furniture || Solid Capacity (in [[size|cm<sup>3</sup>]]) || Liquid Capacity || Stores
|| Stone || Wood || Glass || Metal || Cloth || Leather || Ceramic
|-
|[[Barrel]] || Furniture > Type > Barrels || No || 3000 || 3000 || Food, Alcohol<sup>4</sup>, Extracts<sup>4</sup>, Milk, Lye, Bags
|| No || Yes || No || Yes || No || No || No
|-
|[[Bin]] || Furniture > Type > Bins || No || 3000 || || Items, Jugs, Flasks
|| No || Yes || No || Yes || No || No || No
|-
|[[Bucket]] || Furniture > Type > Buckets || No || || 600 || Milk, Lye, Water<sup>2</sup>
|| No || Yes || No || Yes || No || No || No
|-
|[[Flask]]<br />Vial<br />Waterskin
|| Finished Goods > Type > Flasks || No || || 180 || Alcohol, Water<br />Vials: Extracts<sup>4</sup>
|| No || No || Vial || Flask || No || Waterskin || No
|-
|[[Equipment#Backpacks|Backpack]]
|| Finished Goods > Type > Backpacks || No || 3000 || || Food
|| No || No || No || No || Adamantine<sup>3</sup> || Yes || No
|-
|[[Equipment#Quiver|Quiver]]
|| Finished Goods > Type > Quivers || No || 1200 || || Ammunition
|| No || No || No || No || Adamantine<sup>3</sup> || Yes || No
|-
| Bag<br />Chest<br />Coffer<br />Box
|| Furniture > Type > Boxes and Bags || Special || 3000 || || Bags: Seeds, Leaves, Powders<br />Other: Owned items
|| Coffer || Chest || Box || Chest || Bag || Bag || No
|-
|Pouch
|| Finished Goods > Type > Tools{{verify}} || No || 100 || || Coins (in [[adventurer mode]])
|| No || No || No || No || Yes || Yes || No
|-
|[[Cabinet]]
|| Furniture > Type > Cabinets || Yes || 3000 || || Owned clothing
|| Yes || Yes || Yes || Yes || No || No || No
|-
|[[Jug]] || Finished Goods > Type > Tools || No || || 1000 || Royal Jelly, Honey, Rock Nut Oil
|| Yes<sup>5</sup> || Yes<sup>5</sup> || Yes || Yes || No || No || Yes
|-
|[[Large pot]]
|| Finished Goods > Type > Tools || No || 6000 || 6000 || Food, Alcohol, Bags
|| Yes<sup>5</sup> || Yes<sup>5</sup> || Yes || Yes || No || No || Yes
|-
|[[Nest box]]
|| Finished Goods > Type > Tools || Yes || 200 || || Eggs
|| Yes<sup>5</sup> || Yes<sup>5</sup> || Yes || Yes || No || No || No
|-
|[[Hive]] || Finished Goods > Type > Tools || Yes || 500 || 500 || Honey Bees, Royal Jelly, Honeycomb{{verify}}
|| Yes<sup>5</sup> || Yes<sup>5</sup> || Yes || Yes || No || No || Yes
|-
|[[Wheelbarrow]]
|| Furniture > Type > Wheelbarrows || No || 10000 || || hauled items
|| No || Yes || No || Yes || No || No || No
|-
|[[Minecart]]
|| Furniture > Type > Minecarts || No<sup>6</sup> || 50000 || 50000 || hauled items;<br />[[Minecart#Loading_liquids|scooped]], but not loaded: Water, Magma
|| No || Yes || No || Yes || No || No || No
|-
|[[Cage]]<br />Terrarium<br />Aquarium
|| Animals || Yes & No || 6000 || 6000 || Creatures, Vermin<br />Aquarium: Water
|| No || Cage || Terrarium<br />Aquarium || Cage || No || No || No
|-
|[[Animal trap]]
|| Animals || Yes & No || 3000 || || Vermin, Bait
|| No || Yes || No || Yes || No || No || No
|-
|[[Coffin]]<br />Casket<br />Sarcophagus
|| Furniture > Type > Coffins || Yes || 6000 || || Creature/Vermin Corpses/Remains
|| Coffin || Casket || Coffin || Sarcophagus || No || No || No
|-
|[[Weapon rack]]
|| Furniture > Type > Weapon Racks || Yes || 6000 || || Weapons
|| Yes || Yes || Yes || Yes || No || No || No
|-
|[[Armor stand]]
|| Furniture > Type > Armor Stands || Yes || 6000 || || Armor
|| Yes || Yes || Yes || Yes || No || No || No
|}
:<sup>1</sup> - Large Pots can be made from any hard material, including wood and metal
:<sup>2</sup> - Used to carry water, can store Milk and Lye but will be emptied into Barrels
:<sup>3</sup> - Backpacks and quivers can only be made from Adamantine cloth, though ones made from other cloth can be purchased from caravans
:<sup>4</sup> - Brewing and extracting can store any amount of liquid within a barrel or flask
:<sup>5</sup> - Rock and Wood versions of these items are made in [[Craftsdwarf's workshop]] rather than [[Carpenter's workshop]] or [[Mason's workshop]] as usual.
:<sup>6</sup> - A [[minecart]] can be placed where you need it and used for storage, but technically it's not built furniture

*[[Tools]] have capacity set in units 10 times smaller; liquids take container capacity 60 per 1 unit, i.e. capacity 180 = 3 units of water, 50000 = 833 units, etc.
*Large Pots are like Barrels but with different capacities.
*Bins are like Barrels but store different stuff.
*Buckets are used for temporary storage of Milk, Lye, and Water.
*Jugs are mini containers for honey and royal jelly and can be stored inside Bins, in this sense they are like Bags.
*Bags are mini containers for powders and can be stored inside Barrels/Large Pots if holding food items.
*Bags are like Chests/Coffers/Boxes made of cloth or leather, can be placed as furniture in the same fashion.
*Flasks/Waterskins/Vials are different names for the same containers depending on the material it's made from.
*Chests/Coffers/Boxes are different names for the same piece of furniture depending on the material it's made from.
*A terrarium can be designated as an Aquarium. A dwarf will use a bucket to fill it with water. If deconstructed it'll stay filled with Water[10] and can even be sold with the water inside. The water costs 1☼ each, so you get 10☼ for the water.
*A hive won't be destroyed if you don't have a stockpile for its products. You could use {{key|t}} on the hive and dump the item to use it.

== Spilling ==
A container item that moves fast and collides with an obstacle spills its contents. If the obstacle permits (i.e. [[fortification]]), these continue to move in the same direction with some scattering, otherwise displaced 1 tile above and retain velocity. This was introduced for [[minecart]]s, but applies at least to [http://www.bay12forums.com/smf/index.php?topic=109460.msg3315406#msg3315406 other tools] and [http://www.bay12forums.com/smf/index.php?topic=109460.msg3340230#msg3340230 cages]. If the tile above also contains an obstacle and the spilled item is a container, the process repeats on the next tick, until it runs out of either nested containers or wall height (see the first link above).

== Bugs ==
* Hauling containers ties up all the items in the containers until the hauling is complete. This often results in cancellation spam and work delays.{{bug|5992}} With heavy containers, hauling them around is also inefficient.{{bug|5964}} One workaround is creating a "feeder stockpile" with containers disabled.
* Stockpiles with containers enabled and wheelbarrows assigned perform poorly.{{bug|5964}}
* Container size works in mysterious ways. Items only have "SIZE" determining the volume of their material and thus [[weight]], but ''no separate external volume''. For containers, CAPACITY is ''not'' added to it, i.e. they all are treated like soft bags: you can put 30 other bags inside a bag, and you can load a minecart with minecarts. At the same time, containers are assumed to ''not'' be soft bags - while weight of contents adds to the container's, the ambiguous SIZE is constant. Together, these facts make containers nest-able ''indefinitely'', as long as CAPACITY>SIZE (which normally is the case) and potentially act like bags of holding - have the same stated volume whether empty or holding an arbitrary total amount of items via nested containers. The only nesting that normally happens in Fortress mode is minecart > barrel > bag, but this still makes a minor [[exploit]].
* Stacks made by a single job tend to ignore capacity. For one, dwarves picking up items may stuff a [[Exploit#Quantum_stockpiles|quantum stockpile]] worth of items into one container.{{bug|6063}} Same goes for brewing and extracting. Some of related bugs{{bug|3986}} are fixed, so the details may need re-checking{{verify}}.
* Conversely, a freshly produced stack, no matter how small, will be put into a new container and not added into the old ones. Which may be justified with ''brewing'', but also happens to production of items/substances without quality modifiers.
* Metal chests cannot be [[melt]]ed; attempting to do so will leave the chest intact but cause the furnace operator to gain experience (and waste [[fuel]] at non-magma smelters). {{bug|2493}}
{{Buildings}}

User:JT/Token Wishlist

2014-07-29T01:17:36Z

JT: /* General Tokens */ APPLY_CASTE_VARIATION

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or ANY for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_NUMBER) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

=====''[SOULMATE]''=====

: This tag causes a species to have only one mate at a time. Once it has found a mate, it will remain with that mate, and it will not reproduce unless its mate is accessible. If its mate is killed or passes away naturally, it will receive an unhappy thought even if it is not an [INTELLIGENT] species, but it will then be capable of finding another mate. Most humanoids demonstrate this behaviour.

=====''[SOULMATE_PERMANENT]''=====

: This tag causes a species to seek only one mate during its lifetime. It will receive an indefinite unhappy thought when its soulmate dies, and will never again seek another mate. Seahorses fit this behaviour.

=====''[SEASONAL_REPRODUCTION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: This tag means that the species is only seasonally fertile, in that it will reproduce only in certain seasons; e.g., [SEASONAL_REPRODUCTION:SPRING]. When a fertile season begins, the animal resumes normal computation of its fertility cycles. When the season ends (and the next season is no longer fertile), the being is suppressed from mating; the fertility cycle counter halts, to resume from where it left off in the next fertile season.

: This allows limiting certain species' reproductive intervals to reduce overpopulation due to year-round reproduction.

: Default is [SEASONAL_REPRODUCTION:ANY].

=====''[TEMPERATE_REPRODUCTION:weather...]''=====

: '''Arguments:'''
:* ''season'': ANY; one or more of SCORCHING, HOT, WARM, TEMPERATE, COOL, COLD, or FREEZING, separated by colons; or a specific temperature range ''min'':''max'' in degrees Urist.

: e.g., [TEMPERATE_REPRODUCTION:ANY], [TEMPERATE_REPRODUCTION:SCORCHING:HOT:WARM], [TEMPERATE_REPRODUCTION:10000:10060]

: In addition to a blacklist based on SEASONAL_REPRODUCTION, a species may also have its fertility blacklist set to certain weather, to prevent it from reproducing in environmental conditions that are hostile to it or its offspring. It is intended more for fortress mode (and ostensibly adventure mode in the far future), to prevent species that have been imported from breeding successfully in hostile environments, as BIOME already serves as an adequate limiter on worldgen populations.

: Default is [TEMPERATE_REPRODUCTION:ANY].

=====''[CONDITIONAL_FERTILITY:population]''=====

: '''Arguments:'''
:* ''population'': The population limit of the species within the region.

: This tag allows a population to be conditionally fertile, based on its population number per unit area; if the population exceeds the specified number, all fertility cycles halt until the population falls. Aside from its metagame usefulness for controlling populations for better frame rates, it represents those species in reality which are genuinely capable of conditional fertility. As with other caps, it is a soft cap -- multiple births in a litter or pre-existing pregnancies can bring the population over the cap.

=====''[REPRODUCTION_FREQUENCY:days:duration]''=====

: '''Arguments:'''
:* ''days'': The number of days between subsequent fertility cycles.
:* ''duration'': The length of days (overlapping with the ''days'' parameter) during which the animal is fertile.

: This controls the frequency of a species' reproductive cycles, blacklisting animals from becoming pregnant outside of their fertility periods.

: For code simplicity, since the oestrus event itself wouldn't simulated (although simulating it would be of particular realism interest for keen-sensed animals, especially bloodthirsty animals like sharks or ''Pitch Black''-style blind predators), it would be easier just to make the "fertile" period begin immediately when the cycle begins, rather than halfway through.

: The default is the standard human 28-day cycle, [REPRODUCTION_FREQUENCY:28:5] -- the female is fertile for 5 days out of every 28-day period. If a fertility check falls on this interval... congratulations!

=====''[REPRODUCTION_SUCCESS:permille]''=====

: '''Arguments:'''
:* ''permille'': Chance of becoming pregnant on a pregnancy check.

: This allows finer control over successful reproduction even when blacklisting based on season, temperature/climate, fertility cycle, and population are taken into account, to allow species that tend to reproduce too quickly to be fine-tuned for greater realism.

: Default is whatever the current pregnancy chance is set to, which is probably buried deeply in the code somewhere...

===General Tokens===

=====''[HIBERNATION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: A species which hibernates will not spawn on the map outside of the valid seasons -- it will remain comfortably within the site populations instead. Species which hibernate will automatically go to sleep during fortress mode and remain asleep, requiring no food or water, until the end of the season. At the end of the season, however, they will be set automatically to Hungry and Thirsty and will seek food to eat. (Though many species which hibernate remain awake, and do eat and drink while hibernating, this implementation is far simpler to simulate.)

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=====''[APPLY_CASTE_VARIATION:variation]''=====

: '''Arguments:'''
:* ''variation'': The creature variation to apply to this specific caste (i.e., not affecting any other caste).

: APPLY_CREATURE_VARIATION currently affects all castes, which doesn't suit gender dimorphism too well. It would be great if there were a way to apply a creature variation to the currently selected caste instead of implicitly affecting the "all" caste.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Creature Variation Tokens ==

=====''[CVCT_APPEND:...]'' =====

: '''Arguments:'''
:* ''...'': Colon-separated list of additional parameters to append to end of CVCT_MASTER token's parameters

: As a fundamental improvement on my former ADD_BODY_TAG request, this would make use of existing CVCT functionality to allow appending parameters to existing tokens, with particular intention for use with a CVCT_MASTER:BODY (but fundamentally it should work with any tag, except perhaps for reciprocal creature variation tags). There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers ''unless I replace one of those existing body parts with itself while doing so''); this currently means that your creature variation tag must cover all possible usage scenarios instead of being properly generic -- i.e., instead of simply adding tags to the BODY, it has to target BASIC_1PARTBODY, BASIC_2PARTBODY, HUMANOID, HUMANOID_NECK, HUMANOID_HOOF, HUMANOID_NECK_HOOF, etc., etc.... The proposed new tag would neatly avoid that by allowing you to add any body part scot free, without worrying about what body parts are already there, proviso that you don't create an invalid body (which would simply appear in errorlog.txt as normal).

: Note in particular that this would vastly simplify such things as sheep:

[CREATURE_VARIATION:BASIC_2HORNS]
[CV_CONVERT_TAG]
[CVCT_MASTER:BODY]
[CVCT_APPEND:2HEAD_HORN]

: Instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then a CREATURE_VARIATION could be applied to the male caste, [APPLY_CREATURE_VARIATION:BASIC_2HORNS]. The fact that such a tag would be generically useful for such things as demon variations of humanoids, etc. is also of note.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

User:JT/Token Wishlist

2014-07-28T19:09:48Z

JT: /* [CVCT_APPEND:...] */ grammars off my internets

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or ANY for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_NUMBER) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

=====''[SOULMATE]''=====

: This tag causes a species to have only one mate at a time. Once it has found a mate, it will remain with that mate, and it will not reproduce unless its mate is accessible. If its mate is killed or passes away naturally, it will receive an unhappy thought even if it is not an [INTELLIGENT] species, but it will then be capable of finding another mate. Most humanoids demonstrate this behaviour.

=====''[SOULMATE_PERMANENT]''=====

: This tag causes a species to seek only one mate during its lifetime. It will receive an indefinite unhappy thought when its soulmate dies, and will never again seek another mate. Seahorses fit this behaviour.

=====''[SEASONAL_REPRODUCTION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: This tag means that the species is only seasonally fertile, in that it will reproduce only in certain seasons; e.g., [SEASONAL_REPRODUCTION:SPRING]. When a fertile season begins, the animal resumes normal computation of its fertility cycles. When the season ends (and the next season is no longer fertile), the being is suppressed from mating; the fertility cycle counter halts, to resume from where it left off in the next fertile season.

: This allows limiting certain species' reproductive intervals to reduce overpopulation due to year-round reproduction.

: Default is [SEASONAL_REPRODUCTION:ANY].

=====''[TEMPERATE_REPRODUCTION:weather...]''=====

: '''Arguments:'''
:* ''season'': ANY; one or more of SCORCHING, HOT, WARM, TEMPERATE, COOL, COLD, or FREEZING, separated by colons; or a specific temperature range ''min'':''max'' in degrees Urist.

: e.g., [TEMPERATE_REPRODUCTION:ANY], [TEMPERATE_REPRODUCTION:SCORCHING:HOT:WARM], [TEMPERATE_REPRODUCTION:10000:10060]

: In addition to a blacklist based on SEASONAL_REPRODUCTION, a species may also have its fertility blacklist set to certain weather, to prevent it from reproducing in environmental conditions that are hostile to it or its offspring. It is intended more for fortress mode (and ostensibly adventure mode in the far future), to prevent species that have been imported from breeding successfully in hostile environments, as BIOME already serves as an adequate limiter on worldgen populations.

: Default is [TEMPERATE_REPRODUCTION:ANY].

=====''[CONDITIONAL_FERTILITY:population]''=====

: '''Arguments:'''
:* ''population'': The population limit of the species within the region.

: This tag allows a population to be conditionally fertile, based on its population number per unit area; if the population exceeds the specified number, all fertility cycles halt until the population falls. Aside from its metagame usefulness for controlling populations for better frame rates, it represents those species in reality which are genuinely capable of conditional fertility. As with other caps, it is a soft cap -- multiple births in a litter or pre-existing pregnancies can bring the population over the cap.

=====''[REPRODUCTION_FREQUENCY:days:duration]''=====

: '''Arguments:'''
:* ''days'': The number of days between subsequent fertility cycles.
:* ''duration'': The length of days (overlapping with the ''days'' parameter) during which the animal is fertile.

: This controls the frequency of a species' reproductive cycles, blacklisting animals from becoming pregnant outside of their fertility periods.

: For code simplicity, since the oestrus event itself wouldn't simulated (although simulating it would be of particular realism interest for keen-sensed animals, especially bloodthirsty animals like sharks or ''Pitch Black''-style blind predators), it would be easier just to make the "fertile" period begin immediately when the cycle begins, rather than halfway through.

: The default is the standard human 28-day cycle, [REPRODUCTION_FREQUENCY:28:5] -- the female is fertile for 5 days out of every 28-day period. If a fertility check falls on this interval... congratulations!

=====''[REPRODUCTION_SUCCESS:permille]''=====

: '''Arguments:'''
:* ''permille'': Chance of becoming pregnant on a pregnancy check.

: This allows finer control over successful reproduction even when blacklisting based on season, temperature/climate, fertility cycle, and population are taken into account, to allow species that tend to reproduce too quickly to be fine-tuned for greater realism.

: Default is whatever the current pregnancy chance is set to, which is probably buried deeply in the code somewhere...

===General Tokens===

=====''[HIBERNATION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: A species which hibernates will not spawn on the map outside of the valid seasons -- it will remain comfortably within the site populations instead. Species which hibernate will automatically go to sleep during fortress mode and remain asleep, requiring no food or water, until the end of the season. At the end of the season, however, they will be set automatically to Hungry and Thirsty and will seek food to eat. (Though many species which hibernate remain awake, and do eat and drink while hibernating, this implementation is far simpler to simulate.)

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Creature Variation Tokens ==

=====''[CVCT_APPEND:...]'' =====

: '''Arguments:'''
:* ''...'': Colon-separated list of additional parameters to append to end of CVCT_MASTER token's parameters

: As a fundamental improvement on my former ADD_BODY_TAG request, this would make use of existing CVCT functionality to allow appending parameters to existing tokens, with particular intention for use with a CVCT_MASTER:BODY (but fundamentally it should work with any tag, except perhaps for reciprocal creature variation tags). There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers ''unless I replace one of those existing body parts with itself while doing so''); this currently means that your creature variation tag must cover all possible usage scenarios instead of being properly generic -- i.e., instead of simply adding tags to the BODY, it has to target BASIC_1PARTBODY, BASIC_2PARTBODY, HUMANOID, HUMANOID_NECK, HUMANOID_HOOF, HUMANOID_NECK_HOOF, etc., etc.... The proposed new tag would neatly avoid that by allowing you to add any body part scot free, without worrying about what body parts are already there, proviso that you don't create an invalid body (which would simply appear in errorlog.txt as normal).

: Note in particular that this would vastly simplify such things as sheep:

[CREATURE_VARIATION:BASIC_2HORNS]
[CV_CONVERT_TAG]
[CVCT_MASTER:BODY]
[CVCT_APPEND:2HEAD_HORN]

: Instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then a CREATURE_VARIATION could be applied to the male caste, [APPLY_CREATURE_VARIATION:BASIC_2HORNS]. The fact that such a tag would be generically useful for such things as demon variations of humanoids, etc. is also of note.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

User:JT/Token Wishlist

2014-07-28T19:06:48Z

JT: modified ADD_BODY_TAG request into CVCT_APPEND

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or ANY for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_NUMBER) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

=====''[SOULMATE]''=====

: This tag causes a species to have only one mate at a time. Once it has found a mate, it will remain with that mate, and it will not reproduce unless its mate is accessible. If its mate is killed or passes away naturally, it will receive an unhappy thought even if it is not an [INTELLIGENT] species, but it will then be capable of finding another mate. Most humanoids demonstrate this behaviour.

=====''[SOULMATE_PERMANENT]''=====

: This tag causes a species to seek only one mate during its lifetime. It will receive an indefinite unhappy thought when its soulmate dies, and will never again seek another mate. Seahorses fit this behaviour.

=====''[SEASONAL_REPRODUCTION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: This tag means that the species is only seasonally fertile, in that it will reproduce only in certain seasons; e.g., [SEASONAL_REPRODUCTION:SPRING]. When a fertile season begins, the animal resumes normal computation of its fertility cycles. When the season ends (and the next season is no longer fertile), the being is suppressed from mating; the fertility cycle counter halts, to resume from where it left off in the next fertile season.

: This allows limiting certain species' reproductive intervals to reduce overpopulation due to year-round reproduction.

: Default is [SEASONAL_REPRODUCTION:ANY].

=====''[TEMPERATE_REPRODUCTION:weather...]''=====

: '''Arguments:'''
:* ''season'': ANY; one or more of SCORCHING, HOT, WARM, TEMPERATE, COOL, COLD, or FREEZING, separated by colons; or a specific temperature range ''min'':''max'' in degrees Urist.

: e.g., [TEMPERATE_REPRODUCTION:ANY], [TEMPERATE_REPRODUCTION:SCORCHING:HOT:WARM], [TEMPERATE_REPRODUCTION:10000:10060]

: In addition to a blacklist based on SEASONAL_REPRODUCTION, a species may also have its fertility blacklist set to certain weather, to prevent it from reproducing in environmental conditions that are hostile to it or its offspring. It is intended more for fortress mode (and ostensibly adventure mode in the far future), to prevent species that have been imported from breeding successfully in hostile environments, as BIOME already serves as an adequate limiter on worldgen populations.

: Default is [TEMPERATE_REPRODUCTION:ANY].

=====''[CONDITIONAL_FERTILITY:population]''=====

: '''Arguments:'''
:* ''population'': The population limit of the species within the region.

: This tag allows a population to be conditionally fertile, based on its population number per unit area; if the population exceeds the specified number, all fertility cycles halt until the population falls. Aside from its metagame usefulness for controlling populations for better frame rates, it represents those species in reality which are genuinely capable of conditional fertility. As with other caps, it is a soft cap -- multiple births in a litter or pre-existing pregnancies can bring the population over the cap.

=====''[REPRODUCTION_FREQUENCY:days:duration]''=====

: '''Arguments:'''
:* ''days'': The number of days between subsequent fertility cycles.
:* ''duration'': The length of days (overlapping with the ''days'' parameter) during which the animal is fertile.

: This controls the frequency of a species' reproductive cycles, blacklisting animals from becoming pregnant outside of their fertility periods.

: For code simplicity, since the oestrus event itself wouldn't simulated (although simulating it would be of particular realism interest for keen-sensed animals, especially bloodthirsty animals like sharks or ''Pitch Black''-style blind predators), it would be easier just to make the "fertile" period begin immediately when the cycle begins, rather than halfway through.

: The default is the standard human 28-day cycle, [REPRODUCTION_FREQUENCY:28:5] -- the female is fertile for 5 days out of every 28-day period. If a fertility check falls on this interval... congratulations!

=====''[REPRODUCTION_SUCCESS:permille]''=====

: '''Arguments:'''
:* ''permille'': Chance of becoming pregnant on a pregnancy check.

: This allows finer control over successful reproduction even when blacklisting based on season, temperature/climate, fertility cycle, and population are taken into account, to allow species that tend to reproduce too quickly to be fine-tuned for greater realism.

: Default is whatever the current pregnancy chance is set to, which is probably buried deeply in the code somewhere...

===General Tokens===

=====''[HIBERNATION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: A species which hibernates will not spawn on the map outside of the valid seasons -- it will remain comfortably within the site populations instead. Species which hibernate will automatically go to sleep during fortress mode and remain asleep, requiring no food or water, until the end of the season. At the end of the season, however, they will be set automatically to Hungry and Thirsty and will seek food to eat. (Though many species which hibernate remain awake, and do eat and drink while hibernating, this implementation is far simpler to simulate.)

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Creature Variation Tokens ==

=====''[CVCT_APPEND:...]'' =====

: '''Arguments:'''
:* ''...'': Colon-separated list of additional parameters to append to end of CVCT_MASTER token's parameters

: As a fundamental improvement on my former ADD_BODY_TAG request, this would make use of existing CVCT functionality to allow appending parameters to existing tokens, with particular intention for use with a CVCT_MASTER:BODY (but fundamentally it should work with any tag, except perhaps than reciprocal creature variation tags). There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers ''unless I replace one of those existing body parts with itself while doing so''). This means that your creature variation tag must cover all possible usage scenarios instead of being properly generic -- i.e., instead of simply adding tags to the BODY, it has to target BASIC_1PARTBODY, BASIC_2PARTBODY, HUMANOID, HUMANOID_NECK, HUMANOID_HOOF, HUMANOID_NECK_HOOF, etc., etc....

: Note in particular that this would vastly simplify such things as sheep:

[CREATURE_VARIATION:BASIC_2HORNS]
[CV_CONVERT_TAG]
[CVCT_MASTER:BODY]
[CVCT_APPEND:2HEAD_HORN]

: Instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then a CREATURE_VARIATION could be applied to the male caste, [APPLY_CREATURE_VARIATION:BASIC_2HORNS]. The fact that such a tag would be generically useful for such things as demon variations of humanoids, etc. is also of note.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

User:JT/Token Wishlist

2014-07-23T01:20:47Z

JT: note to self: when looking up the correct tag to use, don't rely on a badly-written object definition as your source

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or ANY for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_NUMBER) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

=====''[SOULMATE]''=====

: This tag causes a species to have only one mate at a time. Once it has found a mate, it will remain with that mate, and it will not reproduce unless its mate is accessible. If its mate is killed or passes away naturally, it will receive an unhappy thought even if it is not an [INTELLIGENT] species, but it will then be capable of finding another mate. Most humanoids demonstrate this behaviour.

=====''[SOULMATE_PERMANENT]''=====

: This tag causes a species to seek only one mate during its lifetime. It will receive an indefinite unhappy thought when its soulmate dies, and will never again seek another mate. Seahorses fit this behaviour.

=====''[SEASONAL_REPRODUCTION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: This tag means that the species is only seasonally fertile, in that it will reproduce only in certain seasons; e.g., [SEASONAL_REPRODUCTION:SPRING]. When a fertile season begins, the animal resumes normal computation of its fertility cycles. When the season ends (and the next season is no longer fertile), the being is suppressed from mating; the fertility cycle counter halts, to resume from where it left off in the next fertile season.

: This allows limiting certain species' reproductive intervals to reduce overpopulation due to year-round reproduction.

: Default is [SEASONAL_REPRODUCTION:ANY].

=====''[TEMPERATE_REPRODUCTION:weather...]''=====

: '''Arguments:'''
:* ''season'': ANY; one or more of SCORCHING, HOT, WARM, TEMPERATE, COOL, COLD, or FREEZING, separated by colons; or a specific temperature range ''min'':''max'' in degrees Urist.

: e.g., [TEMPERATE_REPRODUCTION:ANY], [TEMPERATE_REPRODUCTION:SCORCHING:HOT:WARM], [TEMPERATE_REPRODUCTION:10000:10060]

: In addition to a blacklist based on SEASONAL_REPRODUCTION, a species may also have its fertility blacklist set to certain weather, to prevent it from reproducing in environmental conditions that are hostile to it or its offspring. It is intended more for fortress mode (and ostensibly adventure mode in the far future), to prevent species that have been imported from breeding successfully in hostile environments, as BIOME already serves as an adequate limiter on worldgen populations.

: Default is [TEMPERATE_REPRODUCTION:ANY].

=====''[CONDITIONAL_FERTILITY:population]''=====

: '''Arguments:'''
:* ''population'': The population limit of the species within the region.

: This tag allows a population to be conditionally fertile, based on its population number per unit area; if the population exceeds the specified number, all fertility cycles halt until the population falls. Aside from its metagame usefulness for controlling populations for better frame rates, it represents those species in reality which are genuinely capable of conditional fertility. As with other caps, it is a soft cap -- multiple births in a litter or pre-existing pregnancies can bring the population over the cap.

=====''[REPRODUCTION_FREQUENCY:days:duration]''=====

: '''Arguments:'''
:* ''days'': The number of days between subsequent fertility cycles.
:* ''duration'': The length of days (overlapping with the ''days'' parameter) during which the animal is fertile.

: This controls the frequency of a species' reproductive cycles, blacklisting animals from becoming pregnant outside of their fertility periods.

: For code simplicity, since the oestrus event itself wouldn't simulated (although simulating it would be of particular realism interest for keen-sensed animals, especially bloodthirsty animals like sharks or ''Pitch Black''-style blind predators), it would be easier just to make the "fertile" period begin immediately when the cycle begins, rather than halfway through.

: The default is the standard human 28-day cycle, [REPRODUCTION_FREQUENCY:28:5] -- the female is fertile for 5 days out of every 28-day period. If a fertility check falls on this interval... congratulations!

=====''[REPRODUCTION_SUCCESS:permille]''=====

: '''Arguments:'''
:* ''permille'': Chance of becoming pregnant on a pregnancy check.

: This allows finer control over successful reproduction even when blacklisting based on season, temperature/climate, fertility cycle, and population are taken into account, to allow species that tend to reproduce too quickly to be fine-tuned for greater realism.

: Default is whatever the current pregnancy chance is set to, which is probably buried deeply in the code somewhere...

===General Tokens===

=====''[HIBERNATION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: A species which hibernates will not spawn on the map outside of the valid seasons -- it will remain comfortably within the site populations instead. Species which hibernate will automatically go to sleep during fortress mode and remain asleep, requiring no food or water, until the end of the season. At the end of the season, however, they will be set automatically to Hungry and Thirsty and will seek food to eat. (Though many species which hibernate remain awake, and do eat and drink while hibernating, this implementation is far simpler to simulate.)

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=====''[ADD_BODY_TAG:caste:...]'' =====

: '''Arguments:'''
:* ''caste'': Caste within the current creature object to append additional body tokens to
:* ''...'': Colon-separated list of [[body tokens|body templates]]

: This is an ''appendix'' of the creature's BODY token which allows you to add additional body parts to male or female members of the creature, instead of being required to redefine the caste through SELECT_CASTE and override the BODY token already present. There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers). (I could be wrong here as I delve deeper (snerk) into the creature variations, but even so the creature variation method, though immensely powerful, is extremely obtuse compared to simple edits.)

: Whenever a creature is created, it receives all of the body parts from the BODY token, plus all of the body templates from each ADD_BODY token in sequence that matches its caste.

: Note in particular that this would vastly simplify such things as sheep -- instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then an ADD_BODY_TAG:MALE:2HEAD_HORN tag anywhere after the CASTE:MALE has been defined.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

User:JT/Token Wishlist

2014-07-22T22:43:34Z

JT: more requests, based on more work with my (as yet unannounced) creature mods

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or ANY for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_SIZE) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

=====''[SOULMATE]''=====

: This tag causes a species to have only one mate at a time. Once it has found a mate, it will remain with that mate, and it will not reproduce unless its mate is accessible. If its mate is killed or passes away naturally, it will receive an unhappy thought even if it is not an [INTELLIGENT] species, but it will then be capable of finding another mate. Most humanoids demonstrate this behaviour.

=====''[SOULMATE_PERMANENT]''=====

: This tag causes a species to seek only one mate during its lifetime. It will receive an indefinite unhappy thought when its soulmate dies, and will never again seek another mate. Seahorses fit this behaviour.

=====''[SEASONAL_REPRODUCTION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: This tag means that the species is only seasonally fertile, in that it will reproduce only in certain seasons; e.g., [SEASONAL_REPRODUCTION:SPRING]. When a fertile season begins, the animal resumes normal computation of its fertility cycles. When the season ends (and the next season is no longer fertile), the being is suppressed from mating; the fertility cycle counter halts, to resume from where it left off in the next fertile season.

: This allows limiting certain species' reproductive intervals to reduce overpopulation due to year-round reproduction.

: Default is [SEASONAL_REPRODUCTION:ANY].

=====''[TEMPERATE_REPRODUCTION:weather...]''=====

: '''Arguments:'''
:* ''season'': ANY; one or more of SCORCHING, HOT, WARM, TEMPERATE, COOL, COLD, or FREEZING, separated by colons; or a specific temperature range ''min'':''max'' in degrees Urist.

: e.g., [TEMPERATE_REPRODUCTION:ANY], [TEMPERATE_REPRODUCTION:SCORCHING:HOT:WARM], [TEMPERATE_REPRODUCTION:10000:10060]

: In addition to a blacklist based on SEASONAL_REPRODUCTION, a species may also have its fertility blacklist set to certain weather, to prevent it from reproducing in environmental conditions that are hostile to it or its offspring. It is intended more for fortress mode (and ostensibly adventure mode in the far future), to prevent species that have been imported from breeding successfully in hostile environments, as BIOME already serves as an adequate limiter on worldgen populations.

: Default is [TEMPERATE_REPRODUCTION:ANY].

=====''[CONDITIONAL_FERTILITY:population]''=====

: '''Arguments:'''
:* ''population'': The population limit of the species within the region.

: This tag allows a population to be conditionally fertile, based on its population number per unit area; if the population exceeds the specified number, all fertility cycles halt until the population falls. Aside from its metagame usefulness for controlling populations for better frame rates, it represents those species in reality which are genuinely capable of conditional fertility. As with other caps, it is a soft cap -- multiple births in a litter or pre-existing pregnancies can bring the population over the cap.

=====''[REPRODUCTION_FREQUENCY:days:duration]''=====

: '''Arguments:'''
:* ''days'': The number of days between subsequent fertility cycles.
:* ''duration'': The length of days (overlapping with the ''days'' parameter) during which the animal is fertile.

: This controls the frequency of a species' reproductive cycles, blacklisting animals from becoming pregnant outside of their fertility periods.

: For code simplicity, since the oestrus event itself wouldn't simulated (although simulating it would be of particular realism interest for keen-sensed animals, especially bloodthirsty animals like sharks or ''Pitch Black''-style blind predators), it would be easier just to make the "fertile" period begin immediately when the cycle begins, rather than halfway through.

: The default is the standard human 28-day cycle, [REPRODUCTION_FREQUENCY:28:5] -- the female is fertile for 5 days out of every 28-day period. If a fertility check falls on this interval... congratulations!

=====''[REPRODUCTION_SUCCESS:permille]''=====

: '''Arguments:'''
:* ''permille'': Chance of becoming pregnant on a pregnancy check.

: This allows finer control over successful reproduction even when blacklisting based on season, temperature/climate, fertility cycle, and population are taken into account, to allow species that tend to reproduce too quickly to be fine-tuned for greater realism.

: Default is whatever the current pregnancy chance is set to, which is probably buried deeply in the code somewhere...

===General Tokens===

=====''[HIBERNATION:season...]''=====

: '''Arguments:'''
:* ''season'': ANY, or one or more of SPRING, SUMMER, AUTUMN, and/or WINTER separated by colons.

: A species which hibernates will not spawn on the map outside of the valid seasons -- it will remain comfortably within the site populations instead. Species which hibernate will automatically go to sleep during fortress mode and remain asleep, requiring no food or water, until the end of the season. At the end of the season, however, they will be set automatically to Hungry and Thirsty and will seek food to eat. (Though many species which hibernate remain awake, and do eat and drink while hibernating, this implementation is far simpler to simulate.)

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=====''[ADD_BODY_TAG:caste:...]'' =====

: '''Arguments:'''
:* ''caste'': Caste within the current creature object to append additional body tokens to
:* ''...'': Colon-separated list of [[body tokens|body templates]]

: This is an ''appendix'' of the creature's BODY token which allows you to add additional body parts to male or female members of the creature, instead of being required to redefine the caste through SELECT_CASTE and override the BODY token already present. There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers). (I could be wrong here as I delve deeper (snerk) into the creature variations, but even so the creature variation method, though immensely powerful, is extremely obtuse compared to simple edits.)

: Whenever a creature is created, it receives all of the body parts from the BODY token, plus all of the body templates from each ADD_BODY token in sequence that matches its caste.

: Note in particular that this would vastly simplify such things as sheep -- instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then an ADD_BODY_TAG:MALE:2HEAD_HORN tag anywhere after the CASTE:MALE has been defined.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

Creature token

2014-07-22T22:04:59Z

JT:

{{Migrated_article}}
{{av}}{{Quality|Exceptional}}

A full list of all known creature tokens.

__NOTOC__

<div align="center">
{{alphabetical TOC}}
</div>

==A==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ADOPTS_OWNER}}
| Caste
|
| Tame creature cannot be made available for adoption, instead automatically adopting whoever it wants. It appears that the basic requirements for adoption are intact; for example, the creature is more likely to adopt an owner which likes creatures of that species.{{verify}}

|-
| {{text anchor|ALCOHOL_DEPENDENT}}
| Caste
|
| Creature needs alcohol to get through the working day, choosing to drink booze instead of water if possible. Going sober for too long reduces speed.

|-
| {{text anchor|ALL_ACTIVE}}
| Caste
|
| Sets if the creature is active in day, night, and twilight. Seems to be a separate value from DIURNAL/NOCTURNAL/CREPUSCULAR, rather than implying them.

|-
| {{text anchor|ALTTILE}}
| Creature
|
| If set, the creature will blink between its [TILE] and its [ALTTILE].

|-
| {{text anchor|AMBUSHPREDATOR}}
| Caste
|
| Instead of charging relentlessly at prey, a creature with this tag will wait till the prey is within a few squares before charging.{{verify}}

|-
| {{text anchor|AMPHIBIOUS}}
| Caste
|
| Allows a creature to breathe with or without [[water]]. Implies [AQUATIC].

|-
| {{text anchor|APP_MOD_DESC_RANGE}}
| Caste
|
*Range
| [http://www.bay12forums.com/smf/index.php?topic=60554.msg1766793#msg1766793 Forum post describing how description ranges work]

|-
| {{text anchor|APP_MOD_GENETIC_MODEL}}
| Caste
|
*Model (Accepts DOMINANT_MORE, DOMINANT_LESS, and MIX)
| Defines a genetic model for the relevant appearance modifier(s). May or may not do anything significant at present.

|-
| {{text anchor|APP_MOD_IMPORTANCE}}
| Caste
|
*number
| Determines how important the appearance modifier is, for determining whether it shows up in the creature description.{{verify}}

|-
| {{text anchor|APP_MOD_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| creates a noun for the appearance and whether it is singular or plural

|-
| {{text anchor|APP_MOD_RATE}}
| Caste
|
*Rate (integer)
*Scale (DAILY, YEARLY)
*min:max of growth
*start year:start day
*end year:end day
| setting the growth rate of the modifier. The last two tokens can be replaced by NO_END to have growth continue indefinitely.

|-
| {{text anchor|APPLY_CREATURE_VARIATION}}
| Special
|
*CV TEMPLATE NAME
| Loads the Creature Variation Template specified.

|-
| {{text anchor|APPLY_CURRENT_CREATURE_VARIATION}}
| Special
|
| Applies loaded Creature Variation

|-
| {{text anchor|AQUATIC}}
| Caste
|
| Creature can breathe in water, but air-drowns on dry land.

|-
| {{text anchor|ARENA_RESTRICTED}}
| Caste
|
| Does not appear in arena mode list.

|-
| {{text anchor|ARTIFICIAL_HIVEABLE}}
| Creature
|
| Can be kept in artificial hives by beekeepers.

|-
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
| Caste
|
| Does not attack or frighten wildlife.

|-
| {{text anchor|ATTACK}}
| Caste
|
*token
*bodypart
*selection criteria
*location
| Defines the attack name, and the body part used. See [[#Attack Tokens|below]] for valid subtokens
'''Example:'''<br />
[ATTACK:GORE:BODYPART:BY_CATEGORY:HORN]<br />
''GORE'' : name of the attack<br />
''BODYPART:BY_CATEGORY:HORN'' : the horn is used to attack (presuming the creature has one)

|-
| {{text anchor|ATTACK_TRIGGER}}
| Caste
| pop:exported wealth:created wealth
| Specifies when a [[megabeast]] will attack the fortress.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==B==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|BABY}}
| Caste
| integer
| Age at which creature is considered a child. Default is zero. One can think of this as the duration of the baby stage.

|-
| {{text anchor|BABYNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in baby state at the caste level. For non-caste-specific baby names, see GENERAL_BABY_NAME.

|-
| {{text anchor|BEACH_FREQUENCY}}
| Caste
|
| [[Whale]]s and [[Sea nettle jellyfish|jellyfish]] have this. Controls the beaching frequency of the creature.

|-
| {{text anchor|BENIGN}}
| Caste
|
| The creature is non-aggressive by default, but may lash out if agitated or disturbed.

|-
| {{text anchor|BIOME}}
| Creature
|
* [[biome token]]
| Select a [[Biome]] the creature may appear in.

|-
| {{text anchor|BLOOD}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| Specifies what the creature's blood is made of.

|-
| {{text anchor|BLOODSUCKER}}
| Caste
|
| Seems to be required to make the creature denouncable as a creature of the night.

|-
| {{text anchor|BODY}}
| Caste
| body parts
| Draws body parts from OBJECT:BODY files (such as body_default.txt)
'''Example:'''<br />
[BODY:BODY_WITH_HEAD_FLAG:HEART:GUTS:BRAIN:MOUTH] <br />
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.

|-
| {{text anchor|BODY_APPEARANCE_MODIFIER}}
| Caste
|
*ATTRIBUTE
*lowest:lower:low:median:high:higher:highest
| These body modifiers give individual creatures different characteristics. In the case of HEIGHT, BROADNESS and LENGTH, the modifier is also a percentage change to the BODY_SIZE of the individual creature. The seven numbers afterward give a distribution of ranges. Each interval has an equal chance of occurring.
'''Example:'''<br />
[BODY_APPEARANCE_MODIFIER:HEIGHT:90:95:98:100:102:105:110] <br />
''HEIGHT'' : marks the height to be changed <br />
''90:95:98:100:102:105:110'' : sets the range from the shortest (90% of the average height) to the tallest (110% of the average height) creature variation.

|-
| {{text anchor|BODY_DETAIL_PLAN}}
| Caste
| PlanName, PlanName:type:type:type:etc.
| loads a plan 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 />
[BODY_DETAIL_PLAN:VERTEBRATE_TISSUE_LAYERS:SKIN:FAT:MUSCLE:BONE:CARTILAGE] <br />
This creates the detailed body of a [[fox]], the skin, fat, muscle, bones and cartilage out of the vertebrate tissues.<br />
A [[Purring maggot|maggot]] would only need:<br />
''[BODY_DETAIL_PLAN:EXOSKELETON_TISSUE_LAYERS:SKIN:FAT:MUSCLE]''

|-
| {{text anchor|BODY_SIZE}}
| Caste
| years:days:size
| Sets size at a given age. Size is in cubic centimeters, and for normal body materials is roughly equal to the creature's average weight in grams.
'''Example:'''<br />
[BODY_SIZE:0:0:10000]<br />
[BODY_SIZE:1:168:50000]<br />
[BODY_SIZE:12:0:220000]<br />
This describes the size of a [[minotaur]]. His birth size would be 10,000 cm<sup>3</sup> (~10 kg). At 1 year and 168 days old he would be 50,000 cm<sup>3</sup> (~50 kg). And as an adult (at 12 years old) he would be 220,000 cm<sup>3</sup> and weigh roughly 220 kg.

|-
| {{text anchor|BODYGLOSS}}
| Caste
| gloss
| Substitutes body part text with replacement text. Draws gloss information from OBJECT:BODY files (such as body_default.txt)

|-
| {{text anchor|BONECARN}}
| Caste
|
| Creature eats bones. Implies CARNIVORE and has the same worldgen problem.

|-
| {{text anchor|BP_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets up the breadth of possibilities for appearance qualities for a selected BP group. EG. Eyes (CLOSE_SET, DEEP_SET, ROUND_VS_NARROW, LARGE_IRIS),Lips (THICKNESS), Nose (BROADNESS, LENGTH, UPTURNED, CONVEX), Ear (SPLAYED_OUT, HANGING_LOBES, BROADNESS, HEIGHT), Tooth (GAPS), Skull (HIGH_CHEEKBONES, BROAD_CHIN, JUTTING CHIN, SQUARE_CHIN), Neck (DEEP_VOICE, RASPY_VOICE), Head (BROADNESS, HEIGHT)

|-
| {{text anchor|BUILDINGDESTROYER}}
| Caste
| 1 or 2
| Allows a creature to destroy furniture and buildings. Value [1] targets mostly doors, hatches, furniture and the like. Value [2] targets anything not made with the b + C commands.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==C==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|CAN_DO_INTERACTION}}
| Caste
| interaction token
| The creature can perform an interaction. See [[interaction token]].

|-
| {{text anchor|CAN_LEARN}}
| Caste
|
| The creature gains skills and can have professions. Note that this token makes the creature unable to be butchered by an adventurer so it is not recommended for uncivilized monsters. Adventurers lacking this token can allocate but not increase attributes and skills. skills allocated will disappear on start.

|-
| {{text anchor|CAN_SPEAK}}
| Caste
|
| Can talk. Note that it is not necessary for a creature to gain social skills. If a member of a civilization (such as a pet) has this token, it'll need to eat and drink.{{verify}}

|-
| {{text anchor|CANNOT_CLIMB}}
| Caste {{Verify}}
|
| Creature cannot climb, even if it has free grasps.

|-
| {{text anchor|CANNOT_JUMP}}
| Caste
|
| Creature cannot jump.

|-
| {{text anchor|CANNOT_UNDEAD}}
| Caste
|
| Alias for NOT_LIVING

|-
| {{text anchor|CANOPENDOORS}}
| Caste
|
| Allows the creature to open doors.

|-
| {{text anchor|CARNIVORE}}
| Caste
|
| Creature ''only'' eats meat. If the creature goes on rampages in worldgen, it will often devour the people/animals it kills. Currently bugged in worldgen -- exclusively carnivore civilizations always starve out. Goblins and kobolds live off raw exceptions.

|-
| {{text anchor|CASTE}}
| Creature
|
*name
| Defines a caste.

|-
| {{text anchor|CASTE_ALTTILE}}
| Caste
|
*tile number or "letter"
| Caste-specific ALT_TILE. Requires CASTE_TILE.

|-
| {{text anchor|CASTE_COLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific COLOR.

|-
| {{text anchor|CASTE_GLOWCOLOR}}
| Caste
|
*fg
*bg
*brightness
| Caste-specific GLOWCOLOR.

|-
| {{text anchor|CASTE_GLOWTILE}}
| Caste
|
*tile value or "letter"
| Caste-specific GLOWTILE.

|-
| {{text anchor|CASTE_NAME}}
| Caste
| singular:plural:adjective
| Caste-specific NAME.

|-
| {{text anchor|CASTE_PROFESSION_NAME}}
| Caste
|
*[[Unit type token]] (Profession)
*singular
*plural
| Caste-specific PROFESSION_NAME.

|-
| {{text anchor|CASTE_SOLDIER_ALTTILE}}
| Caste
| 'character' or tile number
| Caste-specific SOLDIER_ALTTILE. Requires CASTE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SOLDIER_TILE}}
| Caste
| 'character' or tile number
| Caste-specific CREATURE_SOLDIER_TILE.

|-
| {{text anchor|CASTE_SPEECH}}
| Caste
| speech file
| Caste-specific SPEECH.

|-
| {{text anchor|CASTE_TILE}}
| Caste
|
* tile number or "letter"
| Caste-specific CREATURE_TILE.

|-
| {{text anchor|CAVE_ADAPT}}
| Caste
|
| Gives the creature a bonus in caves. Also causes [[Cave adaptation]].

|-
| {{text anchor|CDI}}
| Caste
| Varies
| Specifies details for the preceding CAN_DO_INTERACTION token. See [[Interaction token]].

|-
| {{text anchor|CHANGE_BODY_SIZE_PERC}}
| Caste
| integer
| Multiplies body size by a factor of (integer)%. 50 halves size, 200 doubles.

|-
| {{text anchor|CHILD}}
| Caste
| integer
| age at which creature is considered an adult. One can think of this as the duration of the child stage. Without this token, a creature will not reproduce in Fortress mode.

|-
| {{text anchor|CHILDNAME}}
| Caste
| singular:plural
| Defines a new name for a creature in child state at the caste level. For non-caste-specific child names, see GENERAL_CHILD_NAME.

|-
| {{text anchor|CLUSTER_NUMBER}}
| Creature
|
*min
*max
| The minimum/maximum numbers of how many creatures per spawned cluster. Certain vermin fish use this token in combination with temperate ocean and river biome tokens to perform seasonal migrations.
e.g. [CLUSTER_NUMBER:1:3]

|-
| {{text anchor|CLUTCH_SIZE}}
| Caste
|
*min
*max
|Number of eggs laid in one sitting.

|-
| {{text anchor|COLONY_EXTERNAL}}
| Caste
|
| Caste hovers around colony.

|-
| {{text anchor|COLOR}}
| Creature
| foreground:background:brightness
| Color of the creature's tile. See [[Color]] for usage.

|-
| {{text anchor|COMMON_DOMESTIC}}
| Caste
|
| Any civilization with USE_COMMON_DOMESTIC tag (humans, dwarves) has domesticated this creature by default and always has access to it, even without any wild populations. Useless without PET, PACK_ANIMAL, WAGON_PULLER or MOUNT tags and invalid on FANCIFUL creatures. Requires NATURAL tag?{{verify}}

|-
| {{text anchor|CONVERTED_SPOUSE}}
| Caste
|
| Creatures of this caste's species with the SPOUSE_CONVERTER and NIGHT_CREATURE_HUNTER tokens will kidnap SPOUSE_CONVERSION_TARGETs of an appropriate sex and convert them into castes with CONVERTED_SPOUSE.

|-
| {{text anchor|COOKABLE_LIVE}}
| Caste
|
| Set this to allow the creature to be cooked in meals without first being butchered/cleaned. Used for mussels, for one.

|-
| {{text anchor|CRAZED}}
| Caste
|
| Creature is 'berserk' and will attack all other creatures, except members of its own species that ALSO have the CRAZED tag.

|-
| {{text anchor|COPY_TAGS_FROM}}
| Special
|
*CREATURE NAME
| Copies tags from another specified creature.

|-
| {{text anchor|CREATURE_CLASS}}
| Caste
|
*classname
| An arbitrary creature classification. Can be set to anything, but only existing uses are GENERAL_POISON (used in syndromes) and EDIBLE_GROUND_BUG (valid targets for GOBBLE_VERMIN_x tokens). A single creature can have multiple classes. Eligibility for certain entity positions can also be permitted or restricted by this tag.

|-
| {{text anchor|CREATURE_SOLDIER_TILE}}
| Creature
| 'character' or tile number
| Creatures active in their civilization's military will use this tile instead.

|-
| {{text anchor|CREATURE_TILE}}
| Creature
| 'character' or tile number
| The symbol of the creature in ASCII mode.

|-
| {{text anchor|CREPUSCULAR}}
| Caste
|
| Sets if the creature is active at twilight.

|-
| {{text anchor|CURIOUSBEAST_EATER}}
| Caste
|
| Allows a creature to steal and eat edible items from a site.

|-
| {{text anchor|CURIOUSBEAST_GUZZLER}}
| Caste
|
| Allows a creature to (very quickly) drink your alcohol. Or spill the barrel to the ground. Also affects undead versions of the creature.

|-
| {{text anchor|CURIOUSBEAST_ITEM}}
| Caste
|
| Allows a creature to steal things (apparently the highest value it can find). If the creature goes on rampages in worldgen, it will often steal items instead of attacking. Kea birds are infamous for this.

|-
| {{text anchor|CV_ADD_TAG}}
| Special
|
*TAG NAME
| Adds a tag. Used in conjunction with creature variation templates.

|-
| {{text anchor|CV_REMOVE_TAG}}
| Special
|
*TAG NAME
| Removes a tag. Used in conjunction with creature variation templates.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==D==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|DEMON}}
| Caste
|
| Found on generated [[demon]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|DESCRIPTION}}
| Caste
| text
| A brief description of the creature type.

|-
| {{text anchor|DIE_WHEN_VERMIN_BITE}}
| Caste
|
| Dies upon attacking. Used for [[bee]] stings.

|-
| {{text anchor|DIFFICULTY}}
| Caste
| integer
| Increases experience gain during adventure mode. Creatures with 11 or higher are not assigned for quests in adventure mode.

|-
| {{text anchor|DIURNAL}}
| Caste
|
| Sets if the creature is active in day.

|-
| {{text anchor|DIVE_HUNTS_VERMIN}}
| Caste
|
| Found on [[peregrine falcon]]s. The creature hunts vermin by diving from the air. Does not seem to work on tame creatures.

|-
| {{text anchor|DOES_NOT_EXIST}}
| Creature
|
| Creature does not actually exist; used for a few [[fanciful]] creatures of myth.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==E==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|EBO_ITEM}}
| Caste
| [[item token]]:[[material token]] (ANY_HARD_STONE can be used for the material)
| Defines the item that the creature drops upon being butchered. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EBO_SHAPE}}
| Caste
| gem shape
| The shape of the extra item of the creature upon butchering. Used with EXTRA_BUTCHER_OBJECT.

|-
| {{text anchor|EGG_MATERIAL}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, or GAS)
| Egg material. Egg-laying creatures will 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.

|-
| {{text anchor|EGG_SIZE}}
| Caste
|
*size
| Determines the size of eggs.

|-
| {{text anchor|EQUIPMENT_WAGON}}
| Creature
|
| Makes the creature into a large 3x3 creature responsible for carrying trade goods, pulled by two [WAGON_PULLER]s and driven by a merchant.

|-
| {{text anchor|EQUIPS}}
| Caste
|
| Allows the creature to wear or wield items.

|-
| {{text anchor|EVIL}}
| Creature
|
| Creature is considered evil and will only show up in evil biomes. Civilizations with USE_EVIL_ANIMALS can domesticate them regardless of exotic status. Has no effect on cavern creatures.

|-
| {{text anchor|EXTRA_BUTCHER_OBJECT}}
| Caste
|
* BY_CATEGORY, BY_TYPE, BY_TOKEN
* TYPE, CATEGORY, or TOKEN
| The creature drops an additional object when butchered (typically a gizzard stone), defined by EBO_ITEM and EBO_SHAPE.

|-
| {{text anchor|EXTRACT}}
| Caste
|
* [[material token]]
| Defines a creature extract which can be obtained via [[small animal dissection]].

|-
| {{text anchor|EXTRAVISION}}
| Caste
|
| Creature can see regardless of whether it has working eyes.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==F==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|FANCIFUL}}
| Creature
|
| The creature is a thing of legend and known to all civilizations. Its materials cannot be requested or preferred. The tag also adds some art value modifiers. Used for things like dragons and other legendary creatures. Conflicts with {{token|COMMON_DOMESTIC|c}}

|-
| {{text anchor|FEATURE_ATTACK_GROUP}}
| Caste
|
| Found on subterranean animal-man tribals.

|-
| {{text anchor|FEATURE_BEAST}}
| Caste
|
| Found on [[forgotten beast]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|FEMALE}}
| Caste
|
| The creature is female and can bear young. Usually determined inside a caste.

|-
| {{text anchor|FIREIMMUNE}}
| Caste
|
| The creature is immune to FIREBALL and FIREJET attacks.

|-
| {{text anchor|FIREIMMUNE_SUPER}}
| Caste
|
| The creature is immune to DRAGONFIRE attacks. Implies {{token|FIREIMMUNE|c}}.

|-
| {{text anchor|FISHITEM}}
| Caste
|
| Needs to be cleaned at a fishery

|-
| {{text anchor|FIXED_TEMP}}
| Caste
| temperature
| The natural heat generated by the creature.

|-
| {{text anchor|FLEEQUICK}}
| Caste
|
| Determines how soon a creature flees in a losing battle. Creatures with this tag will flee at the first sign of resistance.

|-
| {{text anchor|FLIER}}
| Caste
|
| Allows a creature to fly. Fortress Mode pathfinding only partially incorporates flying - flying creatures need a land path to exist between them and an area in order to access it, but as long as one such path exists, they do not need to use it, instead being able to fly over intervening obstacles.

|-
| {{text anchor|FREQUENCY}}
| Creature
|
*number, max 100
| Determines the chances of a creature appearing within its environment, with higher values resulting in more frequent appearance. 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}}.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==G==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|GAIT}}
| Unknown
|
* type (WALK, CLIMB, SWIM, CRAWL, or FLY)
* gait name
* full speed
* build up time:max turning speed:start speed (or NO_BUILD_UP for instant use)
* energy use
* Optional flags:
** LAYERS_SLOW - if gait is slowed by increased weight
** STRENGTH - if gait is affected by strength stat
** AGILITY - if gait is affected by agility stat
** STEALTH_SLOWS:penalty - if gait is slowed by being stealthed
| Defines a gait at which the creature can move. See [[Gait]] for more information.

|-
| {{text anchor|GENERAL_BABY_NAME}}
| Creature
| singular:plural
| BABYNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_CHILD_NAME}}
| Creature
| singular:plural
| CHILDNAME applied regardless of caste.

|-
| {{text anchor|GENERAL_MATERIAL_FORCE_MULTIPLIER}}
| Caste
| A:B
| Attacks against the creature have their force modified by A/B. For example, 1:2 will halve the force of an attack made against the creature. {{verify}}

|-
| {{text anchor|GENERATED}}
| Creature
|
| Found on procedurally generated creatures like [[Forgotten beast]]s, (biome name) [[titan]]s, [[Demon]]s, and [[night creature]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|GETS_INFECTIONS_FROM_ROT}}
| Caste
|
| Creature can get infections from necrotic tissue.

|-
| {{text anchor|GETS_WOUND_INFECTIONS}}
| Caste
|
| This creature's wounds can become infected if left untreated for too long.

|-
| {{text anchor|GLOWCOLOR}}
| Creature
|
*foreground
*background
*brightness
| The colour of the creature's GLOWTILE.

|-
| {{text anchor|GLOWTILE}}
| Creature
| ascii character
| If present, the being glows in the dark (generally used for Adventure Mode). The tile is what replaces the being's current tile when it is obscured from your sight by darkness. The default setting for kobolds (a yellow quotation mark) provides a nice "glowing eyes" effect. The game is also hardcoded to automatically convert quotation mark GLOWTILES into apostrophes if the creature has lost one eye. This works at the generic creature level - for caste-specific glow tiles, use CASTE_GLOWTILE instead.

|-
| {{text anchor|GNAWER}}
| Caste
| verb
| The creature can and will gnaw its way out of [[animal trap]]s and [[cage]]s using the specified verb, depending on the material from which it is made. Due to a bug, however, they will only escape from [[artifact]]s.{{bug|6117}}

|-
| {{text anchor|GOBBLE_VERMIN_CLASS}}
| Caste
| class
| The creature eats vermin of the specified class.

|-
| {{text anchor|GOBBLE_VERMIN_CREATURE}}
| Caste
| creature:caste
| The creature eats a specified vermin.

|-
| {{text anchor|GO_TO_END}}
| Special
|
| When using tags from an existing creature, inserts new tags at the end of the creature.

|-
| {{text anchor|GO_TO_START}}
| Special
|
| When using tags from an existing creature, inserts new tags at the beginning of the creature.

|-
| {{text anchor|GO_TO_TAG}}
| Special
|
| When using tags from an existing creature, inserts new tags after the specified tag.

|-
| {{text anchor|GOOD}}
| Creature
|
| Creature is considered good and will only show up in good biomes. [[unicorn]]s for example. Civilizations with USE_GOOD_ANIMALS can domesticate them regardless of exotic status. Presumably has no effect on cavern creatures.

|-
| {{text anchor|GRASSTRAMPLE}}
| Caste
| value
| The value determines how rapidly grass is trampled when a creature steps on it - a value of 0 causes the creature to never damage grass, while a value of 100 causes grass to be trampled as rapidly as possible. Defaults to 5.

|-
| {{text anchor|GRAVITATE_BODY_SIZE}}
| Caste
| target value
| Used in Creature Variants. This token changes the adult body size to the average of the old adult body size and the target value and scales all intermediate growth stages by the same factor.

|-
| {{text anchor|GRAZER}}
| Caste
|
*number
| 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. See [[Pasture]] for details on its issues.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==H==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|HABIT}}
| Caste
| type:probability
| 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, and COLLECT_WEALTH. These require the creature to have a lair to work properly, and also don't seem to work on creatures who are not (SEMI)MEGABEASTs or NIGHT_CREATURE_HUNTERs.

|-
| {{text anchor|HABIT_NUM}}
| Caste
| number or TEST_ALL
| "If you set HABIT_NUM to a number, it should give you that exact number of habits according to the weights.".<sup>[[http://www.bay12forums.com/smf/index.php?topic=60554.msg1719248#msg1719248 source post]]</sup> All lists of HABITs are preceded by [HABIT_NUM:TEST_ALL]

|-
| {{text anchor|HAS_NERVES}}
| Caste
|
| The creature has nerves in its muscles. Cutting the muscle tissue can sever motor and sensory nerves.

|-
| {{text anchor|HASSHELL}}
| Caste
|
| The creature has a shell. Seemingly no longer used - holdover from previous versions.

|-
| {{text anchor|HFID}}
| Creature
| Integer (generic token?)
| Found on generated [[angel]]s. Seemingly identifies a historical figure with said hist figure ID, possibly to associate it with hist figure.

|-
| {{text anchor|HIVE_PRODUCT}}
| Creature
|
*number
*[[time]]
*[[item token]]s
| What product is harvested from [[Beekeeping industry|beekeeping]].

|-
| {{text anchor|HOMEOTHERM}}
| Caste
|
| Default 'NONE'. The creature's normal body [[temperature]]

|-
| {{text anchor|HUNTS_VERMIN}}
| Caste
|
| Creature hunts and kills nearby vermin.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==I==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|IMMOBILE}}
| Caste
|
| The creature cannot move. Found on [[sponge]]s. Will also stop a creature from breeding in Fortress Mode (MALE and FEMALE are effected, if one is IMMOBILE no breeding will happen)

|-
| {{text anchor|IMMOBILE_LAND}}
| Caste
|
| The creature is immobile while on land. Only works on AQUATIC creatures which can't breathe on land.

|-
| {{text anchor|IMMOLATE}}
| Caste
|
| The creature radiates fire. It will ignite, and potentially completely destroy, items the creature is standing on. Keep booze away from critters with this tag. Also gives the vermin a high chance of escaping from [[animal trap]]s and [[cage]]s made of certain materials. Due to a bug, however, they will only escape from [[artifact]]s.{{bug|6117}}

|-
| {{text anchor|INTELLIGENT}}
| Caste
|
| Alias for [CAN_SPEAK] + [CAN_LEARN].

|-
| {{text anchor|ITEMCORPSE}}
| Caste
|
* [[item token]]
* [[material token]]
| Determines if the creature leaves behind a non-standard corpse (i.e. wood, statue, bars, ash from ghost etc.).

|-
| {{text anchor|ITEMCORPSE_QUALITY}}
| Caste
|
| The quality of an item-type corpse left behind; 5 is masterpiece-level.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==L==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|LAIR}}
| Caste
| type: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, SIMPLE_MOUND, WILDERNESS_LOCATION, SHRINE, and LABYRINTH.

|-
| {{text anchor|LAIR_CHARACTERISTIC}}
| Caste
| characteristic:probability
| Defines certain features of the creature's lair. The only valid characteristic is HAS_DOORS.

|-
| {{text anchor|LAIR_HUNTER}}
| Caste
|
| This creature will actively hunt adventurers in its lair.

|-
| {{text anchor|LAIR_HUNTER_SPEECH}}
| Caste
| speech file
| What this creature says while hunting adventurers in its lair.

|-
| {{text anchor|LARGE_PREDATOR}}
| Caste
|
| Will attack things that are smaller than it (like dwarves). Only one group of "large predators" will appear on any given map (possibly two groups on "savage" maps). In adventure 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."

|-
| {{text anchor|LARGE_ROAMING}}
| Creature
|
| In Fortress Mode, spawns outdoors and is not a vermin creature.

|-
| {{text anchor|LAYS_EGGS}}
| Caste
|
| Creature lays eggs instead of giving birth to live young.

|-
| {{text anchor|LAYS_UNUSUAL_EGGS}}
| Caste
|
* [[item token]]
* [[material token]]
| Creature lays a particular item instead of regular eggs.

|-
| {{text anchor|LIGAMENTS}}
| Caste
|
* [[material token]]
*healing rate
| Creature has ligaments in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|LIGHT_GEN}}
| Caste
|
| The creature will generate light, such as in adventurer mode at night.

|-
| {{text anchor|LIKES_FIGHTING}}
| Caste
|
| The creature will attack enemies rather than flee from them. This tag has the same effect on player-controlled creatures - included modded dwarves.

|-
| {{text anchor|LISP}}
| Caste
|
| Creature uses "sssssnake talk" (multiplies 'S' when talking - "My name isss Recisssiz.")

|-
| {{text anchor|LITTERSIZE}}
| Caste
|
* minimum
* maximum
| Determines the range of how many creatures are generated when giving birth. [LITTERSIZE:1:2]

|-
| {{text anchor|LOCKPICKER}}
| Caste
|
| Lets a creature open doors that are set to forbidden in Fortress Mode.

|-
| {{text anchor|LOOSE_CLUSTERS}}
| Creature
|
| The creatures will scatter if they have this tag, or form tight packs if they don't.

|-
| {{text anchor|LOW_LIGHT_VISION}}
| Caste
| number
| Determines how well a creature can see in the dark. Higher is better. Dwarves have 10000, which amounts to perfect nightvision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==M==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|MAGICAL}}
| Caste
|
| Unknown.

|-
| {{text anchor|MAGMA_VISION}}
| Caste
|
| Creature's able to see while covered in magma.

|-
| {{text anchor|MALE}}
| Caste
|
| The creature is male. Usually declared inside a caste.

|-
| {{text anchor|MANNERISM|MANNERISM_*}}
| Caste
|
*occasionally body part
| Adds a possible mannerism to the creature's profile.
See [[Creature mannerism token]] for further info.

|-
| {{text anchor|MATERIAL}}
| Creature
|
*material id
| Begins defining a new material.{{verify}}

|-
| {{text anchor|MATERIAL_FORCE_MULTIPLIER}}
| Caste
|
*[[Material token]]
*A:B
| Set the force multiplier of a specific material against the creature to A/B. For example, 10:1 multiplies the force by 10. {{verify}}

|-
| {{text anchor|MATUTINAL}}
| Caste
|
| Sets if the creature is active in dawn.

|-
| {{text anchor|MAXAGE}}
| Caste
| min:max
| Range of time in years in which death from old age may occur. Once a creature reaches the min value, it has a random chance each season of dying from old age. Unknown if the chance increases with further age.

|-
| {{text anchor|MEANDERER}}
| Caste
|
| Gives a creature random movement.

|-
| {{text anchor|MEGABEAST}}
| Caste
|
| A 'boss' creature. A small number of the creature 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.

|-
| {{text anchor|MENT_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|MENT_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher:highest
| Sets up a mental attribute's range of values (0-5000). All mental attribute ranges default to 200:800:900:1000:1100:1300:2000.

|-
| {{text anchor|MENT_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Mental attribute gain/decay rates. Defaults are 500:4:5:4.

|-
| {{text anchor|MILKABLE}}
| Caste
|
* [[material token]]
* frequency
| Allows the creature to be milked in the farmer's workshop. The frequency is the amount of time units the creature needs to "recharge".

|-
| {{text anchor|MISCHIEVIOUS}}
| Caste
|
| Alias for MISCHIEVOUS.

|-
| {{text anchor|MISCHIEVOUS}}
| Caste
|
| Will pull any levers it comes across. Also makes creature spawn invisible and with several ranks in Ambusher. "They go on little missions to mess with various fortress buildings, not just levers."

|-
| {{text anchor|MODVALUE}}
| Caste
|
| Seemingly no longer used.

|-
| {{text anchor|MOUNT}}
| Caste
|
| Creature may be used as a mount. No use for the player, but enemy siegers may arrive with cavalry.

|-
| {{text anchor|MOUNT_EXOTIC}}
| Caste
|
| Creature may be used as a mount, but civilizations cannot domesticate it in worldgen without certain exceptions.

|-
| {{text anchor|MULTIPART_FULL_VISION}}
| Caste {{Verify}}
|
| Allows the creature to have all-around vision as long as it has multiple heads(?) that can see. {{Verify}}

|-
| {{text anchor|MULTIPLE_LITTER_RARE}}
| Caste
|
| Makes litters with more than one offspring rare. To ensure larger littlers, use [[DF2012:Creature_token#LITTERSIZE|LITTERSIZE]].

|-
| {{text anchor|MUNDANE}}
| Creature
|
| Marks if the creature is an actual real-life creature. Only used for age-names at present, and determining whether a creature will attack creatures with the AT_PEACE_WITH_WILDLIFE token.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==N==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|NAME}}
| Creature
| singular:plural:adjective
| The generic name for any creature of this type - will be used when distinctions between caste are unimportant. For names for specific castes, use CASTE_NAME instead. If left undefined, the creature will be labeled as "nothing" by the game.

|-
| {{text anchor|NATURAL}}
| Caste
|
| Animal is considered to be natural. Seems to be the default option and opposite to FANCIFUL.

|-
| {{text anchor|NATURAL_ANIMAL}}
| Caste
|
| Alias of NATURAL.

|-
| {{text anchor|NATURAL_SKILL}}
| Caste
| [[Skill_token|Skill token]]:value
| The creature possesses this skill at this level inherently. It begins with this skill at this level, and the skill may never rust below this level. A value of 16 is legendary. Requires CAN_LEARN or INTELLIGENT to function in .25 or earlier.

|-
| {{text anchor|NIGHT_CREATURE_BOGEYMAN}}
| Caste
|
| Found on bogeymen. Creatures with this tag will join other bogeymen in attacking adventurers at night, and will also adopt their other behaviors, such as vanishing in smoke upon being killed. This does not affect the creature's presence elsewhere, such as for generated megabeasts, normal creatures, entity members, etc. Setting the number of bogeyman types to zero in the world gen parameters will remove only the randomly-generated bogeymen.

|-
| {{text anchor|NIGHT_CREATURE_HUNTER}}
| Caste
|
| 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. If this creature has SPOUSE_CONVERTER, 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 [[werebeast]]s 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.

|-
| {{text anchor|NO_AUTUMN}}
| Caste
|
| This creature caste does not appear in [[Calendar|autumn]].

|-
| {{text anchor|NO_CONNECTIONS_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require connected body parts to move{{verify}}; generally used on undead creatures with connections that have rotted away.

|-
| {{text anchor|NO_DIZZINESS}}
| Caste
|
| Creature cannot become dizzy.

|-
| {{text anchor|NO_DRINK}}
| Caste
|
| Creature does not need to drink.

|-
| {{text anchor|NO_EAT}}
| Caste
|
| Creature does not need to eat.

|-
| {{text anchor|NO_FEVERS}}
| Caste
|
| Creature cannot suffer fevers.

|-
| {{text anchor|NO_GENDER}}
| Caste
|
| Creature has no gender.

|-
| {{text anchor|NO_PHYS_ATT_GAIN}}
| Caste
|
| The affected caste cannot gain any physical skills.

|-
| {{text anchor|NO_PHYS_ATT_RUST}}
| Caste
|
| The affected caste cannot lose any physical skills.

|-
| {{text anchor|NO_SLEEP}}
| Caste
|
| Creature does not need to sleep.

|-
| {{text anchor|NO_SPRING}}
| Caste
|
| This creature caste does not appear in [[Calendar|spring]].

|-
| {{text anchor|NO_SUMMER}}
| Caste
|
| This creature caste does not appear in [[Calendar|summer]].

|-
| {{text anchor|NO_THOUGHT_CENTER_FOR_MOVEMENT}}
| Caste
|
| Creature doesn't require an organ with the [THOUGHT] tag to survive or attack; generally used on creatures that don't have brains.

|-
| {{text anchor|NO_UNIT_TYPE_COLOR}}
| Caste
|
| Prevents creature from selecting its color based on its profession (e.g. Miner, Hunter, Wrestler).

|-
| {{text anchor|NO_VEGETATION_PERTURB}}
| Caste{{Verify}}
|
| Likely prevents the creature from leaving broken vegetation tracks.{{Verify}}

|-
| {{text anchor|NO_WINTER}}
| Caste
|
| This creature caste does not appear in [[Calendar|winter]].

|-
| {{text anchor|NOBONES}}
| Caste
|
| Creature has no bones.

|-
| {{text anchor|NOBREATHE}}
| Caste
|
| Creature doesn't need to breathe or have [BREATHE] parts in body. Cannot drown or be strangled.

|-
| {{text anchor|NOCTURNAL}}
| Caste
|
| Sets if the creature is active in night.

|-
| {{text anchor|NOEMOTION}}
| Caste
|
| The creature has no emotions, and does not rage.

|-
| {{text anchor|NOEXERT}}
| Caste
|
| Creature can't become tired or over-exerted from taking too many combat actions.

|-
| {{text anchor|NOFEAR}}
| Caste
|
| Creature doesn't feel fear and will never run away from battle.

|-
| {{text anchor|NOMEAT}}
| Caste
|
| Creature will not drop meat when butchered.

|-
| {{text anchor|NONAUSEA}}
| Caste
|
| Creature isn't nauseated by gut hits and cannot vomit.

|-
| {{text anchor|NOPAIN}}
| Caste
|
| Creature doesn't feel pain.

|-
| {{text anchor|NOSKIN}}
| Caste
|
| Creature will not drop a hide when butchered.

|-
| {{text anchor|NOSKULL}}
| Caste
|
| Creature will not drop a skull on butcher, rot, or decay of severed head.

|-
| {{text anchor|NOSMELLYROT}}
| Caste
|
| Does not produce miasma when rotting.

|-
| {{text anchor|NOSTUCKINS}}
| Caste
|
| Weapons can't get stuck in creature.

|-
| {{text anchor|NOSTUN}}
| Caste
|
| Creature can't be stunned. Creatures with this tag never wake up from sleep in Fortress Mode and stay drowsy.{{verify}} If this creature must eat and drink while playing, it WILL die.

|-
| {{text anchor|NOT_BUTCHERABLE}}
| Caste
|
| Cannot be butchered

|-
| {{text anchor|NOT_LIVING}}
| Caste
|
| Cannot be raised from the dead.

|-
| {{text anchor|NOTHOUGHT}}
| Caste
|
| Creature doesn't require a [THOUGHT] body part to survive. If it does not have NO_THOUGHT_CENTER_FOR_MOVEMENT as well, it will be unable to use any attacks other than the default 'push'.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==O==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ODOR_LEVEL}}
| Caste
| number
| How easy the creature is to smell. The higher the number, the easier the creature can be smelled. Zero is odorless. Default is 50.

|-
| {{text anchor|ODOR_STRING}}
| Caste
| string
| What the creature smells like. If no odor string is defined, the creature name (not the caste name) is used.

|-
| {{text anchor|OPPOSED_TO_LIFE}}
| Caste
|
| Is hostile to all creatures except undead and other non-living ones. Used for [[Undead]].

|-
| {{text anchor|ORIENTATION}}
| Caste
| MALE/FEMALE:disinterested chance:lover-possible chance:commitment-possible 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.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==P==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PACK_ANIMAL}}
| Caste
|
| Allows the creature to be used as a pack animal. Currently only used by merchants without wagons. Also prevents creature from dropping hauled items on its own -- do not use for player-controllable creatures!

|-
| {{text anchor|PARALYZEIMMUNE}}
| Caste
|
| The creature is immune to all paralyzing special attacks.

|-
| {{text anchor|PATTERNFLIER}}
| Caste
|
| Unknown. No creatures currently have this token.

|-
| {{text anchor|PEARL}}
| Caste
|
| In earlier versions, creature would generate pearls. Does nothing in the current version.

|-
| {{text anchor|PENETRATEPOWER}}
| Caste
| value
| Controls the ability of vermin to find a way into containers when they are eating food from your stockpiles.

|-
| {{text anchor|PERSONALITY}}
| Caste
|
*ATTRIBUTE
*lowest:median:highest
| Determines the range and chance of personality traits. Standard is 0:50:100. See [[Personality trait]] for more info.

|-
| {{text anchor|PET}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations that encounter it in worldgen will tame and domesticate it for their own use.

|-
| {{text anchor|PET_EXOTIC}}
| Caste
|
| Allows the creature to be tamed in Fortress mode. Prequisite for all other working animal roles and allows all females of the species to breed regardless of marital status. Civilizations cannot domesticate it in worldgen without certain exceptions. More difficult to tame?{{verify}}

|-
| {{text anchor|PETVALUE}}
| Caste
| value
| How valuable a tamed animal is. Actual cost in points in the embarking screen is 1+(PETVALUE/2) for an untrained animal, 1+PETVALUE for a war/hunting one.

|-
| {{text anchor|PETVALUE_DIVISOR}}
| Caste
| value
| Divides the creature's PETVALUE by the specified number. Used for bees to prevent a single hive from being worth a fortune.

|-
| {{text anchor|PHYS_ATT_CAP_PERC}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*Cap %
|Default is 200. This means you can increase your attribute to 200% of its starting value (or the average value + your starting value if that is higher).

|-
| {{text anchor|PHYS_ATT_RANGE}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]]
*lowest:lower:low:median:high:higher: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.

|-
| {{text anchor|PHYS_ATT_RATES}}
| Caste
|
*[[DF2012:Attribute|ATTRIBUTE]] Token
*cost to improve
*unused counter rate
*rust counter rate
*demotion counter rate
| Physical attribute gain/decay rates. Defaults for STRENGTH, AGILITY, TOUGHNESS, and ENDURANCE are 500:3:4:3, while RECUPERATION and DISEASE_RESISTANCE default to 500:NONE:NONE:NONE.

|-
| {{text anchor|PLUS_BP_GROUP}}
| Caste
|
*BY_TYPE, BY_CATEGORY, or BY_TOKEN
*body type, category, or token
| Adds a body part group to selected body part group. Presumably used immediately after SET_BP_GROUP.

|-
| {{text anchor|PLUS_MATERIAL}}
| Creature
|
*material
| Adds a material to selected materials. Used immediately after SELECT_MATERIAL.

|-
| {{text anchor|POP_RATIO}}
| Caste
|
| Weighted population of caste; Lower is rarer. Not to be confused with FREQUENCY.

|-
| {{text anchor|POPULATION_NUMBER}}
| Creature
| min:max
| The minimum/maximum numbers of how many of these creatures are present in each world map tile of the appropriate region.

|-
| {{text anchor|POWER}}
| Caste
|
| Allows the being to represent itself as a deity. 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.

|-
| {{text anchor|PREFSTRING}}
| Creature
| string
| Sets what other creatures like about this creature. "Urist likes dwarves for their beards." Multiple entries will be chosen from at random

|-
| {{text anchor|PROFESSION_NAME}}
| Creature
|
*[[Unit type token]] (Profession)
*singular
*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.

|-
| {{text anchor|PRONE_TO_RAGE}}
| Caste
| Chance
| Creature has a percentage chance to flip out at visible non-friendly creatures. Enraged creatures attack anything regardless of timidity and get a strength bonus to their hits. This is what makes badgers so hardcore.

|-
| {{text anchor|PUS}}
| Caste
|
* [[material token]]
*matter state (LIQUID, GAS, SOLID)
| The creature has pus. Specifies the stuff secreted by infected wounds.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==R==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|RELSIZE}}
| Caste
|
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*body category, type, or token
*Relsize
| Specifies a new relative size for a part than what is stated in the body plan. For example, Dwarves have larger livers.

|-
| {{text anchor|REMAINS}}
| Caste
| singular:plural
| What creature's remains are called.

|-
| {{text anchor|REMAINS_COLOR}}
| Caste
|
| What color creature's remains are.

|-
| {{text anchor|REMAINS_ON_VERMIN_BITE_DEATH}}
| 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.

|-
| {{text anchor|REMAINS_UNDETERMINED}}
| Caste
|
| Unknown.

|-
| {{text anchor|REMOVE_MATERIAL}}
| Creature
|
*material token
| Removes a material from a creature.

|-
| {{text anchor|REMOVE_TISSUE}}
| Creature
|
*material token
| Removes a tissue from a creature.

|-
| {{text anchor|RETRACT_INTO_BP}}
| Caste
|
*BY_TYPE, BY_CATEGORY or BY_TOKEN
*TYPE, CATEGORY or TOKEN
| The creature will retract into a body part when threatened. It will be unable to move or attack, but enemies will only be able to attack the specified body part.

|-
| {{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 his feet. Requires HUNTS_VERMIN, obviously.

|-
| {{text anchor|ROOT_AROUND}}
| Caste
|
| Creature will occasionally root around in the grass, looking for insects. Used for flavor in Adventure Mode, spawns vermin edible by this creature in Fortress Mode.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==S==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|SAVAGE}}
| Creature
|
| The creature will only show up in "savage" biomes.

|-
| {{text anchor|SECRETION}}
| Caste
|
* [[material token]]
*Material State
*location secreted from (by_type, by_category, by_token)
*body part
*tissue layer
*trigger
| creates a secreted material on given tissue on a given part of the body. Valid triggers are:
*CONTINUOUS
*EXTREME_EMOTION
*EXERTION

|-
| {{text anchor|SELECT_ADDITIONAL_CASTE}}
| Creature
|
*caste name
| adds an additional previously defined caste to the selection. Used after SELECT_CASTE.

|-
| {{text anchor|SELECT_CASTE}}
| Creature
|
*caste name, or ALL
| selects a previously defined caste

|-
| {{text anchor|SELECT_MATERIAL}}
| Creature
|
*Material token
| Selects a locally defined material. Can be ALL.

|-
| {{text anchor|SEMIMEGABEAST}}
| Caste
|
| Essentially the same as MEGABEAST, but more of them are created during worldgen.

|-
| {{text anchor|SENSE_CREATURE_CLASS}}
| Caste
|
* Creature class
* [[Tilesets|Tile]]
* [[Color|Color]]
| Allows creature to sense creatures with a certain creature class through walls, floors etc. Sense will be with tile and color specified.

|-
| {{text anchor|SET_BP_GROUP}}
| Caste
|
*selection criteria BY_TYPE, BY_CATEGORY, BY_TOKEN
*category, type, or token
| Begins a selection of body parts.

|-
| {{text anchor|SET_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| begins a selection of tissue layers

|-
| {{text anchor|SHEARABLE_TISSUE_LAYER}}
| Caste
|
* tissue modifier
* required value
| Tissue layer can be sheared for its component material. The specified modifier must be at least of the desired value for shearing to be possible (a llama's wool must have a LENGTH of 300 before it is shearable).

|-
| {{text anchor|SKILL_LEARN_RATE}}
| Caste
| [[skill_token]]:percentage
| The rate at which this creature learns this skill. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_LEARN_RATES}}
| Caste
| percentage
| The rate at which this creature learns all skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATE}}
| Caste
| [[skill_token]]:percentage:value:value:value
| As SKILL_RATES for individual skills. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RATES}}
| Caste
|
*% of improvement points you get
*unused counter rate
*rust counter rate
*demotion counter rate
| Affects skill gain and decay. Lower numbers in the last three slots make decay occur faster ([SKILL_RATES:100:1:1:1] would cause rapid decay). The counter rates may also be replaced with NONE.
Default is [SKILL_RATES:100:8:16:16]. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATE}}
| Caste
| [[skill_token]]:value:value:value
| The rate at which this skill decays. Lower values cause the skill to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SKILL_RUST_RATES}}
| Caste
| value:value:value
| The rate at which all skills decay. Lower values cause the skills to decay faster. Requires CAN_LEARN or INTELLIGENT to function.

|-
| {{text anchor|SLOW_LEARNER}}
| Caste
|
| Shorthand for [CAN_LEARN] + [SKILL_LEARN_RATES:50].{{verify}} Used for ogres and giants. Applicable to player races.

|-
| {{text anchor|SMALL_REMAINS}}
| Caste
|
| Creature leaves a "remains" instead of a corpse. Used for vermin.

|-
| {{text anchor|SMELL_TRIGGER}}
| Creature
| value
| Determines how keen a creature's sense of smell is. Lower is better. At 10000, a creature cannot smell at all.

|-
| {{text anchor|SOLDIER_ALTTILE}}
| Creature
| 'character' or tile number
| If this creature is active in its civilization's military, it will blink between its default tile and this one.

|-
| {{text anchor|SOUND}}
| Caste
|
* Sound application (currently accepts ALERT or PEACEFUL_INTERMITTENT)
* Sound range (in tiles)
* Sound delay (lower values = sound is produced more often)
* VOCALIZATION or NONE (determines whether the sound requires breathing or not)
* First-person description
* Third-person description
* Description when out of sight
| Creature makes sounds periodically, which can be heard in Adventure mode.

|-
| {{text anchor|SPECIFIC_FOOD}}
| Caste
|
* PLANT or CREATURE
* Plant/creature ID
| Creature can will only graze or eat the designated plant or creature parts.

|-
| {{text anchor|SPEECH}}
| Creature
| speech file
| Boasting speeches relating to killing this creature. Examples include dwarf.txt and elf.txt in data\speech.

|-
| {{text anchor|SPEECH_FEMALE}}
| Creature
| speech file
| Boasting speeches relating to killing females of this creature.

|-
| {{text anchor|SPEECH_MALE}}
| Creature
| speech file
| Boasting speeches relating to killing males of this creature.

|-
| {{text anchor|SPHERE}}
| Creature
|
*sphere name
| Sets what religious spheres the creature is aligned to, for purposes of being worshipped via the [POWER] token. Also affects the layout of hidden fun stuff, and the creature's name.

|-
| {{text anchor|SPOUSE_CONVERSION_TARGET}}
| Caste
|
| This creature can be converted by a night creature with SPOUSE_CONVERTED.

|-
| {{text anchor|SPOUSE_CONVERTER}}
| Caste
|
| If the creature has the NIGHT_CREATURE_HUNTER tag, it will kidnap SPOUSE_CONVERSION_TARGETs and transform them into the caste of its species with the CONVERTED_SPOUSE tag during worldgen. It may also start families this way.

|-
| {{text anchor|STANCE_CLIMBER}}
| Caste {{verify}}
|
| Caste does not require GRASP body parts to climb -- it can climb with STANCE parts instead.

|-
| {{text anchor|SUPERNATURAL}}
| Caste
|
| Gives the creature knowledge of any secrets with SUPERNATURAL_LEARNING_POSSIBLE that match its spheres. Other effects are unknown.

|-
| {{text anchor|SWIMS_INNATE}}
| Caste
|
| The creature naturally knows how to swim, as opposed to [SWIMS_LEARNED] below. However, Fortress mode AI never paths into water anyway, so it's less useful there.

|-
| {{text anchor|SWIMS_LEARNED}}
| Caste
|
| The creature doesn't know how to swim unless it has learned the skill. Requires [CAN_LEARN], obviously.

|}

<div align="center">
{{alphabetical TOC}}
</div>

==T==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|TENDONS}}
| Caste
|
* [[material token]]
*healing rate
| The creature has tendons in its bones. Cutting the bone tissue severs them, disabling motor function if the target is a limb.

|-
| {{text anchor|THICKWEB}}
| Caste
|
| The creature's webs can catch larger creatures.

|-
| {{text anchor|TISSUE}}
| Creature
| name
| Begins defining a tissue in the creature file.

|-
| {{text anchor|TITAN}}
| Caste
|
| Found on [[titan]]s. Cannot be specified in user-defined raws.

|-
| {{text anchor|TL_COLOR_MODIFIER}}
| Caste
| COLOR:freq:COLOR:freq etc.
| Creates a list of color patterns, giving each a relative frequency.

|-
| {{text anchor|TLCM_GENETIC_MODEL}}
| Caste
|
| The way the color modifier is passed on to offspring. May or may not work right now.{{verify}}

|-
| {{text anchor|TLCM_IMPORTANCE}}
| Caste
|
*number
| Presumably modifies the importance of the tissue layer color modifier, for description purposes.
HOWEVER using this appears to remove all mention of colour from creature descriptions. It does not appear in any default creatures.

|-
| {{text anchor|TLCM_NOUN}}
| Caste
|
*name
*SINGULAR or PLURAL
| Names the tissue layer color modifier, and determines the noun. Also used by stonesense for colouring body parts.

|-
| {{text anchor|TLCM_TIMING}}
| Caste
|
*ROOT
*start change window years:days:end change window years:days
| determines the point in the creature's life where the color change begins

|-
| {{text anchor|TRADE_CAPACITY}}
| Caste
|
| How much the creature can carry when used by merchants.

|-
| {{text anchor|TRAINABLE}}
| Caste
|
| Shortcut for [TRAINABLE_HUNTING] + [TRAINABLE_WAR].

|-
| {{text anchor|TRAINABLE_HUNTING}}
| Caste
|
| Can be trained as a hunting beast, increasing speed.

|-
| {{text anchor|TRAINABLE_WAR}}
| Caste
|
| Can be trained as a war beast, increasing strength and endurance.

|-
| {{text anchor|TRANCES}}
| Caste
|
| Allows the creature to go into martial trances.

|-
| {{text anchor|TRAPAVOID}}
| Caste
|
| The creature is immune to traps. Probably every procedurally generated megabeast has this.

|-
| {{text anchor|TRIGGERABLE_GROUP}}
| Creature
| min:max
| A large swarm of vermin can be disturbed, usually in Adventure mode.{{verify}}

|-
| {{text anchor|TSU_NOUN}}
| Caste
|
*noun
*SINGULAR or PLURAL
| Noun for the TISSUE_STYLE_UNIT, used in the description of the tissue layer's style.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==U==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|UBIQUITOUS}}
| Creature
|
| Creature will occur in every region with the correct biome. Does not apply to evil/good tags.

|-
| {{text anchor|UNDERGROUND_DEPTH}}
| Creature
|
*mindepth
*maxdepth
| Depth the creature appears underground. Numbers can be from 0 to 5. 0 is actually 'above ground' and can be used if the creature is to appear both above and below ground. A single argument may be used instead of min and max. Only magma creatures use 4 or 5 in the default raws. [[Demon]]s use only 5:5; user-defined creatures with both this depth and [FLIER] will take part in the initial wave from the HFS alongside generated demons. Without [FLIER], they will only spawn from the map edges. Civilizations that can use underground plants or animals will only export (via the embark screen or caravans) things that available at depth 1.

|-
| {{text anchor|UNDERSWIM}}
| Caste
|
| Creature swims under the water and can't be seen. Seems to be a relic from the 2D era.

|-
| {{text anchor|UNIQUE_DEMON}}
| Caste
|
| Typically found on generated [[demon]]s; causes the game to create a single named instance of the demon which will emerge from the underworld and take over civilizations during worldgen. Cannot be specified in user-defined raws.

|-
| {{text anchor|USE_CASTE}}
| Creature
|
*new caste token
*old caste token
| Defines a new caste derived directly from a previous caste. The new caste inherits all properties of the old one. The effect of this tag is automatic if one has not yet defined any castes: "Any caste-level tag that occurs before castes are explicitly declared is saved up and placed on any caste that is declared later, unless the caste is explicitly derived from another caste."

|-
| {{text anchor|USE_MATERIAL}}
| Creature
|
*new material ID
*old material ID
| Defines a new local creature material and populates it with all properties defined in the specified local creature material.

|-
| {{text anchor|USE_MATERIAL_TEMPLATE}}
| Creature
|
*new material token
*material template
| Defines a new local creature material and populates it with all properties defined in the specified template.

|-
| {{text anchor|USE_TISSUE}}
| Creature
|
*new tissue token
*old tissue id
| Defines a new local creature tissue and populates it with all properties defined in the local tissue specified in the second argument.

|-
| {{text anchor|USE_TISSUE_TEMPLATE}}
| Creature
|
*new tissue token
*tissue template
| Loads a tissue template listed in OBJECT:TISSUE_TEMPLATE files, such as tissue_template_default.txt.

|-
| {{text anchor|UTTERANCES}}
| Caste
|
| Changes the language of the creature into unintelligible 'kobold-speak', which creatures of other species will be unable to understand. If a civilized creature has this and is not part of a SKULKING civ, it will tend to start wars with all nearby civilizations and will be unable to make peace treaties due to 'inability to communicate'.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==V==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|VEGETATION}}
| Caste
|
| The creature is made of swamp stuff. Used for [[grimeling]]s.

|-
| {{text anchor|VERMIN_BITE}}
| Caste
|
*chance of occurrence{{verify}}
*verb (bitten, stung, etc.)
* [[material token]]
| Vermin bites, and injects something.

|-
| {{text anchor|VERMIN_EATER}}
| Creature
|
| The vermin creature will attempt to eat exposed food. See PENETRATEPOWER. Distinct from VERMIN_ROTTER.

|-
| {{text anchor|VERMIN_FISH}}
| Creature
|
| The vermin appears in water and will attempt to swim around.

|-
| {{text anchor|VERMIN_GROUNDER}}
| Creature
|
| The creature appears in "general" surface ground locations. Note that this doesn't stop the creature from flying if it can (most vermin birds have this tag).

|-
| {{text anchor|VERMIN_HATEABLE}}
| Caste
|
| Some dwarves will hate the creature and get unhappy thoughts when around it.

|-
| {{text anchor|VERMIN_MICRO}}
| Caste
|
| This makes the creature move in a swarm of creatures of the same race as it (e.g. swarm of flies, swarm of ants).

|-
| {{text anchor|VERMIN_NOFISH}}
| Caste
|
| The creature cannot be caught by fishing.

|-
| {{text anchor|VERMIN_NOROAM}}
| Caste
|
| The creature will not be observed randomly roaming about the map.

|-
| {{text anchor|VERMIN_NOTRAP}}
| Caste
|
| The creature cannot be caught in baited animal traps; however, a "catch live land animal" task may still be able to capture one if a dwarf finds one roaming around.

|-
| {{text anchor|VERMIN_ROTTER}}
| Creature
|
| Present on flies, knuckle worms, acorn flies, and blood gnats. Attracted to rotting stuff left in the open. Speeds up decay?{{verify}}

|-
| {{text anchor|VERMIN_SOIL}}
| Creature
|
| The creature randomly appears near dirt or mud.

|-
| {{text anchor|VERMIN_SOIL_COLONY}}
| Creature
|
| The vermin will appear in a single tile cluster of many vermin, such as a colony of ants.

|-
| {{text anchor|VERMINHUNTER}}
| Caste
|
| Old shorthand for "does cat stuff". Contains [AT_PEACE_WITH_WILDLIFE] + [RETURNS_VERMIN_KILLS_TO_OWNER] + [HUNTS_VERMIN] + [ADOPTS_OWNER].

|-
| {{text anchor|VESPERTINE}}
| Caste
|
| Sets if the creature is active in evening.

|-
| {{text anchor|VIEWRANGE}}
| Caste
| value
| Value should determine how close you have to get to a critter before it attacks (or prevents adv mode travel etc.) Default is 20.

|-
| {{text anchor|VISION_ARC}}
| Caste {{Verify}}
|
*binocular vision arc
*non-binocular vision arc
| The width of the creature's vision arcs. The first number is binocular vision, the second is non-binocular vision.
|}

<div align="center">
{{alphabetical TOC}}
</div>

==W==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|WAGON_PULLER}}
| Caste
|
| Allows the creature to pull caravan wagons. If a civilization doesn't have access to any, it is restricted to trading with pack animals.

|-
| {{text anchor|WEBBER}}
| Caste
|
* [[material token]]
| Allows the creature to create webs, and defines what the webs are made of.

|-
| {{text anchor|WEBIMMUNE}}
| Caste
|
| The creature will not get caught in thick webs.
|}

==Attack Tokens==
{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|ATTACK_SKILL}}
| Caste
|
*[[Skill token]]
| Defines the skill used by the attack.

|-
| {{text anchor|ATTACK_VERB}}
| Caste
| 2nd person:3rd person
| Descriptive text for the attack.

|-
| {{text anchor|ATTACK_CONTACT_PERC}}
| Caste
|
*% value
| The contact area of the attack, measured in % of the body part's volume. Note that all attack percentages can be more than 100%.

|-
| {{text anchor|ATTACK_PENETRATION_PERC}}
| Caste
|
*% value
| The penetration value of the attack, measured in % of the body part's volume. Requires ATTACK_FLAG_EDGE. Maximum value: 15000.

|-
| {{text anchor|ATTACK_PRIORITY}}
| Caste
|
*MAIN or SECOND
| Usage frequency. MAIN attacks are 100 times more frequently chosen than SECOND. Opportunity attacks ignore this preference.

|-
| {{text anchor|ATTACK_VELOCITY_MODIFIER}}
| Caste
| number
| The velocity multiplier of the attack, multiplied by 1000.

|-
| {{text anchor|ATTACK_FLAG_CANLATCH}}
| Caste
|
| Attacks that damage tissue have the chance to latch on in a wrestling hold. The grabbing bodypart can then use the "shake around" wrestling move, causing severe, armor-bypassing tensile damage according to the attacker's body volume.

|-
| {{text anchor|ATTACK_FLAG_WITH}}
| Caste
|
| In adventure mode, displays the name of the body part used by an attack when announcing the attack.

|-
| {{text anchor|ATTACK_FLAG_EDGE}}
| Caste
|
| The attack is edged, with all the effects on physical resistance and contact area that it entails.

|-
| {{text anchor|ATTACK_PREPARE_AND_RECOVER}}
| Caste
|
* Preparation time
* Recovery time
| Determines the length of time to prepare this attack and until one can perform this attack again. Values appear to be calculated in adventure mode ticks.

|-
| {{text anchor|ATTACK_FLAG_BAD_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack cannot be performed effectively.

|-
| {{text anchor|ATTACK_FLAG_INDEPENDENT_MULTIATTACK}}
| Caste
|
| Multiple strikes with this attack can be performed with no penalty.

|-
| {{text anchor|SPECIALATTACK_INJECT_EXTRACT}}
| Caste
|
* [[material token]]
*state (SOLID, LIQUID, GAS)
*min:max
| attack type addition that injects a material into the victim.

|-
| {{text anchor|SPECIALATTACK_INTERACTION}}
| Caste
| interaction
| When this attack lands successfully, an interaction with I_SOURCE:ATTACK will take effect on the target creature. The attack must break the target creature's skin in order to work. This will take effect in worldgen as well.

|-
| {{text anchor|SPECIALATTACK_SUCK_BLOOD}}
| Caste
| min:max
| Successful attack draws out an amount of blood randomized between the min and max value. Beware that this '''will''' trigger any ingestion syndromes attached to the target creature's blood - for example, using this attack on a vampire will turn you into one too.
|}

==Important Related Tokens==
These next groups of tokens include several tokens that are not technically classified as creature tokens in string dump, but bear mentioning in this as they are used frequently in creature raws. (Some regular creature tokens may also be reprinted for the sake of ease of navigation)

===Tissue Modification===
This next group of tokens deals setting and modifying properties of previously defined tissues. (See also [[Tissue definition token]])

{| {{prettytable}}
|- bgcolor="#ddd"
! width="20%" | Token
! width="10%" | Type
! width="20%" | Arguments
! width="50%" | Description

|-
| {{text anchor|PLUS_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
| Adds a tissue to those selected

|-
| {{text anchor|PLUS_TL_GROUP}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token
*tissue
| continues a selection of tissue layers

|-
| {{text anchor|SELECT_TISSUE}}
| Creature
|
*tissue token
| Selects a tissue for editing.

|-
| {{text anchor|SELECT_TISSUE_LAYER}}
| Caste
|
*TISSUE
*BY_CATEGORY, BY_TYPE, BY_TOKEN
*Location - category, type, or token | Selects a tissue at a location
* (optional) FRONT, BACK, LEFT, RIGHT, TOP, BOTTOM, AROUND.
| Selects a tissue layer for descriptor and cosmetic purposes.
[SELECT_TISSUE_LAYER:SKIN:BY_TYPE:UPPERBODY]

|-
| {{text anchor|SET_LAYER_TISSUE}}
| Caste
|
| Sets a tissue layer to be made of a different tissue.

|-
| {{text anchor|TISSUE_LAYER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Adds the tissue layer to wherever it is required.
Non-argument Locations can be FRONT, RIGHT, LEFT, TOP, BOTTOM. Argument locations are AROUND and CLEANS, requiring a further body part and a % of coverage/cleansing

|-
| {{text anchor|TISSUE_LAYER_OVER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
*LOCATION
| Presumably a counterpart to TISSUE_LAYER_UNDER (see below).

|-
| {{text anchor|TISSUE_LAYER_UNDER}}
| Caste
|
*BY_TYPE, BY_CATEGORY, BY_TOKEN
*TYPE,CATEGORY, or TOKEN
*TISSUE
| Adds the tissue layer under a given part.
For example an Iron Man has a gaseous poison within and this tissue (GAS is its name) has the token [TISSUE_LEAKS] and its state is GAS so when you puncture the iron outside and damage this tissue it leaks gas (can have a syndrome by using a previous one in the creature sample.) [TISSUE_LAYER_UNDER:BY_CATEGORY:ALL:{tissue}] {tissue} is what will be under the TISSUE_LAYER here is an example Tissue from Iron Man:<br>
[TISSUE:GAS] [TISSUE_NAME:gas:NP] [TISSUE_MATERIAL:LOCAL_CREATURE_MAT:GAS] [TISSUE_MAT_STATE:GAS] [RELATIVE_THICKNESS:50] [TISSUE_LEAKS] [TISSUE_SHAPE:LAYER]
|-
| {{text anchor|TISSUE_LAYER_APPEARANCE_MODIFIER}}
| Caste
|
*QUALITY
*lowest:lower:low:median:high:higher:highest
| sets the range of qualities, including LENGTH, DENSE, HIGH_POSITION, CURLY, GREASY, WRINKLY

|-
| {{text anchor|TISSUE_STYLE_UNIT}}
| Caste
|
*tissue style unit ID
*shaping
| sets tissue layer to be the target of TISSUE_STYLE token specified for an entity, works only on entity members. Mostly used with tissues HAIR, BEARD, MOUSTACHE, SIDEBURNS.

|-
| {{text anchor|TL_CONNECTS}}
| Caste
|
| Presumably gives the CONNECTS attribute to selected layers.

|-
| {{text anchor|TL_HEALING_RATE}}
| Caste
|
| Presumably changes the HEALING_RATE of the selected tissue layers.

|-
| {{text anchor|TL_MAJOR_ARTERIES}}
| Caste
|
| Gives the "major arteries" attribute to selected layers. Used to add massive bleeding properties to the throat, made from skin.

|-
| {{text anchor|TL_PAIN_RECEPTORS}}
| Caste
|
| Seems to set new number of pain receptors for selected tissue layers.

|-
| {{text anchor|TL_RELATIVE_THICKNESS}}
| Caste
|
| Seems to set new relative thickness for selected tissue layers.

|-
| {{text anchor|TL_VASCULAR}}
| Caste
|
| Seems to set new a VASCULAR value (which modulates bleeding) for selected tissue layers.

|}

==See Also==
*[[Body detail plan token]]
*[[Body token]]
*[[Material definition token]]
*[[Syndrome]]
*[[Tissue definition token]]

{{Category|Modding}}
{{Category|Tokens}}

User:JT/Token Wishlist

2014-07-11T04:36:14Z

JT: alpha reproduction

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or NONE for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

=====''[ALPHA_REPRODUCTION]''=====

: This tag forces only one mated pair per population cluster (i.e., CLUSTER_NUMBER) to reproduce. Only the female with the highest attributes will bear offspring, with all other females in the group simply being suppressed from mating. This inborn social control reduces overpopulation among animals that bear large numbers of offspring.

===General Tokens===

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

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

: This variation on the SWIMS_INNATE tag 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).

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=====''[ADD_BODY_TAG:caste:...]'' =====

: '''Arguments:'''
:* ''caste'': Caste within the current creature object to append additional body tokens to
:* ''...'': Colon-separated list of [[body tokens|body templates]]

: This is an ''appendix'' of the creature's BODY token which allows you to add additional body parts to male or female members of the creature, instead of being required to redefine the caste through SELECT_CASTE and override the BODY token already present. There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers).

: Whenever a creature is created, it receives all of the body parts from the BODY token, plus all of the body templates from each ADD_BODY token in sequence that matches its caste.

: Note in particular that this would vastly simplify such things as sheep -- instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then an ADD_BODY_TAG:MALE:2HEAD_HORN tag anywhere after the CASTE:MALE has been defined.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

User:JT/Token Wishlist

2014-07-11T03:15:42Z

JT: infant_mortality and parental_adoption

==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 ±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—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—for instance if the male can be impregnated by the female and the female can be impregnated by the male—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.

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

: A modifier tag for LAYS_EGGS, 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). The eggs can shrivel or rot (depending on whether they are soft eggs or hard eggs). If they are fertilised, the gestation time is reset and they will then grow on their own.

=====''[WARMS_EGGS]''=====

: If at least one caste includes this token, the eggs must be warmed in order to hatch. The castes which possess this token will share in the effort of warming the eggs.

=====''[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.

: An attack within the creature record must have an ATTACK_FLAG_OVIPOSITOR in order to allow implantation.

=====''[SAPOTROPH_EGG:target]''=====

: '''Arguments:'''
:* ''target'': The creature ID or creature class of the species where eggs are injected, or NONE for any dead body.

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

: The target can be a specific species, to reflect certain predatory flies which have specific creatures they target.

=====''[KILLS_FOR_SAPOTROPH_EGGS]''=====

: The creature after being impregnated will actively and aggressively manufacture corpses to lay eggs inside, if no corpses are already available.

=====''[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.)

=====''[VOLUNTARY_EGGS]''=====

: If a LAYS_EGGS creature has this tag, it is allowed to choose whether or not to lay eggs; it does not lay eggs at every reproductive cycle unless they are 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.

=====''[INFANT_MORTALITY:number:ratio]''=====

: '''Arguments:'''
:* ''number'': The number out of the ratio that will die
:* ''ratio'': The total ratio of surviving and extinct offspring by reaching childhood (or maturity, if no BABY tag)

: This causes infants of the creature to die during world gen, or spontaneously during fortress mode when outdoors (based on implied predation), based on the given ratio of dead offspring to the total ratio. For instance, if INFANT_MORTALITY:3:1000, then there is a 3 in 1000 chance that any given member of the species will die within its infancy.

: This is intended to balance creatures which lay massive egg clutches, as they do so in reality in order to counterbalance their extremely low infant survival rates: for instance, infant crocodiles are frequently eaten by birds and even fish. Turtles also employ similar mass-clutch laying based on the same principle.

=====''[PARENTAL_ADOPTION:minimum:maximum]''=====

: '''Arguments:'''
:* ''number'': The minimum number of offspring per litter that parents will raise.
:* ''number'': The maximum number of offspring per litter that parents will raise, allowing the others to die.

: This is intended to represent the behaviour of pandas, where they may occasionally have multiple births but will adopt only the strongest of their infants. Creatures with this tag will choose the offspring in the litter that has the highest average attributes. Theoretically this helps ensure the survival of the species, however barbaric it may seem to we humans who care so deeply about our own offspring (but then again, it hasn't exactly worked out well for pandas so far -- and actually, as carnivores that live in mountainous areas and prefer to eat bamboo that grows on flatter ground, they really are a species that just doesn't want to survive...).

===General Tokens===

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

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

: This variation on the SWIMS_INNATE tag 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).

=====''[CORPSE_SPECHEAT]'' / ''[CORPSE_LAYERING]'' / ''[CORPSE_CORPSE_BOILING_POINT]'' / etc.=====

: These tokens would allow a being's corpse to have temperatures that are different than their living temperatures. The primary usefulness would be in making creatures which spontaneously combust when killed (vampires in Blade series!) or creatures which burn while alive but turn into useless lumps when dead. The current closest token, itemcorpse, only accomplishes the latter.

: Cool beans!

=====''[CHILD_CONVERTER:species:product:time]''=====

: '''Arguments:'''
:* ''species'': The species to assimilate, or NONE for all species
:* ''product'': The species produced, or NONE for this species
:* ''time'': The number of assimilation points it takes to totally assimilate that creature

: The motivation behind this token is to allow goblins to transform captured children into their own kind. Unlike the Trekkie assimilation, this is done in campaign time; each assimilation attempt takes one day, causing one assimilation point. The transformation occurs when the number of assimilation points stored up for a given creature exceeds the specified time, in days. Only one attempt could be made per creature per day. Once the creature is assimilated and transformed into the new creature type, it treats the CHILD_CONVERTER as its parent.

: ''Dance, magic dance... dance, magic dance!''
: ''Dance, magic dance... dance, magic dance!''
: ''Put that baby spell on me''
: ''Jump, magic jump... jump, magic jump!''
: ''Jump, magic jump... jump, magic jump!''
: ''Put that magic jump on me''
: ''Slap that baby, make him free!''

The closest current tag is SPOUSE_CONVERTER, which applies to compatible sexes and which lacks parameters.

=====''[ASSIMILATE_CONVERTER:species:product:time]''=====

: As per CHILD_CONVERTER, but for any member of the targetted species. The converted creature will become a faction member instead of a dynastic member.

=====''[ADD_BODY_TAG:caste:...]'' =====

: '''Arguments:'''
:* ''caste'': Caste within the current creature object to append additional body tokens to
:* ''...'': Colon-separated list of [[body tokens|body templates]]

: This is an ''appendix'' of the creature's BODY token which allows you to add additional body parts to male or female members of the creature, instead of being required to redefine the caste through SELECT_CASTE and override the BODY token already present. There is presently no way of using creature variations to add new body parts to the BODY tag, only to replace existing parts within the tag (e.g., I can convert the fingers to talons, but I can't add three adamantium spikes to the existing hands and fingers).

: Whenever a creature is created, it receives all of the body parts from the BODY token, plus all of the body templates from each ADD_BODY token in sequence that matches its caste.

: Note in particular that this would vastly simplify such things as sheep -- instead of having two define the body token twice, once under CASTE:FEMALE and once under CASTE:MALE, the body tag could be defined once under the root ("all") caste, and then an ADD_BODY_TAG:MALE:2HEAD_HORN tag anywhere after the CASTE:MALE has been defined.

=== Thought Tokens ===

=====''[MELANCHOLY:weight]'' / ''[BERSERKNESS:weight]'' / ''[MADNESS:weight]''=====

: '''Arguments:'''
:* ''weight'': The odds that when the being suffers this form of insanity when pushed to depression.

: This is designed to influence how exactly a given species behaves when it hits insanity. The possible insanity forms are rolled against with weighted throws to determine which form of insanity takes hold.

: Additional insanity types, as they are added, would also have corresponding weighting tokens added. Gaining disturbing fetishes, becoming sociopathic (i.e., covert murder instead of overt murder when found alone with a potential victim), and acquiring debilitating phobias are all potential insanity forms that could be added to DF.

: If a token for a corresponding insanity type does not appear, it takes on the default weighting of 100.

=====''[LIMIT_HAPPINESS:min:max]''=====

: '''Arguments:'''
:* ''min'': The minimum, default -100.
:* ''max'': The maximum, default 100.

: This is designed to impose caps to the creature's possible happiness. This also allows the creation of generally emotionless races, if you were to set both values to zero.

: If the minimum is set above the unhappiness threshold, the being can never become insane due to unhappiness, so ideally there would be other penalties to unhappiness like having their work rate directly proportional to their current percentage of happiness or some such.

: Mostly this token would be used to impose a maximum cap while leaving the minimum as -100, so certain beings are simply more prone to insanity.

=====''[HAPPYMULT:percent]'' / ''[SADMULT:percent]''=====

: '''Arguments:'''
:* ''percent'': The percentage by which thought modify the current happiness level.

: This token makes some beings naturally more prone to becoming happy or to becoming sad as a result of unhappy thoughts. If a being has HAPPYMULT 50 and SADMULT 100, for instance, then happy thoughts are one half as effective at making the being happy and sad thoughts are of normal effectiveness.

: With high values for each, this makes beings have greater mood swings. With low values for each, this makes beings more steady. With low values for HAPPYMULT and high values for SADMULT, this makes the creatures tend towards depression. The converse is true for high HAPPYMULT and low SADMULT.

=====''[BAD_EMOTION:emotion]''=====

: '''Arguments:'''
:* ''emotion'': The type of emotion that upsets the being when it is experienced.

: '''Emotion Parameters:'''
:* FEAR: Causes the being to receive an unhappy thought every time it is forced to flee from an enemy.
:* ATTACK : Causes the being to receive an unhappy thought every time it is forced to fight.
:* KILL : Causes the being to receive an unhappy thought every time it is credited with a kill.

: This token causes the being to receive a small unhappy thought each and every time it performs the indicated activity. This can rapidly lead to insanity.

: This is hard to quantify in human terms and would mostly be used to give certain behaviour to animals when they are otherwise experiencing unusual circumstances. For instance, a normal being (who flees from conflict instead of stays and fights) with BERSERKNESS:500, SADMULT:500 and BAD_EMOTION:FEAR is being chased by a hunter. The being will attempt to flee, and if the aggressor continually chases after it the being will be rapidly driven to go berserk and lash out at its attacker.

===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.

== Body Tokens ==

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

This portion of the body is used for injecting eggs into a victim.

=====''[MILK]''=====

This portion of the body is responsible for production of milk, and if destroyed the creature can no longer produce it or feed its offspring. Multiple MILK organs correspond to a proportional reduction in ability to nurse their young. Viable for udders for cows, goats, donkeys, etc.

=====''[REPRODUCTIVE_CONTRIBUTE]'' / ''[REPRODUCTIVE]'' =====

For REPRODUCTIVE, this portion of the body is responsible for laying of eggs or (non-simulated) copulation, and if destroyed the creature can no longer reproduce. Intended to allow entity-based punishments of castration (in world-gen, presumably).

For REPRODUCTIVE_CONTRIBUTE, this allows some redundancy -- as long as there is at least one REPRODUCTIVE_CONTRIBUTE organ remaining, the animal can reproduce. If all REPRODUCTIVE_CONTRIBUTE organs are missing, however, the creature can no longer reproduce. Intended to allow gelding stallions and bulls or otherwise neutering male pets (removal of testes) or spaying female pets (removal of ovaries).

User:JT

2014-07-11T02:06:05Z

JT: contemporarinessnessness

how u type on internets?

==Aboot==

Canadian, eh? Durned tootin'.

29 years old as of October 29th, 2013. Adamant believer that society is founded on the principles of doing what is best for everyone, even to the extent that it circumvents the law: believes strongly in ''society'' as opposed to ''law and justice''. Intended career path: regular member, [http://en.wikipedia.org/wiki/Royal_Canadian_Mounted_Police RCMP] (you might find this ironic, but track him down on irc://irc.newnet.net/ #bay12games and he'll talk your ear off about why it isn't).

Considers himself Liberal when speaking to Canadians, Libertarian when speaking to Americans, but usually votes for the extreme-left New Democratic Party because they seem to be the only Canadian political party genuinely interested in serving the Canadian interest instead of their partisan agendas. (And even that's a stretch.)

Hobbyist game developer. Likes writing games, but is too much of a perfectionist to release most of them in their unfinished states, and has too many diverse interests to commit to a single one of them until completion. Excellent grasp of game design and balance due to some sort of ability to imagine the finished product well in advance of getting it there (which might be half of the reason he never finishes them).

188 centimetres tall, 85 kilograms, big blue-green eyes, chestnut brown hair, single. Hetero. Prefers effervescent girls with very long hair, facial structure more important than body structure, average weight or higher (but there is an upper limit -- ideally around 75 kilos, 15-30 centimetres shorter).

Apparently enjoys talking about himself in the third person.

==Hello, my name is Simon==

I like to do drawrings!

[[Image:Jt_screwpump.png|left|frame|A screwpump diagram.]]

[[Image:Jt_df_ramp.png|frame|A diagram of a valid and invalid ramp. (It then occurred to me that the top ramp is still usable, but only in the diagonal directions.)]]
<br style="clear: both" />

==Miscellany==

* [[/Starting Builds]]
* [[/Token Wishlist]]
* [[/Teensy weensy wishlist]]
* [[/Threat]]

==Mods==

* [[/Toadmod]] -- because it really needed to be done

User:JT/Token Wishlist

2014-07-11T02:02:38Z

JT: updating for latest version; OVIPAROUS tag was obviated a while ago, but I never fully got into the 2012 version; improved suggestion for SAPOTROPH_EGGS

User talk:JT

2013-05-11T23:40:59Z

JT:

Thanks for the template. -- [[User:Vaevictus|Vae]] 14:37, 08 November 2007 (EST)

:Thanks for the line-height idea! --[[User:JT|JT]] 14:43, 8 November 2007 (EST)

I created that image ([[:Image:Old0c3822.png]]) specifically for that template ([[Template:Old]]) and it doesn't really fit in [[Template:Spoiler]] or [[Template:Minorspoiler]], so I've created a new, pits-based image for that. Minorspoiler could use a different image, but it does fit the spoiler category. --[[User:Savok|Savok]] 11:28, 4 February 2008 (EST)

:Yeah, it was mostly just a placeholder, although it was generic enough not to matter. I wanted to replace it with something, but never got around to it. --01:24, 5 February 2008 (EST)

Great Addition with that "cheet sheet" for the status icons! --[[User:N9103|Edward]] 21:29, 11 May 2008 (EDT)

:I can't claim credit for it. It was just a direct copy from the old Wiki, and if the old Wiki is to be believed then the person who uploaded it there borrowed it from someone else too! --[[User:JT|JT]] 22:02, 11 May 2008 (EDT)

with what program did you draw this : [[File:Jt screwpump.png|256px]] ? --[[User:Tsester|Tsester]] ([[User talk:Tsester|talk]]) 14:49, 10 May 2013 (UTC)

: Good ol' Windows Paint! I may have done some touch-up work or layering work in GIMP -- I can't remember, but I use GIMP like a habit, so it's possible -- but I remember it was straight Paint for the majority. (At that point, it was the Windows XP version. I still can't really wrap my head around the "slightly improved but not really" new Office 2010 style of the Windows 7 Paint.) --[[User:JT|JT]] ([[User talk:JT|talk]]) 23:40, 11 May 2013 (UTC)

v0.34:Reactions

2013-04-15T08:35:35Z

JT: /* Modifiers */ clarity of reaction name; specific solution for CONTAINS_LYE issue; altered "below" to "approaching" to imply must withstand heat instead of must be colder

{{quality|Fine|09:41, 6 October 2010 (UTC)}}
{{av}}

Reactions are modular, editable formulas that take specific ingredients, or reagents, and use them to produce a desired item. A lot of reactions are hardcoded - building beds or creating glass, for example -- but a few are freely editable, and it's quite simple to add additional ones.

== Reaction differences between modes ==
In [[Fortress mode]], reactions are linked to specific buildings, and must be added to a civilization's [[Entities|entity file]] to be usable by that civilization. This has the useful effect of limiting new items and materials (such as special [[wood]] or [[metal]]) to civilizations that have the requisite reaction -- so that if you give your custom civilization a reaction to produce star metal or some other custom material, only they will be able to use it.

In [[Adventure mode]], reactions are freely available via x > create, and any adventurer character can make free use of them. Reagents may be held in the hands or dropped on the ground, but cannot be used within a backpack or quiver. There are several bugs with Adventure mode reactions, chief of which is the fact that you cannot select liquid reagents.{{verify}} 

==Anatomy of a reaction==

Reactions are found within reaction_x files (such as reaction_smelter or reaction_other). Generally speaking they adhere to the following structure:

[REACTION:<identifier>]
[NAME:<name>]
[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
[REAGENT:A:150:BAR:NONE:POTASH:NONE]
[PRODUCT:100:1:BAR:NONE:PEARLASH:NONE][PRODUCT_DIMENSION:150]
[FUEL]
[SKILL:<SKILL TOKEN>]
[AUTOMATIC]
[ADVENTURE_MODE_ENABLED]
* ''[[#Reaction identifier|identifier]]'': The internal ID of the reaction.
* ''[[#Reaction name|name]]'': The name of the reaction, visible to the player in the Fortress mode or Adventure mode menus.
* ''[[#Building|building]]'': The building ID that the reaction uses, and the relevant keyboard shortcut.
* ''[[#Reagents|...reagents...]]'': Zero or more reagents (ingredients) that are required to be in stock for the reaction to be possible.
* ''[[#Products|...products...]]'': Zero or more products that are created from the reaction.
* ''[[#fuel|fuel]]'': (optional) If present, the reaction requires charcoal, coke or a magma-powered workshop.
* ''[[#skill|skill]]'': (optional) The skill required and trained by the reaction.
* ''[[#automatic|automatic]]'': (optional) If present, the reaction will automatically be enqueued whenever it can possibly be performed.
* ''[[#adventure mode|adventure mode]]'': (optional) If present, the reaction is used by the player in Adventure mode instead.

=== Reaction identifier ===

The reaction identifier may be anything, so long as it is unique within the raw data files. A good habit to get into is to append a short prefix or suffix to each name related to the name of your mod, to ensure nobody else is going to make an identical reaction and thereby mess up the game if their mod is run alongside yours.

=== Reaction name ===

This can be anything at all, and is usually used to describe the reaction. '''Tan a hide''', for example, is the name of the default leather-producing reaction. Generally this should be written as a small descriptive verb phrase, with the first letter capitalized, for consistency with the existing reactions.

=== Building ===

[BUILDING:<BUILDING NAME>:<BUILDING KEY>]
* ''name'': The ID of the building where this reaction will appear in the tasks menu.
* ''key'': The keyboard shortcut used to queue up the reaction.

The BUILDING NAME is the name of the building that will house this reaction, and the building key is the keyboard shortcut that will queue up the reaction. If two reactions have the same key, then one of them will be assigned a different key, the first alphabetically available at the building.

Valid buildings are KILN, SMELTER, TANNER, KITCHEN, QUERN, MILLSTONE, STILL, CRAFTSMAN, and any custom buildings (SOAP_MAKER, SCREW_PRESS, and anything you've added).

Specifying multiple BUILDING tokens will cause the reaction to be available at all of the specified buildings.

=== Reagents ===
REAGENTs are a little bit complicated. They are the ingredients that the reaction will use. You can define as many as you like within a reaction.

[REAGENT:<name>:<quantity>:<item token>:<material token>][...modifiers...]
* ''[[#name|name]]'': The name of the reagent, local to the reaction.
* ''[[#quantity|quantity]]'': The amount of the item that will be used in the reaction.
* ''[[#item_token|item token]]'': The type (and subtype) of the item you require.
* ''[[#material_token|material token]]'': The material the item should be made of.
* ''[[#Modifiers|...modifiers...]]'': Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

==== name ====
The name field is a small string used to identify the reagent within the reaction. The name is not visible to the player. It is local to the reaction and does not need to be unique across all of the reactions, so you can reuse the same names over and over, although each reagent within the same individual reaction must have a different name.

Most reactions are simply named '''A''', '''B''', and so forth in default reactions, although names such as '''TOOLSTONE''' or '''FLUX''' will also work equally well. The PRODUCT may make reference to this name — for instance, if a container '''B''' is specified as a reagent, PRODUCT_TO_CONTAINER:B specifies that container.

==== quantity ====
The quantity differs between item types. Generally speaking, cloth, thread, powder, bars and globs use numbers representing the size of material within one item, and everything else uses a static quantity. While REAGENT:A:'''''10''''':'''''THREAD''''':NONE:NONE:NONE thread is an extremely tiny portion of a random spool of thread, REAGENT:A:'''''10''''':'''''TOY''''':NONE:NONE:NONE is ten unique, solid toy items.

Sometimes the quantity of product is directly connected with the quantity of reagent; it seems to be 150 / REAGENT <quantity> (rounding down) so that Reagent <quantity> of 3 gives 50 product and a <quantity> of 4 gives 37. (150/4=37.5) [List of item types this applies to? Bars, for instance.]

==== item token ====
Item tokens are of the form ITEM_TYPE:ITEM_SUBTYPE.

The item type is the sort of item you require; WEAPON, TOY or SKIN_TANNED, for example. A [[item token|full list]] is available.

For reagents, the item token can also be set to ANY_RAW_MATERIAL:NONE (to permit BAR, BOULDER, POWDER_MISC, or GLOB) or ANY_CRAFT:NONE (to permit FIGURINE, AMULET, SCEPTER, CROWN, RING, EARRING, or BRACELET). Internally, these special values are both converted to NONE:NONE and merely set special modifiers (similar to [BUILDMAT]) - they cannot be used in any other context.

The item subtype is name of the exact item that you require. Examples are ITEM_WEAPON_SPEAR or ITEM_TOY_PUZZLEBOX. Some items, like quivers or backpacks, or chunks of stone or metal, only require the item token to be filled in, so if you're asking for those you should set the subtype to NONE. Subtypes are defined within the local raw data files and their exact names can be referenced by looking at the corresponding file.

For backwards compatibility, reagents can also accept "METAL_ORE:metal_id" in place of both the item and material tokens - this is equivalent to using the reagent BOULDER:NONE:NONE:NONE with the modifier [METAL_ORE:metal_id] (see below).

==== material token ====
Material tokens come in several forms - see [[material token|here]] for a full list. For reagents, this will typically be INORGANIC:MATERIAL_ID, whereas products will typically use GET_MATERIAL_FROM_REAGENT:REAGENT_ID:REACTION_PRODUCT_ID.

==== Modifiers ====
Reagents may also have extra tokens added on afterwards, placed just after the REAGENT tag.

A list of them follows:

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [REACTION_CLASS:X]
| Reagent material must have the specified reaction class - see below for more details.
|-
| [HAS_MATERIAL_REACTION_PRODUCT:X]
| Reagent material must have the specified material reaction product - see below for more details.
|-
| [CONTAINS:X]
| Reagent is a container that holds the specified reagent (where ''X'' is the [[#name|name]] of the reagent).
|-
| [UNROTTEN]
| Reagent must not be rotten, mainly for organic materials.
|-
| style="vertical-align: top"| [CONTAINS_LYE]
| Reagent must be a BARREL or TOOL which contains at least one item of type LIQUID_MISC made of LYE. Use of this token is discouraged, as it does not work with buckets (instead, use [CONTAINS:lye] — note the colon — and a corresponding lye reagent [REAGENT:lye:150:LIQUID_MISC:NONE:LYE]).
|-
| [POTASHABLE]
| Alias for [CONTAINS_LYE].
|-
| [NOT_WEB]
| Reagent must be collected (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| [WEB_ONLY]
| Reagent must be undisturbed (to distinguish silk thread from webs). Only makes sense for items of type THREAD.
|-
| [EMPTY]
| If the reagent is a container, it must be empty.
|-
| [NOT_CONTAIN_BARREL_ITEM]
| If the reagent is a container, it must not contain [[lye]] or [[milk]]. Not necessary if specifying [EMPTY].
|-
| [BAG]
| Reagent must be a bag - that is, a BOX made of plant fiber, silk, yarn, or leather.
|-
| [GLASS_MATERIAL]
| Reagent material must have the [IS_GLASS] token. All 3 types of [[glass]] have this token hardcoded.
|-
| [BUILDMAT]
| Reagent must be a general [[building material]] - BAR, BLOCKS, BOULDER, or WOOD.
|-
| [FIRE_BUILD_SAFE]
| Reagent material must be stable at temperatures approaching 11000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe.
|-
| [MAGMA_BUILD_SAFE]
| Reagent material must be stable at temperatures approaching 12000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe.
|-
| [CAN_USE_ARTIFACT]
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.
|-
| [WORTHLESS_STONE_ONLY]
| Reagent material must be non-[[economic]].
|-
| [ANY_PLANT_MATERIAL]
| Reagent material must be subordinate to a PLANT object.
|-
| [ANY_SILK_MATERIAL]
| Reagent material must have the [SILK] token.
|-
| [ANY_YARN_MATERIAL]
| Reagent material must have the [YARN] token.
|-
| [ANY_SOAP_MATERIAL]
| Reagent material must have the [SOAP] token.
|-
| [ANY_LEATHER_MATERIAL]
| Reagent material must have the [LEATHER] token.
|-
| [ANY_BONE_MATERIAL]
| Reagent material must have the [BONE] token.
|-
| [ANY_STRAND_TISSUE]
| Reagent is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT].
|-
| [ANY_SHELL_MATERIAL]
| Reagent material must have the [SHELL] token.
|-
| [ANY_TOOTH_MATERIAL]
| Reagent material must have the [TOOTH] token.
|-
| [ANY_HORN_MATERIAL]
| Reagent material must have the [HORN] token.
|-
| [ANY_PEARL_MATERIAL]
| Reagent material must have the [PEARL] token.
|-
| [USE_BODY_COMPONENT]
| Reagent must be a body part (CORPSE or CORPSEPIECE).
|-
| [NO_EDGE_ALLOWED]
| Reagent must not have an edge - excludes sharp stones (produced using knapping) and most types of weapon/ammo.
|-
| [NOT_ENGRAVED]
| Reagent has not been engraved (excludes memorial slabs).
|-
| [NOT_IMPROVED]
| Reagent has not been decorated.
|-
| [DOES_NOT_ABSORB]
| Reagent material must have [ABSORPTION:0]
|-
| [FOOD_STORAGE_CONTAINER]
| Reagent is either a BARREL or a TOOL with the FOOD_STORAGE use.
|-
| [HARD_ITEM_MATERIAL]
| Reagent material must have [ITEMS_HARD].
|-
| [NOT_PRESSED]
| Reagent must not be in the SOLID_PRESSED state.
|-
| [METAL_ORE:X]
| Reagent material must be an ore of the specified metal.
|-
| [MIN_DIMENSION:X]
| Reagent's item dimension must be at least this large. The reagent's item type must be BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, or CLOTH for this to work.
|-
| [HAS_TOOL_USE:X]
| Reagent must be a [[tool]] with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.
|-
| [PRESERVE_REAGENT]
| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.
|-
| [DOES_NOT_DETERMINE_PRODUCT_AMOUNT]
| Reagent quantity is ignored for the purposes of producing extra outputs. Typically used for containers so that [[stack]]s of reagents will correctly produce additional outputs.
|}

Generally speaking, if you set a field in a reagent to NONE, the reaction won't discriminate when it comes to that particular field. For example, if you require a BOULDER reagent but leave the material as NONE:NONE, it will grab any available BOULDER-type item regardless of material.

===Products===
Products are the end product of the reaction. A reaction can have as many products as it likes.

Products are almost identical to reagents, except that they do not need to be named, can't have fields undefined, and don't use the quantity field to determine the product size. Instead, the token PRODUCT_DIMENSION:X is tacked on after the PRODUCT token, determining the size of the product.

Products can be produced directly to a container using the [PRODUCT_TO_CONTAINER:<IDENTIFIER>] token, where the IDENTIFIER is the name of a reagent. This requires the reagent to have the PRESERVE_REAGENT token.

Restating this in the above style, we have:
[PRODUCT:<probability>:<quantity>:<item token>:<material token>][...modifiers...][PRODUCT_DIMENSION:X][PRODUCT_TO_CONTAINER:<IDENTIFIER>]

====probability====
The percentage chance the product will be produced when the reaction is completed.

====quantity====
Determines how many of the product will be produced. For the item types AMMO, REMAINS, MEAT, FISH, FISH_RAW, PLANT, LEAVES, DRINK, CHEESE, LIQUID_MISC, COIN, and EGG, the resulting items will be created as a single [[stack]], while all other item types will produce multiple individual items.

====item token====
The [[item token]] and subtype of the item you produce.

For products, this can also be set to CRAFTS:NONE to produce up to three random [[craft]] items. This value cannot be used in any other context.

====material token====
A [[material token]] describing what the product will be made of.

====Product modifiers====
Zero or more tokens which further clarify the acceptable types when the item type and material types are insufficient to distinguish them.

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| [FORCE_EDGE]
| Product is given a sharp edge. Used for knapping.
|-
| [PRODUCT_PASTE]
| Product is created in the SOLID_PASTE state.
|-
| [PRODUCT_PRESSED]
| Product is created in the SOLID_PRESSED state.
|-
| [PRODUCT_DIMENSION:<size>]
| Specifies the size of the product. A size of 150 is typical for BAR, POWDER_MISC, LIQUID_MISC, and DRINK. A size of 15000 is typical for THREAD, and a size of 10000 is typical for CLOTH. Has no effect on any other item types.
|-
| [PRODUCT_TO_CONTAINER:<id>]
| Places the product in a container; <id> must be the name of a reagent with the PRESERVE_REAGENT token and a container item type.

|}

===Improvements===
Improvements are applied to existing reagents. A reaction can have as many improvements as it likes.

Restating this in the above style, we have:
[IMPROVEMENT:<probability>:<reagent name>:<improvement type>:<material token>]

====probability====
The percentage chance the improvement will be applied to the reagent when the reaction is completed.

====reagent name====
The name of the reagent that will be improved. In order to be meaningful, this reagent must have [PRESERVE_REAGENT].

====improvement type====
The following improvement types can be used:
{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Meaning
|-
| COVERED
| Item is encrusted/studded/decorated with <material>.
|-
| GLAZED
| Item is glazed with <material>.
|-
| RINGS_HANGING
| Item is adorned with hanging rings of <material>.
|-
| BANDS
| Item is encircled with bands of <material>.
|-
| SPIKES
| Item menaces with spikes of <material>.
|-
| PAGES
| Adds pages to a [[book]].
|}

All other item improvement tokens (ART_IMAGE, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE, and ILLUSTRATION) are ignored.

====material token====
A [[material token]] describing what the decoration will be made of.

===Other tokens===

==== fuel ====
The FUEL token means that the reaction requires coke or charcoal to be performed. Fuel is not needed when the reaction is performed at a magma workshop (a [[magma kiln]], [[magma smelter]], or any custom building having [NEEDS_MAGMA]).

==== skill ====
The SKILL token determines what [[Skill token|skill]] the reaction requires and what skill it trains. Only one skill may be specified.

==== automatic ====
The AUTOMATIC token means that the reaction will be queued automatically if the reaction reagents are all present.

This token only works with jobs performed at a [[kiln]], [[smelter]], [[tanner's shop]], [[kitchen]], or custom workshop, and [[standing orders]] allow you to limit which ones trigger; custom reactions performed at a [[quern]], [[millstone]]{{verify}}, [[still]]{{verify}} or [[craftsdwarf's workshop]]{{verify}} cannot be made automatic.

==== adventure mode enabled ====
The ADVENTURE_MODE_ENABLED token means that this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files.

==Material reaction products and reaction classes==

You can get a certain measure of control over very specific materials using reaction classes and material reaction products - the tokens look like this:

[REACTION_CLASS:FAT]
[HAS_MATERIAL_REACTION_PRODUCT:RENDER_MAT]

Reaction classes represent different classes of material - basically, the material of the reagent must have a REACTION_CLASS the same as the one in the reaction.

Material reaction products are similar, but are generally used more for things like different kinds of creature materials than universal materials like stone. This token is how skin can be tanned into leather, which are two separate materials - the skin material has leather as a MATERIAL_REACTION_PRODUCT.

In short, they require the material to have a token such as
[MATERIAL_REACTION_PRODUCT:X:Y]
...where X is the name of the reaction product that will be referred to in the reaction (RENDER_MAT, in the reaction class example, or TAN_MAT for leather) and Y is a [[material token]] indicating the material of the desired product (such as LOCAL_CREATURE_MAT:LEATHER]).

==Reactions and world generation==

There are several things to keep in mind when you're adding reactions to a game that already exists.

* Most entity changes require a regen, but adding PERMITTED_REACTION tokens for reactions that existed at the time of world generation to the entity file in the save directory do not.
* Adding reactions to the raws in a save directory requires you to regen the world.
* You can alter an existing reaction in any way you like without regenning the world, so long as you don't alter the reaction identifier.

==Full Token List==
For the sake of convenience and readability this is a complete compilation of the previously listed reaction tokens in alphabetical order

{| {{prettytable}}
|- bgcolor="#dddddd"
! Token
! Arguments
! Description

|-
| ADVENTURE_MODE_ENABLED
|
| this version of the reaction is not used by dwarves at home in a fortress, but rather the wanderers of Adventure Mode. When using this token, it will be allowed for adventurers of any race, without editing Entity files

|-
| ANY_BONE_MATERIAL
|
| Reagent material must have the [BONE] token.

|-
| ANY_HORN_MATERIAL
|
| Reagent material must have the [HORN] token.

|-
| ANY_LEATHER_MATERIAL
|
| Reagent material must have the [LEATHER] token.

|-
| ANY_PEARL_MATERIAL
|
| Reagent material must have the [PEARL] token.

|-
| ANY_PLANT_MATERIAL
|
| Reagent material must be subordinate to a PLANT object.

|-
| ANY_SHELL_MATERIAL
|
| Reagent material must have the [SHELL] token.

|-
| ANY_SILK_MATERIAL
|
| Reagent material must have the [SILK] token.

|-
| ANY_SOAP_MATERIAL
|
| Reagent material must have the [SOAP] token.

|-
| ANY_STRAND_TISSUE
|
| Reagent is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT].

|-
| ANY_TOOTH_MATERIAL
|
| Reagent material must have the [TOOTH] token.

|-
| ANY_YARN_MATERIAL
|
| Reagent material must have the [YARN] token.

|-
| AUTOMATIC
|
| the reaction will be queued automatically if the reaction reagents are all present.

|-
| BAG
|
| Reagent has to be a bag. Intended to be used with an item type of BOX, to prevent chests, coffers, and other containers from being used instead.

|-
| BUILDING
|
* Building name
* in-building reaction hotkey
| Sets the building that the reaction will be performed in, and the button used to queue the reaction once that building's menu is accessed in-game

|-
| BUILDMAT
|
| Reagent is able to be used to build structures (Stone, Wood, Blocks, Bars?).

|-
| CAN_USE_ARTIFACT
|
| Reagent can be an Artifact. Using [PRESERVE_REAGENT] with this is strongly advised.

|-
| CONTAINS
| required content
| Reagent is a container that holds the specified reagent.

|-
| CONTAINS_LYE
|
| If the reagent is a container, it must contain LYE. No longer used - instead, use one reagent for the LYE itself and another reagent with [CONTAINS:lye_reagent].

|-
| DOES_NOT_ABSORB
|
| Reagent material must have [ABSORPTION:0]

|-
| DOES_NOT_DETERMINE_PRODUCT_AMOUNT
|
| Performing a reaction with large [[stack]]s of inputs can allow multiple sets of outputs to be produced. Setting this flag causes the reagent to be ignored in this process - for example, with the reaction "1 plant + 1 barrel -> 5 alcohol (into barrel)", using this on the barrel allows the reaction to be performed as "5 plant + 1 barrel -> 25 alcohol" instead of "5 plant + 5 barrel -> 25 alcohol".

|-
| EMPTY
|
| If the reagent is a container, it must be empty.

|-
| FIRE_BUILD_SAFE
|
| Reagent must be considered fire safe - ie. not wood, and not coal.

|-
| FORCE_EDGE
|
| Product is given a sharp edge. Used for knapping.

|-
| FUEL
|
| Requires that the reaction either use up a unit of coal or charcoal or else be performed at a magma workshop

|-
| GLASS_MATERIAL
|
| Reagent material has [IS_GLASS].

|-
| HAS_MATERIAL_REACTION_PRODUCT
| PRODUCT_ID (custom)
| Similar to REACTION_CLASS, but requires the reagent's material to have a matching [[Material definition token|MATERIAL_REACTION_PRODUCT]] entry. Intended for reactions which transform one class of material into another, such as skin->leather and fat->tallow.

|-
| HAS_TOOL_USE
| Tool-use token
| Reagent must be a [[tool]] with the specific TOOL_USE value. The reagent's item type must be TOOL:NONE for this to make any sense.

|-
| IMPROVEMENT
|
* Probability
* Reagent Name
* Improvement type
* Material Token
| Improvement types include BANDS, COVERED, GLAZED, RINGS_HANGING, and SPIKES

|-
| MAGMA_BUILD_SAFE
|
| Currently broken - behaves exactly the same as FIRE_BUILD_SAFE.

|-
| METAL_ORE
|
* Inorganic material
| Reagent material must be an ore of the specified metal

|-
| MIN_DIMENSION
|
* size
| Requires that the reagent have a dimension of at least this value. Only effective with BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, and CLOTH items.

|-
| NAME
| name
| defines the name used by the reaction in-game

|-
| NO_EDGE_ALLOWED
|
| Reagent must not be sharpened (used for knapping).

|-
| NOT_CONTAIN_BARREL_ITEM
|
| If the reagent is a Barrel, it must not contain an item that has to reside in a barrel. Barrel items appear to be lye and milk. Alcohol appears to be covered as part of [EMPTY]. A reaction which places an item in a barrel should probably have both tags.

|-
| NOT_ENGRAVED
|
| Reagent must not be engraved?

|-
| NOT_IMPROVED
|
| Reagent has not been decorated.

|-
| NOT_PRESSED
|
| Reagent must not be in the SOLID_PRESSED state.

|-
| NOT_WEB
|
| Reagent must be "collected" - used with THREAD:NONE to exclude webs.

|-
| POTASHABLE
|
| Alias for CONTAINS_LYE.

|-
| PRESERVE_REAGENT
|
| Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.

|-
| PRODUCT
|
*Probability
*Quantity
*Item Token
*Material Token
| Defines one of the products to be outputted by the reaction, "Material Token" can be replaced with "GET_MATERIAL_FROM_REAGENT:(reagent_id):(product_id)", where (product_id) matches a MATERIAL_REACTION_PRODUCT present on the specified reagent's material (ideally confirmed to exist using "[HAS_MATERIAL_REACTION_PRODUCT:(product_id)]" on said reagent) or is equal to "NONE" to simply use the reagent's actual material.

|-
| PRODUCT_DIMENSION
| size
| Specifies the size of the product. A size of 150 is typical for BAR, POWDER_MISC, LIQUID_MISC, and DRINK. A size of 15000 is typical for THREAD, and a size of 10000 is typical for CLOTH.

|-
| PRODUCT_PASTE
|
| Product is created in the SOLID_PASTE state.

|-
| PRODUCT_PRESSED
|
| Product is created in the SOLID_PRESSED state.

|-
| PRODUCT_TO_CONTAINER
| Reagent ID
| Places the product in a container; <id> must be the name of a reagent with the PRESERVE_REAGENT token and a container item type.

|-
| REACTION
| Identifier
| defines a new reaction

|-
| REACTION_CLASS
| CLASS_ID (custom)
| Requires the reagent's material to have a matching [[Material definition token|REACTION_CLASS]] entry. Intended for reactions which accept a variety of materials but where the input material does not determine the output material, such as FLUX (for making pig iron and steel) and GYPSUM (for producing plaster powder).

|-
|REAGENT
|
* name/id
* quantity
* [[item token]]
* [[material token]]
| Requires a given reagent as an input for a reaction

|-
| SKILL
| Skill Token
| Skill used by the reaction

|-
| UNROTTEN
|
| Reagent must not be rotten, mainly for organic materials.

|-
| USE_BODY_COMPONENT
|
| Reagent material must come off a creature's body.

|-
| WEB_ONLY
|
| Reagent must be "undisturbed" - used with THREAD:NONE to gather webs.

|-
| WORTHLESS_STONE_ONLY
|
| Reagent is not made of an economic stone.

|}

{{Category|Modding}}

v0.34:Smelter

2012-07-18T15:58:06Z

JT:

{{quality|Fine|16:32, 7 September 2010 (UTC)}}
{{Furnace|name=Smelter|key=s|job=[[Furnace operator]]
|construction=
* [[Fire-safe]] [[building material]] (non-[[economic]])
|construction_job=
* [[Architecture]]
* [[Masonry]] or [[Metalsmithing]]
|use=
* [[Coke]] or [[Charcoal]] ([[Fuel]])
* [[Ore]]
* Meltable [[metal]] item
* [[Bituminous coal]]
* [[Lignite]]
* [[Flux]]
|production=
* Metal [[Bar]]s
* [[Coke]]
}}{{av}}

The lifeblood of a fortress, a '''smelter''' is used to smelt [[ore]]s with [[fuel]] or for [[Melt item|melting]] existing metal objects into metal [[bar]]s. The smelter is also where [[lignite]] and [[bituminous coal]] are made into [[coke]]. A dwarf must have the "Furnace Operator" labor enabled to use the smelter.

If all options in a smelter are red, there are two possible scenarios to explain why:
# Fuel is needed - find/buy [[coke]] or turn wood into [[charcoal]] at a [[wood furnace]].
# The workshop is being specified as a "Give" destination from a stockpile that does not possess any/all of the necessary materials.

{{Workshops}}

User:JT/Threat

2012-07-18T08:46:59Z

JT: truth in advertising

Since a lot of trolling slipped into the [[speech mods#threat|threat.txt]] mod page on the Wiki but I'm remiss to remove them entirely because frankly some people might like the off-colour humour, I thought I'd go ahead and create my own subpage containing my preferred threat.txt layout.

I've done a lot of threat.txt modding over the years but I think I've finally come to version I actually like.

Since I need to be truthful in advertising (what kind of person would I be to create a subpage titled "threat" that doesn't actually threaten anyone?)... '''''if you attempt to edit this page, I will know, I will find you, and I will hurt you.'''''

<pre>
Accept your fate!
Are you yet afraid? If not, you will be!
Battle awaits!
Behind my thunderous roar, you will utter but a dying whisper!
Come! I am waiting!
Cower before my might and I might just crush you quickly!
Cry, for now you end!
Death now looms for you!
Die. Die! DIE!
Do you not see? You are dead already!
Draw!
Drop your weapons and await your fate!
Embrace the end that awaits you!
Fool! Perish at my hand!
Give in to darkness and despair!
I am destined to be your last foe!
I am going to split you like a ripe melon!
I damn you to oblivion!
I decree that you are to die!
I shall delight in watching the life fade from your cold, glassy eyes!
I shall delight in your torture!
I shall devour your heart!
I shall feast on your entrails!
I shall flatten you!
I shall impale you on a pike and watch you whimper as I dine!
I shall quarter you like a small gamefowl!
I shall show you final justice!
I shall strike you down!
I will drink from your skull!
I will not be gentle!
I will tear you limb from limb!
I will wear your face as a mask!
It is already over; stand still and embrace death!
It's time to suffer!
Kneel before your god!
Let us match weapons and make the sound of thunder!
Perhaps I shall refer to you as a worthy foe when next a fool challenges me!
Perhaps you will be a worthy prey!
Perhaps you will live if you flee now!
Praise me, for I am now your god!
Pray to your maker!
Pray while you still can!
Prepare for battle!
Prepare to die!
Prove your worthiness to fight me!
Relax! This will be over very soon!
Scream now, for soon you will be unable to speak!
Show me the color of your blood!
Show me your mettle!
Squeal, whimper, gasp, and die!
Stand ready!
Stand ready! I will not go easy on you!
Submit to the cold embrace of death!
The blackness will take you!
There is no escape!
This will end badly for you!
To arms!
With your death, I shall grow even stronger!
You are now but a footnote of my greatness!
You DARE challenge me?!
You have already made your final mistake!
You have been doled a death sentence!
You have not felt suffering yet!
You may flee now! I will enjoy the sport!
You will be proud to die at my hands!
You will beg for death before I am done!
You will know nothing but terror when I am through!
You will know only pain!
Your blood shall be spilled this day!
Your body will fall like a limp bag!
Your bones will be my dinner!
Your fear sustains me!
Your god has foresaken you! Worship me! Worship your death!
Your head affronts me! I shall remove it for you!
Your head will hang on my wall!
Your heartbeat is agony to my ears, and soon will be stopped!
Your life belongs to me!
Your tale ends here!
</pre>

User:JT/Threat

2012-07-18T08:44:47Z

JT: Created page with "Since a lot of trolling slipped into the threat.txt mod page on the Wiki but I'm remiss to remove them entirely because frankly some people might like the ..."

Since a lot of trolling slipped into the [[speech mods#threat|threat.txt]] mod page on the Wiki but I'm remiss to remove them entirely because frankly some people might like the off-colour humour, I thought I'd go ahead and create my own subpage containing my preferred threat.txt layout.

I've done a lot of threat.txt modding over the years but I think I've finally come to version I actually like.

<pre>
Accept your fate!
Are you yet afraid? If not, you will be!
Battle awaits!
Behind my thunderous roar, you will utter but a dying whisper!
Come! I am waiting!
Cower before my might and I might just crush you quickly!
Cry, for now you end!
Death now looms for you!
Die. Die! DIE!
Do you not see? You are dead already!
Draw!
Drop your weapons and await your fate!
Embrace the end that awaits you!
Fool! Perish at my hand!
Give in to darkness and despair!
I am destined to be your last foe!
I am going to split you like a ripe melon!
I damn you to oblivion!
I decree that you are to die!
I shall delight in watching the life fade from your cold, glassy eyes!
I shall delight in your torture!
I shall devour your heart!
I shall feast on your entrails!
I shall flatten you!
I shall impale you on a pike and watch you whimper as I dine!
I shall quarter you like a small gamefowl!
I shall show you final justice!
I shall strike you down!
I will drink from your skull!
I will not be gentle!
I will tear you limb from limb!
I will wear your face as a mask!
It is already over; stand still and embrace death!
It's time to suffer!
Kneel before your god!
Let us match weapons and make the sound of thunder!
Perhaps I shall refer to you as a worthy foe when next a fool challenges me!
Perhaps you will be a worthy prey!
Perhaps you will live if you flee now!
Praise me, for I am now your god!
Pray to your maker!
Pray while you still can!
Prepare for battle!
Prepare to die!
Prove your worthiness to fight me!
Relax! This will be over very soon!
Scream now, for soon you will be unable to speak!
Show me the color of your blood!
Show me your mettle!
Squeal, whimper, gasp, and die!
Stand ready!
Stand ready! I will not go easy on you!
Submit to the cold embrace of death!
The blackness will take you!
There is no escape!
This will end badly for you!
To arms!
With your death, I shall grow even stronger!
You are now but a footnote of my greatness!
You DARE challenge me?!
You have already made your final mistake!
You have been doled a death sentence!
You have not felt suffering yet!
You may flee now! I will enjoy the sport!
You will be proud to die at my hands!
You will beg for death before I am done!
You will know nothing but terror when I am through!
You will know only pain!
Your blood shall be spilled this day!
Your body will fall like a limp bag!
Your bones will be my dinner!
Your fear sustains me!
Your god has foresaken you! Worship me! Worship your death!
Your head affronts me! I shall remove it for you!
Your head will hang on my wall!
Your heartbeat is agony to my ears, and soon will be stopped!
Your life belongs to me!
Your tale ends here!
</pre>

User:JT

2012-07-18T08:40:51Z

JT:

how u type on internets?

==Aboot==

Canadian, eh? Durned tootin'.

26 years old as of October 29th, 2010. Adamant believer that society is founded on the principles of doing what is best for everyone, even to the extent that it circumvents the law: believes strongly in ''society'' as opposed to ''law and justice''. Intended career path: regular member, [http://en.wikipedia.org/wiki/Royal_Canadian_Mounted_Police RCMP] (you might find this ironic, but track him down on irc://irc.newnet.net/ #bay12games and he'll talk your ear off about why it isn't).

Considers himself Liberal when speaking to Canadians, Libertarian when speaking to Americans, but usually votes for the extreme-left New Democratic Party because they seem to be the only Canadian political party genuinely interested in serving the Canadian interest instead of their partisan agendas. (And even that's a stretch.)

Hobbyist game developer. Likes writing games, but is too much of a perfectionist to release most of them in their unfinished states, and has too many diverse interests to commit to a single one of them until completion. Excellent grasp of game design and balance due to some sort of ability to imagine the finished product well in advance of getting it there (which might be half of the reason he never finishes them).

188 centimetres tall, 85 kilograms, big blue-green eyes, chestnut brown hair, single. Hetero. Prefers effervescent girls with very long hair, facial structure more important than body structure, average weight or higher (but there is an upper limit -- ideally around 75 kilos, 15-30 centimetres shorter).

Apparently enjoys talking about himself in the third person.

==Hello, my name is Simon==

I like to do drawrings!

[[Image:Jt_screwpump.png|left|frame|A screwpump diagram.]]

[[Image:Jt_df_ramp.png|frame|A diagram of a valid and invalid ramp. (It then occurred to me that the top ramp is still usable, but only in the diagonal directions.)]]
<br style="clear: both" />

==Miscellany==

* [[/Starting Builds]]
* [[/Token Wishlist]]
* [[/Teensy weensy wishlist]]
* [[/Threat]]

==Mods==

* [[/Toadmod]] -- because it really needed to be done

User:JT/Teensy weensy wishlist

2011-04-02T18:36:37Z

JT: /* Rename animals based on location */

This is my collection of teensy-tiny or teensy-weensy feature requests; things which I figure would take at most a few minutes to implement.

==Gender of animals being assigned==

It would be nice if we could see the gender of animals when we are assigning them to cages or to pits.

==Rename animals based on location==

[This was implemented in 0.31.21!]

==Stones screen add-on==

The Stones status screen should gain the information displayed under the Stocks status screen if your stockpile records are precise enough to inventory all of the stones.

==Spikes of rope reed==

Spikes of cloth do not make sense: cloth cannot make a spike as it is much too soft. "Tassels" would be a superior designation for cloth.

To make this into a not-so-teensy-weensy request, perhaps the "spikes", "hanging rings", "bands", etc. could be exported to the raw object files, and the appropriate ones could then make use of the [HARD_MAT] tag just as toys do.

User:JT

2011-04-02T18:34:48Z

JT: /* Aboot */

how u type on internets?

==Aboot==

Canadian, eh? Durned tootin'.

26 years old as of October 29th, 2010. Adamant believer that society is founded on the principles of doing what is best for everyone, even to the extent that it circumvents the law: believes strongly in ''society'' as opposed to ''law and justice''. Intended career path: regular member, [http://en.wikipedia.org/wiki/Royal_Canadian_Mounted_Police RCMP] (you might find this ironic, but track him down on irc://irc.newnet.net/ #bay12games and he'll talk your ear off about why it isn't).

Considers himself Liberal when speaking to Canadians, Libertarian when speaking to Americans, but usually votes for the extreme-left New Democratic Party because they seem to be the only Canadian political party genuinely interested in serving the Canadian interest instead of their partisan agendas. (And even that's a stretch.)

Hobbyist game developer. Likes writing games, but is too much of a perfectionist to release most of them in their unfinished states, and has too many diverse interests to commit to a single one of them until completion. Excellent grasp of game design and balance due to some sort of ability to imagine the finished product well in advance of getting it there (which might be half of the reason he never finishes them).

188 centimetres tall, 85 kilograms, big blue-green eyes, chestnut brown hair, single. Hetero. Prefers effervescent girls with very long hair, facial structure more important than body structure, average weight or higher (but there is an upper limit -- ideally around 75 kilos, 15-30 centimetres shorter).

Apparently enjoys talking about himself in the third person.

==Hello, my name is Simon==

I like to do drawrings!

[[Image:Jt_screwpump.png|left|frame|A screwpump diagram.]]

[[Image:Jt_df_ramp.png|frame|A diagram of a valid and invalid ramp. (It then occurred to me that the top ramp is still usable, but only in the diagonal directions.)]]
<br style="clear: both" />

==Miscellany==

* [[/Starting Builds]]
* [[/Token Wishlist]]
* [[/Teensy weensy wishlist]]

==Mods==

* [[/Toadmod]] -- because it really needed to be done

File talk:WoodIndustry1.jpg

2011-02-21T11:02:10Z

JT: Created page with 'Why are these JPEGs instead of PNGs? Seems like a square peg in a round hole. =) --~~~~'

Why are these JPEGs instead of PNGs? Seems like a square peg in a round hole. =) --[[User:JT|JT]] 11:02, 21 February 2011 (UTC)

v0.31:Reactions

2010-10-06T11:02:04Z

JT: /* Reagents */

v0.31:Reactions

2010-10-06T10:55:14Z

JT: /* Anatomy of a reaction */ I'd like to expand the PRODUCT section, but this is a good start

v0.31:Reactions

2010-10-06T10:46:53Z

JT: /* Reagents */

v0.31:Reactions

2010-10-06T10:41:50Z

JT: /* Anatomy of a reaction */

v0.31:Reactions

2010-10-06T10:29:27Z

JT: /* Reagents */

v0.31 Talk:Reaction examples

2010-04-07T02:07:11Z

JT: Created page with '== Smelt hematite ore == Was that tested? The item type is BOULDER for any freshly-mined stone. --~~~~'

== Smelt hematite ore ==

Was that tested? The item type is BOULDER for any freshly-mined stone. --[[User:JT|JT]] 02:07, 7 April 2010 (UTC)

v0.31:Reactions

2010-04-07T02:06:01Z

JT:

{{av}}

'''Reactions''' are moddable crafting formulas. They can be tweaked and added onto to allow smelting of new metals, alloys, and many other products. They must be assigned to specific [[Entities]]; if not explicitly added to an entity's definition, they will not be able to produce that reaction. Some examples of various forms of reactions, go here [[Reaction Examples|examples]].

Currently, a reaction can only result in an object of base quality.

==Reaction Makeup==
[REACTION:<REACTION_IDENTIFIER>]
[NAME:<REACTION_NAME>]
<... [[#Buildings]] One or more reagent declarations ...>
<... [[#Reagents]] Zero or more reagent declarations...>
<... [[#Products]] Zero or more reagent declarations ...>
<... [[#Reaction Modifiers]] Zero or more reagent declarations ...>
<... [[#Skills]] Zero or more skill declarations ...>

'''<REACTION_IDENTIFER>''' - Refers to a unique identifier for the reaction (Used in Entity Raws to allow an Enitity to make use of the reaction.

'''<REACTION_NAME>''' - String displayed in the building for the reaction.

==Buildings==
Each reaction requires a building to be declared for it to be used at.

[BUILDING:<BUILDING_IDENTIFIER>:<BUILDING_KEY>]

'''<BUILDING_IDENTIFIER''' - The building at which this reaction can be used. NOTE: SMELTER, KILN, KITCHEN and TANNER seem to be the only non-custom buildings allowed to be specified at this point.{{verify}}

'''<BUILDING_KEY>''' - The key that is pressed at the building (Such as 'b' for bed at a Carpenter or a block at a Mason's). If two reactions have the same key, then one of them will be assigned a different key, the first alphabetically available at the building.

==Reagents==
A reagent is some object that is required to produce whatever the intended object is. This is typically something like needing the ore of a metal to smelt bars of it.

===Reagent Types===
[REAGENT:<Identifier>:<Quantity>:<ITEM_TOKEN>:<ITEM_SUBTYPE>:<MATGLOSS_TOKEN>:<MATGLOSS_SUBTYPE>]
or
[REAGENT:<Identifier>:<Quantity>:<MATGLOSS_TOKEN>:<MATGLOSS_SUBTYPE>]

Type 1: Is used for reactions where a specific type of object is required, such as a BUCKET, SWORD, etc.

Type 2: Is used for when only a material type is needed, such as METAL_ORE for smelter reactions.

<Identifier> - Used to refer to this reagent in the reaction Product.

<Quantity> - Used to refer to the number of individual units of the reagent needed for the reaction. NOTE: If a bar, thread, or cloth is used as the <ITEM_TOKEN>, then this value refers to the PRODUCT_DENSITY of the object (150, 15000, 10000 respectively).

<ITEM_TOKEN> - Refers to the hard coded ITEM_TOKEN that the reagent must be.

<ITEM_SUBTYPE> - Refers to a specific item subtype, defined in the raws, of a specific ITEM_TOKEN, such as TOY:ITEM_TOY_MINIFORGE.

<MATGLOSS_TOKEN> - Refers to the hardcoded material type of the reagent, such as PLANT_MAT, METAL_ORE, etc.

<MATGLOSS_SUBTYPE> - Refers to a specific item subtype, defined in the raws, of a specific MATGLOSS_TOKEN, such as INORGANIC:MICA. In the case of a plant type the syntax is slightly different, the MATGLOSS_SUBTYPE is actually <PLANT_NAME>:<PLANT_PART>.

''<PLANT_NAME>'' - Refers to the actual plant's name in the raw files.

''<PLANT_PART>'' - Refers to the plant 'part' you want, whether it's the PLANT, WOOD, LEAVES, SEED, etc.

===Reagent Modifier===
A reagent can be modified by attaching one, or more, of the following. The modification is used to narrow the available items that can be used for the reaction.

'''[PRESERVE_REAGENT]''' - Reagent is not destroyed, which is the normal effect, at the completion of the reaction. Typically used for containers.

'''[REACTION_CLASS:X]''' - Reagent's MATGLOSS_SUBTYPE must have a REACTION_CLASS of type X attached to it. Such as the various forms of Gypsum having [REACTION_CLASS:GYPSUM] in them. Reaction classes are not hard-coded and you may freely insert REACTION_CLASS tags with custom "X" types into object definitions that will be used as reagents.

'''[HAS_MATERIAL_REACTION_PRODUCT:X]''' - Reagent's MATGLOSS_SUBTYPE must have a MATERIAL_REACTION_PRODUCT tag. This is used primarily on items that come from a dead, or butchered, animal such as skins or fat for tanning and rendering.

'''[UNROTTEN]''' - Reagent must not be rotten, mainly for organic MATGLOSS types.

'''[BUILDMAT]''' - Reagent is able to be used to build structures (Stone, Wood, Blocks, Bars?).

'''[GLASS_MATERIAL]''' - Reagent has a one of the glass MATGLOSS types.

'''[WORTHLESS_STONE_ONLY]''' - Only use objects allowed in the Stone Menu.

'''[FIRE_BUILD_SAFE]''' - Reagent must be considered fire safe (INORGANIC, excluding COAL types).

'''[MAGMA_BUILD_SAFE]''' - Reagent must be considered magma safe (INORGANIC, with a melting point greater than the temperature of Magma.

'''[CAN_USE_ARTIFACT]''' - Reagent can be an Artifact.

'''[ANY_PLANT_MATERIAL]''' - Reagent MATGLOSS must be of a plant subtype.

'''[ANY_SILK_MATERIAL]''' - Reagent MATGLOSS must be of a silk type.

'''[ANY_SOAP_MATERIAL]''' - Reagent MATGLOSS must be of a soap type.

'''[ANY_LEATHER_MATERIAL]''' - Reagent MATGLOSS must be of a leather type.

'''[ANY_BONE_MATERIAL]''' - Reagent MATGLOSS must be of a bone type.

'''[ANY_SHELL_MATERIAL]''' - Reagent MATGLOSS must be of a shell type.

'''[ANY_TOOTH_MATERIAL]''' - Reagent MATGLOSS must be of a tooth type.

'''[ANY_HORN_MATERIAL]''' - Reagent MATGLOSS must be of a horn type.

'''[ANY_PEARL_MATERIAL]''' - Reagent MATGLOSS must be of a pearl type (Excretion from sea creatures?)

'''[USE_BODY_COMPONENT]''' - Reagent MATGLOSS must come off a creature's body.

'''[METAL_ORE]''' - Reagent MATGLOSS must be a metal ore.

'''[NOT_WEB]''' - States that the material cannot be web (For making only plant/adamantine thread?).

'''[WEB_ONLY]''' - States that the material has to be web (For making only silk thread?).

'''[POTASHABLE]''' - The reagent must be able to be turned into pot ash.

'''[EMPTY]''' - If the reagent is a container, it must be empty.

'''[CONTAINS_LYE]''' - If the reagent is a container, it must contain LYE.

'''[NOT_CONTAIN_BARREL_ITEM]''' - If the reagent is a Barrel, it must not contain an item that has to reside in a barrel (Such as alcohol?).

'''[BAG]''' - Reagent has to be a bag. Intended to be used with an item type of BOX, to prevent chests, coffers, and other containers from being used instead.

==Products==
These are the results of a given reaction. There may be any number of such results.

===Product Format===
[PRODUCT:<CHANCE>:<QUANTITY>:<ITEM_TOKEN>:<ITEM_SUBTYPE>:<MATGLOSS>:<MATGLOSS_SUBTYPE>]

'''<CHANCE>''' - This is the chance (As a percent) that the <QUANTITY> number of items will be created after this reaction completes.

'''<QUANTITY>''' - This is the number of the item to be created.

'''<ITEM_TOKEN>''' - This is the ITEM_TOKEN of the result.

'''<ITEM_SUBTYPE>''' - This is a ITEM_SUBTYPE listed in an actual Raw File.

'''<MATGLOSS>''' - This is the MATGLOSS of the item. If you want to use the MATGLOSS information of a Reagent, then this is GET_MATERIAL_FROM_REAGENT:IDENTIFIER, where IDENTIFIER is the reagent's identifier in the reaction.

'''<MATGLOSS_SUBTYPE>''' - Refers to a specific item subtype, defined in the raws, of a specific MATGLOSS_TOKEN, such as PLANT_MAT:MUSHROOM_HELMET_PLUMP. If GET_MATERIAL_FROM_REAGENT was used in the MATGLOSS, you can specify a type, or you can state NONE, to recieve the MATGLOSS_SUBTYPE of the reagent.

===Product Modifiers===
Each product may have a zero, or more, modifiers following its declaration.

'''[PRODUCT_TO_CONTAINER:<IDENTIFIER>]''' - This states that the product should be put into a specific container listed in as a reagent.

''<IDENTIFIER>'' - Refers back to a reagent identifier.

'''[PRODUCT_DIMENSIONS:<DIMENSION>]''' - Used to specify the dimensions of the object, primarily for use with bars, threads, and cloth.

''<DIMENSION>'' - The 'size' of the object, for use in reactions that require a certain amount of bars, threads and cloth. 'Normal' size is bars = 150, threads = 15000 and cloth = 10000.{{verify}}

==Reaction Modifiers==
Reactions can be further modified by the adding zero or more of the following.

'''[FUEL]''' - Which states that it must take some form of COAL (COKE or CHARCOAL) to fuel it. If the building requires magma, it's assumed that this tag is ignored.

'''[AUTOMATIC]''' - Meaning that if the reagents are present, this reaction is automatically added to the work list of the building, such as 'Butcher Animal' at a Butcher's or 'Gather Web' at a Loom.

==Skills==
Skills have to be associated with a reaction. This dictates what skill receives the experience and who can do the job. More than one skill can be associated with the reaction, but only the last SKILL on the list, that a dwarf can perform, receives experience.

[SKILL:<SKILL_TOKEN>]

'''<IDENTIFIER>''' - This is SKILL_TOKEN for the reaction.

[[Category:Modding]]

User:JT

2010-04-06T20:55:02Z

JT: /* Aboot */ contemporariousnessnessness

how u type on internets?

==Aboot==

Canadian, eh? Durned tootin'.

25 years old as of October 29th, 2009. Adamant believer that society is founded on the principles of doing what is best for everyone, even to the extent that it circumvents the law: believes strongly in ''society'' as opposed to ''law and justice''. Intended career path: regular member, [http://en.wikipedia.org/wiki/Royal_Canadian_Mounted_Police RCMP] (you might find this ironic, but track him down on irc://irc.newnet.net/ #bay12games and he'll talk your ear off about why it isn't).

Considers himself Liberal when speaking to Canadians, Libertarian when speaking to Americans, but usually votes for the extreme-left New Democratic Party because they seem to be the only Canadian political party genuinely interested in serving the Canadian interest instead of their partisan agendas. (And even that's a stretch.)

Hobbyist game developer. Likes writing games, but is too much of a perfectionist to release most of them in their unfinished states, and has too many diverse interests to commit to a single one of them until completion. Excellent grasp of game design and balance due to some sort of ability to imagine the finished product well in advance of getting it there (which might be half of the reason he never finishes them).

188 centimetres tall, 85 kilograms, big blue-green eyes, chestnut brown hair, single. Hetero. Prefers effervescent girls with very long hair, facial structure more important than body structure, average weight or higher (but there is an upper limit -- ideally around 75 kilos, 15-30 centimetres shorter).

Apparently enjoys talking about himself in the third person.

==Hello, my name is Simon==

I like to do drawrings!

[[Image:Jt_screwpump.png|left|frame|A screwpump diagram.]]

[[Image:Jt_df_ramp.png|frame|A diagram of a valid and invalid ramp. (It then occurred to me that the top ramp is still usable, but only in the diagonal directions.)]]
<br style="clear: both" />

==Miscellany==

* [[/Starting Builds]]
* [[/Token Wishlist]]
* [[/Teensy weensy wishlist]]

==Mods==

* [[/Toadmod]] -- because it really needed to be done

v0.31 Talk:Reactions

2010-04-06T20:42:59Z

JT: unsigned

== Worthless Stone Only ==

'''[WORTHLESS_STONE_ONLY]''' - Only a stone of value 1 can be used?

This tag is probably unconcerned with ''value'', but rather ''economic stone status'' -- whether the stone is used in any specific reactions. For instance, anything which is listed under a [REAGENT:BOULDER...] is fair game (broad categories of reagents do not force economic stone status), but if it were to directly specify [REAGENT:CLAYSTONE...] then claystone would become an economic stone and would be forbidden from any WORTHLESS_STONE_ONLY reactions.

One thing that would be necessary is to verify whether the WORTHLESS_STONE_ONLY setting honours the economic stone state of the Status screen -- i.e., if you enable an economic stone for routine crafting (say your entire fort is built on dolomite), is it now considered worthless stone? --[[User:JT|JT]] 20:42, 6 April 2010 (UTC)