v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "v0.34:Entity token"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(Added "and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen." to INDIV_CONTROLLABLE. The wording of that could do with improvement however.)
m
 
(18 intermediate revisions by 8 users not shown)
Line 11: Line 11:
  
 
|-
 
|-
−
| ADVENTURE_TIER
+
| {{text anchor|ADVENTURE_TIER}}
 
| order
 
| order
 
| Allows adventure mode for entities with sites.  Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom creature can have a tier of 3000 and still work even if it's the only custom creature.
 
| Allows adventure mode for entities with sites.  Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom creature can have a tier of 3000 and still work even if it's the only custom creature.
Line 17: Line 17:
  
 
|-
 
|-
−
| INDIV_CONTROLLABLE
+
| {{text anchor|INDIV_CONTROLLABLE}}
 
|  
 
|  
 
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.
 
| Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.
  
 
|-
 
|-
−
| CIV_CONTROLLABLE
+
| {{text anchor|CIV_CONTROLLABLE}}
 
|  
 
|  
 
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, than in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.
 
| Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, than in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.
 
|-
 
|-
−
| CREATURE
+
| {{text anchor|CREATURE}}
 
| creature
 
| creature
−
|The type of creature that will inhabit the civilization. Multiple entries will be chosen from at random for each civilization.
+
|The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.
 
[CREATURE:DWARF]
 
[CREATURE:DWARF]
  
Line 42: Line 42:
  
 
|-
 
|-
−
| BIOME_SUPPORT
+
| {{text anchor|BIOME_SUPPORT}}
 
|
 
|
 
* [[Biome token|biome]]
 
* [[Biome token|biome]]
Line 50: Line 50:
  
 
|-
 
|-
−
| START_BIOME
+
| {{text anchor|START_BIOME}}
 
| [[Biome token|biome]]
 
| [[Biome token|biome]]
 
| Birth of the civilization can be performed on this biome.
 
| Birth of the civilization can be performed on this biome.
Line 56: Line 56:
  
 
|-
 
|-
−
| DEFAULT_SITE_TYPE
+
| {{text anchor|DEFAULT_SITE_TYPE}}
 
| site type
 
| site type
−
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, FORTRESS, and MONUMENT, though these likely will not work. Defaults to CITY. CITY is the only one that exists in all 34.xx versions.
+
| Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Dark fortresses, detailed caves, tree cities, and monuments cannot be visited in Adventurer mode.
 
[DEFAULT_SITE_TYPE:CAVE_DETAILED]
 
[DEFAULT_SITE_TYPE:CAVE_DETAILED]
  
 
|-
 
|-
−
| LIKES_SITE
+
| {{text anchor|LIKES_SITE}}
 
| site type
 
| site type
 
| Most residents will try to move to this site type, unless already at one.
 
| Most residents will try to move to this site type, unless already at one.
Line 68: Line 68:
  
 
|-
 
|-
−
| TOLERATES_SITE
+
| {{text anchor|TOLERATES_SITE}}
 
| site type
 
| site type
 
| Some residents will try to move to this site type, unless already at one.
 
| Some residents will try to move to this site type, unless already at one.
Line 74: Line 74:
  
 
|-
 
|-
−
| WORLD_CONSTRUCTION
+
| {{text anchor|WORLD_CONSTRUCTION}}
 
| construction
 
| construction
 
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
 
| Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.
Line 93: Line 93:
  
 
|-
 
|-
−
| START_GROUP_NUMBER
+
| {{text anchor|START_GROUP_NUMBER}}
 
| number
 
