- 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.
Difference between revisions of "v0.34:Beekeeping industry"
m |
|||
| (32 intermediate revisions by 21 users not shown) | |||
| Line 1: | Line 1: | ||
| − | {{quality| | + | {{quality|Masterwork|18:20, 8 July 2013 (UTC)}}{{av}} |
{{buggy}} | {{buggy}} | ||
| − | |||
| − | + | [[Image:Beekeeping Industry Flowchart.png|right|400px]] | |
| + | The '''beekeeping industry''' is an agricultural process that allows a fortress to produce auxiliary food ([[honey]], [[royal jelly]]), drink ([[mead]]), and craftable materials ([[wax]]) by farming [[honey bee]]s. | ||
| − | + | == Basic setup == | |
| + | Before you can have a beekeeping industry you must logically have bees. There are two types of bees in the game: [[honey bee]]s, which (true to their name) can be used for beekeeping, and [[bumblebee]]s, which cannot currently be so applied (this may or [http://www.bay12games.com/dwarves/mantisbt/view.php?id=4003#c15306 may not] change in the future). Honey bee colonies appear in any [[Freezing#Climate|non-freezing]] [[biome]] in some number, but are not necessarily guaranteed to appear in your fortress [[surroundings]] if you [[embark]] on such a biome, especially if a large part of your embark site is incompatible. | ||
| − | + | If you do not have any honey bee colonies on your screen, then you obviously cannot have a beekeeping industry, at least not until a honey bee colony spawns. Honey bee colonies are one of a number of "colony" type tile features, and it is possible that all of your "slots" are occupied by other colonies. If no honey bee colony is able to spawn due to this issue, you can build [[farm plot]]s over existing colonies to "free up" space for honey bee ones, or [[dirt road]]s in the case of colonies on the edge of the map. <s>Whether or not this is worth the effort is a different story.</s> It is very much worth the effort for the glorious mead. | |
| − | + | Once you are sure you have a colony of bees, the next step is to create an artificial [[hive]], either from [[stone]] or [[wood]] at a [[craftsdwarf's workshop]], from [[ceramic]]s at a [[kiln]], from [[glass]] at a [[glass furnace]], or from [[metal]] at a [[metalsmith's forge]]. Hives are [[tool]]s stored in the [[finished goods]] [[stockpile]], and can be {{k|b}}uilt by a [[beekeeper]] using the {{k|Alt}}+{{k|h}} [[hotkeys|hotkey]]. In order to be productive, a hive must be constructed on or adjacent to a [[tile]] that is [[Tile attributes|above ground]]. Dwarves will install colonies in hives installed underground, and such colonies will grow and allow splitting off new colonies, but they will not produce honey. | |
| − | |||
| − | |||
| − | + | Once a hive is installed, it is automatically toggled to "install colony when ready", which will generate an "Install Colony in Hive" job onto the [[manager|job list]], unless the player specifies otherwise (with {{K|q}}-{{K|c}}). Hives can have colonies installed into them from preexisting wild colonies or from hives that are ready to split (more on that later); the beekeeper will walk to the location of the colony, pick it up and bring it to the built hive. Again, if there are no wild honey bee colonies on your map, no colony can be installed until there is one. It may be more sensible to build a single hive and then see if a beekeeper can find a colony to fill it with rather than go searching for one beforehand if it is uncertain whether or not there are any honey bees on the map. It will take a while until it is certain that the beekeeper does not have a colony available to collect and isn't just doing other stuff; if there is no available colony, the "install colony in hive" job will not cancel but rather stay "inactive" indefinitely. | |
| − | + | == Hive management == | |
| + | Once there is a colony (of 10 000 to 20 000 bees) in your hive, you have two options: | ||
| + | * You may toggle the hive (using {{K|q}}-{{K|g}}) so that the product is not automatically gathered. This will prevent your dwarves from collecting the products but at the same time preserves the colony, which will keep growing, so that new colonies can be split off it regularly and placed in additional hives. Assuming you have spare hives built and available, this is the option you set your hives to in order to grow them. | ||
| + | * Or you can choose to have the hive harvested, causing a beekeeper to approach the hive about nine months later to transfer the [[royal jelly]] into an empty [[jug]] and to make the [[honeycomb]] available, so that it can be moved to storage. This is the production option; the hives will produce things for you at a steady rate, but the harvesting destroys the colony in the hive; it can then be repopulated by a colony ready for splitting. | ||
| − | + | Note: The colony in a hive set to "collect products" will still grow, but splitting off a new colony only becomes possible shortly before the hive is ripe for harvesting, and harvesting will always destroy the entire colony, whether it is ready to split or not. Consequently, dwarves will sometimes replenish hives from colonies set to "collect", but not reliably. To sustain a beekeeping industry without tedious micro-management, a healthy number of "breeding" hives are needed which are not allowed for collection. | |
| − | + | Beekeeping as an industry is currently extremely buggy, involves a lot of micromanagement on the supply side, and doesn't produce as many products as it really should to be worthwhile. Most annoyingly, there is a bug where multiple empty hives will generate conflicting jobs targeting the same colony which reliably get beekeepers stuck {{bug|3981}}. Consequently, a beekeeping industry must be grown quite slowly and measures must be taken to reduce the number of hives which are empty at the same time, like limiting the number of dwarves who may perform the beekeeping labor. Additionally, there is no way to tell beekeepers to prioritize fortress hives over wild ones for colony installation (except perhaps by using a [[burrow]]) - they will often wander far out into the map without even the [[ambusher]]'s [[crossbow]]s for self-protection. For these reasons the industry is typically seen as a novelty, at least until the kinks are ironed out. | |
| − | ==Examining hives== | + | ===Examining hives=== |
Interacting with a hive ({{K|q}}) will show: | Interacting with a hive ({{K|q}}) will show: | ||
| Line 30: | Line 32: | ||
If interacting with the hive shows {{DFtext|Not ready to be split|7:0}} then it might mean it has a colony too small to be split, or that it has no colony at all. To see if a hive has a colony, uses "view items in buildings" ({{K|t}}), which will show an item [[stack]] of thousands of bees if there's a colony. {{K|t}} will also show if the hive has a honey comb or lump of royal jelly. | If interacting with the hive shows {{DFtext|Not ready to be split|7:0}} then it might mean it has a colony too small to be split, or that it has no colony at all. To see if a hive has a colony, uses "view items in buildings" ({{K|t}}), which will show an item [[stack]] of thousands of bees if there's a colony. {{K|t}} will also show if the hive has a honey comb or lump of royal jelly. | ||
| − | ==Artificial hive limits== | + | ===Artificial hive limits=== |
| − | + | If your fortress has more than 40 inhabited artificial hives, but less than 60, then interacting with a hive ({{K|q}}) will show: | |
| − | |||
| − | If your fortress has | ||
{{Gametext|Too many hives|6:1}} | {{Gametext|Too many hives|6:1}} | ||
| Line 40: | Line 40: | ||
Presumably this means that existing artificial hives grow more slowly. {{Verify}} | Presumably this means that existing artificial hives grow more slowly. {{Verify}} | ||
| − | Having more than | + | Having more than 40 or more than 60 inhabited artificial hives does not appear to prevent new wild hives from appearing, and these can still be transferred to empty artificial hives. |
If you fortress has 60 or more inhabited artificial hives, then interacting with a hive ({{K|q}}) will show: | If you fortress has 60 or more inhabited artificial hives, then interacting with a hive ({{K|q}}) will show: | ||
| Line 47: | Line 47: | ||
{{Gametext|* No output|4:1}} | {{Gametext|* No output|4:1}} | ||
| − | Presumably this means that existing artificial hives no longer grow, or that grown hives can't be split. | + | Presumably this means that existing artificial hives no longer grow, or that grown hives can't be split. |
| + | |||
| + | ==Products== | ||
| + | Harvesting a hive produces two items, one of which is a lump of [[royal jelly]], which must be collected in an empty [[jug]], an item used only by the beekeeping industry and in the production of [[quarry bush|rock nut oil]]. Royal jelly is a liquid [[food]] item, and so can only be used in [[cook]]ing [[prepared meal]]s, and only if another, solid food item is included in the meal. Every harvest will result in a single jug filled with jelly. The other item produced by a harvest job is the [[honeycomb]], which is a little more complicated to process: it is considered a [[wax]] [[tool]] and doesn't have any direct application, but when [[presser|pressed]] at a [[screw press]] produces two products, one jug filled with [[honey]] and a [[wax]] press cake, both of which are handled as food items for storage. | ||
| + | |||
| + | Harvesting a hive requires a jug (ae. you cannot harvest the honeycomb alone), as does pressing the honeycomb; carrying the products to their destination [[stockpile]] or production point is considered an [[item hauling]] job unrelated with the beekeeping labor, so after being harvested by a beekeeper they will be left at the foot of the hive until someone comes by to haul them off, unless the beekeeper has item hauling enabled themselves (in which case they'll send it to nearest applicable stockpiles). The same is true of honeycomb pressing. | ||
| − | + | [[Honey]] can be cooked into a meal or brought to a [[still]] and processed with a [[barrel]] or [[large pot]] into mead, the only non plant-based alcoholic drink in the game. [[Wax]], meanwhile, can be processed into various wax [[craft]]s by a [[wax worker]] at a [[craftsdwarf's workshop]]. Wax crafts are not particularly valuable - they have a [[material value]] of one, the same as [[wood]] and non-[[flux]] [[stone]] - but they're something. | |
| − | |||
==Bugs== | ==Bugs== | ||
| − | *Dwarves have a hard time splitting hives. | + | * Dwarves have a hard time splitting hives. They also have a hard time keeping track of wild colonies of bees that die out.{{bug|3981}}<br/>Having the beekeeping labor enabled on only one dwarf at a time may alleviate these problems. The problem is caused by multiple empty hives targeting the same colony for installing. The most effective troubleshooting method is to look up the job of a 'stuck' beekeeper in the job list, then zooming to the building - the hive which issued the job. Toggling the 'c' option (install colony) off, letting the game run for a few seconds and then switching the option back on will usually clear the faulty job and issue a new 'install colony in hive' job with a legal target colony. Removing and rebuilding empty hives usually fixes beekeepers stuck trying to install colonies, but is much more time-consuming than simply toggling the install option. |
| − | + | * Filled [[Jug]]s may be stored in [[bin]]s as [[finished goods]], preventing the use of their contents in the food industry.{{bug|4229}} | |
| + | * Stacks of [[honey bee]]s in their hives can be [[wear|mangled]] by [[fire|forest fires]], but will still live, resulting in some odd descriptions.{{bug|4101}} | ||
| + | * [[Screw press]]es built in [[burrow]]s may not allow the "press [[honeycomb]]" job to be added directly; adding the job via the [[manager]] interface will get the work started. This seems to be related to their distance from applicable materials.{{bug|434}} | ||
{{Category|Guides}} | {{Category|Guides}} | ||
{{Category|Industry}} | {{Category|Industry}} | ||
| + | {{Industry}} | ||
Latest revision as of 20:21, 16 June 2024
| This article is about an older version of DF. |
 | This feature has one or more outstanding bugs. Please view the Bugs section for details. |
The beekeeping industry is an agricultural process that allows a fortress to produce auxiliary food (honey, royal jelly), drink (mead), and craftable materials (wax) by farming honey bees.
Basic setup[edit]
Before you can have a beekeeping industry you must logically have bees. There are two types of bees in the game: honey bees, which (true to their name) can be used for beekeeping, and bumblebees, which cannot currently be so applied (this may or may not change in the future). Honey bee colonies appear in any non-freezing biome in some number, but are not necessarily guaranteed to appear in your fortress surroundings if you embark on such a biome, especially if a large part of your embark site is incompatible.
If you do not have any honey bee colonies on your screen, then you obviously cannot have a beekeeping industry, at least not until a honey bee colony spawns. Honey bee colonies are one of a number of "colony" type tile features, and it is possible that all of your "slots" are occupied by other colonies. If no honey bee colony is able to spawn due to this issue, you can build farm plots over existing colonies to "free up" space for honey bee ones, or dirt roads in the case of colonies on the edge of the map. Whether or not this is worth the effort is a different story. It is very much worth the effort for the glorious mead.
Once you are sure you have a colony of bees, the next step is to create an artificial hive, either from stone or wood at a craftsdwarf's workshop, from ceramics at a kiln, from glass at a glass furnace, or from metal at a metalsmith's forge. Hives are tools stored in the finished goods stockpile, and can be built by a beekeeper using the Alt+h hotkey. In order to be productive, a hive must be constructed on or adjacent to a tile that is above ground. Dwarves will install colonies in hives installed underground, and such colonies will grow and allow splitting off new colonies, but they will not produce honey.
Once a hive is installed, it is automatically toggled to "install colony when ready", which will generate an "Install Colony in Hive" job onto the job list, unless the player specifies otherwise (with q-c). Hives can have colonies installed into them from preexisting wild colonies or from hives that are ready to split (more on that later); the beekeeper will walk to the location of the colony, pick it up and bring it to the built hive. Again, if there are no wild honey bee colonies on your map, no colony can be installed until there is one. It may be more sensible to build a single hive and then see if a beekeeper can find a colony to fill it with rather than go searching for one beforehand if it is uncertain whether or not there are any honey bees on the map. It will take a while until it is certain that the beekeeper does not have a colony available to collect and isn't just doing other stuff; if there is no available colony, the "install colony in hive" job will not cancel but rather stay "inactive" indefinitely.
Hive management[edit]
Once there is a colony (of 10 000 to 20 000 bees) in your hive, you have two options:
- You may toggle the hive (using q-g) so that the product is not automatically gathered. This will prevent your dwarves from collecting the products but at the same time preserves the colony, which will keep growing, so that new colonies can be split off it regularly and placed in additional hives. Assuming you have spare hives built and available, this is the option you set your hives to in order to grow them.
- Or you can choose to have the hive harvested, causing a beekeeper to approach the hive about nine months later to transfer the royal jelly into an empty jug and to make the honeycomb available, so that it can be moved to storage. This is the production option; the hives will produce things for you at a steady rate, but the harvesting destroys the colony in the hive; it can then be repopulated by a colony ready for splitting.
Note: The colony in a hive set to "collect products" will still grow, but splitting off a new colony only becomes possible shortly before the hive is ripe for harvesting, and harvesting will always destroy the entire colony, whether it is ready to split or not. Consequently, dwarves will sometimes replenish hives from colonies set to "collect", but not reliably. To sustain a beekeeping industry without tedious micro-management, a healthy number of "breeding" hives are needed which are not allowed for collection.
Beekeeping as an industry is currently extremely buggy, involves a lot of micromanagement on the supply side, and doesn't produce as many products as it really should to be worthwhile. Most annoyingly, there is a bug where multiple empty hives will generate conflicting jobs targeting the same colony which reliably get beekeepers stuck Bug:3981. Consequently, a beekeeping industry must be grown quite slowly and measures must be taken to reduce the number of hives which are empty at the same time, like limiting the number of dwarves who may perform the beekeeping labor. Additionally, there is no way to tell beekeepers to prioritize fortress hives over wild ones for colony installation (except perhaps by using a burrow) - they will often wander far out into the map without even the ambusher's crossbows for self-protection. For these reasons the industry is typically seen as a novelty, at least until the kinks are ironed out.
Examining hives[edit]
Interacting with a hive (q) will show:
- Which options have been set for that hive (install colony or don't, gather products or save for split).
- Whether it has Outdoor access or No outdoor access.
- If the hive is Ready to be split.
If interacting with the hive shows Not ready to be split then it might mean it has a colony too small to be split, or that it has no colony at all. To see if a hive has a colony, uses "view items in buildings" (t), which will show an item stack of thousands of bees if there's a colony. t will also show if the hive has a honey comb or lump of royal jelly.
Artificial hive limits[edit]
If your fortress has more than 40 inhabited artificial hives, but less than 60, then interacting with a hive (q) will show:
Presumably this means that existing artificial hives grow more slowly. [Verify]
Having more than 40 or more than 60 inhabited artificial hives does not appear to prevent new wild hives from appearing, and these can still be transferred to empty artificial hives.
If you fortress has 60 or more inhabited artificial hives, then interacting with a hive (q) will show:
Presumably this means that existing artificial hives no longer grow, or that grown hives can't be split.
Products[edit]
Harvesting a hive produces two items, one of which is a lump of royal jelly, which must be collected in an empty jug, an item used only by the beekeeping industry and in the production of rock nut oil. Royal jelly is a liquid food item, and so can only be used in cooking prepared meals, and only if another, solid food item is included in the meal. Every harvest will result in a single jug filled with jelly. The other item produced by a harvest job is the honeycomb, which is a little more complicated to process: it is considered a wax tool and doesn't have any direct application, but when pressed at a screw press produces two products, one jug filled with honey and a wax press cake, both of which are handled as food items for storage.
Harvesting a hive requires a jug (ae. you cannot harvest the honeycomb alone), as does pressing the honeycomb; carrying the products to their destination stockpile or production point is considered an item hauling job unrelated with the beekeeping labor, so after being harvested by a beekeeper they will be left at the foot of the hive until someone comes by to haul them off, unless the beekeeper has item hauling enabled themselves (in which case they'll send it to nearest applicable stockpiles). The same is true of honeycomb pressing.
Honey can be cooked into a meal or brought to a still and processed with a barrel or large pot into mead, the only non plant-based alcoholic drink in the game. Wax, meanwhile, can be processed into various wax crafts by a wax worker at a craftsdwarf's workshop. Wax crafts are not particularly valuable - they have a material value of one, the same as wood and non-flux stone - but they're something.
Bugs[edit]
- Dwarves have a hard time splitting hives. They also have a hard time keeping track of wild colonies of bees that die out.Bug:3981
Having the beekeeping labor enabled on only one dwarf at a time may alleviate these problems. The problem is caused by multiple empty hives targeting the same colony for installing. The most effective troubleshooting method is to look up the job of a 'stuck' beekeeper in the job list, then zooming to the building - the hive which issued the job. Toggling the 'c' option (install colony) off, letting the game run for a few seconds and then switching the option back on will usually clear the faulty job and issue a new 'install colony in hive' job with a legal target colony. Removing and rebuilding empty hives usually fixes beekeepers stuck trying to install colonies, but is much more time-consuming than simply toggling the install option. - Filled Jugs may be stored in bins as finished goods, preventing the use of their contents in the food industry.Bug:4229
- Stacks of honey bees in their hives can be mangled by forest fires, but will still live, resulting in some odd descriptions.Bug:4101
- Screw presses built in burrows may not allow the "press honeycomb" job to be added directly; adding the job via the manager interface will get the work started. This seems to be related to their distance from applicable materials.Bug:434