- 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.
Beekeeping industry
v50.14 · v0.47.05 This article is about the current version of DF.Note that some content may still need to be updated. |
 | This feature has one or more outstanding bugs. Please view the Bugs section for details. |
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
Finding wild bees
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. Colonies of honey bees appear randomly on the surface ground as ○. Maps have a hard limit to how much 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. Occasionally check the hive for live bees by viewing the building with t from the menu.
Building hives
| 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 make them. Hives are stored in finished goods stockpiles. They can be built by opening the building menu and either selecting Hive or pressing Alt + h. They can be built on any hard surface, both indoors and outdoors. Citizens with beekeeping enabled are needed to build 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 Outdoor or No outdoor 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.
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, 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
Hovering the cursor near a hive in the building settings menu (q) will display:
- Which options have been set for that hive:
- c Install colony when ready or Do not install colony.
- g 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
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
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
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
There is a soft limit of 40 colonies. Empty hives, wild colonies, and hauled colonies do not count to this limit. When the number of colonies on the map reach over 41, 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 effect colonies that were installed before the limit was 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 do they alter 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
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 and cave-ins. It is unknown if evil weather and temperature have any destructive effect on the building or colony.[Verify]
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.
Production and processing
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. In addition, the surroundings, plants, weather, and the seasons do not affect production.
Royal jelly is a liquid food. It is 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 are 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, it 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, honey 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. Wax crafts have a material value of one.
Bugs
- 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
| Primary | |
|---|---|
| Secondary | |
| Tertiary | |
| Quaternary | |