| number
−
| Number of breeding couples to start with per entity. Helps give a boost to weaker civs by giving them more cannon fodder at the beginning of their histories, and better genetic diversity (if that's modeled for that particular creature). Note that single-gender (eg. [FEMALE], [MALE], [NO_GENDER]) creatures will not have breeding couples, so a civilization with only these creatures will not be very likely to survive. As of 40d, although many had problems getting such civilizations to survive, there are those who have demonstrably and repeatedly done so. Presumably if the civ-stating code can't place breeding couples, it doesn't start the civ. However, because the children never grow up, the civ is limited to its original individuals).
+
| Number of breeding couples to start with per entity. Helps give a boost to weaker civs by giving them more cannon fodder at the beginning of their histories, and better genetic diversity (if that's modeled for that particular creature). Note that single-gender (e.g. [FEMALE], [MALE], [NO_GENDER]) creatures will not have breeding couples, so a civilization with only these creatures will not be very likely to survive. As of 40d, although many had problems getting such civilizations to survive, there are those who have demonstrably and repeatedly done so. Presumably if the civ-stating code can't place breeding couples, it doesn't start the civ. However, because the children never grow up, the civ is limited to its original individuals).
 
[START_GROUP_NUMBER:10]
 
[START_GROUP_NUMBER:10]
  
 
|-
 
|-
−
| MAX_POP_NUMBER
+
| {{text anchor|MAX_POP_NUMBER}}
 
| number
 
| number
 
| Max population '''per entity'''. Multiply this by max starting civ to get the total population of the species. Defaults to 500.
 
| Max population '''per entity'''. Multiply this by max starting civ to get the total population of the species. Defaults to 500.
Line 105: Line 105:
  
 
|-
 
|-
−
| MAX_SITE_POP_NUMBER
+
| {{text anchor|MAX_SITE_POP_NUMBER}}
 
| number  
 
| number  
 
| Max population per individual site. Generic site types will not hold any more than this number of entities.  Must be at least 80 for towns to be generated.  In general, lower pop numbers mean more sprawl, and higher numbers mean more needing to crawl when entering town stores, which are not affected by this cap. Defaults to 50.
 
| Max population per individual site. Generic site types will not hold any more than this number of entities.  Must be at least 80 for towns to be generated.  In general, lower pop numbers mean more sprawl, and higher numbers mean more needing to crawl when entering town stores, which are not affected by this cap. Defaults to 50.
Line 111: Line 111:
  
 
|-
 
|-
−
| MAX_STARTING_CIV_NUMBER
+
| {{text anchor|MAX_STARTING_CIV_NUMBER}}
 
| number
 
| number
 
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws.  Once it reaches the end of the list, it will begin again at the top.  Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type.  Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
 
| Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws.  Once it reaches the end of the list, it will begin again at the top.  Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type.  Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.
Line 126: Line 126:
  
 
|-
 
|-
−
| PERMITTED_BUILDING
+
| {{text anchor|PERMITTED_BUILDING}}
 
| building name  
 
| building name  
 
| The named, custom building can be built by a civilization in Fortress Mode.
 
| The named, custom building can be built by a civilization in Fortress Mode.
Line 132: Line 132:
  
 
|-
 
|-
−
| PERMITTED_JOB
+
| {{text anchor|PERMITTED_JOB}}
 
| [[Unit type token|profession]]
 
| [[Unit type token|profession]]
−
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play.
+
| Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.
 
[PERMITTED_JOB:MINER]
 
[PERMITTED_JOB:MINER]
  
 
|-
 
|-
−
| PERMITTED_REACTION
+
| {{text anchor|PERMITTED_REACTION}}
 
| reaction name  
 
| reaction name  
 
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
 
| Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.
Line 144: Line 144:
  
 
|-
 
|-
−
| CURRENCY_BY_YEAR
+
| {{text anchor|CURRENCY_BY_YEAR}}
 
|  
 
|  
 
| Causes the civ's currency to be numbered with the year it was minted.
 
| Causes the civ's currency to be numbered with the year it was minted.
  
 
|-
 
|-
−
| CURRENCY
+
| {{text anchor|CURRENCY}}
 
|
 
|
 
* inorganic material
 
* inorganic material
 
* value
 
* value
−
| What kind of metals the civ uses for coin minting as well as the value of the coin.
+
| What kind of metals the civ uses for coin minting as well as the value of the coin. Only effective in Adventurer mode due to lack of [[dwarven economy]].
 
[CURRENCY:SILVER:5]
 
[CURRENCY:SILVER:5]
  
 
|-
 
|-
−
| ART_FACET_MODIFIER
+
| {{text anchor|ART_FACET_MODIFIER}}
 
|
 
|
 
* type
 
* type
Line 166: Line 166:
  
 
|-
 
|-
−
| ART_IMAGE_ELEMENT_MODIFIER
+
| {{text anchor|ART_IMAGE_ELEMENT_MODIFIER}}
 
|
 
|
 
* item
 
* item
Line 177: Line 177:
  
 
|-
 
|-
−
| ITEM_IMPROVEMENT_MODIFIER
+
| {{text anchor|ITEM_IMPROVEMENT_MODIFIER}}
 
|
 
|
 
* item
 
* item
Line 190: Line 190:
  
 
|-
 
|-
−
| TRANSLATION
+
| {{text anchor|TRANSLATION}}
 
| language
 
| language
 
| What language raw the entity uses.
 
| What language raw the entity uses.
Line 197: Line 197:
  
 
|-
 
|-
−
| SELECT_SYMBOL
+
| {{text anchor|SELECT_SYMBOL}}
 
|
 
|
 
* noun
 
* noun
Line 206: Line 206:
  
 
|-
 
|-
−
| SUBSELECT_SYMBOL
+
| {{text anchor|SUBSELECT_SYMBOL}}
 
|
 
|
 
* noun
 
* noun
Line 213: Line 213:
  
 
|-
 
|-
−
| CULL_SYMBOL
+
| {{text anchor|CULL_SYMBOL}}
 
|
 
|
 
* noun
 
* noun
Line 221: Line 221:
  
 
|-
 
|-
−
| FRIENDLY_COLOR
+
| {{text anchor|FRIENDLY_COLOR}}
 
| see [[color]]
 
| see [[color]]
 
|
 
|
Line 237: Line 237:
  
 
|-
 
|-
−
| RELIGION
+
| {{text anchor|RELIGION}}
 
| type
 
| type
 
|
 
|
Line 246: Line 246:
  
 
|-
 
|-
−
| RELIGION_SPHERE
+
| {{text anchor|RELIGION_SPHERE}}
 
| sphere
 
| sphere
 
| Can by any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.
 
| Can by any available [[Sphere]]. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.
Line 253: Line 253:
  
 
|-
 
|-
−
| SPHERE_ALIGNMENT
+
| {{text anchor|SPHERE_ALIGNMENT}}
 
|
 
|
 
* type
 
* type
Line 272: Line 272:
  
 
|-
 
|-
−
| POSITION
+
| {{text anchor|POSITION}}
 
| string
 
| string
 
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].
 
| Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see [[Position token]].
  
 
|-
 
|-
−
| LAND_HOLDER_TRIGGER
+
| {{text anchor|LAND_HOLDER_TRIGGER}}
 
|
 
|
 
* land holder number
 
* land holder number
Line 286: Line 286:
  
 
|-
 
|-
−
| VARIABLE_POSITIONS
+
| {{text anchor|VARIABLE_POSITIONS}}
 
| Position responsibility or ALL
 
| Position responsibility or ALL
 
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).
 
| Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).
Line 300: Line 300:
  
 
|-
 
|-
−
| [[Ethics|ETHIC]]
+
| {{text anchor|ETHIC}}
 
|  
 
|  
 
*behavior
 
*behavior
 
*reaction
 
*reaction
−
| Sets the civ's view of certain behaviors, from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
+
| Sets the civ's view of [[ethic]]s (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.
 
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]
 
[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]
  
 
|-
 
|-
−
| WILL_ACCEPT_TRIBUTE
+
| {{text anchor|WILL_ACCEPT_TRIBUTE}}
 
|  
 
|  
 
| Makes the civ's traders accept offered goods.
 
| Makes the civ's traders accept offered goods.
  
 
|-
 
|-
−
| WANDERER, BEAST_HUNTER, SCOUT
+
| {{text anchor|WANDERER}}, {{text anchor|BEAST_HUNTER}}, {{text anchor|SCOUT}}
 
|  
 
|  
 
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill.
 
| The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill.
  
 
|-
 
|-
−
| ABUSE_BODIES
+
| {{text anchor|ABUSE_BODIES}}
 
|  
 
|  
 
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.
 
| The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.
  
 
|-
 
|-
−
| ACTIVE_SEASON
+
| {{text anchor|ACTIVE_SEASON}}
 
| season
 
| season
 
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
 
| the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.
Line 329: Line 329:
  
 
|-
 
|-
−
| AMBUSHER
+
| {{text anchor|AMBUSHER}}
 
|  
 
|  
 
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots.
 
| When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots.
  
 
|-
 
|-
−
| AT_PEACE_WITH_WILDLIFE
+
| {{text anchor|AT_PEACE_WITH_WILDLIFE}}
 
|
 
|
 
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.
 
| Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.
  
 
|-
 
|-
−
| BABYSNATCHER
+
| {{text anchor|BABYSNATCHER}}
 
|
 
|
 
| Sends thieves to steal babies. Also sends ambush parties to harass your civilization. Without this tag, enemy civs will only siege, and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.
 
| Sends thieves to steal babies. Also sends ambush parties to harass your civilization. Without this tag, enemy civs will only siege, and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.
  
