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.31:Plant token"
Jump to navigation
Jump to search
m (→Grass Tokens) |
|||
(15 intermediate revisions by 5 users not shown) | |||
Line 1: | Line 1: | ||
− | {{quality| | + | {{quality|Exceptional|21:01, 30 March 2011 (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. | ||
Line 40: | Line 40: | ||
*reason | *reason | ||
| 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.") | ||
+ | |||
+ | |- | ||
+ | | MATERIAL | ||
+ | | | ||
+ | *material_name | ||
+ | | Starts defining a new local plant material with the given name and '''no''' properties.{{verify}} | ||
+ | |||
+ | |- | ||
+ | | USE_MATERIAL | ||
+ | | | ||
+ | *material_name | ||
+ | *old_material | ||
+ | | Starts defining a new local plant material with the given name and using the properties of another local plant material. | ||
|- | |- | ||
Line 46: | Line 59: | ||
*material_name | *material_name | ||
*template_name | *template_name | ||
− | | Starts defining a new local plant material with the given name using the specified template | + | | Starts defining a new local plant material with the given name and using the properties of the specified material template. |
|- | |- | ||
| BASIC_MAT | | BASIC_MAT | ||
| | | | ||
− | * | + | * [[Material token|material]] |
− | | Sets the basic | + | | 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. |
|} | |} | ||
Line 69: | Line 82: | ||
*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 [[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). |
|- | |- | ||
Line 90: | Line 103: | ||
| | | | ||
*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. Defaults to 50. |
|- | |- | ||
Line 100: | Line 113: | ||
| DRY | | DRY | ||
| | | | ||
− | | Allows the plant to | + | | Allows the plant to grow away from water features. |
|- | |- | ||
Line 106: | Line 119: | ||
| | | | ||
*biome | *biome | ||
− | | What | + | | What [[biome token|biome]] this plant appears in. |
|} | |} | ||
Line 122: | Line 135: | ||
| TREE | | TREE | ||
| | | | ||
− | * | + | * [[Material token|material]] |
− | | Makes the plant into a | + | | Makes the plant into a [[tree]]. Cutting down the tree will yield logs made of this material. |
|- | |- | ||
Line 134: | Line 147: | ||
| | | | ||
*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. Defaults to 24 (↑). |
|- | |- | ||
Line 140: | Line 153: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used for (un)dead trees of this type. | + | | The tile used for (un)dead trees of this type. Defaults to 198 (╞). |
|- | |- | ||
Line 146: | Line 159: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used for saplings of this tree. | + | | The tile used for saplings of this tree. Defaults to 231 (τ). |
|- | |- | ||
Line 152: | Line 165: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used for dead saplings of this tree. | + | | The tile used for dead saplings of this tree. Defaults to 231 (τ). |
|- | |- | ||
Line 160: | Line 173: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The [[color]] of the tree on the map. Defaults to 2:0:0 (dark green). |
|- | |- | ||
Line 168: | Line 181: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The [[color]] of the tree on the map when (un)dead. Defaults to 0:0:1 (dark gray). |
|- | |- | ||
Line 176: | Line 189: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The [[color]] of saplings of this tree. Defaults to 2:0:0 (dark green). |
|- | |- | ||
Line 184: | Line 197: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The [[color]] of dead saplings of this tree. Defaults to 0:0:1 (dark gray). |
|- | |- | ||
Line 190: | Line 203: | ||
| | | | ||
*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. Defaults to 4. |
|- | |- | ||
Line 196: | Line 209: | ||
| | | | ||
*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. Defaults to 7. |
|- | |- | ||
| 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]". |
|} | |} | ||
Line 238: | Line 251: | ||
| | | | ||
*time | *time | ||
− | | How long the plant takes to grow. See | + | | How long the plant takes to grow. See [[Time]]. Defaults to 300. There are 1008 GROWDUR units in a season. |
|- | |- | ||
Line 244: | Line 257: | ||
| | | | ||
*value | *value | ||
− | | Value of harvested plant. | + | | Value of harvested plant (default 1). Appears to have no effect in version 0.31. |
|- | |- | ||
Line 250: | Line 263: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used when harvested. May either be a number or letter within apostrophes(confirm?) | + | | The tile used when harvested. May either be a number or letter within apostrophes(confirm?). See [[Main:character table|character table]]. Defaults to 231 (τ). |
|- | |- | ||
Line 256: | Line 269: | ||
| | | | ||
*tile | *tile | ||
− | | The tile used when a harvested plant has wilted. | + | | The tile used when a harvested plant has wilted. Defaults to 169 (⌐). |
|- | |- | ||
Line 262: | Line 275: | ||
| | | | ||
*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. Defaults to 34 ("). |
|- | |- | ||
Line 268: | Line 281: | ||
| | | | ||
*tile | *tile | ||
− | | What tile is used | + | | 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 ("). |
|- | |- | ||
Line 274: | Line 287: | ||
| | | | ||
*size | *size | ||
− | | The maximum stack size collected when gathered | + | | The maximum stack size collected when gathered via herbalism. Defaults to 5. |
|- | |- | ||
Line 282: | Line 295: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The [[color]] of the plant in farms. Defaults to 2:0:0 (dark green). |
|- | |- | ||
Line 290: | Line 303: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The [[color]] of the plant when wilted. Defaults to 0:0:1 (dark gray). |
|- | |- | ||
Line 298: | Line 311: | ||
*background | *background | ||
*bright | *bright | ||
− | | The | + | | The [[color]] of shrubs bearing this plant. Defaults to 2:0:0 (dark green). |
|- | |- | ||
Line 306: | Line 319: | ||
*background | *background | ||
*bright | *bright | ||
− | |The | + | |The [[color]] of dead shrubs that bore this plant. Defaults to 6:0:0 (brown). |
|- | |- | ||
Line 312: | Line 325: | ||
| | | | ||
*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. Defaults to 4. |
|- | |- | ||
| DRINK | | DRINK | ||
| | | | ||
− | * | + | * [[Material token|material]] |
− | | Permits brewing the plant into | + | | Permits brewing the plant into [[alcohol]] made of this material. Said material should have [ALCOHOL_PLANT] to permit proper stockpiling. |
|- | |- | ||
| MILL | | MILL | ||
| | | | ||
− | * | + | * [[Material token|material]] |
− | | Permits milling the plant at a | + | | 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 | | THREAD | ||
| | | | ||
− | * | + | * [[Material token|material]] |
− | | Permits processing the plant at a | + | | 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. |
|- | |- | ||
Line 340: | Line 353: | ||
*background | *background | ||
*bright | *bright | ||
− | * | + | *[[Material token|material]] |
| Causes the plant to yield plantable seeds made of this material and having these properties. Said material should have [SEED_MAT] to permit proper stockpiling. | | Causes the plant to yield plantable seeds made of this material and having these properties. Said material should have [SEED_MAT] to permit proper stockpiling. | ||
Line 355: | Line 368: | ||
*wilt_background | *wilt_background | ||
*wilt_bright | *wilt_bright | ||
− | * | + | *[[Material token|material]] |
− | | Permits processing the plant into a | + | | 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 | | EXTRACT_STILL_VIAL | ||
| | | | ||
− | * | + | * [[Material token|material]] |
− | | Permits processing the plant into a | + | | Permits processing the plant into a [[vial]] at a [[still]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK]. |
|- | |- | ||
| EXTRACT_VIAL | | EXTRACT_VIAL | ||
| | | | ||
− | * | + | *[[Material token|material]] |
− | | Permits processing the plant into a | + | | Permits processing the plant into a [[vial]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK]. |
|- | |- | ||
| EXTRACT_BARREL | | EXTRACT_BARREL | ||
| | | | ||
− | * | + | * [[Material token|material]] |
− | | Permits processing the plant into a | + | | Permits processing the plant into a [[barrel]] at a [[farmer's workshop]] to yield extract made of this material. Said material should have [EXTRACT_STORAGE:BARREL]. |
|} | |} | ||
==Grass Tokens== | ==Grass Tokens== | ||
− | These tokens are used only for | + | These tokens are used only for [[grass]]es. |
{| {{prettytable}} | {| {{prettytable}} | ||
Line 390: | Line 403: | ||
| GRASS | | GRASS | ||
| | | | ||
− | | | + | | Makes the plant behave as a type of grass. |
|- | |- | ||
Line 399: | Line 412: | ||
*tile | *tile | ||
*tile | *tile | ||
− | | | + | | Specifies the 4 tiles used to represent grass of this type. If VARIED_GROUND_TILES is disabled in d_init.txt, these are seemingly ignored. Defaults to 46:44:96:39 (.,`'). |
|- | |- | ||
Line 405: | Line 418: | ||
| | | | ||
*period | *period | ||
− | * | + | *offset |
− | | How often the grass switches between alternate tiles. | + | | How often the grass switches between its main tiles and alternate tiles. The "period" value determines how quickly (in frames) the grass animates, and the "offset" value specifies how much of that time is spent displaying the alternate tiles. If the "offset" value is greater than or equal to the "period" value, the grass will only display using the alternate tiles.{{verify}} Defaults to 0:0. |
|- | |- | ||
Line 415: | Line 428: | ||
*tile | *tile | ||
*tile | *tile | ||
− | | | + | | When used with ALT_PERIOD, specifies the 4 alternate tiles used to represent grass of this type. Defaults to 46:44:96:39 (.,`'). Dead grass does not animate. |
|- | |- | ||
Line 424: | Line 437: | ||
*dry color (fore:back:bright) | *dry color (fore:back:bright) | ||
*dead color (fore:back:bright) | *dead color (fore:back:bright) | ||
− | | | + | | Specifies the color of this grass. Defaults to 2:0:1:2:0:0:6:0:1:6:0:0 (light green, dark green, yellow, brown). |
|} | |} | ||
{{Category|Modding}} | {{Category|Modding}} | ||
{{Category|Tokens}} | {{Category|Tokens}} |
Latest revision as of 03:12, 30 December 2011
This article is about an older version of DF. |
The default plants are stored in the plant_standard.txt file, while grasses are stored in plant_grasses.txt.
Basic Tokens[edit]
These tokens are specified for all plants and define their most basic characteristics.
Token | Arguments | Description |
---|---|---|
NAME |
|
The singular form of the plants name as seen in game. |
NAME_PLURAL |
|
The plural form of the plants name as seen in game. |
ADJ |
|
The word or phrase used to describe items made from this plant. |
ALL_NAMES |
|
Sets the NAME, NAME_PLURAL, and ADJ to the specified string. |
PREFSTRING |
|
What dwarves can like this object for (e.g. "Urist likes plump helmets for their rounded tops.") |
MATERIAL |
|
Starts defining a new local plant material with the given name and no properties.[Verify] |
USE_MATERIAL |
|
Starts defining a new local plant material with the given name and using the properties of another local plant material. |
USE_MATERIAL_TEMPLATE |
|
Starts defining a new local plant material with the given name and using the properties of the specified material template. |
BASIC_MAT | 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 Tokens[edit]
These tokens, also applicable to all plants, specify where the plants grow.
Token | Arguments | Description |
---|---|---|
UNDERGROUND_DEPTH |
|
Designates the highest and lowest cavern levels that the plant can appear in if its 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]. | |
EVIL | 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). | |
FREQUENCY |
|
How frequently this plant is generated in a particular area. Defaults to 50. |
WET | Allows the plant to grow near water features. | |
DRY | Allows the plant to grow away from water features. | |
BIOME |
|
What biome this plant appears in. |
Tree Tokens[edit]
These tokens are used only for trees.
Token | Arguments | Description |
---|---|---|
TREE | 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 |
|
The tile used for the tree on the map. May be a number or a character inside apostrophes. Defaults to 24 (↑). |
DEAD_TREE_TILE |
|
The tile used for (un)dead trees of this type. Defaults to 198 (╞). |
SAPLING_TILE |
|
The tile used for saplings of this tree. Defaults to 231 (τ). |
DEAD_SAPLING_TILE |
|
The tile used for dead saplings of this tree. Defaults to 231 (τ). |
TREE_COLOR |
|
The color of the tree on the map. Defaults to 2:0:0 (dark green). |
DEAD_TREE_COLOR |
|
The color of the tree on the map when (un)dead. Defaults to 0:0:1 (dark gray). |
SAPLING_COLOR |
|
The color of saplings of this tree. Defaults to 2:0:0 (dark green). |
DEAD_SAPLING_COLOR |
|
The color of dead saplings of this tree. Defaults to 0:0:1 (dark gray). |
SAPLING_DROWN_LEVEL |
|
The water depth at which saplings of this tree will drown. Exact behavior is unknown. Defaults to 4. |
TREE_DROWN_LEVEL |
|
The water depth at which this tree will drown. Exact behavior is unknown. Defaults to 7. |
SAPLING | Makes young versions of the tree be called "[tree name] sapling"; otherwise, they are called "young [tree name]". |
Crop Tokens[edit]
These tokens are used only for plantable crops and harvestable shrubs.
Token | Arguments | 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. | |
GROWDUR |
|
How long the plant takes to grow. See Time. Defaults to 300. There are 1008 GROWDUR units in a season. |
VALUE |
|
Value of harvested plant (default 1). Appears to have no effect in version 0.31. |
PICKED_TILE |
|
The tile used when harvested. May either be a number or letter within apostrophes(confirm?). See character table. Defaults to 231 (τ). |
DEAD_PICKED_TILE |
|
The tile used when a harvested plant has wilted. Defaults to 169 (⌐). |
SHRUB_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 |
|
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 |
|
The maximum stack size collected when gathered via herbalism. Defaults to 5. |
PICKED_COLOR |
|
The color of the plant in farms. Defaults to 2:0:0 (dark green). |
DEAD_PICKED_COLOR |
|
The color of the plant when wilted. Defaults to 0:0:1 (dark gray). |
SHRUB_COLOR |
|
The color of shrubs bearing this plant. Defaults to 2:0:0 (dark green). |
DEAD_SHRUB_COLOR |
|
The color of dead shrubs that bore this plant. Defaults to 6:0:0 (brown). |
SHRUB_DROWN_LEVEL |
|
The water depth at which shrubs of this plant will drown. Exact behavior is unknown. Defaults to 4. |
DRINK | Permits brewing the plant into alcohol made of this material. Said material should have [ALCOHOL_PLANT] to permit proper stockpiling. | |
MILL | 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 | 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 |
|
Causes the plant to yield plantable seeds made of this material and having these properties. Said material should have [SEED_MAT] to permit proper stockpiling. |
LEAVES |
|
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 | Permits processing the plant into a vial at a still to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK]. | |
EXTRACT_VIAL | Permits processing the plant into a vial at a farmer's workshop to yield extract made of this material. Said material should have [EXTRACT_STORAGE:FLASK]. | |
EXTRACT_BARREL | Permits processing the plant into a barrel at a farmer's workshop to yield extract made of this material. Said material should have [EXTRACT_STORAGE:BARREL]. |
Grass Tokens[edit]
These tokens are used only for grasses.
Token | Arguments | Description |
---|---|---|
GRASS | Makes the plant behave as a type of grass. | |
GRASS_TILES |
|
Specifies the 4 tiles used to represent grass of this type. If VARIED_GROUND_TILES is disabled in d_init.txt, these are seemingly ignored. Defaults to 46:44:96:39 (.,`'). |
ALT_PERIOD |
|
How often the grass switches between its main tiles and alternate tiles. The "period" value determines how quickly (in frames) the grass animates, and the "offset" value specifies how much of that time is spent displaying the alternate tiles. If the "offset" value is greater than or equal to the "period" value, the grass will only display using the alternate tiles.[Verify] Defaults to 0:0. |
ALT_GRASS_TILES |
|
When used with ALT_PERIOD, specifies the 4 alternate tiles used to represent grass of this type. Defaults to 46:44:96:39 (.,`'). Dead grass does not animate. |
GRASS_COLORS |
|
Specifies the color of this grass. Defaults to 2:0:1:2:0:0:6:0:1:6:0:0 (light green, dark green, yellow, brown). |