Difference between revisions of "Beekeeping industry"

V · T · E Industries
Primary	Beekeeping · Farming · Fishing · Gathering · Meat · Poultry · Stone · Wood
Secondary	Alcohol · Armor · Arms · Ceramic · Extract · Finished goods · Fuel · Furniture · Gem · Glass · Metal · Paper · Soap · Textile
Tertiary	Military · Health care · Noble · Trade · Tavern
Quaternary	Library · Temple

Latest revision as of 10:15, 21 September 2024

xTATTEREDx · +FINE+ · *SUPERIOR* · ≡EXCEPTIONAL≡ · ☼MASTERWORK☼

v50.14 · v0.47.05

This article is about the current version of DF.
Note that some content may still need to be updated.

More Info · V

The beekeeping industry is an agricultural process that involves farming honey bees in built hives to produce honeycombs and royal jelly, the former of which is further processed into honey and wax. The primary skill and labor used in the industry is beekeeping.

Setup[edit]

Finding wild bees[edit]

Beekeeping industry flowchart

Wild colonies of honey bees must be present on the map. Since live vermin cannot be bought during embark, wild bees are necessary to start beekeeping. Colonies of honey bees can appear in any non-freezing land biome, which excludes mountains, glaciers, and tundras. While they are common in places they appear ([FREQUENCY:100]), bees are not [UBIQUITOUS], thus are not guaranteed to appear in every region.

Bumblebees cannot be used in beekeeping.^[1] They do possess their own version of honey, royal jelly, wax, and even mead, all of which are unobtainable in normal gameplay.

Honey bees are one of the [VERMIN_SOIL_COLONY] creatures, which includes bumblebees, ants, and termites. Maps have a hard limit to how many wild colonies can appear simultaneously. If new colonies stop appearing, it means this limit has been reached. Therefore, honey bee colonies might be unable to spawn because the "space" is occupied by other vermin colonies. Building dirt roads over existing colonies frees up space for new ones to generate.

If a colony cannot be found after searching, set up a single hive and leave it for about a year as a last-ditch effort. Beekeepers will immediately be able to find an accessible honey bee colony that may have gone unnoticed or spawned inconspicuously.

Building hives[edit]

Main article: Hive

Workshop and labor requirements
Material	Workshop	Labor
Ceramic	Kiln or magma kiln	Pottery
Glass	Glass furnace or magma glass furnace	Glassmaking
Metal	Metalsmith's forge or magma forge	Metalcrafting
Stone	Craftsdwarf's workshop	Stonecrafting
Wood	Craftsdwarf's workshop	Woodcrafting

Hives are a tool. They can be made in a variety of hard materials from their respective workshops and labors. Beekeepers themselves do not craft them. Hives are stored in finished goods stockpiles.

Hives can be built (bofh) on any hard surface, both indoors and outdoors. Only beekeepers can haul and place hives.

Tile attributes affect honey production. In order for hives to produce, they must be built adjacent to (or on) an above ground tile. Subterranean hives cannot produce anything, but can store colonies to be split later. Clicking on a hive will show whether it has "Outdoor access" or "No outdoor access" - relating to the above ground or subterranean attribute respectively. So long as hives are placed adjacent to or on an above ground tile, they can be completely enclosed with constructions from outside while still creating products, allowing beekeepers to work safely at all times.

Hive management[edit]

Managing hives is fairly automated–beekeepers will perform most of the necessary jobs on their own when available. There are two options in the building settings that can be toggled to control beekeepers from installing colonies or from gathering products in a hive. Hives are set by default to allow colony installation and product gathering.

In the job list, two notable beekeeping jobs are:

Install Colony In Hive – when a beekeeper installs a colony to a new hive.
Collect Hive Products – when a beekeeper gathers the products from a hive.

Examining hives[edit]

Clicking on the hive will display:

Which options have been set for that hive:
- Install colony when ready or Do not install colony.
- Gather any products or Do not gather products.
Whether it has Outdoor access or No outdoor access.
If the hive is Ready to be split or Not ready to be split.
If there are too many colonized hives on the map (due to a limit).

To see if a hive has a colony, use the "view items in buildings" menu. If a colony is present, it will show a stack of live honey bees inside a built hive. It will also show if the hive contains a honeycomb or royal jelly. To know how many hives are currently built on the map, open the building menu and look for the number next to the "Hive" button.