−
Note: If the playable civ in Fortress Mode has this tag (ie. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will trade with you.
+
Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will trade with you.
  
 
|-
 
|-
−
| BUILDS_OUTDOOR_FORTIFICATIONS
+
| {{text anchor|BUILDS_OUTDOOR_FORTIFICATIONS}}
 
|  
 
|  
 
| Makes the civilization build castles.
 
| Makes the civilization build castles.
  
 
|-
 
|-
−
| BUILDS_OUTDOOR_TOMBS
+
| {{text anchor|BUILDS_OUTDOOR_TOMBS}}
 
|  
 
|  
 
| Makes the civilization build tombs.
 
| Makes the civilization build tombs.
  
 
|-
 
|-
−
| BANDITRY
+
| {{text anchor|BANDITRY}}
 
| percentage
 
| percentage
 
| Sets a percentage of the entity population to be used as bandits.
 
| Sets a percentage of the entity population to be used as bandits.
  
 
|-
 
|-
−
| DIPLOMAT_BODYGUARDS
+
| {{text anchor|DIPLOMAT_BODYGUARDS}}
 
|
 
|
 
| Visiting diplomats are accompanied by a pair of soldiers. Does not work due to a bug.{{bug|5854}}
 
| Visiting diplomats are accompanied by a pair of soldiers. Does not work due to a bug.{{bug|5854}}
  
 
|-
 
|-
−
| INVADERS_IGNORE_NEUTRALS
+
| {{text anchor|INVADERS_IGNORE_NEUTRALS}}
 
|
 
|
 
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}
 
| Causes invaders to ignore visiting caravans and other neutral creatures.{{verify}}
  
 
|-
 
|-
−
| ITEM_THIEF
+
| {{text anchor|ITEM_THIEF}}
 
|
 
|
 
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home.
 
| Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home.
  
 
|-
 
|-
−
| LOCAL_BANDITRY
+
| {{text anchor|LOCAL_BANDITRY}}
 
|
 
|
−
| Causes the entity to send out patrols that can ambush adventurers. Will cause cities to be hostile to adventurers whenever they enter, regardless of race or nationality.
+
| Causes the entity to send out patrols that can ambush adventurers. Will cause cities to be hostile to adventurers whenever they enter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.
  
 
|-
 
|-
−
| MERCHANT_BODYGUARDS
+
| {{text anchor|MERCHANT_BODYGUARDS}}
 
|
 
|
 
| Caravan merchants are accompanied by soldiers.
 
| Caravan merchants are accompanied by soldiers.
  
 
|-
 
|-
−
| MERCHANT_NOBILITY
+
| {{text anchor|MERCHANT_NOBILITY}}
 
|
 
|
 
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.
 
| Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.
  
 
|-
 
|-
−
| PROGRESS_TRIGGER_POPULATION
+
| {{text anchor|PROGRESS_TRIGGER_POPULATION}}
 
| level
 
| level
 
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.
 
| 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.
  
 
|-
 
|-
−
| PROGRESS_TRIGGER_PRODUCTION
+
| {{text anchor|PROGRESS_TRIGGER_PRODUCTION}}
 
| level
 
| level
 
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.
 
| 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.
  
 
|-
 
|-
−
| PROGRESS_TRIGGER_TRADE
+
| {{text anchor|PROGRESS_TRIGGER_TRADE}}
 
| level
 
| level
 
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.
 
| 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.
  
 
|-
 
|-
−
| PROGRESS_TRIGGER_POP_SIEGE
+
| {{text anchor|PROGRESS_TRIGGER_POP_SIEGE}}
 
| level
 
| level
 
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.
 
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.
Line 413: Line 413:
  
 
|-
 
|-
−
| PROGRESS_TRIGGER_PROD_SIEGE
+
| {{text anchor|PROGRESS_TRIGGER_PROD_SIEGE}}
 
| level
 
| level
 
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.
 
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.
  
 
|-
 
|-
−
| PROGRESS_TRIGGER_TRADE_SIEGE
+
| {{text anchor|PROGRESS_TRIGGER_TRADE_SIEGE}}
 
| level
 
| level
 
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.
 
| 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.
  
 
|-
 
|-
−
| SIEGER
+
| {{text anchor|SIEGER}}
 
|
 
|
 
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack.
 
| Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack.
  
 
|-
 
|-
−
| SKULKING
+
| {{text anchor|SKULKING}}
 
|
 
|
 
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Makes trade impossible with the related civilization.
 
| This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Makes trade impossible with the related civilization.
  
 
|-
 
|-
−
| TREE_CAP_DIPLOMACY
+
| {{text anchor|TREE_CAP_DIPLOMACY}}
 
|
 
|
 
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a Barony.
 
| Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a Barony.
  
 
|-
 
|-
−
| LAYER_LINKED
+
| {{text anchor|LAYER_LINKED}}
 
|  
 
|  
 
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.
 
| Defines if a civilization is a hidden subterranean entity, such as batman civilizations.
  
 
|-
 
|-
−
| UNDEAD_CANDIDATE
+
| {{text anchor|UNDEAD_CANDIDATE}}
 
|
 
|
−
| Unknown. Possibly makes this creature available as a "Corpse" (e.g. Human Corpse) for necromancers in adventure mode.
+
| Does nothing. [http://www.bay12forums.com/smf//index.php?topic=169696.msg8265542#msg8265542]
  
 
|}
 
|}
  
−
== Items and Animals Used ==
+
== Available Resources ==
 
