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 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.
If you are creating a redirect to the current version's page, do not use any namespace. For example: use #REDIRECT [[Cat]], not #REDIRECT [[Main:Cat]] or #REDIRECT [[cv:Cat]]. See DF:Versions for more information.
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: | ||
− | {{ | + | {{Migrated_article}} |
− | {{ | + | {{quality|unrated}}{{av}} |
− | {{ | + | The default plants are stored in the plant_standard.txt file, while grasses are stored in plant_grasses.txt. |
− | The | ||
− | + | ==Basic Tokens== | |
− | |||
− | |||
− | |||
− | ==Basic | ||
These tokens are specified for all plants and define their most basic characteristics. | These tokens are specified for all plants and define their most basic characteristics. | ||
Line 18: | Line 13: | ||
|- | |- | ||
− | + | | NAME | |
| | | | ||
*name | *name | ||
− | | The singular form of the | + | | The singular form of the plants name as seen in game. |
|- | |- | ||
− | + | | NAME_PLURAL | |
| | | | ||
*name | *name | ||
− | | The plural form of the | + | | The plural form of the plants name as seen in game. |
|- | |- | ||
− | + | | ADJ | |
| | | | ||
*adjective | *adjective | ||
Line 36: | Line 31: | ||
|- | |- | ||
− | + | | ALL_NAMES | |
| | | | ||
*name | *name | ||
Line 42: | Line 37: | ||
|- | |- | ||
− | + | | PREFSTRING | |
| | | | ||
*reason | *reason | ||
Line 48: | Line 43: | ||
|- | |- | ||
− | + | | MATERIAL | |
| | | | ||
*material_name | *material_name | ||
− | | Starts defining a new local plant material with the given name | + | | Starts defining a new local plant material with the given name and '''no''' properties. |
|- | |- | ||
− | + | | USE_MATERIAL | |
| | | | ||
*material_name | *material_name | ||
− | * | + | *old_material |
− | | Starts defining a new local plant material with the given name and using the properties of another | + | | Starts defining a new local plant material with the given name and using the properties of another local plant material. |
|- | |- | ||
− | + | | USE_MATERIAL_TEMPLATE | |
| | | | ||
*material_name | *material_name | ||
*template_name | *template_name | ||
− | | Starts defining a new local plant material with the name | + | | Starts defining a new local plant material with the given name and using the properties of the specified material template. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | BASIC_MAT | |
| | | | ||
* [[Material token|material]] | * [[Material token|material]] | ||
− | | Sets the basic material of the plant | + | | Sets the basic 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. For crops, said material should have [STRUCTURAL_PLANT_MAT] to permit proper stockpiling. Generally, this should be "LOCAL_PLANT_MAT:material_name", using a material defined using MATERIAL, USE_MATERIAL, or USE_MATERIAL_TEMPLATE. |
|} | |} | ||
− | ==Environment | + | ==Environment Tokens== |
These tokens, also applicable to all plants, specify where the plants grow. | These tokens, also applicable to all plants, specify where the plants grow. | ||
Line 91: | Line 79: | ||
|- | |- | ||
− | + | | UNDERGROUND_DEPTH | |
| | | | ||
*minimum | *minimum | ||
*maximum | *maximum | ||
− | | Designates the highest and lowest cavern levels that the plant can appear in if its [[biome token|biome]] is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that | + | | Designates the highest and lowest cavern levels that the plant can appear in if its [[biome token|biome]] is subterranean. Dwarven civilizations will only export (via the embark screen or caravans) things that available at depth 1. Defaults to 0:0 (surface only). |
|- | |- | ||
− | + | | GOOD | |
| | | | ||
| Restricts the plant to growing in Good regions. Cannot be combined with [EVIL]. | | Restricts the plant to growing in Good regions. Cannot be combined with [EVIL]. | ||
|- | |- | ||
− | + | | EVIL | |
| | | | ||
| Restricts the plant to growing in Evil regions. Cannot be combined with [GOOD]. | | Restricts the plant to growing in Evil regions. Cannot be combined with [GOOD]. | ||
|- | |- | ||
− | + | | SAVAGE | |
| | | | ||
| Restricts the plant to growing in Savage regions (regardless of alignment). | | Restricts the plant to growing in Savage regions (regardless of alignment). | ||
|- | |- | ||
− | + | | FREQUENCY | |
| | | | ||
*freq (0-100) | *freq (0-100) | ||
− | | How frequently this plant is generated in a particular area. Defaults to 50. Plants with valid [[biome token]]s and [FREQUENCY:0] will not grow in the wild, but will still be available for entity use and farm plots. | + | | How frequently this plant is generated in a particular area. Defaults to 50. Plants with valid [[biome token]]s and [FREQUENCY:0] will not grow in the wild, but will still be available for entity use and farm plots. |
|- | |- | ||
− | + | | WET | |
| | | | ||
− | | | + | | Allows the plant to grow near water features. |
|- | |- | ||
− | + | | DRY | |
− | | | + | | |
− | | | + | | Allows the plant to grow away from water features. |
|- | |- | ||
− | + | | BIOME | |
| | | | ||
*biome | *biome | ||
Line 136: | Line 124: | ||
|} | |} | ||
− | ==Growth | + | ==Growth Tokens== |
− | These tokens are used for all plants and specify growths growing on a plant | + | These tokens are used for all plants and specify growths growing on a plant. |
− | |||
− | |||
{| {{prettytable}} | {| {{prettytable}} | ||
Line 148: | Line 134: | ||
|- | |- | ||
− | + | | GROWTH | |
| | | | ||
− | * | + | *token |
− | | Defines a plant growth. Takes the below tokens as arguments | + | | Defines a plant growth. Takes the below tokens as arguments. |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | GROWTH_NAME | |
| | | | ||
*singular | *singular | ||
Line 167: | Line 147: | ||
|- | |- | ||
− | + | | GROWTH_ITEM | |
| | | | ||
* [[item token]] | * [[item token]] | ||
* [[material token]] | * [[material token]] | ||
− | | Specifies what item this growth is and what it is made of. | + | | Specifies what item this growth is and what it is made of. Item is usually PLANT_GROWTH:NONE. |
|- | |- | ||
− | + | | GROWTH_HOST_TILE | |
| | | | ||
*plant part | *plant part | ||
| Specifies on which part of the plant or tree the growth appears, usually for multi-tile [[tree]]s. Valid tokens are: | | Specifies on which part of the plant or tree the growth appears, usually for multi-tile [[tree]]s. Valid tokens are: | ||
+ | *BRANCHES | ||
+ | *LIGHT_BRANCHES | ||
+ | *HEAVY_BRANCHES | ||
+ | *DIRECTED_BRANCHES | ||
+ | *CAP | ||
+ | *ROOTS | ||
+ | *TRUNK | ||
*TWIGS | *TWIGS | ||
− | * | + | *SAPLING |
− | * | + | *BRANCHES_AND_TWIGS |
*ALL_BRANCHES_AND_TWIGS | *ALL_BRANCHES_AND_TWIGS | ||
− | * | + | *LIGHT_BRANCHES_AND_TWIGS |
− | *HEAVY_BRANCHES_AND_TRUNK | + | *HEAVY_BRANCHES_AND_TRUNK |
− | * | + | *DIRECTED_BRANCHES_AND_TRUNK |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | GROWTH_DENSITY | |
| | | | ||
*integer | *integer | ||
− | | | + | | Specifies growth density. |
|- | |- | ||
− | + | | GROWTH_TIMING | |
| | | | ||
− | *[[time]] | + | *[[time]] ticks (0-403200?) |
| Specifies at which part of the year the growth appears. Default is all year round. | | Specifies at which part of the year the growth appears. Default is all year round. | ||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
|- | |- | ||
− | + | | GROWTH_PRINT | |
| | | | ||
*overworld tile | *overworld tile | ||
*item tile | *item tile | ||
− | * | + | *colour |
− | * | + | *timing (0-403200?), ALL or NONE |
*priority | *priority | ||
− | | Specifies the appearance of the growth. Can be specified more than once, for example for autumn leaves | + | | Specifies the appearance of the growth. Can be specified more than once, for example for autumn leaves. |
− | |||
− | |||
|- | |- | ||
− | + | | GROWTH_HAS_SEED | |
| | | | ||
− | | The growth | + | | The growth carries a seed, which is left when the growth is used or eaten. |
|- | |- | ||
− | + | | GROWTH_DROPS_OFF | |
| | | | ||
− | | Growths | + | | Growths drops from the shrub or tree, leaving a pile of items on the ground. |
− | |||
− | |||
− | |||
− | |||
|} | |} | ||
− | ==Tree | + | ==Tree Tokens== |
These tokens are used only for trees. | These tokens are used only for trees. | ||
Line 254: | Line 217: | ||
|- | |- | ||
− | + | | TREE | |
| | | | ||
− | * [[Material token|material]] | + | * [[Material token|material]] |
− | | Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material | + | | Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material. |
|- | |- | ||
− | | | + | | AUTUMNCOLOR |
| | | | ||
− | + | | Makes the tree turn yellow, orange, and red in Autumn, then lose its leaves in Winter. | |
− | | | ||
|- | |- | ||
− | + | | TREE_TILE | |
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
− | |||
| | | | ||
*tile | *tile | ||
− | | The tile used for | + | | The tile used for the tree on the map. May be a number or a character inside apostrophes. Defaults to 24 (↑). |
|- | |- | ||
− | + | | DEAD_TREE_TILE | |
| | | | ||
*tile | *tile | ||
− | | The tile used for (un)dead trees | + | | The tile used for (un)dead trees of this type. Defaults to 198 (╞). |
|- | |- | ||
− | + | | SAPLING_TILE | |
| | | | ||
*tile | *tile | ||
Line 456: | Line 246: | ||
|- | |- | ||
− | + | | DEAD_SAPLING_TILE | |
| | | | ||
*tile | *tile | ||
Line 462: | Line 252: | ||
|- | |- | ||
− | + | | TREE_COLOR | |
| | | | ||
*foreground | *foreground | ||
Line 470: | Line 260: | ||
|- | |- | ||
− | + | | DEAD_TREE_COLOR | |
| | | | ||
*foreground | *foreground | ||
Line 478: | Line 268: | ||
|- | |- | ||
− | + | | SAPLING_COLOR | |
| | | | ||
*foreground | *foreground | ||
Line 486: | Line 276: | ||
|- | |- | ||
− | + | | DEAD_SAPLING_COLOR | |
| | | | ||
*foreground | *foreground | ||
Line 494: | Line 284: | ||
|- | |- | ||
− | + | | SAPLING_DROWN_LEVEL | |
| | | | ||
*depth | *depth | ||
− | | The | + | | The water depth at which saplings of this tree will drown. Exact behavior is unknown. Defaults to 4. |
|- | |- | ||
− | + | | TREE_DROWN_LEVEL | |
| | | | ||
*depth | *depth | ||
Line 506: | Line 296: | ||
|- | |- | ||
− | + | | 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]". | ||
Line 512: | Line 302: | ||
|} | |} | ||
− | == | + | ==Crop Tokens== |
− | These tokens are used for | + | These tokens are used only for plantable crops and harvestable shrubs. |
{| {{prettytable}} | {| {{prettytable}} | ||
Line 522: | Line 312: | ||
|- | |- | ||
− | | | + | | SPRING |
+ | | | ||
+ | | Allows the plant to grow during spring. | ||
+ | |||
+ | |- | ||
+ | | SUMMER | ||
+ | | | ||
+ | | Allows the plant to grow during summer. | ||
+ | |||
+ | |- | ||
+ | | AUTUMN | ||
| | | | ||
− | | Allows the plant to grow | + | | Allows the plant to grow during autumn. |
− | + | |- | |
+ | | WINTER | ||
+ | | | ||
+ | | Allows the plant to grow during winter. | ||
|- | |- | ||
− | + | | GROWDUR | |
| | | | ||
*time | *time | ||
− | | How long the plant takes to grow | + | | How long the plant takes to grow. Unit hundreds of ticks, See [[Time]]. There are 1008 GROWDUR units in a season. Defaults to 300. |
|- | |- | ||
− | + | | VALUE | |
| | | | ||
*value | *value | ||
− | | Has no | + | | Has no effect as of version 0.34.11. Previously set the value of the harvested plant. |
|- | |- | ||
− | + | | PICKED_TILE | |
| | | | ||
*tile | *tile | ||
− | | The tile used when | + | | The tile used when harvested. May either be a number or letter within apostrophes(confirm?). See [[Main:character table|character table]]. Defaults to 231 (τ). |
|- | |- | ||
− | + | | DEAD_PICKED_TILE | |
| | | | ||
*tile | *tile | ||
− | | The tile used when a plant | + | | The tile used when a harvested plant has wilted. Defaults to 169 (⌐). |
|- | |- | ||
− | + | | SHRUB_TILE | |
| | | | ||
*tile | *tile | ||
− | | | + | | What tile is used for shrubs bearing this plant. Can be either a number or a character inside apostrophes. Defaults to 34 ("). |
|- | |- | ||
− | + | | DEAD_SHRUB_TILE | |
| | | | ||
*tile | *tile | ||
− | | | + | | What tile is used for dead shrubs that once bore this plant. Can be either a number or a character inside apostrophes. Defaults to 34 ("). |
|- | |- | ||
− | + | | CLUSTERSIZE | |
| | | | ||
*size | *size | ||
− | | The maximum stack size collected when gathered via herbalism | + | | The maximum stack size collected when gathered via herbalism. Defaults to 5. |
|- | |- | ||
− | + | | PICKED_COLOR | |
| | | | ||
*foreground | *foreground | ||
*background | *background | ||
*bright | *bright | ||
− | | The color of the plant | + | | The [[color]] of the plant in farms. Defaults to 2:0:0 (dark green). |
|- | |- | ||
− | + | | DEAD_PICKED_COLOR | |
| | | | ||
*foreground | *foreground | ||
*background | *background | ||
*bright | *bright | ||
− | | The [[color]] of the plant when | + | | The [[color]] of the plant when wilted. Defaults to 0:0:1 (dark gray). |
|- | |- | ||
− | + | | SHRUB_COLOR | |
| | | | ||
*foreground | *foreground | ||
*background | *background | ||
*bright | *bright | ||
− | | The [[color]] of | + | | The [[color]] of shrubs bearing this plant. Defaults to 2:0:0 (dark green). |
|- | |- | ||
− | + | | DEAD_SHRUB_COLOR | |
| | | | ||
*foreground | *foreground | ||
*background | *background | ||
*bright | *bright | ||
− | |The [[color]] of | + | |The [[color]] of dead shrubs that bore this plant. Defaults to 6:0:0 (brown). |
|- | |- | ||
− | + | | SHRUB_DROWN_LEVEL | |
| | | | ||
*depth | *depth | ||
− | | The | + | | The water depth at which shrubs of this plant will drown. Exact behavior is unknown. Defaults to 4. |
|- | |- | ||
− | + | | DRINK | |
| | | | ||
* [[Material token|material]] | * [[Material token|material]] | ||
− | | | + | | Permits brewing the plant into [[alcohol]] made of this material. Said material should have [ALCOHOL_PLANT] to permit proper stockpiling. |
|- | |- | ||
− | + | | MILL | |
| | | | ||
* [[Material token|material]] | * [[Material token|material]] | ||
− | | Permits milling the plant at a [[quern]] or [[millstone]] into a powder made of this material | + | | Permits milling the plant at a [[quern]] or [[millstone]] into a powder made of this material. Said material should have [POWDER_MISC_PLANT] to permit proper stockpiling. |
|- | |- | ||
− | + | | THREAD | |
| | | | ||
* [[Material token|material]] | * [[Material token|material]] | ||
− | | Permits processing the plant at a [[farmer's workshop]] to yield threads made of this material | + | | Permits processing the plant at a [[farmer's workshop]] to yield threads made of this material. Said material should have [THREAD_PLANT] to permit proper stockpiling. |
|- | |- | ||
− | + | | SEED | |
| | | | ||
*name | *name | ||
Line 638: | Line 441: | ||
|- | |- | ||
− | | | + | | LEAVES |
+ | | | ||
+ | *name | ||
+ | *name_plural | ||
+ | *tile | ||
+ | *foreground | ||
+ | *background | ||
+ | *bright | ||
+ | *wilt_foreground | ||
+ | *wilt_background | ||
+ | *wilt_bright | ||
+ | *[[Material token|material]] | ||
+ | | Permits processing the plant into a [[bag]] at a [[farmer's workshop]] to yield leaves made of this material and having these properties. Said material should have [LEAF_MAT] to permit proper stockpiling. | ||
+ | |||
+ | |- | ||
+ | | EXTRACT_STILL_VIAL | ||
| | | | ||
* [[Material token|material]] | * [[Material token|material]] | ||
Line 644: | Line 462: | ||
|- | |- | ||
− | + | | EXTRACT_VIAL | |
| | | | ||
*[[Material token|material]] | *[[Material token|material]] | ||
Line 650: | Line 468: | ||
|- | |- | ||
− | + | | EXTRACT_BARREL | |
| | | | ||
* [[Material token|material]] | * [[Material token|material]] | ||
Line 657: | Line 475: | ||
|} | |} | ||
− | ==Grass | + | ==Grass Tokens== |
These tokens are used only for [[grass]]es. | These tokens are used only for [[grass]]es. | ||
Line 667: | Line 485: | ||
|- | |- | ||
− | + | | GRASS | |
| | | | ||
− | | Makes the plant behave as a type of grass. | + | | Makes the plant behave as a type of grass. |
|- | |- | ||
− | + | | GRASS_TILES | |
| | | | ||
*tile | *tile | ||
Line 681: | Line 499: | ||
|- | |- | ||
− | + | | ALT_PERIOD | |
| | | | ||
*period | *period | ||
Line 688: | Line 506: | ||
|- | |- | ||
− | + | | ALT_GRASS_TILES | |
| | | | ||
*tile | *tile | ||
Line 697: | Line 515: | ||
|- | |- | ||
− | + | | GRASS_COLORS | |
| | | | ||
*color 1 (fore:back:bright) | *color 1 (fore:back:bright) | ||
Line 708: | Line 526: | ||
{{Category|Modding}} | {{Category|Modding}} | ||
{{Category|Tokens}} | {{Category|Tokens}} | ||
− |