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.34:Building 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.34"). 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|Superior}}{{av}} | {{quality|Superior}}{{av}} | ||
− | + | These tokens control the functionality of custom buildings. | |
All custom buildings are defined as objects of type BUILDING_WORKSHOP or BUILDING_FURNACE; workshops show up in the {{K|b}}-{{K|w}} menu, while furnaces show up in the {{K|b}}-{{K|e}} menu. | All custom buildings are defined as objects of type BUILDING_WORKSHOP or BUILDING_FURNACE; workshops show up in the {{K|b}}-{{K|w}} menu, while furnaces show up in the {{K|b}}-{{K|e}} menu. | ||
Line 16: | Line 16: | ||
|- | |- | ||
− | + | | NAME | |
| name | | name | ||
| The name of the custom building. | | The name of the custom building. | ||
|- | |- | ||
− | + | | NAME_COLOR | |
| [[Color#Modding_color|fg:bg:bright]] | | [[Color#Modding_color|fg:bg:bright]] | ||
| The color of the building's name when {{K|q}}uerying it. Seemingly ignored for furnaces, which are hardcoded to 4:0:1. | | The color of the building's name when {{K|q}}uerying it. Seemingly ignored for furnaces, which are hardcoded to 4:0:1. | ||
|- | |- | ||
− | + | | DIM | |
| width:height | | width:height | ||
| The size of the custom building, in number of tiles. Defaults to 3:3. Maximum possible size is 31x31. | | The size of the custom building, in number of tiles. Defaults to 3:3. Maximum possible size is 31x31. | ||
|- | |- | ||
− | + | | WORK_LOCATION | |
| x:y | | x:y | ||
| The tile (1:1 for upper-left) in which dwarves will stand when they are performing tasks. Defaults to 3:3 (bottom-right). | | The tile (1:1 for upper-left) in which dwarves will stand when they are performing tasks. Defaults to 3:3 (bottom-right). | ||
|- | |- | ||
− | + | | BUILD_LABOR | |
| [[labor token]] | | [[labor token]] | ||
| The labor required to construct the custom building. If multiple BUILD_LABOR tokens are specified, then any of the indicated labors can be used to construct the building; if none are specified, then no labors are required.<br />For furnaces, this labor does not come into play until after the workshop has been designed by an [[architect]]. | | The labor required to construct the custom building. If multiple BUILD_LABOR tokens are specified, then any of the indicated labors can be used to construct the building; if none are specified, then no labors are required.<br />For furnaces, this labor does not come into play until after the workshop has been designed by an [[architect]]. | ||
|- | |- | ||
− | + | | BUILD_KEY | |
| key token | | key token | ||
| The shortcut key used in the Build menu for selecting the custom building. | | The shortcut key used in the Build menu for selecting the custom building. | ||
|- | |- | ||
− | + | | BLOCK | |
| | | | ||
* row | * row | ||
Line 53: | Line 53: | ||
|- | |- | ||
− | + | | TILE | |
| | | | ||
* stage | * stage | ||
Line 61: | Line 61: | ||
|- | |- | ||
− | + | | COLOR | |
| | | | ||
* stage | * stage | ||
Line 69: | Line 69: | ||
|- | |- | ||
− | + | | BUILD_ITEM | |
| | | | ||
* quantity | * quantity | ||
Line 77: | Line 77: | ||
|- | |- | ||
− | + | | NEEDS_MAGMA | |
| | | | ||
| Specifies that one of the building's tiles (other than the WORK_LOCATION) must be hanging over [[magma]] in order for the building to function. Buildings with this token also ignore the [FUEL] token in their reactions. | | Specifies that one of the building's tiles (other than the WORK_LOCATION) must be hanging over [[magma]] in order for the building to function. Buildings with this token also ignore the [FUEL] token in their reactions. | ||
Line 90: | Line 90: | ||
! Meaning | ! Meaning | ||
|- | |- | ||
− | | [ | + | | [REACTION_CLASS:X] |
| Item's material has a [REACTION_CLASS] token with the appropriate ID. | | Item's material has a [REACTION_CLASS] token with the appropriate ID. | ||
|- | |- | ||
− | | [ | + | | [HAS_MATERIAL_REACTION_PRODUCT:X] |
| Item's material has a [MATERIAL_REACTION_PRODUCT] token with the appropriate ID. | | Item's material has a [MATERIAL_REACTION_PRODUCT] token with the appropriate ID. | ||
|- | |- | ||
− | | [ | + | | [UNROTTEN] |
| Item must not be rotten, mainly for organic materials. | | Item must not be rotten, mainly for organic materials. | ||
|- | |- | ||
− | | [ | + | | [CONTAINS_LYE] |
| Item must be a BARREL or TOOL which contains at least one item of type LIQUID_MISC made of LYE. | | Item must be a BARREL or TOOL which contains at least one item of type LIQUID_MISC made of LYE. | ||
|- | |- | ||
− | | [ | + | | [POTASHABLE] |
| Alias for [CONTAINS_LYE]. | | Alias for [CONTAINS_LYE]. | ||
|- | |- | ||
− | | [ | + | | [NOT_WEB] |
| Item must be collected (to distinguish silk thread from webs). Only makes sense for items of type THREAD. | | Item must be collected (to distinguish silk thread from webs). Only makes sense for items of type THREAD. | ||
|- | |- | ||
− | | [ | + | | [WEB_ONLY] |
| Item must be undisturbed (to distinguish silk thread from webs). Only makes sense for items of type THREAD. | | Item must be undisturbed (to distinguish silk thread from webs). Only makes sense for items of type THREAD. | ||
|- | |- | ||
− | | [ | + | | [EMPTY] |
| If the item is a container, it must be empty. | | If the item is a container, it must be empty. | ||
|- | |- | ||
− | | [ | + | | [NOT_CONTAIN_BARREL_ITEM] |
| If the item is a container, it must not contain [[lye]] or [[milk]]. Not necessary if specifying [EMPTY]. | | If the item is a container, it must not contain [[lye]] or [[milk]]. Not necessary if specifying [EMPTY]. | ||
|- | |- | ||
− | | [ | + | | [BAG] |
| Item must be a bag - that is, a BOX made of plant fiber, silk, yarn, or leather. | | Item must be a bag - that is, a BOX made of plant fiber, silk, yarn, or leather. | ||
|- | |- | ||
− | | [ | + | | [GLASS_MATERIAL] |
| Item material must have the [IS_GLASS] token. All 3 types of [[glass]] have this token hardcoded. | | Item material must have the [IS_GLASS] token. All 3 types of [[glass]] have this token hardcoded. | ||
|- | |- | ||
− | | [ | + | | [BUILDMAT] |
| Item must be a general [[building material]] - BAR, BLOCKS, BOULDER, or WOOD. | | Item must be a general [[building material]] - BAR, BLOCKS, BOULDER, or WOOD. | ||
|- | |- | ||
− | | [ | + | | [FIRE_BUILD_SAFE] |
| Item material must be stable at temperatures below 11000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe. | | Item material must be stable at temperatures below 11000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe. | ||
|- | |- | ||
− | | [ | + | | [MAGMA_BUILD_SAFE] |
| Item material must be stable at temperatures below 12000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe. | | Item material must be stable at temperatures below 12000. Only works with items of type BAR, BLOCKS, BOULDER, WOOD, and ANVIL - all others are considered unsafe. | ||
|- | |- | ||
− | | [ | + | | [CAN_USE_ARTIFACT] |
| Item can be an Artifact. | | Item can be an Artifact. | ||
|- | |- | ||
− | | [ | + | | [WORTHLESS_STONE_ONLY] |
| Item material must be non-[[economic]]. | | Item material must be non-[[economic]]. | ||
|- | |- | ||
− | | [ | + | | [ANY_PLANT_MATERIAL] |
| Item material must be subordinate to a PLANT object. | | Item material must be subordinate to a PLANT object. | ||
|- | |- | ||
− | | [ | + | | [ANY_SILK_MATERIAL] |
| Item material must have the [SILK] token. | | Item material must have the [SILK] token. | ||
|- | |- | ||
− | | [ | + | | [ANY_YARN_MATERIAL] |
| Item material must have the [YARN] token. | | Item material must have the [YARN] token. | ||
|- | |- | ||
− | | [ | + | | [ANY_SOAP_MATERIAL] |
| Item material must have the [SOAP] token. | | Item material must have the [SOAP] token. | ||
|- | |- | ||
− | | [ | + | | [ANY_LEATHER_MATERIAL] |
| Item material must have the [LEATHER] token. | | Item material must have the [LEATHER] token. | ||
|- | |- | ||
− | | [ | + | | [ANY_BONE_MATERIAL] |
| Item material must have the [BONE] token. | | Item material must have the [BONE] token. | ||
|- | |- | ||
− | | [ | + | | [ANY_STRAND_TISSUE] |
| Item is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT]. | | Item is made of a tissue having [TISSUE_SHAPE:STRANDS], intended for matching hair and wool. Must be used with [USE_BODY_COMPONENT]. | ||
|- | |- | ||
− | | [ | + | | [ANY_SHELL_MATERIAL] |
| Item material must have the [SHELL] token. | | Item material must have the [SHELL] token. | ||
|- | |- | ||
− | | [ | + | | [ANY_TOOTH_MATERIAL] |
| Item material must have the [TOOTH] token. | | Item material must have the [TOOTH] token. | ||
|- | |- | ||
− | | [ | + | | [ANY_HORN_MATERIAL] |
| Item material must have the [HORN] token. | | Item material must have the [HORN] token. | ||
|- | |- | ||
− | | [ | + | | [ANY_PEARL_MATERIAL] |
| Item material must have the [PEARL] token. | | Item material must have the [PEARL] token. | ||
|- | |- | ||
− | | [ | + | | [USE_BODY_COMPONENT] |
| Item must be a body part (CORPSE or CORPSEPIECE). | | Item must be a body part (CORPSE or CORPSEPIECE). | ||
|- | |- | ||
− | | [ | + | | [NO_EDGE_ALLOWED] |
| Item must not have an edge - excludes sharp stones (produced using knapping) and most types of weapon/ammo. | | Item must not have an edge - excludes sharp stones (produced using knapping) and most types of weapon/ammo. | ||
|- | |- | ||
− | | [ | + | | [NOT_ENGRAVED] |
| Item has not been engraved (excludes memorial slabs). | | Item has not been engraved (excludes memorial slabs). | ||
|- | |- | ||
− | | [ | + | | [METAL_ORE:X] |
| Item material must be an ore of the specified metal. | | Item material must be an ore of the specified metal. | ||
|- | |- | ||
− | | [ | + | | [MIN_DIMENSION:X] |
| Item's dimension must be at least this large. The item type must be BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, or CLOTH for this to work. | | Item's dimension must be at least this large. The item type must be BAR, POWDER_MISC, LIQUID_MISC, DRINK, THREAD, or CLOTH for this to work. | ||
|- | |- | ||
− | | [ | + | | [HAS_TOOL_USE:X] |
| Item must be a [[tool]] with the specific TOOL_USE value. The item type must be TOOL:NONE for this to make any sense. | | Item must be a [[tool]] with the specific TOOL_USE value. The item type must be TOOL:NONE for this to make any sense. | ||
|} | |} |