{| {{prettytable}}
 
{| {{prettytable}}
 
|- bgcolor="#ddd"
 
|- bgcolor="#ddd"
Line 457: Line 457:
  
 
|-
 
|-
−
| AMMO
+
| {{text anchor|AMMO}}
 
| item token
 
| item token
 
|  
 
|  
Line 463: Line 463:
  
 
|-
 
|-
−
| ARMOR
+
| {{text anchor|ARMOR}}
 
|
 
|
 
* item token
 
* item token
Line 471: Line 471:
  
 
|-
 
|-
−
| DIGGER
+
| {{text anchor|DIGGER}}
 
| item token
 
| item token
 
|  
 
|  
Line 477: Line 477:
  
 
|-
 
|-
−
| GLOVES
+
| {{text anchor|GLOVES}}
 
|
 
|
 
* item token
 
* item token
Line 485: Line 485:
  
 
|-
 
|-
−
| HELM
+
| {{text anchor|HELM}}
 
|
 
|
 
* item token
 
* item token
Line 493: Line 493:
  
 
|-
 
|-
−
| INSTRUMENT
+
| {{text anchor|INSTRUMENT}}
 
| item token
 
| item token
 
|  
 
|  
Line 499: Line 499:
  
 
|-
 
|-
−
| PANTS
+
| {{text anchor|PANTS}}
 
|
 
|
 
* item token
 
* item token
Line 507: Line 507:
  
 
|-
 
|-
−
| SHIELD
+
| {{text anchor|SHIELD}}
 
| item token
 
| item token
 
|  
 
|  
Line 513: Line 513:
  
 
|-
 
|-
−
| SHOES
+
| {{text anchor|SHOES}}
 
|
 
|
 
* item token
 
* item token
Line 521: Line 521:
  
 
|-
 
|-
−
| SIEGEAMMO
+
| {{text anchor|SIEGEAMMO}}
 
| item token
 
| item token
 
|  
 
|  
Line 527: Line 527:
  
 
|-
 
|-
−
| TOOL
+
| {{text anchor|TOOL}}
 
| item token
 
| item token
 
|  
 
|  
Line 533: Line 533:
  
 
|-
 
|-
−
| TOY
+
| {{text anchor|TOY}}
 
| item token
 
| item token
 
|  
 
|  
Line 539: Line 539:
  
 
|-
 
|-
−
| TRAPCOMP
+
| {{text anchor|TRAPCOMP}}
 
| item token
 
| item token
 
|  
 
|  
Line 545: Line 545:
  
 
|-
 
|-
−
| WEAPON
+
| {{text anchor|WEAPON}}
 
| item token
 
| item token
 
|  
 
|  
Line 551: Line 551:
  
 
|-
 
|-
−
| USE_ANIMAL_PRODUCTS
+
| {{text anchor|USE_ANIMAL_PRODUCTS}}
 
|
 
|
−
| Allows creature to use products made from animals, such as leather shirts.
+
| Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.
  
 
|-
 
|-
−
| USE_ANY_PET_RACE
+
| {{text anchor|USE_ANY_PET_RACE}}
 
|  
 
|  
−
| Assuming it passes other checks, any creature in their list of usables (from common domestic if they have that or from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet (next time, it'll let them use mounts/pullers/pack animals of any kind as well, but I'm not sure this matters in the stock raws).  This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well.  All common domestic and equipment creatures are also added to the initial list.
+
| Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and ''without'' CAN_LEARN).  This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well.  All common domestic and equipment creatures are also added to the initial list.
  
 
|-
 
|-
−
| USE_CAVE_ANIMALS
+
| {{text anchor|USE_CAVE_ANIMALS}}
 
|
 
|
−
| If they don't have it, creatures with exclusively subterranean biomes are skipped.
+
| If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and ''without'' CAN_LEARN).
  
 
|-
 
|-
−
| USE_EVIL_ANIMALS
+
| {{text anchor|USE_EVIL_ANIMALS}}
 
|
 
|
−
| Don't have it -> EVIL creatures skipped.
+
| Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or ''without'' CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).
  
 
|-
 
|-
−
| USE_EVIL_PLANTS
+
| {{text anchor|USE_EVIL_PLANTS}}
 
|
 
|
 
| As EVIL creatures for all uses of plants.
 
| As EVIL creatures for all uses of plants.
  
 
|-
 
|-
−
| USE_EVIL_WOOD
+
| {{text anchor|USE_EVIL_WOOD}}
 
|
 
|
 
| As EVIL creatures for all uses of wood.
 
| As EVIL creatures for all uses of wood.
  
 
|-
 
|-
−
| USE_GOOD_ANIMALS
+
| {{text anchor|USE_GOOD_ANIMALS}}
 
|
 
|
−
| Don't have it -> GOOD creatures skipped.
+
| Don't have it -> GOOD creatures skipped. If they have it, good creatures ''without'' CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).
  
 
|-
 
|-
−
| USE_GOOD_PLANTS
+
| {{text anchor|USE_GOOD_PLANTS}}
 
|
 
|
 
| As GOOD creatures for all uses of plants.
 
| As GOOD creatures for all uses of plants.
  
 
|-
 
|-
−
| USE_GOOD_WOOD
+
| {{text anchor|USE_GOOD_WOOD}}
 
|
 
|
 
| As GOOD creatures for all uses of wood.
 
| As GOOD creatures for all uses of wood.
  
 
|-
 
|-
−
| USE_MISC_PROCESSED_WOOD_PRODUCTS
+
| {{text anchor|USE_MISC_PROCESSED_WOOD_PRODUCTS}}
 
|
 
|
−
| If wood is available locally, and the relevant professions are permitted, controls availability of lye, charcoal, potash and pearlash.
+
| If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).
  
 
|-
 
|-
−
| COMMON_DOMESTIC_MOUNT
+
| {{text anchor|COMMON_DOMESTIC_MOUNT}}
 
|
 
|
−
| If a creature has MOUNT and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.
+
| Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.
  
 
|-
 
|-
−
| COMMON_DOMESTIC_PACK
+
| {{text anchor|COMMON_DOMESTIC_PACK}}
 
|
 
|
−
| If a creature has PACK_ANIMAL and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required currently for trading to occur.
+
| Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.
  
 
|-
 
|-
−
| COMMON_DOMESTIC_PET
+
| {{text anchor|COMMON_DOMESTIC_PET}}
 
|
 
|
−
| If a creature has PET and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks. Also seems to be required to have any animals at all, including those used in trading.
+
| Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.
  
 
|-
 
|-
−
| COMMON_DOMESTIC_PULL
+
| {{text anchor|COMMON_DOMESTIC_PULL}}
 
|
 
|
−
| If a creature has WAGON_PULLER and the relevant COMMON_DOMESTIC_x tag (or COMMON_DOMESTIC for pets), it will be allowed if it passes the other checks.
+
| Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull [[wagon]]s.
  
 
|-
 
|-
−
| RIVER_PRODUCTS
+
| {{text anchor|RIVER_PRODUCTS}}
 
|
 
|
 
| Allow civ to use river products in the goods it has available for trade.
 
| Allow civ to use river products in the goods it has available for trade.
  
 
|-
 
|-
−
| OCEAN_PRODUCTS
+
| {{text anchor|OCEAN_PRODUCTS}}
 
|
 
|
−
| Allow civ to use ocean products in the goods it has available for trade.
+
| Allow civ to use ocean products (including [[amber]] and [[coral]]) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are ''also'' available from other sources (e.g. [[sturgeon]]s and [[stingray]]s).
  
 
|-
 
|-
−
| INDOOR_FARMING
+
| {{text anchor|INDOOR_FARMING}}
 
|  
 
|  
 
| Allow civ to use underground plant products in the goods it has available for trade.
 
| Allow civ to use underground plant products in the goods it has available for trade.
  
 
|-
 
|-
−
| OUTDOOR_FARMING
+
| {{text anchor|OUTDOOR_FARMING}}
 
|
 
|
 
| Allow civ to use outdoor plant products in the goods it has available for trade.
 
| Allow civ to use outdoor plant products in the goods it has available for trade.
  
 
|-
 
