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 | + | The default plants are stored in the plant_standard.txt file. |
==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 30: | Line 28: | ||
|- | |- | ||
− | + | |PREFSTRING | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | | PREFSTRING | ||
| | | | ||
*reason | *reason | ||
Line 42: | Line 34: | ||
|- | |- | ||
− | | | + | | VALUE |
| | | | ||
− | * | + | *value |
− | | | + | | Value of harvested plant. |
|- | |- | ||
− | | | + | | PICKED_TILE |
| | | | ||
− | * | + | *tile |
− | + | | The tile used when harvested. May either be a number or letter within apostrophes(confirm?).<font color="red">Required</font>. See [[character table]]. | |
− | | | ||
|- | |- | ||
− | | | + | | PICKED_COLOR |
| | | | ||
− | * | + | *foreground |
− | * | + | *background |
− | | | + | *bright |
+ | | The {{l|color}} of the plant in farms. | ||
|- | |- | ||
− | | | + | | SHRUB_TILE |
| | | | ||
− | * | + | *tile |
− | | | + | | What tile is used for shrubs bearing this plant. Can be either a number or a character inside apostrophes. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | | | + | | DEAD_SHRUB_TILE |
| | | | ||
− | * | + | *tile |
− | + | | What tile is used when the plant has withered. Can be either a number or a character inside apostrophes. | |
− | | | ||
|- | |- | ||
− | | | + | | SHRUB_COLOR |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| | | | ||
− | * | + | *foreground |
− | | | + | *background |
+ | *bright | ||
+ | | The [[color]] of shrubs bearing this plant. | ||
|- | |- | ||
− | | | + | | DEAD_SHRUB_COLOR |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| | | | ||
− | * | + | *foreground |
− | | | + | *background |
+ | *bright | ||
+ | |The [[color]] of dead shrubs that bore this plant. | ||
|} | |} | ||
− | == | + | ==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}} | {| {{prettytable}} | ||
Line 131: | Line 91: | ||
! width="20%" | Arguments | ! width="20%" | Arguments | ||
! width="60%" | Description | ! width="60%" | Description | ||
+ | |- | ||
+ | | USE_MATERIAL_TEMPLATE | ||
+ | | | ||
+ | *material_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}} |
+ | | The material to use for trees made of this plant. | ||
|- | |- | ||
− | | | + | | LEAVES |
| | | | ||
+ | *name | ||
+ | *name_plural | ||
*tile | *tile | ||
− | | The | + | *foreground |
+ | *background | ||
+ | *bright | ||
+ | *wilt_foreground | ||
+ | *wilt_background | ||
+ | *wilt_bright | ||
+ | *{{L|Material token|material}} | ||
+ | | The material used by the leaves of this plant. | ||
|- | |- | ||
− | | | + | |SEED |
| | | | ||
− | * | + | *name |
− | | The | + | *name_plural |
+ | *foreground | ||
+ | *background | ||
+ | *bright | ||
+ | *{{L|Material token|material}} | ||
+ | | The material used by the seeds of this plant, as well as the singular and plural forms of the name for the seeds and their color. | ||
|- | |- | ||
− | | | + | | DRINK |
| | | | ||
− | * | + | * {{L|Material token|material}} |
− | | The | + | | The material to be used for drinks made from this plant. |
|- | |- | ||
− | | | + | | MILL |
| | | | ||
− | * | + | * {{L|Material token|material}} |
− | | The | + | | The material to be used by the ground version of this plant. |
|- | |- | ||
− | | | + | |THREAD |
| | | | ||
− | * | + | * {{L|Material token|material}} |
− | + | | The material of threads made from this plant. | |
− | |||
− | | The | ||
|- | |- | ||
− | | | + | |EXTRACT_BARREL |
| | | | ||
− | * | + | * {{L|Material token|material}} |
− | + | | The material that is used for the extract put into barrels. Should correspond to a material with the [EXTRACT_STORAGE:BARREL] token. | |
− | |||
− | | The | ||
|- | |- | ||
− | | | + | | EXTRACT_VIAL |
| | | | ||
− | * | + | *{{L|Material token|material}} |
− | + | | The material that is used for the extract put into vials. Should correspond to a material with the [EXTRACT_STORAGE:FLASK] token. | |
− | |||
− | | The | ||
|- | |- | ||
− | | | + | | EXTRACT_STILL_VIAL |
| | | | ||
− | * | + | * {{L|Material token|material}} |
− | + | | The material that is used for the extract put into vials. Should correspond to a material with the [EXTRACT_STORAGE:FLASK] token. These are extracted at a {{L|Still}}, not a {{L|Farmer's workshop}}. | |
− | |||
− | | The [ | ||
|- | |- | ||
− | | | + | | EXTRACT_STORAGE |
| | | | ||
− | * | + | *storage_type (BARREL or FLASK) |
− | | | + | | Used in material definitions, defines where the new material is stored. |
|- | |- | ||
− | | | + | | EDIBLE_VERMIN |
− | | | + | | |
− | + | | Used in material definitions, permits the plant material to be eaten by {{L|vermin}}. | |
− | | | + | |
+ | |- | ||
+ | | EDIBLE_RAW | ||
+ | | | ||
+ | | Used in material definitions, permits the plant material to be eaten raw. | ||
|- | |- | ||
− | | | + | | EDIBLE_COOKED |
| | | | ||
− | | | + | | Used in material definition, permits the plant material to be cooked into prepared meals. |
|} | |} | ||
− | == | + | ==Growing Tokens== |
− | |||
− | |||
{| {{prettytable}} | {| {{prettytable}} | ||
|- style='background-color:#ddd' | |- style='background-color:#ddd' | ||
Line 226: | Line 201: | ||
! width="20%" | Arguments | ! width="20%" | Arguments | ||
! width="60%" | Description | ! width="60%" | Description | ||
+ | |- | ||
+ | | GROWDUR | ||
+ | | | ||
+ | *time | ||
+ | | How long the plant takes to grow. See {{l|Time}}. | ||
+ | |||
+ | |- | ||
+ | | BIOME | ||
+ | | | ||
+ | *biome | ||
+ | | What {{L|biome token|biome}} this plant appears in. | ||
|- | |- | ||
Line 248: | Line 234: | ||
|- | |- | ||
− | | | + | | WET |
− | | | + | | |
− | + | | Allows the plant to grow near water features. | |
− | | | ||
|- | |- | ||
− | | | + | | DRY |
− | | | + | | |
− | + | | Allows the plant to gruw away from water features. | |
− | | | ||
|- | |- | ||
− | | | + | | EVIL |
− | | | + | | |
− | + | | Restricts the plant to growing in Evil regions. Cannot be combined with [GOOD]. | |
− | | | ||
|- | |- | ||
− | | | + | | GOOD |
− | | | + | | |
− | + | | Restricts the plant to growing in Good regions. Cannot be combined with [EVIL]. | |
− | | | ||
|- | |- | ||
− | | | + | | SAVAGE |
− | | | + | | |
− | + | | Restricts the plant to growing in Savage regions (regardless of alignment). | |
− | | | ||
|- | |- | ||
− | | | + | | FREQUENCY |
| | | | ||
− | * | + | *freq (0-100) |
− | | | + | | How frequently shrubs of this plant are generated in a particular area. |
|- | |- | ||
Line 287: | Line 268: | ||
| | | | ||
*size | *size | ||
− | | The maximum stack size collected when gathered via | + | | The maximum stack size collected when gathered or harvested. |
+ | |||
+ | |- | ||
+ | | UNDERGROUND_DEPTH | ||
+ | | | ||
+ | *minimum | ||
+ | *maximum | ||
+ | | 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. | ||
+ | |||
+ | |} | ||
+ | |||
+ | ==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}} | ||
+ | |- style='background-color:#ddd' | ||
+ | ! width="20%" | Token | ||
+ | ! width="20%" | Arguments | ||
+ | ! width="60%" | Description | ||
|- | |- | ||
− | | | + | | AUTUMNCOLOR |
| | | | ||
− | + | | Makes the tree turn yellow, orange, and red in Autumn. | |
− | |||
− | |||
− | | | ||
|- | |- | ||
− | | | + | |TREE_TILE |
| | | | ||
− | * | + | *tile |
− | + | | The tile used for the tree on the map. May be a number or a character inside apostrophes. | |
− | |||
− | | The | ||
|- | |- | ||
− | | | + | | TREE_COLOR |
| | | | ||
*foreground | *foreground | ||
*background | *background | ||
*bright | *bright | ||
− | | The [[color]] of | + | | The [[color]] of the tree on the map. |
|- | |- | ||
− | | | + | | DEAD_TREE_COLOR |
| | | | ||
*foreground | *foreground | ||
*background | *background | ||
*bright | *bright | ||
− | |The [[color]] of | + | | The [[color]] of the tree on the map when (un)dead. |
|- | |- | ||
− | | | + | | SAPLING |
− | | | + | | |
− | + | | Makes young versions of the tree be called "[tree name] sapling"; otherwise, they are called "young [tree name]" | |
− | | | ||
|- | |- | ||
− | | | + | | SAPLING_COLOR |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
*foreground | *foreground | ||
*background | *background | ||
*bright | *bright | ||
− | + | | The [[color]] of saplings of this tree. | |
− | |||
|- | |- | ||
− | | | + | | DEAD_SAPLING_COLOR |
| | | | ||
− | |||
− | |||
− | |||
*foreground | *foreground | ||
*background | *background | ||
*bright | *bright | ||
− | + | | The [[color]] of dead saplings of this tree. | |
− | |||
− | |||
− | |||
− | | | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
==Grass Tokens== | ==Grass Tokens== | ||
− | |||
{| {{prettytable}} | {| {{prettytable}} | ||
Line 403: | Line 349: | ||
| GRASS | | GRASS | ||
| | | | ||
− | | | + | | Plant is a type of grass. |
− | |||
|- | |- | ||
| GRASS_TILES | | GRASS_TILES | ||
Line 412: | Line 357: | ||
*tile | *tile | ||
*tile | *tile | ||
− | | | + | |Tiles for a surface covered in grass. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
| ALT_GRASS_TILES | | ALT_GRASS_TILES | ||
Line 428: | Line 365: | ||
*tile | *tile | ||
*tile | *tile | ||
− | | | + | |Grass tiles will alternate between these and GRASS_TILES. Currently used for wormy tendrils and eyeballs. |
− | |||
|- | |- | ||
| GRASS_COLORS | | GRASS_COLORS | ||
| | | | ||
*color 1 (fore:back:bright) | *color 1 (fore:back:bright) | ||
− | *color 2 (fore:back:bright) | + | *color 2 (fore:back:bright) color (fore:back:bright) |
− | |||
*dead color (fore:back:bright) | *dead color (fore:back:bright) | ||
− | | | + | |Colors of grass tiles. |
+ | |- | ||
+ | | ALT_PERIOD | ||
+ | | | ||
+ | *period | ||
+ | *delay | ||
+ | |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}} | ||
|} | |} | ||
+ | |||
{{Category|Modding}} | {{Category|Modding}} | ||
{{Category|Tokens}} | {{Category|Tokens}} |