Colony installation[edit]

Beekeepers automatically haul colonies to new hives as long as they have access to a wild colony or another colony that is ready to be split from another hive. They must have their setting set to Install colony when ready. Hives set to Do not install colony will not accept new colonies, even after existing colonies are destroyed. If the settings change or the hive gets slated for removal before the beekeeper reaches the hive to install a new colony, then the job gets cancelled, and the hauled colony is removed from the beekeeper.

Beekeepers usually go for the closest available colony to install, whether it's a wild colony or a colony in a hive. Assigning beekeepers to burrows can prevent them from seeking other hives.

Splitting colonies[edit]

Colonies can split in three months after installation. A split-able colony is indicated in the building settings as Ready to be split. Splitting colonies produce new colonies that are installed to other hives, thereby increasing the colony count. In order to split the colony, an empty hive and a beekeeper must be present. A beekeeper will perform a splitting automatically if an empty hive is set to allow colony installation. After splitting, beekeepers haul the new colony to an empty built hive. Doing this leaves the original hive populated, and after another three months, it will become ready for splitting again.

Splitting a colony does not reset the honeycomb and royal jelly production. Forbidding a hive or its colony will not prevent beekeepers from using the hive's colony for splitting. If a hive is slated for removal but has not been removed yet, then the split-able colony inside can still be used for installation.

Gathering products[edit]

Hives containing colonies produce a single honeycomb and royal jelly. Honeycombs and royal jelly are "part" of the building, as indicated by the [B] symbol next to their names when viewing the building's items. When a beekeeper gathers them, the items are released from the hive, which allows a food hauler to carry the items to a stockpile. An empty jug is required to gather the products, since royal jelly must be stored in a container.

Hives must set to Gather any products for beekeepers to go and gather its products. A honeycomb and royal jelly must both be present in a hive before they can be gathered. When these requirements are met, a beekeeper will automatically find an empty jug and gather the products for hauling. Beekeepers usually go for the closest accessible hive to gather first. If the settings change or the hive gets slated for removal before the beekeeper reaches the hive to collect the products, then the job gets cancelled, and the jug is stored back.

The gathering process always destroys the colony inside the hive. The colony disappears instantly when destroyed. A new colony must be installed every time the products are gathered in order for the hive to produce more. To avoid colony extinction from gathering products, it is recommended to save a few hives just for splitting by changing their settings to not gather products. This would ensure a permanent supply of bees at all times.

Limit[edit]

There is a soft limit of 40 colonies, which empty hives and wild or hauled colonies do not count against. When the number of colonies on the map reaches 41 or more, honeycomb and royal jelly no longer have a 100% possibility of spawning six months after installation. If the colony does not produce a honeycomb or royal jelly, then it has a chance to produce again every six months. The likelihood of spawning affects products individually, so it is possible that a honeycomb appears while royal jelly does not, and vice versa. The soft limit does not affect colonies that were installed before the limit had passed. Hives that contain colonies will have the following warning in the building settings when the soft limit is exceeded:

Too many hives
* Output restricted

The maximum limit of active colonies for honey production is 59. When the colony count reaches 60, no more hive products appear. It also resets all ongoing production, so any colony that was in the process of producing must wait at least six months again to produce honeycomb and royal jelly after the max limit is brought back down. When the max limit is reached, the warning message in the building settings reads:

Too many hives
* No output

The limits do not affect the spawning of wild colonies, nor the amount of time needed for colonies to become ready to split.

The total number of colonies can be checked in the stocks under "Small live animals" and hitting Tab to display individual stacks. Each stack represents a single colony. The number of colonies can exceed 60 by installing colonies into new hives (by splitting or collecting wild bees), but nothing is gained from doing this. To lower the number of colonies, either dismantle colonized hives, dump the colony, or allow beekeepers to gather existing products in the hive, which destroys the colony. To attain high output efficiency, keep the number of active hives below 41.

Removing hives[edit]

Built hives can be removed using the building menu (q + x). A beekeeper is required to remove the hive. After the building is removed, the item is carried back to a finished goods stockpile by an item hauler. Hives can also be destroyed by building destroyers, cave-ins, and magma.