|-
−
| CLOTHING
+
| {{text anchor|CLOTHING}}
 
|
 
|
 
| Civ members will attempt to wear clothing.
 
| Civ members will attempt to wear clothing.
  
 
|-
 
|-
−
| SUBTERRANEAN_CLOTHING
+
| {{text anchor|SUBTERRANEAN_CLOTHING}}
 
|
 
|
 
| Will wear things made of spider silk and other subterranean materials.  
 
| Will wear things made of spider silk and other subterranean materials.  
  
 
|-
 
|-
−
| EQUIPMENT_IMPROVEMENTS
+
| {{text anchor|EQUIPMENT_IMPROVEMENTS}}
 
|
 
|
 
| Adds decorations to equipment based on the level of the generated unit.  Also improves item quality.
 
| Adds decorations to equipment based on the level of the generated unit.  Also improves item quality.
  
 
|-
 
|-
−
| IMPROVED_BOWS
+
| {{text anchor|IMPROVED_BOWS}}
 
|
 
|
 
| Adds decorations to weapons generated for bowman and master bowman.  An elf hack.
 
| Adds decorations to weapons generated for bowman and master bowman.  An elf hack.
  
 
|-
 
|-
−
| METAL_PREF
+
| {{text anchor|METAL_PREF}}
 
|
 
|
−
| Needs testing.
+
| Allows metal materials to be used to make cages (inexpensive metals only) and crafts.
  
 
|-
 
|-
−
| STONE_PREF
+
| {{text anchor|STONE_PREF}}
 
|
 
|
−
| Enables creatures of this entity to bring stones in trade. Also seems to enable the use of metals smelted from ore, such as iron or copper.
+
| Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.
  
 
|-
 
|-
−
| WOOD_WEAPONS
+
| {{text anchor|WOOD_WEAPONS}}
 
|
 
|
−
| Causes members to be able to use wooden weapons.
+
| The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.
  
 
|-
 
|-
−
| WOOD_ARMOR
+
| {{text anchor|WOOD_ARMOR}}
 
|
 
|
−
| Causes members to be able to use wooden armor.
+
| The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.
  
 
|-
 
|-
−
| GEM_PREF
+
| {{text anchor|GEM_PREF}}
 
|
 
|
 
| Enables creatures of this entity to bring gems in trade.
 
| Enables creatures of this entity to bring gems in trade.
  
 
|-
 
|-
−
| INDOOR_WOOD
+
| {{text anchor|INDOOR_WOOD}}
 
|  
 
|  
−
| Allow civ to trade subterranean wood types, such as tower-cap and fungiwood logs.
+
| Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.
  
 
|-
 
|-
−
| OUTDOOR_WOOD
+
| {{text anchor|OUTDOOR_WOOD}}
 
|
 
|
 
| Allow civ to use outdoor wood types, such as mangrove and oak.
 
| Allow civ to use outdoor wood types, such as mangrove and oak.
 +
 +
|-
 +
| {{text anchor|GEM_SHAPE}}
 +
| [[Descriptor shape token|shape]]
 +
| Precious gems cut by this civilization's jewelers can be of this shape.
 +
 +
|-
 +
| {{text anchor|STONE_SHAPE}}
 +
| [[Descriptor shape token|shape]]
 +
| Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.
  
 
|}
 
|}
Line 705: Line 715:
  
 
|-
 
|-
−
| TISSUE_STYLE
+
| {{text anchor|TISSUE_STYLE}}
−
|
+
| tissue style unit ID
−
*tissue???
+
| Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.
−
| Presumably selects tissue to set cultural style parameters for. Needs testing.
 
  
 
|-
 
|-
−
| TS_MAINTAIN_LENGTH
+
| {{text anchor|TS_MAINTAIN_LENGTH}}
 
|
 
|
−
*length?
+
* minimum length?
−
*???
+
* maximum length?
 
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
 
| Presumably sets culturally preferred tissue length for selected tissue. Needs testing.
 +
Dwarves have their beards set to 100:NONE by default.
  
 
|-
 
|-
−
| TS_PREFERRED_SHAPING
+
| {{text anchor|TS_PREFERRED_SHAPING}}
−
| ???
+
| styling token
−
| Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.
+
| Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.
 +
Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.
  
  
 
{{Category|Modding}}
 
{{Category|Modding}}
 
{{Category|Tokens}}
 
{{Category|Tokens}}

Latest revision as of 20:25, 28 September 2024

xTATTEREDx  · +FINE+  · *SUPERIOR*  · ≡EXCEPTIONAL≡  · ☼MASTERWORK☼
v50.14 · v0.47 · v0.34.11 · v0.31 · v0.28 · v0.23
This article is about an older version of DF.

These tokens define entities, or civilizations, in entity_*.txt files.


Gameplay[edit]

Token Arguments Description
ADVENTURE_TIER order Allows adventure mode for entities with sites. Dwarves, Elves, and Humans take up tier 3, 2, and 1 respectively. Order doesn't need to be maintained; a custom creature can have a tier of 3000 and still work even if it's the only custom creature.

[ADVENTURE_TIER:4]

INDIV_CONTROLLABLE Allows the race to be played as an "outsider" in adventure mode. Not having this specified in one of the entities will cause the Adventure mode option to disappear. Note that ADVENTURE_TIER is not required if this token is included, and that this cannot be applied to civilizations that were not in an entity_*.txt file during world gen.
CIV_CONTROLLABLE Allows fortress mode. If multiple entities have the CIV_CONTROLLABLE token, than in embark mode the specific civs can be chosen by + or - on the civ list screen (by pressing tab), though it will not state what entity the civs belong to. To check which one, tab to the neighbors screen: the entity's race will be at the top. At least one civilization must have this token.
CREATURE creature The type of creature that will inhabit the civilization. If multiple creature types are specified, each civilization will randomly choose one of the creatures.

[CREATURE:DWARF]

Placement[edit]

Token Arguments Description
BIOME_SUPPORT Frequency goes from 0 to 10. Higher numbers make the entity more likely to settle there.

[BIOME_SUPPORT:ANY_GRASSLAND:4]

START_BIOME biome Birth of the civilization can be performed on this biome.

[START_BIOME:MOUNTAIN]

