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.
Editing v0.31:Plant token
Jump to navigation
Jump to search
Warning: You are not logged in.
Your IP address will be recorded in this page's edit history.
You are editing a page for an older version of Dwarf Fortress ("Main" is the current version, not "v0.31"). Please make sure you intend to do this. If you are here by mistake, see the current page instead.
The edit can be undone. Please check the comparison below to verify that this is what you want to do, and then save the changes below to finish undoing the edit.
Latest revision | Your text | ||
Line 1: | Line 1: | ||
− | {{quality| | + | {{quality|Fine|08:00, 22 May 2010 (UTC)}}{{av}} |
The default plants are stored in the plant_standard.txt file, while grasses are stored in plant_grasses.txt. | The default plants are stored in the plant_standard.txt file, while grasses are stored in plant_grasses.txt. | ||
==Basic Tokens== | ==Basic Tokens== | ||
− | |||
− | |||
{| {{prettytable}} | {| {{prettytable}} | ||
|- style='background-color:#ddd' | |- style='background-color:#ddd' | ||
Line 15: | Line 13: | ||
| | | | ||
*name | *name | ||
− | | The singular form of the plants name as seen in game. | + | | The singular form of the plants name as seen in game. <font color="red">Required</font>. |
|- | |- | ||
Line 21: | Line 19: | ||
| | | | ||
*name | *name | ||
− | | The plural form of the plants name as seen in game. | + | | The plural form of the plants name as seen in game. <font color="red">Required</font>. |
|- | |- | ||
Line 27: | Line 25: | ||
| | | | ||
*adjective | *adjective | ||
− | | The word or phrase used to describe items made from this plant. | + | | The word or phrase used to describe items made from this plant. <font color="red">Required</font>. |
|- | |- | ||
Line 41: | Line 39: | ||
| What dwarves can like this object for (e.g. "Urist likes plump helmets for their rounded tops.") | | What dwarves can like this object for (e.g. "Urist likes plump helmets for their rounded tops.") | ||
+ | |} | ||
+ | |||
+ | ==Plant Materials== | ||
+ | Materials defined within a plant can be modified by all valid material tokens and may only be accessed by the local plant. | ||
+ | |||
+ | {| {{prettytable}} | ||
+ | |- style='background-color:#ddd' | ||
+ | ! width="20%" | Token | ||
+ | ! width="20%" | Arguments | ||
+ | ! width="60%" | Description | ||
|- | |- | ||
− | | | + | | USE_MATERIAL_TEMPLATE |
| | | | ||
*material_name | *material_name | ||
− | | Starts defining a new local plant material with the given name | + | *template_name |
+ | | Starts defining a new local plant material with the given name using the specified template. material_name is used to reference the newly created material from the same plant. | ||
+ | |||
+ | |- | ||
+ | | BASIC_MAT | ||
+ | | | ||
+ | * {{L|Material token|material}} | ||
+ | | Sets the basic(structural) material of the plant. According to Toady, you can use other materials (for instance, iron) but the game may hiccup on plants that aren't structurally plants. | ||
+ | |||
+ | |- | ||
+ | | TREE | ||
+ | | | ||
+ | * {{L|Material token|material}} | ||
+ | | Makes the plant into a {{L|tree}} made of this material. | ||
+ | |||
+ | |- | ||
+ | | DRINK | ||
+ | | | ||
+ | * {{L|Material token|material}} | ||
+ | | Permits brewing the plant into {{L|alcohol}} made of this material. | ||
+ | |||
+ | |- | ||
+ | | MILL | ||
+ | | | ||
+ | * {{L|Material token|material}} | ||
+ | | Permits milling the plant at a {{L|quern}} or {{L|millstone}} into a powder made of this material. | ||
+ | |||
+ | |- | ||
+ | | THREAD | ||
+ | | | ||
+ | * {{L|Material token|material}} | ||
+ | | Permits processing the plant at a {{L|farmer's workshop}} to yield threads made of this material. | ||
+ | |||
+ | |- | ||
+ | | SEED | ||
+ | | | ||
+ | *name | ||
+ | *name_plural | ||
+ | *foreground | ||
+ | *background | ||
+ | *bright | ||
+ | *{{L|Material token|material}} | ||
+ | | Causes the plant to yield plantable seeds having these properties and made of this material. | ||
|- | |- | ||
− | | | + | | LEAVES |
| | | | ||
− | * | + | *name |
− | * | + | *name_plural |
− | | | + | *tile |
+ | *foreground | ||
+ | *background | ||
+ | *bright | ||
+ | *wilt_foreground | ||
+ | *wilt_background | ||
+ | *wilt_bright | ||
+ | *{{L|Material token|material}} | ||
+ | | Permits processing the plant into a {{L|bag}} at a {{L|farmer's workshop}} to yield leaves having these properties and made of this material. | ||
+ | |||
+ | |- | ||
+ | | EXTRACT_STILL_VIAL | ||
+ | | | ||
+ | * {{L|Material token|material}} | ||
+ | | Permits processing the plant into a {{L|vial}} at a {{L|still}} to yield extract made of this material. Said material should have the [EXTRACT_STORAGE:FLASK] token. | ||
|- | |- | ||
− | | | + | | EXTRACT_VIAL |
| | | | ||
− | * | + | *{{L|Material token|material}} |
− | + | | Permits processing the plant into a {{L|vial}} at a {{L|farmer's workshop}} to yield extract made of this material. Said material should have the [EXTRACT_STORAGE:FLASK] token. | |
− | | | ||
|- | |- | ||
− | | | + | |EXTRACT_BARREL |
| | | | ||
− | * | + | * {{L|Material token|material}} |
− | | | + | | Permits processing the plant into a {{L|barrel}} at a {{L|farmer's workshop}} to yield extract made of this material. Said material should have the [EXTRACT_STORAGE:BARREL] token. |
|} | |} | ||
==Environment Tokens== | ==Environment Tokens== | ||
− | |||
− | |||
{| {{prettytable}} | {| {{prettytable}} | ||
|- style='background-color:#ddd' | |- style='background-color:#ddd' | ||
Line 76: | Line 137: | ||
! width="20%" | Arguments | ! width="20%" | Arguments | ||
! width="60%" | Description | ! width="60%" | Description | ||
+ | |||
+ | |- | ||
+ | | SPRING | ||
+ | | | ||
+ | | Allows the plant to grow during spring. | ||
+ | |||
+ | |- | ||
+ | | SUMMER | ||
+ | | | ||
+ | | Allows the plant to grow during summer. | ||
+ | |||
+ | |- | ||
+ | | AUTUMN | ||
+ | | | ||
+ | | Allows the plant to grow during autumn. | ||
+ | |||
+ | |- | ||
+ | | WINTER | ||
+ | | | ||
+ | | Allows the plant to grow during winter. | ||
|- | |- | ||
Line 82: | Line 163: | ||
*minimum | *minimum | ||
*maximum | *maximum | ||
− | | Designates the highest and lowest cavern levels that the plant can appear in if its | + | | Designates the highest and lowest cavern levels that the plant can appear in if its {{L|biome token|biome}} is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1. |
|- | |- | ||
Line 103: | Line 184: | ||
| | | | ||
*freq (0-100) | *freq (0-100) | ||
− | | How frequently this plant is generated in a particular area | + | | How frequently this plant is generated in a particular area. |
|- | |- | ||
Line 113: | Line 194: | ||
| DRY | | DRY | ||
| | | | ||
− | | Allows the plant to | + | | Allows the plant to gruw away from water features. |
|- | |- | ||
Line 119: | Line 200: | ||
| | | | ||
*biome | *biome | ||
− | | What | + | | What {{L|biome token|biome}} this plant appears in. |
|} | |} | ||
==Tree Tokens== | ==Tree Tokens== | ||
− | + | Trees cannot be used for seeds/food/drink/thread at this point, however, the structural material is designated in the same way. | |
− | + | Trees now appear under plant_standard instead of matgloss_wood. | |
{| {{prettytable}} | {| {{prettytable}} | ||
|- style='background-color:#ddd' | |- style='background-color:#ddd' | ||
Line 131: | Line 212: | ||
! width="20%" | Arguments | ! width="20%" | Arguments | ||
! width="60%" | Description | ! width="60%" | Description | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 147: | Line 222: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used for the tree on the map. May be a number or a character inside apostrophes | + | | The tile used for the tree on the map. May be a number or a character inside apostrophes. |
|- | |- | ||
Line 153: | Line 228: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used for (un)dead trees of this type | + | | The tile used for (un)dead trees of this type. |
|- | |- | ||
Line 159: | Line 234: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used for saplings of this tree | + | | The tile used for saplings of this tree. |
|- | |- | ||
Line 165: | Line 240: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used for dead saplings of this tree | + | | The tile used for dead saplings of this tree. |
|- | |- | ||
Line 173: | Line 248: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The {{L|color}} of the tree on the map. |
|- | |- | ||
Line 181: | Line 256: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The {{L|color}} of the tree on the map when (un)dead. |
|- | |- | ||
Line 189: | Line 264: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The {{L|color}} of saplings of this tree. |
|- | |- | ||
Line 197: | Line 272: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The {{L|color}} of dead saplings of this tree. |
|- | |- | ||
Line 203: | Line 278: | ||
| | | | ||
*depth | *depth | ||
− | | The water depth at which saplings of this tree will drown. Exact behavior is unknown | + | | The water depth at which saplings of this tree will drown. Exact behavior is unknown. |
|- | |- | ||
Line 209: | Line 284: | ||
| | | | ||
*depth | *depth | ||
− | | The water depth at which this tree will drown. Exact behavior is unknown | + | | The water depth at which this tree will drown. Exact behavior is unknown. |
|- | |- | ||
| SAPLING | | SAPLING | ||
| | | | ||
− | | Makes young versions of the tree be called "[tree name] sapling"; otherwise, they are called "young [tree name]" | + | | Makes young versions of the tree be called "[tree name] sapling"; otherwise, they are called "young [tree name]" |
|} | |} | ||
==Crop Tokens== | ==Crop Tokens== | ||
− | |||
{| {{prettytable}} | {| {{prettytable}} | ||
Line 226: | Line 300: | ||
! width="20%" | Arguments | ! width="20%" | Arguments | ||
! width="60%" | Description | ! width="60%" | Description | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
Line 251: | Line 305: | ||
| | | | ||
*time | *time | ||
− | | How long the plant takes to grow. See | + | | How long the plant takes to grow. See {{l|Time}}. |
|- | |- | ||
Line 257: | Line 311: | ||
| | | | ||
*value | *value | ||
− | | Value of harvested plant | + | | Value of harvested plant. |
|- | |- | ||
Line 263: | Line 317: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used when harvested. May either be a number or letter within apostrophes(confirm?). See [[ | + | | The tile used when harvested. May either be a number or letter within apostrophes(confirm?).<font color="red">Required</font>. See [[character table]]. |
|- | |- | ||
Line 269: | Line 323: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used when a harvested plant has wilted | + | | The tile used when a harvested plant has wilted. |
|- | |- | ||
Line 275: | Line 329: | ||
| | | | ||
*tile | *tile | ||
− | | What tile is used for shrubs bearing this plant. Can be either a number or a character inside apostrophes | + | | What tile is used for shrubs bearing this plant. Can be either a number or a character inside apostrophes. |
|- | |- | ||
Line 281: | Line 335: | ||
| | | | ||
*tile | *tile | ||
− | | What tile is used | + | | What tile is used when the plant has withered. Can be either a number or a character inside apostrophes. |
|- | |- | ||
Line 287: | Line 341: | ||
| | | | ||
*size | *size | ||
− | | The maximum stack size collected when gathered | + | | The maximum stack size collected when gathered or harvested. |
|- | |- | ||
Line 295: | Line 349: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The {{l|color}} of the plant in farms. |
|- | |- | ||
Line 303: | Line 357: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The {{l|color}} of the plant when wilted. |
|- | |- | ||
Line 311: | Line 365: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The {{l|color}} of shrubs bearing this plant. |
|- | |- | ||
Line 319: | Line 373: | ||
*background | *background | ||
*bright | *bright | ||
− | |The | + | |The {{l|color}} of dead shrubs that bore this plant. |
|- | |- | ||
Line 325: | Line 379: | ||
| | | | ||
*depth | *depth | ||
− | | The water depth at which shrubs of this plant will drown. Exact behavior is unknown | + | | The water depth at which shrubs of this plant will drown. Exact behavior is unknown. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
==Grass Tokens== | ==Grass Tokens== | ||
− | |||
{| {{prettytable}} | {| {{prettytable}} | ||
Line 403: | Line 394: | ||
| GRASS | | GRASS | ||
| | | | ||
− | | | + | | Plant is a type of grass. |
|- | |- | ||
Line 412: | Line 403: | ||
*tile | *tile | ||
*tile | *tile | ||
− | | | + | |Tiles for a surface covered in grass. |
|- | |- | ||
Line 418: | Line 409: | ||
| | | | ||
*period | *period | ||
− | * | + | *delay |
− | | How often the grass switches between | + | | How often the grass switches between alternate tiles. Each tile has a counter which starts at the "period" value and decrements once per frame - when the counter reaches the "delay" value, the grass switches to the ALT tile, and when it reaches zero, it switches back to the original tile and restarts the counter. If the "delay" value is greater than or equal to the "period" value, the grass will not animate - instead, it will permanently display the ALT tile.{{bug|4151}} |
|- | |- | ||
Line 428: | Line 419: | ||
*tile | *tile | ||
*tile | *tile | ||
− | | | + | |Grass tiles will alternate between these and GRASS_TILES. Currently used for wormy tendrils and eyeballs. |
|- | |- | ||
Line 437: | Line 428: | ||
*dry color (fore:back:bright) | *dry color (fore:back:bright) | ||
*dead color (fore:back:bright) | *dead color (fore:back:bright) | ||
− | | | + | |Colors of grass tiles. |
|} | |} | ||
{{Category|Modding}} | {{Category|Modding}} | ||
{{Category|Tokens}} | {{Category|Tokens}} |