Deconstructing a hive releases the colony inside (it cannot be retrieved), as well as dropping any honeycomb, royal jelly, or jug left inside. Fallen honeycombs and jugs can be hauled back, but spilled royal jelly cannot.

Production and processing[edit]

Six months after installing a colony, a hive produces one honeycomb ∞ and one royal jelly ≈. Products have a 100% chance of spawning, unless the colony count exceeded the limit. Only one honeycomb and royal jelly will spawn at a time, and no further products will appear until they are gathered from the hive. The colony size does not affect the output speed; neither do the surroundings, plants, weather, or seasons affect production.

Royal jelly is a liquid food used as an ingredient in prepared meals, but it can only be cooked if another solid food item is included in the meal.

Honeycombs are classified as tools, and stored with other finished goods. As an intermediate product, honeycombs do not have any applications on their own, but when pressed at a screw press, each honeycomb produces two items: honey ≈ and pressed wax (or wax cake) ≈, both of which are stored in food stockpiles. To press a honeycomb, add a new task in a screw press and select "Press honey from honeycomb" (h), or search and select "Press honey from honeycomb" in the manager screen. An empty jug is needed for the job to store the honey.

Honey, like royal jelly, is a liquid food that can be cooked into a meal. Additionally, it can be brought to a still and brewed into mead, the only obtainable non-plant-based alcoholic drink. Wax can be processed into various crafts by a wax worker, which all have a material value of one.

Bugs[edit]

Stacks of honey bees in their hives can be mangled by forest fires, but will still live, resulting in some odd descriptions.^Bug:4101
Filled jugs may be stored in bins as finished goods, preventing the use of their contents in the food industry.^Bug:4229

This article or section has been rated D for Dwarf. It may include witty humour, not-so-witty humour, bad humour, in-jokes, pop culture references, and references to the Bay12 forums. Don't believe everything you read, and if you miss some of the references, don't worry. It was inevitable.

The entire beekeeping industry is a bug exploit.(with regards to the Apis genus, to be exact)

You get used to the buzzing sounds. Honest.

@@ Line 1: / Line 1: @@
-{{Quality|Exceptional|18:00, 15 August 2014 (UTC)}}
+{{Quality|Exceptional}}
 {{av}}
 {{buggy}}
+<div style="margin-right: 15px;">[[File:honey_bee_sprite_preview.png|right]]</div>
-[[File:Beekeeping Industry Flowchart.png|thumb|upright=1.5|Beekeeping industry flowchart]]
+The '''beekeeping industry''' is an agricultural process that involves farming [[honey bee]]s in built [[hive]]s to produce [[honeycomb]]s and [[royal jelly]], the former of which is further processed into [[honey]] and [[wax]]. The primary skill and labor used in the industry is [[Beekeeper|beekeeping]].
-The '''beekeeping industry''' is an agricultural process that involves farming [[honey bee]]s in built [[hive]]s to produce [[honeycomb]]s and [[royal jelly]], the former of which is further processed into [[honey]] and [[wax]]. The primary skill and labor used in the industry is [[beekeeping]].
 == Setup ==
 === Finding wild bees ===