DEFAULT_SITE_TYPE site type Valid site types are DARK_FORTRESS (π), CAVE (•), CAVE_DETAILED (Ω), TREE_CITY (î), and CITY (#). Also recognizes PLAYER_FORTRESS, and MONUMENT, though these likely will not work. FORTRESS is no longer a valid entry, instead castles are controlled by BUILDS_OUTDOOR_FORTIFICATIONS. Defaults to CITY. Dark fortresses, detailed caves, tree cities, and monuments cannot be visited in Adventurer mode.

[DEFAULT_SITE_TYPE:CAVE_DETAILED]

LIKES_SITE site type Most residents will try to move to this site type, unless already at one.

[LIKES_SITE:CAVE_DETAILED]

TOLERATES_SITE site type Some residents will try to move to this site type, unless already at one.

[TOLERATES_SITE:CITY]

WORLD_CONSTRUCTION construction Controls which constructions the civ will build on the world map. Valid constructions are ROAD, TUNNEL, BRIDGE, and WALL.

[WORLD_CONSTRUCTION:BRIDGE] [WORLD_CONSTRUCTION:ROAD] [WORLD_CONSTRUCTION:TUNNEL] [WORLD_CONSTRUCTION:WALL]

Population[edit]

Token Arguments Description
START_GROUP_NUMBER number Number of breeding couples to start with per entity. Helps give a boost to weaker civs by giving them more cannon fodder at the beginning of their histories, and better genetic diversity (if that's modeled for that particular creature). Note that single-gender (e.g. [FEMALE], [MALE], [NO_GENDER]) creatures will not have breeding couples, so a civilization with only these creatures will not be very likely to survive. As of 40d, although many had problems getting such civilizations to survive, there are those who have demonstrably and repeatedly done so. Presumably if the civ-stating code can't place breeding couples, it doesn't start the civ. However, because the children never grow up, the civ is limited to its original individuals).

[START_GROUP_NUMBER:10]

MAX_POP_NUMBER number Max population per entity. Multiply this by max starting civ to get the total population of the species. Defaults to 500.

[MAX_POP_NUMBER:500]

MAX_SITE_POP_NUMBER number Max population per individual site. Generic site types will not hold any more than this number of entities. Must be at least 80 for towns to be generated. In general, lower pop numbers mean more sprawl, and higher numbers mean more needing to crawl when entering town stores, which are not affected by this cap. Defaults to 50.

[MAX_SITE_POP_NUMBER:200]

MAX_STARTING_CIV_NUMBER number Max number of entities to spawn at world generation. Worldgen picks civs in some sequential order from the raws. Once it reaches the end of the list, it will begin again at the top. Setting this number lower than 100, like say, 7, will cause worldgen to skip over this civ for placement if there are already 7 civs of this type. Note that if all civs are set to lower numbers, and the number of starting civs is set higher than the maximum possible amount of civs in total, it will gracefully stop placing civs and get down to the history aspect of worldgen. Defaults to 3.

[MAX_STARTING_CIV_NUMBER:3]

Flavor[edit]

Token Arguments Description
PERMITTED_BUILDING building name The named, custom building can be built by a civilization in Fortress Mode.

[PERMITTED_BUILDING:SOAP_MAKER]

PERMITTED_JOB profession Allows this job type to be selected. This applies to worldgen creatures, in the embark screen, and in play. Certain professions also influence the availability of materials for trade.

[PERMITTED_JOB:MINER]

PERMITTED_REACTION reaction name Allows this reaction to be used by a civilization. It is used primarily in Fortress Mode. When creating custom reactions, this token MUST be present or the player will not be able to use the reaction in Fortress Mode.

[PERMITTED_REACTION:TAN_A_HIDE]

CURRENCY_BY_YEAR Causes the civ's currency to be numbered with the year it was minted.
CURRENCY
  • inorganic material
  • value
 What kind of metals the civ uses for coin minting as well as the value of the coin. Only effective in Adventurer mode due to lack of dwarven economy.

[CURRENCY:SILVER:5]

ART_FACET_MODIFIER
  • type
  • number
 OWN_RACE, FANCIFUL, EVIL, GOOD

Number goes from 0 to 25600 where 256 is the default. [ART_FACET_MODIFIER:OWN_RACE:512]

ART_IMAGE_ELEMENT_MODIFIER
  • item
  • number
 CREATURE, PLANT, TREE, SHAPE, ITEM
0-25600

Determines the chance of each image occurring in that entity's artwork, such as engravings and on artifacts, for default (non-historical) artwork.

[ART_IMAGE_ELEMENT_MODIFIER:TREE:512]

ITEM_IMPROVEMENT_MODIFIER
  • item
  • number
 ART_IMAGE, COVERED or GLAZED, RINGS_HANGING, BANDS, SPIKES, ITEMSPECIFIC, THREAD, CLOTH, SEWN_IMAGE
0-25600

Determines the chance of the entity using that particular artwork method, such as "encircled with bands" or "menaces with spikes".

[ITEM_IMPROVEMENT_MODIFIER:SPIKES:0]

This also seems to change the amount that the entity will pay for items that are improved in the ways in their tokens.

TRANSLATION language What language raw the entity uses.
  • If an entity lacks this tag, translations appear to be drawn randomly from all translation files[Verify].

[TRANSLATION:DWARF]

SELECT_SYMBOL
  • noun
  • symbol
 ALL, REMAINING, CIV, SITE, VESSEL, RELIGION, MILITARY_UNIT, TEMPLE, WAR, BATTLE, SIEGE, ROAD, BRIDGE, TUNNEL, WALL

Causes the entity to more often use these symbols in the particular SYM set. [SELECT_SYMBOL:ALL:PEACE]

SUBSELECT_SYMBOL
  • noun
  • symbol
 Unknown.
CULL_SYMBOL
  • noun
  • symbol
 Causes the entity to not use the words in these SYM sets.

[CULL_SYMBOL:ALL:UGLY]

FRIENDLY_COLOR see color

The color of this entity's civilization settlements in the world gen and embark screens. Defaults to 7:0:1. [FRIENDLY_COLOR:1:0:1]

Religion[edit]

Token Arguments Description
RELIGION type
  • REGIONAL_FORCE: The creatures will worship a single force associated with their spheres. Currently hardcoded to only be associated with rivers and nature.
  • PANTHEON: The creatures will worship a group of gods, each aligned with their spheres and other appropriate ones as well.

[RELIGION:PANTHEON]

RELIGION_SPHERE sphere Can by any available Sphere. Multiple entries are possible. Choosing a religious sphere will automatically make its opposing sphere not possible for the species to have: adding WATER, for example, means the species will never get FIRE as a religious sphere.

[RELIGION_SPHERE:FORTRESSES]

SPHERE_ALIGNMENT
  • type
  • number

This token forces an entity to favor or disfavor particular religious spheres, causing them to acquire those spheres more often when generating a pantheon.

[SPHERE_ALIGNMENT:TREES:512]

Leadership[edit]

Token Arguments Description
POSITION string Defines a leader/noble position for a civilization. These replace previous tags such as [MAYOR] and [CAN_HAVE_SITE_LEADER] and so on. To define a position further, see Position token.
LAND_HOLDER_TRIGGER
  • land holder number
  • population
  • wealth exported
  • created wealth
 Defines when a particular land-holding noble (baron, count, duke in vanilla) will arrive at a fortress.
VARIABLE_POSITIONS Position responsibility or ALL Allows a responsibility to be taken up by a dynamically generated position (such as Law-maker).

Behavior[edit]

Token Arguments Description
ETHIC
  • behavior
  • reaction
 Sets the civ's view of ethics (certain behaviors), from capital punishment to completely acceptable. This also causes the civ to look upon opposing ethics with disfavor, if their reaction to it is opposing, and when at extremes (one ACCEPTABLE, another civ UNTHINKABLE for example) they will often go to war over it.

[ETHIC:EAT_SAPIENT_KILL:ACCEPTABLE]

WILL_ACCEPT_TRIBUTE Makes the civ's traders accept offered goods.
WANDERER, BEAST_HUNTER, SCOUT The civ will send out these sorts of adventurers in worldgen. This seems to increase Tracker skill.
ABUSE_BODIES The civilization will mutilate bodies when they are the victors in history-gen warfare, such as hanging bodies from trees, putting them on spikes, and so forth. Adventurers killed in Adventurer mode will sometimes be impaled on spikes wherever they died, with or without this token, and regardless of whether they actually antagonized the townspeople.
ACTIVE_SEASON season the season when the civ is most active: when they will trade, interact with you via diplomats, and/or invade you. Civs can have multiple season entries. Note: If multiple caravans arrive at the same time, you are able to select which civ to trade with at the depot menu. ACTIVE_SEASON tags may be changed for a currently active fort.

[ACTIVE_SEASON:AUTUMN]

AMBUSHER When invading sneaks around and shoots at straggling members of your society. They will spawn on the edge of the map and will only be visible when one of their party are spotted; this can be quite dangerous to undefended trade depots.
AT_PEACE_WITH_WILDLIFE Will not attack wildlife, and will not be attacked by them, even if you have them in your party. This can be somewhat disconcerting when attacked by bears in the forest and your elven ally sits back and does nothing.
BABYSNATCHER Sends thieves to steal babies. Also sends ambush parties to harass your civilization. Without this tag, enemy civs will only siege, and will siege as early as they would otherwise babysnatch. This can happen as early as the first year of the fort! In addition, babysnatcher civs will snatch children during worldgen, allowing them to become part of the civ if they do not escape.

Note: If the playable civ in Fortress Mode has this tag (i.e. you add BABYSNATCHER to the Dwarf entity) then the roles will be reversed and elves and humans will siege and ambush and goblins will trade with you.

BUILDS_OUTDOOR_FORTIFICATIONS Makes the civilization build castles.
BUILDS_OUTDOOR_TOMBS Makes the civilization build tombs.
BANDITRY percentage Sets a percentage of the entity population to be used as bandits.
DIPLOMAT_BODYGUARDS Visiting diplomats are accompanied by a pair of soldiers. Does not work due to a bug.Bug:5854
INVADERS_IGNORE_NEUTRALS Causes invaders to ignore visiting caravans and other neutral creatures.[Verify]
ITEM_THIEF Sends thieves to steal items. This will also occur in history generation, and thieves will have the "thief" profession. Items stolen in history gen will be scattered around that creature's home.
LOCAL_BANDITRY Causes the entity to send out patrols that can ambush adventurers. Will cause cities to be hostile to adventurers whenever they enter, regardless of race or nationality. Adding this tag to playable entities will also make adventurers with this token willing to move-attack non-hostile villagers, rather than having to make an aimed attack.
MERCHANT_BODYGUARDS Caravan merchants are accompanied by soldiers.
MERCHANT_NOBILITY Effect unknown - in previous versions, this resulted in the civ having a Guild Representative / Merchant Baron / Merchant Prince, but now this is controlled solely by positions.
PROGRESS_TRIGGER_POPULATION level 0 to 5, civ will come to site once population at site has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 20 dwarves, 2 to 50 dwarves, 3 to 80, 4 to 110, and 5 to 140. Progress triggers may be changed, added, or deleted for a currently active fort. Note: hostile civs require that the population trigger be fulfilled as well as at least one other trigger before attacking.
PROGRESS_TRIGGER_PRODUCTION level 0 to 5, civ will come to site once created wealth has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 5000☼ created wealth, 2 to 25000☼, 3 to 100000☼, 4 to 200000☼, and 5 to 300000☼. Progress triggers may be changed, added, or deleted for a currently active fort.
PROGRESS_TRIGGER_TRADE level 0 to 5, civ will come to site once exported goods has reached that level. If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger. 1 corresponds to 500☼ exported wealth, 2 to 2500☼, 3 to 10000☼, 4 to 20000☼, and 5 to 30000☼. Progress triggers may be changed, added, or deleted for a currently active fort.
PROGRESS_TRIGGER_POP_SIEGE level 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.

If multiple progress triggers exist for a civ, it will come when any one of them is fulfilled instead of waiting for all of them to be reached. A value of 0 disables the trigger.

PROGRESS_TRIGGER_PROD_SIEGE level 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.
PROGRESS_TRIGGER_TRADE_SIEGE level 0 to 5, civ will begin to send sieges against the player civ when this level is reached if it is hostile.
SIEGER Will start campfires and wait around at the edge of your map for a month or two before rushing in to attack.
SKULKING This makes the severity of attacks depend on the extent of item/baby thievery rather than the passage of time. Makes trade impossible with the related civilization.
TREE_CAP_DIPLOMACY Visiting diplomats impose tree cutting quotas; without this, they will simply compliment your fortress and leave. Also causes the diplomat to make unannounced first contact at the very beginning of the first Spring after your fortress becomes a Barony.
LAYER_LINKED Defines if a civilization is a hidden subterranean entity, such as batman civilizations.
UNDEAD_CANDIDATE Does nothing. [1]

Available Resources[edit]

Token Arguments Description
AMMO item token

[AMMO:ITEM_AMMO_BOLTS]

ARMOR
  • item token
  • rarity
 Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).

[ARMOR:ITEM_ARMOR_PLATEMAIL:COMMON]

DIGGER item token

[DIGGER:ITEM_WEAPON_PICK]

GLOVES
  • item token
  • rarity
 Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).

