Editing Beekeeping industry

{{migrated article}}
{{Quality|Unrated}}
{{av}}
{{buggy}}
[[File:Beekeeping Industry Flowchart.png|thumb|300px|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 beekeeping.

== Setup ==
=== Finding wild bees ===
[[File:bee_keeping_preview.png|140px|right]]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]].

[[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.

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.

=== Building hives ===

{{Main|Hive}}

{| class="wikitable floatright"
|+ 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 [[workshop]]s and [[labor]]s. Beekeepers themselves do not craft them. Hives are stored in [[finished goods]] [[stockpile]]s.

Hives can be built ({{k|b}} -> {{k|o}} -> {{k|f}} -> {{k|h}}) 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. If you expose a subterranean floor tile to sunlight, it will not make the hive produce honey, even though the hive may say "Outdoor access", and be "Outdoors"; 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 above ground, 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.

In the [[job list|{{k|j}}ob list]], two notable beekeeping jobs are:

* {{DFtext|Install Colony In Hive|3:0}} – when a beekeeper installs a colony to a new hive.
* {{DFtext|Collect Hive Products|3:0}} – when a beekeeper gathers the products from a hive.

=== Examining hives ===
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}}.
** {{k|g}} {{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}}.
* If there are too many colonized hives on the map (due to a [[#Limit|limit]]).

To see if a hive has a colony, use the "view i{{k|t}}ems 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 {{k|b}}uilding menu and look for the number next to the "Hive" button.

=== 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.

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 [[burrow]]s can prevent them from seeking other hives.

=== 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.

Splitting a colony does not reset the honeycomb and royal jelly production. [[Forbid]]ding 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 ===
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.

Hives must set to {{DFtext|Gather any products|7:1}} 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 ===
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:

<div style="background: {{fgcolor|0:0}}; width: 12em;">
{{DFtext|Too many hives|6:1}}<br/>{{DFtext|* Output restricted|6:0}}
</div>

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:

<div style="background: {{fgcolor|0:0}}; width: 12em;">
{{DFtext|Too many hives|4:1}}<br/>{{DFtext|* No output|4:0}}
</div>

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 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]] 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, 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}}

{{Category|Guides}}
{{Category|Industry}}
[[ru:Beekeeping industry]]