+[[File:Beekeeping Industry Flowchart.png|thumb|300px|upright=1.5|Beekeeping industry flowchart]]Wild colonies of honey bees must be present on the map. Since live [[vermin]] cannot be bought during [[embark]], wild bees are necessary to start beekeeping. Colonies of honey bees can appear in any [[Freezing#Climate|non-freezing]] land [[biome]], which excludes mountains, glaciers, and tundras. While they are common in places they appear ({{token|FREQUENCY|c|100}}), bees are not {{token|UBIQUITOUS|c}}, thus are not guaranteed to appear in every [[region]].
-Wild colonies of honey bees {{Tile|·|6:1}} must be present on the map. Since live [[vermin]] cannot be bought during [[embark]], wild bees are necessary to start beekeeping. Colonies of honey bees can appear in any [[Freezing#Climate|non-freezing]] land [[biome]], which excludes mountains, glaciers, and tundras. While they are common in places they appear ({{token|FREQUENCY|c|100}}), bees are not {{token|UBIQUITOUS|c}}, thus are not guaranteed to appear in every [[region]].
+[[Bumblebee]]s cannot be used in beekeeping.<sup>[https://dwarffortress.mantishub.io/view.php?id=4003#c15306 &#91;1&#93;]</sup> They do possess their own version of honey, royal jelly, wax, and even mead, all of which are unobtainable in normal gameplay.
-[[Bumblebee]]s cannot be used in beekeeping.<sup>[http://www.bay12games.com/dwarves/mantisbt/view.php?id=4003#c15306 &#91;1&#93;]</sup> They do possess their own version of honey, royal jelly, wax, and even mead, all of which are unobtainable in normal gameplay.
-Honey bees are one of the {{token|VERMIN_SOIL_COLONY|c}} creatures, which includes bumblebees, [[ant]]s, and [[termite]]s. Colonies of honey bees appear randomly on the surface ground as a circle {{Tile|○|7:1}} (the color is determined by the floor tile). Maps have a hard limit to how many wild colonies can appear simultaneously. If new colonies stop appearing, it means this limit has been reached. Therefore, honey bee colonies might be unable to spawn because the "space" is occupied by other vermin colonies. Building [[dirt road]]s over existing colonies frees up space for new ones to generate.
+Honey bees are one of the {{token|VERMIN_SOIL_COLONY|c}} creatures, which includes bumblebees, [[ant]]s, and [[termite]]s. Maps have a hard limit to how many wild colonies can appear simultaneously. If new colonies stop appearing, it means this limit has been reached. Therefore, honey bee colonies might be unable to spawn because the "space" is occupied by other vermin colonies. Building [[dirt road]]s over existing colonies frees up space for new ones to generate.
-If a colony cannot be found after searching, set up a single hive and leave it for about a year as a last-ditch effort. Beekeepers will immediately be able to find an accessible honey bee colony that may have gone unnoticed or spawned inconspicuously. Occasionally check the hive for live bees by viewing the building with {{k|t}} from the menu.
+If a colony cannot be found after searching, set up a single hive and leave it for about a year as a last-ditch effort. Beekeepers will immediately be able to find an accessible honey bee colony that may have gone unnoticed or spawned inconspicuously.
 === Building hives ===
@@ Line 37: / Line 33: @@
 | [[Wood]] || [[Craftsdwarf's workshop]] || [[Woodcrafting]]
 |}
+Hives are a [[tool]]. They can be made in a variety of hard materials from their respective [[workshop]]s and [[labor]]s. Beekeepers themselves do not craft them. Hives are stored in [[finished goods]] [[stockpile]]s.
-Hives {{Tile|▬|6:1}} are a [[tool]]. They can be made in a variety of hard materials from their respective [[workshop]]s and [[labor]]s. Beekeepers themselves do not craft them. Hives are stored in [[finished goods]] [[stockpile]]s.
+Hives can be built ({{Menu icon|b|o|f|h}}) on any hard surface, both indoors and outdoors. Only beekeepers can haul and place hives.
-They can be built by opening the [[building|{{k|b}}uilding]] menu and either selecting {{DFtext|Hive|7:1}} or pressing {{k|Alt + h}}. They can be built on any hard surface, both indoors and outdoors. Only beekeepers can haul and place them.
-[[Tile attributes]] affect honey production. In order for hives to produce, they must be built adjacent to (or on) an above ground tile. Subterranean hives can still store colonies that can be used later for splitting, but they cannot produce anything. Hives are marked as having either {{DFtext|Outdoor|2:1}} or {{DFtext|No outdoor|4:1}} access; this is referring to the above ground and subterranean attributes, not the outside and inside attributes. Hives can produce normally in both outside and inside tiles. So long as hives are placed above ground, they can be completely enclosed with constructions from outside while still creating products, allowing beekeepers to work safely at all times.
+[[Tile attributes]] affect honey production. In order for hives to produce, they must be built adjacent to (or on) an above ground tile. Subterranean hives cannot produce anything, but can store colonies to be split later. Clicking on a hive will show whether it has "Outdoor access" or "No outdoor access" - relating to the above ground or subterranean attribute respectively. So long as hives are placed adjacent to or on an above ground tile, they can be completely enclosed with constructions from outside while still creating products, allowing beekeepers to work safely at all times.
 == Hive management ==
+Managing hives is fairly automated–beekeepers will perform most of the necessary jobs on their own when available. There are two options in the building settings that can be toggled to control beekeepers from installing colonies or from gathering products in a hive. Hives are set by default to allow colony installation and product gathering.
-Managing hives is fairly automated. Beekeepers will perform most of the necessary jobs on their own when available. There are two options in the building settings that can be toggled to control beekeepers from installing colonies or from gathering products in a hive. Hives are set by default to allow colony installation and product gathering.
 In the [[job list|{{k|j}}ob list]], two notable beekeeping jobs are:
@@ Line 54: / Line 48: @@
 === Examining hives ===
+Clicking on the hive will display:
-Hovering the cursor near a hive in the building settings menu ({{k|q}}) will display:
 * Which options have been set for that hive:
-** {{k|c}} {{DFtext|Install colony when ready|7:1}} or {{DFtext|Do not install colony|7:1}}.
+** {{DFtext|Install colony when ready|7:1}} or {{DFtext|Do not install colony|7:1}}.
-** {{k|g}} {{DFtext|Gather any products|7:1}} or {{DFtext|Do not gather products|7:1}}.
+** {{DFtext|Gather any products|7:1}} or {{DFtext|Do not gather products|7:1}}.
 * Whether it has {{DFtext|Outdoor access|2:1}} or {{DFtext|No outdoor access|4:1}}.
 * If the hive is {{DFtext|Ready to be split|2:1}} or {{DFtext|Not ready to be split|0:1}}.
@@ Line 67: / Line 60: @@
 === Colony installation ===
 Beekeepers automatically haul colonies to new hives as long as they have access to a wild colony or another colony that is ready to be split from another hive. They must have their setting set to {{DFtext|Install colony when ready|7:1}}. Hives set to {{DFtext|Do not install colony|7:1}} will not accept new colonies, even after existing colonies are destroyed. If the settings change or the hive gets slated for removal before the beekeeper reaches the hive to install a new colony, then the job gets cancelled, and the hauled colony is removed from the beekeeper.
@@ Line 73: / Line 65: @@
 === Splitting colonies ===
 Colonies can split in three months after installation. A split-able colony is indicated in the building settings as {{DFtext|Ready to be split|2:1}}. Splitting colonies produce new colonies that are installed to other hives, thereby increasing the colony count. In order to split the colony, an empty hive and a beekeeper must be present. A beekeeper will perform a splitting automatically if an empty hive is set to allow colony installation. After splitting, beekeepers haul the new colony to an empty built hive. Doing this leaves the original hive populated, and after another three months, it will become ready for splitting again.
@@ Line 79: / Line 70: @@
 === Gathering products ===
 Hives containing colonies produce a single honeycomb and royal jelly. Honeycombs and royal jelly are "part" of the building, as indicated by the {{DFtext|[B]|1:1}} symbol next to their names when viewing the building's items. When a beekeeper gathers them, the items are released from the hive, which allows a food hauler to carry the items to a stockpile. An empty [[jug]] is required to gather the products, since royal jelly must be stored in a container.
@@ Line 87: / Line 77: @@
 === Limit ===
+There is a soft limit of 40 colonies, which empty hives and wild or hauled colonies do not count against. When the number of colonies on the map reaches 41 or more, honeycomb and royal jelly no longer have a 100% possibility of spawning six months after installation. If the colony does not produce a honeycomb or royal jelly, then it has a chance to produce again every six months. The likelihood of spawning affects products individually, so it is possible that a honeycomb appears while royal jelly does not, and vice versa. The soft limit does not affect colonies that were installed before the limit had passed. Hives that contain colonies will have the following warning in the building settings when the soft limit is exceeded:
-There is a soft limit of 40 colonies. Empty hives, wild colonies, and hauled colonies do not count against this limit. When the number of colonies on the map reaches 41 or more, honeycomb and royal jelly no longer have a 100% possibility of spawning six months after installation. If the colony does not produce a honeycomb or royal jelly, then it has a chance to produce again every six months. The likelihood of spawning affects products individually, so it is possible that a honeycomb appears while royal jelly does not, and vice versa. The soft limit does not affect colonies that were installed before the limit had passed. Hives that contain colonies will have the following warning in the building settings when the soft limit is exceeded:
 <div style="background: {{fgcolor|0:0}}; width: 12em;">
@@ Line 100: / Line 89: @@
 </div>
-The limits do not affect the spawning of wild colonies, nor do they alter the amount of time needed for colonies to become ready to split.
+The limits do not affect the spawning of wild colonies, nor the amount of time needed for colonies to become ready to split.
 The total number of colonies can be checked in the [[stocks]] under "Small live animals" and hitting {{k|Tab}} to display individual stacks. Each stack represents a single colony. The number of colonies can exceed 60 by installing colonies into new hives (by splitting or collecting wild bees), but nothing is gained from doing this. To lower the number of colonies, either dismantle colonized hives, [[dump]] the colony, or allow beekeepers to gather existing products in the hive, which destroys the colony. To attain high output efficiency, keep the number of active hives below 41.
 === Removing hives ===
 Built hives can be removed using the building menu ({{k|q + x}}). A beekeeper is required to remove the hive. After the building is removed, the item is carried back to a finished goods stockpile by an item hauler. Hives can also be destroyed by [[building destroyer]]s, [[cave-in]]s, and [[magma]].
-Deconstructing a hive releases the colony inside (it cannot be retrieved), as well as dropping any honeycomb, royal jelly, or jug left inside. Fallen honeycombs and jugs can be hauled back, but spilled royal honey cannot be hauled.
+Deconstructing a hive releases the colony inside (it cannot be retrieved), as well as dropping any honeycomb, royal jelly, or jug left inside. Fallen honeycombs and jugs can be hauled back, but spilled royal jelly cannot.
 == Production and processing ==
 Six months after installing a colony, a hive produces one [[honeycomb]] {{Tile|∞|6:1}} and one [[royal jelly]] {{Tile|≈|7:1}}. Products have a 100% chance of spawning, unless the colony count exceeded the limit. Only one honeycomb and royal jelly will spawn at a time, and no further products will appear until they are gathered from the hive. The colony size does not affect the output speed; neither do the [[surroundings]], [[plant]]s, [[weather]], or [[season]]s affect production.
-Royal jelly is a liquid [[food]]. It is used as an ingredient in [[prepared meal]]s, but it can only be cooked if another solid food item is included in the meal.
+Royal jelly is a liquid [[food]] used as an ingredient in [[prepared meal]]s, but it can only be cooked if another solid food item is included in the meal.
 Honeycombs are classified as tools, and stored with other finished goods. As an intermediate product, honeycombs do not have any applications on their own, but when [[presser|pressed]] at a [[screw press]], each honeycomb produces two items: [[honey]] {{Tile|≈|6:0}} and pressed [[wax]] (or wax cake) {{Tile|≈|6:1}}, both of which are stored in food stockpiles. To press a honeycomb, add a new task in a screw press and select "Press honey from honeycomb" ({{k|h}}), or search and select "Press honey from honeycomb" in the [[manager]] screen. An empty jug is needed for the job to store the honey.
-Honey, like royal jelly, is a liquid food that can be cooked into a meal. Additionally, honey can be brought to a [[still]] and brewed into [[alcohol|mead]], the only obtainable non-plant-based alcoholic drink. Wax can be processed into various [[craft]]s by a [[wax worker]]. Wax crafts have a [[material value]] of one.
+Honey, like royal jelly, is a liquid food that can be cooked into a meal. Additionally, it can be brought to a [[still]] and brewed into [[alcohol|mead]], the only obtainable non-plant-based alcoholic drink. Wax can be processed into various [[craft]]s by a [[wax worker]], which all have a [[material value]] of one.
 == Bugs ==
 * Stacks of honey bees in their hives can be [[wear|mangled]] by forest [[fire]]s, but will still live, resulting in some odd descriptions.{{bug|4101}}
 * Filled jugs may be stored in [[bin]]s as finished goods, preventing the use of their contents in the food industry.{{bug|4229}}
+{{d for dwarf}}
+The entire beekeeping industry is a bug exploit.(''with regards to the Apis genus, to be exact'')
+[[File:beekeeping_preview.png|thumb|340px|center|You get used to the buzzing sounds. Honest.]]
 {{Industry}}