[GLOVES:ITEM_GLOVES_GLOVES:COMMON]

HELM
  • item token
  • rarity
 Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).

[HELM:ITEM_HELM_HELM:COMMON]

INSTRUMENT item token

[INSTRUMENT:ITEM_INSTRUMENT_FLUTE]

PANTS
  • item token
  • rarity
 Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).

[PANTS:ITEM_PANTS_PANTS:COMMON]

SHIELD item token

[SHIELD:ITEM_SHIELD_SHIELD]

SHOES
  • item token
  • rarity
 Rarity is optional. Permitted rarity values are RARE, UNCOMMON, FORCED (anything else is treated as COMMON).

[SHOES:ITEM_SHOES_SHOES:COMMON]

SIEGEAMMO item token

[SIEGEAMMO:ITEM_SIEGEAMMO_BALLISTA]

TOOL item token

[TOOL:ITEM_TOOL_NEST_BOX]

TOY item token

[TOY:ITEM_TOY_PUZZLEBOX]

TRAPCOMP item token

[TRAPCOMP:ITEM_TRAPCOMP_GIANTAXEBLADE]

WEAPON item token

[WEAPON:ITEM_WEAPON_AXE_BATTLE]

USE_ANIMAL_PRODUCTS Allows civilization to use products made from animals. All relevant creatures will be able to provide wool, silk, and extracts (including milk and venom) for trade, and non-sentient creatures (unless ethics state otherwise) will be able to provide eggs, caught fish, meat, leather, bone, shell, pearl, horn, and ivory.
USE_ANY_PET_RACE Any creature in the civilization's list of usables (from the surrounding 7x7 or so of squares and map features in those squares) which has PET or PET_EXOTIC will be available as a pet, pack animal (with PACK_ANIMAL), wagon puller (with WAGON_PULLER), mount (with MOUNT or MOUNT_EXOTIC), or siege minion (with TRAINABLE_WAR and without CAN_LEARN). This notion of the initial usable creature list, which then gets pared down or otherwise considered, applies below as well. All common domestic and equipment creatures are also added to the initial list.
USE_CAVE_ANIMALS If they don't have it, creatures with exclusively subterranean biomes are skipped. If they have it, cave creatures with PET will also be available as pets, pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR and without CAN_LEARN).
USE_EVIL_ANIMALS Don't have it -> EVIL creatures skipped. If they have it, evil creatures with SLOW_LEARNER or without CAN_LEARN will be also available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR or SLOW_LEARNER).
USE_EVIL_PLANTS As EVIL creatures for all uses of plants.
USE_EVIL_WOOD As EVIL creatures for all uses of wood.
USE_GOOD_ANIMALS Don't have it -> GOOD creatures skipped. If they have it, good creatures without CAN_LEARN will also be available as pets (with PET), pack animals (with PACK_ANIMAL), wagon pullers (with WAGON_PULLER), mounts (with MOUNT or MOUNT_EXOTIC), and siege minions (with TRAINABLE_WAR).
USE_GOOD_PLANTS As GOOD creatures for all uses of plants.
USE_GOOD_WOOD As GOOD creatures for all uses of wood.
USE_MISC_PROCESSED_WOOD_PRODUCTS If the relevant professions are permitted, controls availability of lye (LYE_MAKING), charcoal (BURN_WOOD), and potash (POTASH_MAKING).
COMMON_DOMESTIC_MOUNT Gives the civilization access to creatures with COMMON_DOMESTIC and MOUNT. Additionally, all available (based on USE_ANY_PET_RACE, USE_CAVE_ANIMALS, USE_GOOD_ANIMALS, and USE_EVIL_ANIMALS) creature with MOUNT and PET will be allowed for use as mounts during combat.
COMMON_DOMESTIC_PACK Gives the civilization access to creatures with COMMON_DOMESTIC and PACK_ANIMAL. Additionally, all available (see above) creatures with PACK_ANIMAL and PET will be allowed for use during trade as pack animals.
COMMON_DOMESTIC_PET Gives the civilization access to creatures with COMMON_DOMESTIC and PET. Additionally, all available (see above) creatures with PET will be allowed for use as pets.
COMMON_DOMESTIC_PULL Gives the civilization access to creatures with COMMON_DOMESTIC and WAGON_PULLER. Additionally, all available (see above) creatures with WAGON_PULLER and PET will be allowed for use during trade to pull wagons.
RIVER_PRODUCTS Allow civ to use river products in the goods it has available for trade.
OCEAN_PRODUCTS Allow civ to use ocean products (including amber and coral) in the goods it has available for trade. Without OCEAN_PRODUCTS, civilizations will not be able to trade ocean fish even if they are also available from other sources (e.g. sturgeons and stingrays).
INDOOR_FARMING Allow civ to use underground plant products in the goods it has available for trade.
OUTDOOR_FARMING Allow civ to use outdoor plant products in the goods it has available for trade.
CLOTHING Civ members will attempt to wear clothing.
SUBTERRANEAN_CLOTHING Will wear things made of spider silk and other subterranean materials.
EQUIPMENT_IMPROVEMENTS Adds decorations to equipment based on the level of the generated unit. Also improves item quality.
IMPROVED_BOWS Adds decorations to weapons generated for bowman and master bowman. An elf hack.
METAL_PREF Allows metal materials to be used to make cages (inexpensive metals only) and crafts.
STONE_PREF Allows the civilization to make use of nearby stone types. If the FURNACE_OPERATOR job is permitted, also allows ore-bearing stones to be smelted into metals.
WOOD_WEAPONS The civilization can make traditionally metallic weapons such as swords and spears from wood. An elf hack.
WOOD_ARMOR The civilization can make traditionally metallic armor such as mail shirts and helmets from wood. An elf hack.
GEM_PREF Enables creatures of this entity to bring gems in trade.
INDOOR_WOOD Allow civ to use subterranean wood types, such as tower-cap and fungiwood logs.
OUTDOOR_WOOD Allow civ to use outdoor wood types, such as mangrove and oak.
GEM_SHAPE shape Precious gems cut by this civilization's jewelers can be of this shape.
STONE_SHAPE shape Ordinary non-gem stones cut by this civilization's jewelers can be of this shape.

Tissue Styling Related Tokens[edit]

Token Arguments Description
TISSUE_STYLE tissue style unit ID Select tissue layer which have the ID attached using TISSUE_STYLE_UNIT token in unit raws. This allows setting further cultural style parameters for selected tissue layer.
TS_MAINTAIN_LENGTH
  • minimum length?
  • maximum length?
 Presumably sets culturally preferred tissue length for selected tissue. Needs testing.

Dwarves have their beards set to 100:NONE by default.

TS_PREFERRED_SHAPING styling token Valid tokens are NEATLY_COMBED, BRAIDED, DOUBLE_BRAIDS, PONY_TAILS, CLEAN_SHAVEN and STANDARD_HAIR/BEARD/MOUSTACHE/SIDEBURNS_SHAPINGS.

Presumably sets culturally preferred tissue shapings for selected tissue. Needs testing.

Retrieved from "https://dwarffortresswiki.org/index.php?title=v0.34:Entity_token&oldid=303653"