Dwarf Fortress Wiki - User contributions [en]

User:Phlogisticated air

2024-06-12T23:16:45Z

Phlogisticated air:

Hello! I'm new to editing wiki's, so if you have any recommendations for me to follow, you can put it in [[User talk:Phlogisticated air]] and I'll try to follow it to the best of my ability.
Thanks

Talk:Reports

2023-08-05T04:02:56Z

Phlogisticated air: reports and announcements clarification question for v50

== v50 Reports and Announcements ==
Would it be okay to assume that reports are the messages shown inside of announcements (which would be the icon shown in the top left, Eg. [[File:Announce masterpiece icon.png]])? [[User:Phlogisticated air|Phlogisticated air]] ([[User talk:Phlogisticated air|talk]]) 04:02, 5 August 2023 (UTC)

Announcement

2023-08-04T23:38:40Z

Phlogisticated air: Announcement appears when fortress runs out of food

{{av}}
{{Quality|Unrated}}

[[File:announcings_preview.png|thumb|250px|right|List of announcements, in classic/ASCII mode.]]An '''announcement''' is a message displayed at the top left of the game screen used to indicate something important. Major announcements will pause gameplay and center the camera on the event in question, and game-changing ones will both do that and provide a framed message box presenting the event in question. The announcements list ({{k|a}}) lists all game announcements in dated order; some (but not all) can be {{k|z}}oomed to. Announcements are not to be confused with [[reports|{{k|r}}eports]], which detail combat results.

When some major or important game-changing announcements occur, the following icon will appear, accompanied with a wooden ticking-like sound effect:<br>
[[File:alert_icon_anim.gif]]
== Controlling which announcements pause and recenter ==
{{main|announcements.txt}}

You can control which types of announcements do and don't pause and/or recenter the game by editing the <code>announcements.txt</code> file, found at <code>Dwarf Fortress/data/init/announcements.txt</code>. An announcement type containing '''P''' will pause when that announcement type is made, and one containing '''R''' will re-center when that announcement type is made. For example,

:<tt>[MIGRANT_ARRIVAL:A_D:D_D:P:R]</tt>

means that the game will pause and recenter upon the announcement of migrants arriving. You could change it to

:<tt>[MIGRANT_ARRIVAL:A_D:D_D:R]</tt>

to cause the game to recenter on the arriving migrants, but to not pause the game.

== Announcements ==
'''''Note:''' Some of the icons may be incorrect. A question mark placeholder icon is in place of unknown icons. Please update them with the correct ones as soon as possible.''

{|class = "wikitable"
! Icon !! Importance !! Description
|-
|colspan="3" style="padding:7px;" | ''Minor'' announcements are the simplest and most common announcements, and will flicker through the announcements window very quickly. This is typically used for things that happen a lot in a well-developed fortress.
|-
|[[File:announce_cancel_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Job cancellation with a stated reason (building site submerged, item blocking site, dangerous terrain, needs rough picture jaspers, etc.), followed by a [[suspend|suspension]] notice if the job is [[furniture]] placement or building a [[construction]]. The [[standing orders]] menu ({{key|o}}) allows you to filter job cancellation spam, between none, some, most, and all (default is some).
|-
|[[File:announce_weather_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Standard changes in [[weather]]: "It has started raining," "The weather has cleared," or "A snow storm has arrived." Changes in the season.
|-
|[[File:announce_birth_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || [[Creatures]] and [[dwarves]] (and apparently [[ghost]]s as well) [[age|growing up]] and progressing from baby to child to adult. Animals jump straight from babies to adults. A dwarf cancelling a job with the reason of "Seeking infant." may also occur.
|-
|[[File:announce_masterpiece_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || The creation of [[quality|masterpieces]]. Can get quite annoying in mature fortresses, when the announcements will stack up the products of legendary dwarves.
|-
|[[File:announce_artdeface_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || A masterpiece quality item has been lost or destroyed.
|-
|[[File:announce_digging_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || A new type of stone or ore has been found while digging.
|-
|[[File:announce_military_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Individuals are changing their status because they're in a squad.
|-
|[[File:announce_labor_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Changes in [[profession]], for both civilian and [[military]] dwarves. The start of every month is usually marked by rotations within your militia and thus a bevy of messages of this type.
|-
|[[File:announce_hunting_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || A dwarf has begun [[Ambusher|hunting]] for animals.
|-
|[[File:announce_death_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || When an animal is [[butcher's shop|slaughtered]], or a tame animal or dwarf is struck down within view of other dwarves.
|-
|[[File:announce_birth_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Animals giving birth.
|-
|[[File:announce_guest_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || A [[guest]] is visiting your fortress.
|-
|[[File:announce_marriage_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Two dwarves have gotten [[marriage|married]].
|-
|[[File:announce_cancel_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Dwarves getting spooked by other creatures, and cancelling their jobs.
|-
|[[File:announce_combat_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Combat is taking place, or someone has died in combat.
|-
|[[File:announce_sparring_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Sparring is taking place.
|-
|[[File:announce_agreement_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || An agreement or [[mandate]] is active.
|-
|[[File:announce_animal_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || An animal has been caught in a [[Animal_trap|trap]].
|-
|[[File:announce_martial_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || A dwarf is in a [[martial trance]].
|-
|[[File:announce_noble_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Dwarves getting promoted and/or elected to a noble status. Such as [[baron]], [[count]] or [[duke|duke/duchess]].
|-
|[[File:announce_ghost_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || The raising of a [[ghost]].
|-
|[[File:announce_ghost_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Putting a dwarf (and an associated ghost) to rest with a memorial [[slab]] or a [[coffin]].
|-
|[[File:announce_cancel_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || After one week, a dwarf or tame creature has been missing, or if a dwarf comes across a corpse.
|-
|[[File:announce_military_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || Dwarves growing [[Attachment|attached]] to their weapons or armor.
|-
|[[File:announce_rumor_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || A [[rumor]] has been passed on to your dwarves.
|-
|[[File:announce_vermin_icon.png]] || style="background:#ffffc0; text-align:center" | Minor || A creature is stung by a [[bee]].
|-
|colspan="3" style="padding:7px;" | ''Major'' announcements are more important than minor announcements, and in addition to playing their message, the game may be paused and zoom to the location of the event. This is used for things that rarely happen, but aren't the ''most'' important. A wooden "ticking" sound effect is played for these announcement types.
|-
|[[File:announce_placeholder_icon.png]] || style="background:#ffb464; text-align:center" | Major || A [[animal training|trained]] creature going semi-wild (feral), the last stage before becoming wild again.
|-
|[[File:announce_trade_icon.png]] || style="background:#ffb464; text-align:center" | Major || The arrival of a [[caravan]]. Best to get ready for [[thief|thieves]] and [[ambush]]es as well.
|-
|[[File:announce_trade_icon.png]] || style="background:#ffb464; text-align:center" | Major || The arrival of the [[outpost liaison]], although this always happens at the same time as the arrival of the dwarven caravan.
|-
|[[File:announce_migrant_icon.png]] || style="background:#ffb464; text-align:center" | Major || The arrival of [[migrants]].
|-
|[[File:announce_general_icon.png]] || style="background:#ffb464; text-align:center" | Major || Uncovering of a [[thief]]. End them quickly!
|-
|[[File:announce_ambush_icon.png]] || style="background:#ffb464; text-align:center" | Major || Uncovering an [[ambush]] - ''very'' nasty if the dwarf in question is, for instance, just a poor old [[wood cutter]] out doing their job.
|-
|[[File:announce_crime_icon.png]] || style="background:#ffb464; text-align:center" | Major || Discovering a [[gremlin]].
|-
|[[File:announce_crime_icon.png]] || style="background:#ffb464; text-align:center" | Major || Someone is caught sneaking around.
|-
|[[File:announce_digging_icon.png]] || style="background:#ffb464; text-align:center" | Major || A section of a cavern has collapsed. This is usually caused by improper digging.
|-
|[[File:announce_mood_icon.png]] || style="background:#ffb464; text-align:center" | Major || A dwarf entering a [[strange mood]], claiming a workshop, setting to work, and either completing a [[legendary artifact]] or going [[insanity|insane]] in the attempt. (Each step gets its own announcement.)
|-
|[[File:announce_berserk_icon.png]] || style="background:#ffb464; text-align:center" | Major || A dwarf has gone berserk. This can happen if the dwarf is undergoing a strange mood, and does not have the required materials to construct an artifact.
|-
|[[File:announce_monster_icon.png]] || style="background:#ffb464; text-align:center" | Major || A [[bogeyman]] transforms. Can be seen in the [[object testing arena]].
|-
|[[File:announce_noble_icon.png]] || style="background:#ffb464; text-align:center" | Major || The arrival of the [[king]] or queen.
|-
|[[File:announce_monster_icon.png]] || style="background:#ffb464; text-align:center" | Major || The arrival of a [[semi-megabeast]].
|-
|[[File:announce_weather_icon.png]] || style="background:#ffb464; text-align:center" | Major || The appearance of a [[Weather#Evil weather|creeping cloud]] in [[Surroundings|evil biomes]].
|-
|[[File:Announce death icon.png]] || style="background:#ffb464; text-align:center" | Major || No available food is present. The ability to resolve this can depend on the surroundings around your fortress and what you already have.
|-
|colspan="3" style="padding:7px;" | {{colortext|#900|'''''Warning:''' Minor spoilers ahead''}}<br>
''Game-changing'' announcements are among the most important in the game. When these announcements occur, they pause the game, zoom to the location, ''and'' present a message box detailing the occurrence, in addition to repeating the message contained therein in the main feed after you close the box, for good measure. These are also reserved for incredibly rare, and potentially once-in-a-playthrough events.{{spoil small|[[File:Eerie cavern.png|center|500px]]|An example of a game-changing announcement, in ASCII mode.}}
|-
|[[File:announce_masterpiece_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || The creation of an [[artifact]], whether from a [[strange mood]] or from a [[soldier]] bestowing a name upon his/her equipment.
|-
|[[File:announce_digging_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || Discovering a [[cavern]] layer or the [[magma sea]]
|-
|[[File:announce_attack_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || The arrival of a siege.
|-
|[[File:announce_general_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || Your fortress becomes the capital.
|-
|[[File:announce_monster_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || The arrival of a [[megabeast]], [[titan]], [[forgotten beast]], transformed [[werebeast]], or the [[undead]].
|-
|[[File:announce_digging_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || Discovering a [[cavern]] layer or the [[magma sea]]
|-
|[[File:announce_digging_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || Discovering a [[deep pit]], [[magma pool]], or downward passage in a cavern.
|-
|[[File:announce_digging_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || Discovering [[adamantine]] - Praise the miners!
|-
|[[File:announce_placeholder_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || Discovering the [[Underworld]].
|-
|[[File:announce_deitycurse_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important? || A deity is disturbed, and lays a curse.
|-
|[[File:announce_holdings_icon.png]] || style="background:#ff4141; color:white; text-align:center" | Important || An area has been founded, and is incorporated into your fortress' holdings.
|}

{{Category|Interface}}
[[ru:Announcement]]

User:Phlogisticated air

2023-07-15T18:17:09Z

Phlogisticated air: Simple page

Hello! I'm new to editing wiki's, so if you have any recommendations for me to follow, you can put it in [[User talk:Phlogisticated air]] and I'll try to follow it to the best of my ability.

Hive

2023-07-15T02:38:06Z

Phlogisticated air: Added image of hive menu with royal jelly and honeycomb

{{migrated article}}
{{Quality|Unrated}}
{{av}}

{{v50_furniture|name=Hive
|tile=▬|col=6:0:1
|graphic=[[File:hive.png]]
|wood=y
|stone=y
|metal=y
|glass=y
|cloth=n
|leather=n
|ceramic=y
|bone=n
|shell=n
|gem=n
|wax=n
|value = 10
}}[[File:wooden_hive.jpg|thumb|230px|right|More honey than you'll ever care about. 🐝]]A '''hive''' is a [[tool]] and [[building]] that stores [[honey bee]] colonies. It is used in the [[beekeeping industry]] for the production of [[honeycomb]]s and [[royal jelly]], which can be processed into usable items. Citizens with the [[beekeeping]] labor enabled handle the building, removal, and management of hives. By default, the beekeeping labor is enabled for every dwarf in the fortress, unless specified by a [[labor|work detail]].

In ASCII graphics, hives use the same character as [[log]]s. As an item, they have the color of their material, but built ones are displayed as yellow.

== Manufacturing ==
Hives can be made out of [[wood]], [[stone]], [[metal]], [[glass]], or [[ceramic]]. Each material is created from their respective [[workshop]]s by their appropriate [[labor]]s. Hives are categorized as "Tools" in [[finished goods]] [[stockpile]]s.

=== Forging and melting ===
* Metal hives cost '''one''' metal bar to forge, or '''one''' [[adamantine]] wafer.
* When a hive is melted down, it will return '''0.3''' metal bars/adamantine wafers for an efficiency of '''30%'''.

== Building and removal ==
Hives can be built using {{Menu icon|b|sep=+|o|f|h}}. For hives to produce honey, they must be built adjacent to (or on) an [[tile attributes|above ground]] tile. Subterranean hives can still store colonies but will not make products.

Removing a hive via its building interface returns the hive and any items inside it, including the colony, which is released as a single honey bee that eventually disappears if left outside. Removed honeycombs can be collected and hauled, but any royal jelly is spilled onto the ground and wasted.

== Settings ==
The hive's settings can be found by clicking on a constructed hive to open its interface. There are two options which control beekeepers from doing certain jobs with the hive:

'''Install colony when ready.''' This setting is enabled by default, and will cause a beekeeper to install a colony in this hive when one becomes available, either from a wild colony or a hive colony that is ready to split. Changing this setting to '''Do not install colony''' will not allow the hive to accept new colonies. Preexisting colonies in the hive are not affected.

'''Gather any products.''' This setting is enabled by default, and allows beekeepers to gather honeycombs and royal jelly from the hive, destroying the colony. Changing the settings to '''Do not gather products''' will prevent beekeepers from gathering the products inside the hive, leaving the colonies alive so they can be saved for splitting.

The settings also display additional information about the hive: whether it has outdoor access or not (relating to above ground and subterranean tile attributes, which affect honey production), if the colony is ready to be split, and if there are too many colonized hives on the map, which affects production speed.

== Function ==
:''Further information: [[Beekeeping industry#Hive management|Beekeeping industry § Hive management]]''
{{Dual image
|premium=File:V50 hive menu graphics.png
|classic=File:V50 hive menu ASCII.png
|caption=A hive that has produced royal jelly and honeycomb
|width=310px
}}
Items in the hive can be seen by clicking on it to open the hive interface. Each hive can store a colony, which is represented as a stack of live honey bees. Colonies are collected from the wild or by splitting colonies from other hives. Three months after installation, colonies become {{DFtext|Ready to be split|2:1}}, which allows them to be used to install other hives. It produces one [[honeycomb]] and [[royal jelly]] after six months after installation, unless the colony count limit was exceeded. Once both items are produced, a beekeeper with an empty [[jug]] goes to gather the items, storing the royal jelly in the jug. Beekeepers leave both the freed honeycomb and jug of royal jelly in the hive, and [[Hauling#Food hauling|food haulers]] carry them to a stockpile. When a hive's products are gathered, the colony is destroyed, and the hive requires a new colony in order to produce again.

Colonies used to install other hives are not destroyed after installing. They need another three months to become ready to split again.

Colony size typically ranges between 10,000 and 20,000. The size of a colony does not affect production or its readiness to split. The number of bees is static and does not change over time, even after splitting. When beekeepers "split" a colony, they do not actually separate a portion of it; instead, they duplicate the old colony and haul away a new stack of live bees. Both the old and new stack will contain the same number of bees, and the number of bees in the old hive remains unchanged in the process.

When the total number of colonized hives in a fortress reach over forty, the chance of production decreases as indicated by the warnings {{DFtext|Too many hives|6:1}} and {{DFtext|Output restricted|6:0}} seen in the building settings of colonized hives. When the number of colonies reach sixty, the warning turns red ({{DFtext|Too many hives|4:1}}) and products stop appearing. The limits do not affect the duration it takes for colonies to become ready to split, and hives can still be installed with new colonies; just nothing more is produced by hives until the number of colonies is reduced back below 60. [[Flower]]s and other surrounding vegetation do not affect production. The [[surroundings]], [[weather]], and the [[season]]s have no effect on the colony or honey production.

== Hazard ==
Honey bee workers spawn from colonized hives and will occasionally sting passersby. Honey bee workers die and leave [[remains]] after stinging. Placing a [[room]] or [[activity zone]] near colonized hives puts idle citizens, visitors, and animals at high risk of being stung. Honey bee stings are reported in the [[announcement]]s under the icon [[File:Announce vermin icon.png]] / {{DFtext|·|7:0}}{{DFtext|!|7:1}} in yellow text

[[Syndrome#List of syndromes|Honey bee stings]] cause strong swelling and slight pain. They are relatively harmless and inconsequential for dwarves - they do not even produce a bad [[thought]]. Bee stings are not recorded as wounds, but the health screen will display "Slight pain" for the stung dwarf, which can trigger a "recover wounded" task. This can trigger good thoughts about being rescued and resting, even though the hospital stay is instantaneous.

{{Gamedata|{{raw|DF2014:item_tool.txt|ITEM_TOOL|ITEM_TOOL_HIVE}}}}

{{Buildings}}

{{Category|Buildings}}

File:V50 hive menu ASCII.png

2023-07-15T02:26:15Z

Phlogisticated air: Phlogisticated air uploaded a new version of File:V50 hive menu ASCII.png

== Summary ==
A screenshot of the menu of a hive that has produced royal jelly and honeycomb. In ASCII graphics.
== Licensing ==
{{Non-free Dwarf Fortress Screenshot}}

File:V50 hive menu graphics.png

2023-07-15T02:25:10Z

Phlogisticated air: Phlogisticated air uploaded a new version of File:V50 hive menu graphics.png

== Summary ==
A screenshot of the menu of a hive that has produced royal jelly and honeycomb
== Licensing ==
{{Non-free Dwarf Fortress Screenshot}}

File:V50 hive menu ASCII.png

2023-07-15T02:15:34Z

Phlogisticated air: A screenshot of the menu of a hive that has produced royal jelly and honeycomb. In ASCII graphics.

== Summary ==
A screenshot of the menu of a hive that has produced royal jelly and honeycomb. In ASCII graphics.
== Licensing ==
{{Non-free Dwarf Fortress Screenshot}}

File:V50 hive menu graphics.png

2023-07-15T02:13:52Z

Phlogisticated air: A screenshot of the menu of a hive that has produced royal jelly and honeycomb

== Summary ==
A screenshot of the menu of a hive that has produced royal jelly and honeycomb
== Licensing ==
{{Non-free Dwarf Fortress Screenshot}}

Trading

2023-07-15T01:33:31Z

Phlogisticated air: Added info on ability to see contents of a container within the "Move goods to/from depot" menu

{{migrated article}}
{{Quality|Fine}}
{{av}}
{{buggy}}
[[File:merchant_v50_preview.png|right]]'''Trading''' in ''Dwarf Fortress'' allows your dwarves to trade with friendly [[civilization]]s. They can barter their excess goods for items they need, possibly even items they can't otherwise acquire for themselves. Trade can make up for the lack of [[Industry|industries]] you neglected or don't find interesting, provide resources that aren't available where your dwarves settled, replace key tools you lost or accidentally destroyed, and allow you more freedom in selecting starting gear and skills at [[embark]]. Trading generally begins in the first [[Calendar|autumn]] after establishing your fortress, with the arrival of the [[dwarf|dwarven]] [[caravan]] from your home [[civilization]].

'''Trader''' is the generic term used at your [[trade depot]] to refer to your fortress representative (usually your [[broker]], although it can be anyone else in a pinch) when dealing with merchants in a visiting caravan. As a [[profession]], the term applies to visiting merchants and dwarves whose highest [[skill]] is [[Appraiser]].

To trade at all, you will need a [[trade depot]] and peaceful relations with at least one [[civilization]] that can reach your site. Appointing a citizen as a [[broker]] is not strictly necessary but is very helpful. Newly-founded fortresses begin the game at peace with their home civilization and will generally have at least that one trading partner each year, unless the parent civilization is [[Civilization#Dead and struggling civilizations|dead or dying]], or simply can't reach your site due to intervening mountains or open water. A [[civil war]] in your home civilization will also stop trade with them. Trading with your home civilization is quite important, as being visited by their caravans is part of attracting [[Immigration|immigrants]] after the first two waves.

==Trading flowchart ==
{{:Trading/Flowchart}}

{{Clear}}

== Trade depot ==

{{Dual image
|premium=File:DFwikiGraphicalTradeDepot.png
|classic=File:DFwikiASCIITradeDepot.png
|width=150px
|caption=A Trade Depot
}}

{{Main|Trade depot}}
Building a [[trade depot]] is a prerequisite for trade with caravans that arrive at your fortress. If traders can't access your trade depot when they show up, their caravans will simply bypass your fortress that year. While it may be convenient to build a depot outside at first, it is usually a good idea to move it inside, or secure it with [[wall]]s, [[bridge]]s and other fortifications, to protect incoming caravans and your goods from [[steals drink|thirsty animals]], [[thief|thieves]], and [[goblin]]s.

Everything that is on your map belongs to you, except:
* the items that are on merchants' animals and wagons
* the items that are in the trade depot (they belong to the caravan until they are moved out of it)
* items worn by creatures that are not [[citizen]]s of your fortress (initially forbidden, but can be claimed via unforbidding and dumping them)

== Trading ==

{{Dual image
|premium=File:DFwikiTradeScreen.png
|classic=File:DFwikiASCITradeScreen.png
|width=400px
|caption=Trading screen
}}

Before you can begin trading, you need to designate what goods to trade and have the fortress's representative trader located at the [[trade depot]]. Select the trade depot and then click either "Broker requested at depot" or "Anyone requested at depot" if you have no [[broker]] [[noble]] assigned. Be aware that without an assigned [[broker]], it's likely a random, probably unskilled dwarf will volunteer to conduct the trade. Next click "Move goods to/from depot" to be presented with a list of all items in your fortress that belong to you. Mark the goods you want to sell --insert clever advice--, and your dwarves will begin moving them to the depot. If you are unsure about which goods are in which containers, clicking the bin or barrel within the menu will show every item that is stored inside, along with its perceived value (using your broker's [[Appraisal]] skill). However, individual items cannot be marked if they are in a container. Note that during this step, we are just moving the goods physically to the trade depot, and that containers like [[barrels]] and [[bins]] must be moved with all of their contents (although for bins you will have an opportunity to specify which contained items you wish to trade).

Once the trade goods are moved to the depot and your trader has arrived, select the depot again and finally click the "Trade" button to enter the trade menu. In the trade menu, select the items to offer from the right and the desired items from the left. All caravans have a weight limit which cannot be exceeded, and the allowed additional weight is displayed in the lower left corner. If your trader has sufficient [[Appraisal]] skill, the value of all items will be displayed with reasonable accuracy. Once the proposal is ready, click the "Trade" button to propose the trade; merchants will not agree unless they make adequate profit. Clicking the "Offer as gift" button instead will make a gift of the selected items. The amount of acceptable profit is determined by the trader's [[Broker skills|skills]] and the merchant's mood, described below. Merchants may attempt to propose counteroffers if they do not accept the proposal, which can then be accepted, rejected, or further amended by the trader. If the Trader Profit is listed in green rather than yellow or red the trade will always be accepted.{{Verify}}

With more experienced traders and pleased merchants, even marginally profitable trades can be successful, and counterproposals can be rejected safely, offering the same trade again. Note however that a low profit margin for the traders may not be desirable - it has been suggested that both export and profit numbers influence the size of next year's caravan and, in the case of the dwarven caravan, immigration numbers.{{Verify}}

Note: Goods brought by caravans rarely have base quality higher than superior, and decorations on a good rarely exceed superior as well.

Note if you give or trade away an [[Artifact|artifact]], you will receive a special notification:
;[[File:Treasure_Gift.PNG|750px]]
;[[File:Treasure_Trade.PNG|750px]]

=== Items cue colors ===
{| class="wikitable"
! {{DFtext|Brown|6:0}}
| Items have been created (or modified) by your fortress. They can be traded away or offered as a gift.
|-
! {{DFtext|Gray|7:0}}
| Items were created by another source. They can be traded, but if one of these items has been selected, the entire selection cannot be offered as a gift.
|-
! {{DFtext|Purple|5:0}}
| Items are under a no-export mandate. If they are traded away it will result in disciplinary action (see [[justice]]) against the dwarf that brought the item to the depot.
|-
! {{DFtext|Green|2:0}}
| Items have just been gifted to the caravan and they will not trade it back.
|-
! {{DFtext|Red|4:0}}
| Items have been seized from another caravan and cannot be traded as is; you will need to decorate them or turn them into other items for them to become "valid" trading items.
|}

Note that containers (barrels, bins, etc.) will be displayed according to the origin of the ''container'', not the contents. So a foreign barrel holding locally-produced beer will display as foreign (white). Once you {{k|v}}iew the container, the locally-made contents are displayed as local (brown).

=== Seizing items ===

Clicking "Seize" from the trade menu will seize the selected items of the merchant's. If you seize goods from a caravan, the merchant will respond "Take what you want. I can't stop you." and then leave immediately without the seized goods. Items cannot be seized from the dwarven caravan, and other races will not buy goods stolen from one of their caravans (then marked in red) unless they are tricked into asking for them via counteroffer, or the items are "laundered" by decoration or used to create other goods. Seizing goods will hurt diplomatic relations, but is not grounds for an automatic [[siege]].

Pressing the seize button while no goods are selected will result in the merchant interpreting your seizure as a joke. This apparently does nothing to benefit or hinder your trading.

As a side note, if you deconstruct your trade depot with a caravan in it, all the caravan's items will drop to the ground, to be readily hauled away by your dwarves. This does not mark the items as stolen, and the caravan will leave. However, ''next'' year's caravan is partly based on the profits from the previous year - so if you are relying on that race's caravans for needed items, you're hurting yourself in the long run.

Trying to interrogate a merchant can also cause a wagon to fall apart.

Another way to steal without marking as stolen is to forbid the trade depot just before they leave, causing them to leave their goods at the depot.

If you're using the search plugin for [[Utility:DFHack|DFHack]] (e.g. from the [[Utility:Lazy Newb Pack|Lazy Newb Pack]]), be warned that {{K|s}} means "seize" and '''NOT''' "search", and there is '''no warning''' for it. Use {{K|q}} to search the merchant's goods and {{K|w}} to search yours.

Note that the civilization attached to a particular caravan will keep track of the value of items the caravan was carrying when they set out to trade, and they will compare this value with the value of items they return home with. Regardless of what method you use to confiscate items from a caravan, even if you came to possess the goods through no fault of your own (an [[ambush]] killed the traders and guards, for example) the parent civilization may decide that you stole from them and send a [[siege]] instead of a caravan the following year. It is prudent to take measures to protect caravans visiting your lands!

===Offering items===

You can also give away items, as gifts to the leaders of the [[civilization]] you are trading with. This presumably helps relations between yourself and the other faction, though there is not yet a clear correlation between the value of the offerings and the improvement to relations. The exact effects of offerings on trading are unknown but it is believed due to the offerings' net trade value being counted towards the merchants' profit, possibly with a modifier (possibly a multiplier of more than 1 as a bonus or less than 1 to compensate for the improved relations){{Verify}}, which in turn increases the quantity and variety of trade goods brought by next year's caravan. Also the [[Monarch]] requires offerings to be made before their arrival. You cannot offer items that were not made at your fortress; the merchants do not want your spare [[Goblinite]] clothes.

The value of an offering for the purpose of becoming the capital is adjusted by your current export agreement.

Unless you are looking for [[fun]], under no conditions should you offer or trade items which involve animal products, wood, or used wood in their creation (clear glass, for example) to [[elves]], as they will refuse the trade, take offense, and leave, possibly damaging relations enough to provoke a war between you and the elven civilization you traded with. They will accept their own "grown wood" items in trade without insult, however. See below and the [[elves]] page for more detailed information.

== Miscellaneous trading advice ==
* Thieves and thieving critters tend to follow caravans. Expect assaults and intruders.
* Create your trading depot inside your fort, preferably in the beginning. Place a 3-tile wide path—which must be free of obstructions such as stairways, traps, minecart tracks and boulders (not stones)—to the entrance of the fort and position war-trained animals along it (chains do not block wagons); this will help to protect the traders and keep the depot close to your supplies.
* Avoid having multiple wagon paths to your depot. Caravan [[wagon]]s cannot move through each other, and if two wagons happen to meet at a fork they may become gridlocked against each other, resulting in the destruction of wagons and loss of trade opportunities.
* All caravans will bring extra food (meat and edible plants), wooden logs, and cloth/leather (for making clothes) if the supplies of your fortress are low enough, independent of whether or not you requested them. This does not apply in the case that the weight limit is exceeded by (other) items you requested. The supply situation, as observed by traders, is based solely on the number of unforbidden items in your fortress, stockpiled or not; thus, it is possible to trick caravans into thinking your supplies are low by [[forbid]]ding all of your relevant stocks immediately prior to their arrival.
**In order to '''avoid''' this behavior, you should make sure that, for each dwarf in your fortress, you have the following ''unforbidden'' items:
*** 5 pieces of food - meat, fish, plants, or "other" in your [[Status]] screen (even though "other" includes inedible items)
*** 1 wood log
*** 5 pieces of cloth, pieces of leather, or complete sets of [[wear|pristine]] clothing (shirt+pants+shoe)
* Define your trade depot as a burrow. When traders arrive, you can add your broker or another dwarf, perhaps one you want to train in trading, to the burrow. They will head to the depot immediately, and stay there until you remove them from the burrow.
* Each trade you make (regardless of value) will increase your trader's skills by 50, distributed among Comedian, Judge of Intent, Negotiator, and Persuader. Each skill seems to gain around 5-15 experience points, but the sum will always be 50. The skill gain occurs as soon as the "t" button is pressed - if the offer is rejected, the dwarf will still gain 50 points. If the same offer is subsequently accepted, no additional skill will be gained.
* Selecting "only broker may trade" ensures that you will start negotiations with a decently-skilled trader, but it may require a significant delay if your broker is far away (or is busy with other tasks). Selecting "anyone can trade" will ensure that you get the trading done quickly, but at the cost of all item trade values being extremely inaccurate. Once your fortress can produce enough goods to reliably buy out the whole caravan, waiting for your broker is less important; allowing your commoners to trade spreads out the trading skill gains and eliminates the micromanagement of trying to get your broker to the depot in a timely manner.

== Types of Merchant Caravans==
By default, each friendly [[civilization]] (including your own) will send one merchant [[caravan]] per year. Each race always trades in a particular season: autumn for dwarves, spring for elves, and summer for humans. (No race trades in winter by default.) If you have friendly contact with multiple civilizations of the same race, you may even get multiple caravans in a single season. Each race brings different goods, and they sometimes have different trading preferences.

If your fortress was founded in spring, it is highly unlikely that you will receive an elven caravan that spring, and it is uncommon for a human caravan your first summer, so probably your first and only caravan your first year will be the dwarven one. Caravans will only show up if that race considers the fortress site accessible (as denoted on the embark screen) and "worth the effort" (as determined by the [[Entity token#PROGRESS_TRIGGER_POPULATION|[PROGRESS_TRIGGER_*]]] tokens in the entity definition), with the exception of dwarves, who always arrive unless they are [[extinct]].

=== Dwarven ===
{{quote|
: ''Greetings from the mountainhome. Your efforts are legend there. Let us trade!''
:: (Or, if your fort ''is'' the [[Fortress|mountainhome]]...)
: ''Greetings from the outer lands. Your efforts are legend there. Let us trade!}}

Typically, the first caravan you receive is the [[Dwarves|dwarven]] one from your home civilization, giving you at least 22 weeks to prepare (assuming you started mid-spring, the default). This does require that you are on the same continent as they are, and you are not isolated by mountains or bodies of water.

The dwarven caravan:
* arrives in [[Calendar|autumn]].
* carries metal bars, [[leather]], weapons and armor, food and booze, and more. Dwarves alone may bring [[steel]] and steel goods.
:* If the trading civilization does not have access to [[iron]], they can still bring steel (and steel goods) and [[pig iron]] bars, but will not bring iron products.
* usually carries a selection of books that your civilization has access to. This can include books written in previous forts of yours within the same civilization.
* is heavily guarded.

The dwarven caravan from your home civilization:
* sends a liaison who will speak with the [[Expedition leader]], [[Mayor]], [[Baron]], [[Count]], or [[Duke]] to negotiate an import-export agreement (unless the [[Monarch]] is present).
* influences the number of immigrants received (if the caravan leaves intact).
* will not cause sieges when repeatedly destroyed or lost.
* is the only caravan to arrive during a fortress' first year.
* always arrives, regardless of embark location, unless the dwarven civilization is [[extinct]].
* cannot have its goods seized from the trade menu.
* may not arrive if your civilization lacks any notable figures.
* cannot be offered goods if the monarch is present.

=== Elven ===
[[Image:Evil_elves.png|thumb|400px|A typical elven caravan.]]
{{quote|Greetings. We are enchanted by your more ethical works. We've come to trade.}}

Friendly [[elf|elven]] civilizations will each send a caravan sometime in [[Calendar|spring]], giving you about a full year before the first caravan arrives when starting at the default time.

The elven caravan:
* arrives in the [[Calendar|spring]].
* carries [[cloth]], [[rope]]s, various above-ground seeds, [[plant]]s and their byproducts, [[log]]s, [[wood]]en goods & [[weapon]]s, clothing and [[armor]], and may carry tame exotic [[creature]]s.
* does not use [[wagon]]s, only [[Creature#Domestic animals|pack animals]]
* is unguarded.
* will become angry and immediately leave if offered "unethical" wooden or animal products; see [[Trading#Unacceptable items|below]].

Elven caravans don't use wagons, instead bringing all of their goods on pack animals. This means that they don't need any special accommodation to get to the [[trade depot]]: any untrapped one-tile-wide path will suffice. However, this also means that elven caravans have a much lower weight limit, which means selling them heavy items like [[furniture]] or large [[stone]] goods can be problematic. Their caravans are also unguarded, and may need protection if your fortress is in a [[Surroundings|dangerous environment]] or [[Siege|under attack]].

Elves will only ever have goods made from above-ground plants, goods made from their special "grown" wood, or various exotic [[creature]]s or [[vermin]] in grown wooden [[cage]]s. The possibility of getting a breeding pair of [[giant tiger]]s is nice, although they might just bring something useless like [[raven]]s or [[Green tree frog|tree frog]]s instead. If you trade with elves for unusual [[plant]] [[crop]]s, you may be able to [[brew]] or [[Millstone|otherwise]] [[Farmer's workshop|process]] those plants for [[seed]]s you can later grow in your own [[Tile attributes|above-ground]] [[Farming|farm]]s, if you live in a compatible [[biome]]. Elves also wear and sell the same-sized [[clothing]] as dwarves, if you haven't gotten your [[textile industry]] going yet. Otherwise, food, logs, cloth, or miscellaneous wooden goods like [[cage]]s, [[barrel]]s, and [[bucket]]s can be useful.

Elves don't forge [[metal]]. All of their [[weapon]]s and [[armor]] are made from [[wood]], including item types that dwarves can't normally make from wood, like [[spear]]s or different [[sword]] varieties. These are even less useful than most arms and armor sold by caravans, as wooden weapons and armor are [[Material science#Material and item properties|basically useless in combat]]. Even metal-poor dwarves can cheaply make superior arms and armor from bone or leather. It's probably for the best that elves are so poorly armed, because offending them and damaging your [[Diplomacy|diplomatic relationship]] with their civilization is very easy.

==== Unacceptable items ====
Elves [[Elf#Ethics|view]] living trees as sacred and dislike the killing of non-hostile animals; they're the only [[Ethic#Ethics of vanilla civilizations|unmodded civilization]] to do so. Offering them wood or animal-derived products, either as part of a trade or as a gift, will offend the merchant. The merchant will rebuke your broker and leave immediately. This offense reduces your [[civilization]]'s [[Diplomacy|diplomatic relationship]] with the elves' civilization, possibly leading to [[war]] after multiple infractions.

Examine your items carefully! Elf traders will reject [[container]]s holding a prohibited item, otherwise-acceptable items stored in a prohibited container, and all items «[[decoration|decorated]]» with a prohibited [[material]]. If you want to sell food or liquid to elves, it's best to use a [[large pot]] or one of their own grown wood barrels.

Note that elves only care about the items they are actually offered. It's perfectly allowable to use wooden [[bin]]s to haul items to the [[trade depot]], as long as you only offer the elves acceptable items from the bin and not the bins themselves.

===== Items made from wood =====
{{quote|Once a beautiful tree, and now? It is a rude bauble, fit only for your kind.}}
Elves do not want to be offered items you made from wood, nor do they want most items that require wood as part of their creation process.
* All items made of or decorated with [[wood]]. This includes wood from [[Tree#Underground trees|tree-like subterranean fungus]], such as [[tower-cap]]s. Elves make an exception for the "grown" wood items they make themselves, but items made by other races using "grown" wooden logs are still not acceptable.
* All items made of or decorated with wood derivatives. This includes [[ash]], [[potash]], [[pearlash]], [[charcoal]], and [[lye]]. Note the exception for ash-[[glaze]]d [[earthenware]] below, however.
* Items made from or decorated with clear or crystal [[glass]], as these items require [[pearlash]] in their creation. Again, note the exception for raw or cut glass [[gem]]s below.
* [[Obsidian]] [[short sword]]s. These require wood in their production, for the handle.

===== Animal products =====
{{quote|I see your low race still revels in death. That poor, gentle creature...}}
Elves also reject the majority of animal products. (This taboo extends to items made from intelligent creatures, despite the fact that you may see elf [[historical figure]]s wearing items made from the hair or bones of their enemies.)
* Items and decorations made from [[body parts]], such as [[hair]], [[bone]]/[[skull]], [[shell]], [[horn]]/hoof/antler, and [[ivory]]/[[tooth]]. It also includes items dwarfs can't normally use for crafting, such as [[nail]]s, [[chitin]], and [[scale]]s.
* [[Leather]] or [[parchment]]/vellum, and all items made from them. These are made from [[skin]]s.
* [[Wool]] [[yarn]] and [[cloth]], as well as all items made from them. It doesn't matter how well you treat your [[sheep]], elves still associate animal products with death.
* [[Meat]] (including [[prepared organs]]), [[fish]] (both raw and prepared), [[fat]], and [[tallow]]
* [[Egg]]s. Elves aren't keen on keeping chickens, either.
* [[Prepared meals]] made using any of the above products.
* Tallow [[soap]]
* [[Corpse]]s and [[body parts]] themselves, although these are usually worthless anyway.
* [[Blood]], even if you somehow manage to get it into an elf-friendly container.

A distinct retort awaits dwarves who are so tactless as to offer goods made from both wood products '''and''' animal products at the same time (such as tallow soap, or an item decorated with both wood and bone):
{{quote|You truly despise life, don't you? I am beside myself with grief. Perhaps we will show you how they suffered.}}

===== Acceptable items =====
Any item that isn't specifically prohibited above is acceptable to elves. A non-exhaustive list of items they accept:

* The "Feather Tree Egg Yolk" that the elves litter your trade depot with, can be traded back to them. Useful free trade items if you're looking to level another broker.
* Items made from or decorated with [[stone]], as well as raw [[clay]] or raw [[sand]]. This includes items made from [[petrified wood]], [[lignite]], or [[bituminous coal]]; elves aren't concerned with items that were plants or animals in a different geological age.
** [[Gizzard stone]]s are acceptable. Elves can't tell them from any other object made of stone.
* Items made from or decorated with [[metal]] (including [[steel]]), green [[glass]], or [[ceramic]]. Elves are content to assume your dwarves fuel their craft with [[coke]] and [[magma]] rather than [[charcoal]].
* All rough gems and cut gems, as well as items and decorations made from [[gem]] materials. Note that clear glass and crystal glass are not gem materials and are generally not acceptable, even though they can be used for [[Gem setting|gem decoration]]s and gem [[craft]]s.
** Due to a long-standing bug{{bug|919}}, elves do not examine the material rough gems or cut gems are made of. You can safely sell them raw clear or crystal glass, or cut gems made from clear or crystal glass, as long as you haven't used those gems for decorations. Be careful, because clear or crystal glass [[craft]]s from the "cut gems" job, including "large" gems, are still unacceptable.
* [[Plant]] and fungus products in general. Unless otherwise prohibited, all of these items are acceptable either as themselves or as the material for an item or decoration:
** Plant [[crop]]s, [[fruit]]/pods, [[seed]]s/nuts, and [[leaf|leaves]]/bulbs/flowers. Anything that can be grown on a [[farm plot]] or harvested with [[herbalism]] is one of these four. This includes non-wooden produce from trees.
** [[Plant fiber]] [[thread]] and [[cloth]], and all items made from them.
** Processed plant products. This includes (but isn't limited to) [[booze]], [[dye]], [[flour]], [[dwarven sugar]] and [[dwarven syrup]], [[oil]], [[press cake]], and [[paper]]. [[papyrus]] sheets seem to be a notable exception.
* [[Silk]] [[thread]] and [[cloth]] and items made from them. Elves don't care if you're exploiting spiders.
* Products of the [[beekeeping industry]], including [[honey]], [[royal jelly]], [[mead]], [[wax]], and wax [[craft]]s.
* [[Cheese]] and [[milk]]
* [[Prepared meal]]s made entirely with allowed ingredients.
* "Grown" wood items. These can generally only be obtained from elves, and were made in keeping with elven ethics. Note that these items can still become unacceptable if they contain unacceptable items or are later decorated with unacceptable materials.
* Items made from [[Adamantine|certain]] [[Divine metal|spoiler]] [[Divine fabric|materials]], if you're willing to give these up.
* Live [[creature]]s or [[vermin]]. Since these can only be traded when in a [[cage]] or [[animal trap]], make sure the cage or trap is also made of acceptable materials.
* [[Soap]] made from [[oil]]. This may be a bug{{bug|8571}}, as even plant-based soap requires [[lye]], which is made from [[ash]].
* Otherwise-acceptable items are not disqualified by [[ash]] [[glaze]], which may be a bug{{bug|4652}}.

=== Human ===
{{quote|Greetings. The craftsdwarfship of the dwarves is unparalleled. Let's make a deal!}}

Assuming you do have friendly contact with [[human]]s, their first caravan will arrive sometime in summer, giving you well over a full year before they arrive.

The human caravan:
* arrives in [[Calendar|summer]]. (Usually your first caravan opportunity.)
* carries metal bars, sand, [[leather]], cloth, wood, food and booze, books, ropes, waterskins, quivers, backpacks, metal weapons and clothing and armor, cages and a few domestic animals.
* carries only large-sized clothing and armor, which is unusable by dwarves.
* is moderately guarded.
* sends a chief treasurer to negotiate import/export agreements

==== Good Humor ====
Choosing to seize goods from a human caravan without marking anything to be taken is treated as a joke, which will raise the visiting trader's mood. This can only be done once each year.

=== Goblins and Kobolds ===
{{mod}}
{{main|modding#trade}}

A [[goblin]] caravan will only arrive if you mod the game, primarily because their entity lacks the [[entity token]]s needed to make use of pack animals and wagons. That, and that the token {{token|BABYSNATCHER|e}} makes them hostile to all non-goblin civilizations. The same caveats apply to [[kobold]]s (whose {{token|UTTERANCES|c}} and {{token|ITEM_THIEF|e}} tags, similarly, make them hostile to every civilization).

The goblin caravan:
*will arrive every season, four times per year
*is unguarded
*brings mostly food and cloth
*does not send a liaison or a guild representative
*does not make import/export agreements

== Merchant mood ==
{{Verify|Are we sure that this section is correct?}}
If your trader has Novice or better [[Judge of intent]] skill, there will be a line added below the merchant's dialogue describing the caravan's attitude. Their attitude rises with successful trades (especially if they get lots of profit) and falls when you propose deals they don't like. You can never make a deal that's at a loss for the merchant, even if they are at the highest possible mood.

* {{DFtext|(trader) seems ecstatic with the trading.|2:1}}
* {{DFtext|(trader) seems very happy about the trading.|3:1}}
* {{DFtext|(trader) seems pleased with the trading.|1:1}}
* {{DFtext|(trader) seems willing to trade.|7:1}}
* {{DFtext|(trader) seems to be rapidly losing patience.|6:1}}
* {{DFtext|(trader) is not going to take much more of this.|4:1}}
* {{DFtext|(trader) is unwilling to trade.|5:1}}

The happier you make a merchant, the less profit margin they will demand in a trade. Dwarven merchants start off wanting about 100% profit, maybe a little more. If you repeatedly offer less than what they expect, that will "lower" their mood. If, on the other hand, you meet or exceed their expectation, that will, over several trades, improve their mood. If merchants reach the lowest level, no further trade will be possible, and they will immediately pack up and leave your depot. Since annoyed merchants are more likely to reject deals, you should be generous in initial negotiations. Skilled negotiators seem less likely to offend merchants with unsuccessful deals.

An easy way to capitalize on this mood system is to perform several partial trades. First trade for a few items, offering goods twice the value of the items you ask for (e.g. offer 2000☼ for 1000☼ of his stuff). This will likely make the merchant ecstatic about trading with you. Perform the next trades more aggressively, working them down to about a 30% profit. With the merchant in such a good mood, they are more likely to counteroffer than reject a trade outright. If you don't like the counter-offer, try to split the difference, or just back out of the trade and start again.

== Trade Agreements and Liaisons ==
[[Outpost liaison]]s (from your own civilization) and foreign Merchant Nobles (if added with the [[Position token#TRADE|TRADE responsibility]]) will arrive with the caravan to speak to your [[noble]] dwarves (and they ''will'' speak to those dwarves, even if they have to wait at their bedside in the hospital for months after the caravan has left), appearing on the map edge at the same time as the caravan (though in a different location). Meeting with them allows you to request specific items for the next caravan to bring (at a premium price) or take requests for production for the next caravan (for which the merchants will pay a premium).

Current [[Trade agreement|trade agreements]] can be viewed through the Civilization menu ({{k|c}}). These trade agreements are cleared when a liaison of the corresponding civilization enters the screen, so they are generally not accessible after the caravan has arrived.

In the event that your leader is replaced, killed, or taken by a [[strange mood]], the liaison may decide to leave your fortress [[stymied|"unhappy"]].{{bug|576}} Curiously, this will '''not''' occur if your leader is otherwise unable to perform the "conduct meeting" task. You can currently lock a liaison in a room and they will wait years to attend the meeting your noble is constantly conducting (and all subsequent diplomats appear to wait in line for the first to finish); this behavior is presumably a bug.{{bug|8947}}

Whether having successfully met with your leader or given up, a liaison who has decided to leave but is prevented from reaching the map edge will eventually go [[insane]].

== Bugs ==

* Merchants who are attacked by enemies or even wild animals will sometimes become disconnected from the trade depot and refuse to pack of their things to leave the map, and these items will remain 'stuck' in the depot. Deconstructing the trade depot usually forces them to leave, presumably with the downside of causing those goods to be considered seized by the player.
* Aggressive, untrainable creatures (captured goblins, for example) cannot be traded; when a dwarf attempts to move the caged animal to the Depot, the creature is set free.
* When merchants leave with an animal, the merchants seem to be dragging their beast of burden instead of leading it. If the animal is incapacitated but not dead, the merchant will continue to walk at the same speed, dragging the unconscious beast.
* If a merchant's chosen map edge exit is guarded by a hostile creature (including those on a [[restraint]]), the merchant will wander back and forth repeatedly and eventually go insane rather than path to an alternate exit.
* Animals bought from merchants don't always become available for use.{{bug|10162}}

== Loyalty cascade ==
{{main|Faction#Loyalty cascade|l1=Faction}}
If you order your military to kill merchants from your own civilization, a bizarre result of the way loyalty is handled makes the members of your military who attacked the traders become enemies of your civilization, but remain members of your fort's government (dwarves of this [[faction]] are referred to as ''separatists''). As enemies, they attack your other dwarves (''citizens''), but as members of the fort, they still follow orders. Allowing citizen militia dwarves to attack the separatists will give them opposite loyalties of the separatists, (i.e. loyal to civ, not to fort), or ''loyalists'', who do '''not''' follow orders. And then, if a separatist or loyalist kill a citizen, they become enemies of the civ '''and''' fort, making them ''Renegades'', who are essentially complete enemies of the citizens.

To prevent the cascade from spreading, order the original separatists away from the fortress and let them fight amongst themselves. If the results are renegades, it is okay to allow other dwarves to kill them (by stationing them nearby). If the results are separatists/loyalists, then you will need to separate them, somehow.

== Exploits ==
*Deconstructing the Depot will cause merchants to leave your fortress and abandon any goods in the Depot because items are not available until the building is fully deconstructed. However any animals they had caged will still belong to the merchants and only become friendly, you won't actually own them. According to Toady One, this is actually working as intended, and is not really an exploit or bug: "...the reckoning comes when they return with lesser value, and it has the same negative effect (it'll be listed as a disaster rather than an intentional seizing -- the depot could be destroyed, for instance -- but it counts for the same value if I remember). The overall wording could be changed and the interaction could be deepened to recognize this or that, but it's working as intended."[https://dwarffortress.mantishub.io/view.php?id=293#c8393]
*If you wait until the merchants leave the map, you can "claim" caged animals by linking a lever to the cage and opening it, the animals will be released in a tamed state. Check the {{k|u}}nit screen before releasing them; if the creatures still show as Merchant creatures, they will wander off the map when released; if they show as Tame creatures, they will stay once released.
*If you lock them in your fortress for a minute or two (real time), the merchants '''may''' drop items and leave behind pack animals (both of which are yours for the taking!) Note: Results are not consistent.
* If [[Caravan#Destruction|spooked or attacked]] the merchants' caravan could leave their stuff behind as they attempt to flee the map, leaving the items free for the taking.

[[File:Bullock_Team_Wool_Wagon.jpg|thumb|400px|center|An old trading wagon from the 1880's.]]

== World level trade ==
During world generation, trade is established between sites. This probably determines growth.

{{Translation| dwarven = nish | elvish = lathì | goblin = otsmor | human = batow}}

{{Category|Trade| }}
[[ru:Trading]][[zh:Trading]]

Bookcase

2023-07-13T04:31:55Z

Phlogisticated air: Changed to v50 keybinds and furniture info rectangle

{{migrated article}}
{{Quality|Unrated}}
{{av}}
{{v50_furniture|name=Bookcase
|tile=≡|col=0:7:0
|graphic=[[File:Bookcase sprite.png]]
|wood=y
|stone=y
|metal=y
|glass=y
|cloth=n
|leather=n
|ceramic=n
|bone=n
|shell=n
|gem=n
|wax=n
|value = 10
|rooms=
* [[Library]]
}}

'''Bookcases''' are [[furniture]] used in [[library|libraries]] to store written [[book]]s. They are built using {{Menu icon|b|f|o|sep=+}}.

Bookcases can be crafted from 1 log in the [[carpenter's workshop]], 2 bars in the [[metalsmith's forge]], 1 bag of [[sand]] in the [[glass furnace]], or 1 stone in the [[stoneworker's workshop]]. Bookcases are stockpiled in furniture stockpiles under "Other Large Tools".

It is not easy to find how many books a bookcase will hold (codices do not have a fixed size). A bookcase should be capable of between 200 and 500 codices, so not many bookcases are needed for small libraries. A single bookcase can hold 500 scrolls or 1,000 quires.

{{Gamedata|{{raw|DF2014:item_tool.txt|ITEM_TOOL|ITEM_TOOL_BOOKCASE}}}}
[[Ru:Bookcase]]

Hive

2023-07-12T21:00:03Z

Phlogisticated air: changed "specifically specified" to "specified"

{{migrated article}}
{{Quality|Unrated}}
{{av}}

{{v50_furniture|name=Hive
|tile=▬|col=6:0:1
|graphic=[[File:hive.png]]
|wood=y
|stone=y
|metal=y
|glass=y
|cloth=n
|leather=n
|ceramic=y
|bone=n
|shell=n
|gem=n
|wax=n
|value = 10
}}[[File:wooden_hive.jpg|thumb|230px|right|More honey than you'll ever care about. 🐝]]A '''hive''' is a [[tool]] and [[building]] that stores [[honey bee]] colonies. It is used in the [[beekeeping industry]] for the production of [[honeycomb]]s and [[royal jelly]], which can be processed into usable items. Citizens with the [[beekeeping]] labor enabled handle the building, removal, and management of hives. By deafult, the beekeeping labor is enabled for every dwarf in the fortress unless specified by a [[labor|work detail]].

In ASCII graphics, hives use the same character as [[log]]s. As an item, they have the color of their material, but built ones are displayed as yellow.

== Manufacturing ==
Hives can be made out of [[wood]], [[stone]], [[metal]], [[glass]], or [[ceramic]]. Each material is created from their respective [[workshop]]s by their appropriate [[labor]]s. Hives are categorized as "Tools" in [[finished goods]] [[stockpile]]s.

=== Forging and melting ===
* Metal hives cost '''one''' metal bar to forge, or '''one''' [[adamantine]] wafer.
* When a hive is melted down, it will return '''0.3''' metal bars/adamantine wafers for an efficiency of '''30%'''.

== Building and removal ==
Hives can be built using {{Menu icon|b|sep=+|o|f|h}}. For hives to produce honey, they must be built adjacent to (or on) an [[tile attributes|above ground]] tile. Subterranean hives can still store colonies but will not make products.

Removing a hive via its building interface returns the hive and any items inside it, including the colony, which is released as a single honey bee that eventually disappears if left outside. Removed honeycombs can be collected and hauled, but any royal jelly is spilled onto the ground and wasted.

== Settings ==
The hive's settings can be found by clicking on a constructed hive to open its interface. There are two options which control beekeepers from doing certain jobs with the hive:

'''Install colony when ready.''' This setting is enabled by default, and will cause a beekeeper to install a colony in this hive when one becomes available, either from a wild colony or a hive colony that is ready to split. Changing this setting to '''Do not install colony''' will not allow the hive to accept new colonies. Preexisting colonies in the hive are not affected.

'''Gather any products.''' This setting is enabled by default, and allows beekeepers to gather honeycombs and royal jelly from the hive, destroying the colony. Changing the settings to '''Do not gather products''' will prevent beekeepers from gathering the products inside the hive, leaving the colonies alive so they can be saved for splitting.

The settings also display additional information about the hive: whether it has outdoor access or not (relating to above ground and subterranean tile attributes, which affect honey production), if the colony is ready to be split, and if there are too many colonized hives on the map, which affects production speed.

== Function ==
:''Further information: [[Beekeeping industry#Hive management|Beekeeping industry § Hive management]]''

Items in the hive can be seen by clicking on it to open the hive interface. Each hive can store a colony, which is represented as a stack of live honey bees. Colonies are collected from the wild or by splitting colonies from other hives. Three months after installation, colonies become {{DFtext|Ready to be split|2:1}}, which allows them to be used to install other hives. It produces one [[honeycomb]] and [[royal jelly]] after six months after installation, unless the colony count limit was exceeded. Once both items are produced, a beekeeper with an empty [[jug]] goes to gather the items, storing the royal jelly in the jug. Beekeepers leave both the freed honeycomb and jug of royal jelly in the hive, and [[Hauling#Food hauling|food haulers]] carry them to a stockpile. When a hive's products are gathered, the colony is destroyed, and the hive requires a new colony in order to produce again.

Colonies used to install other hives are not destroyed after installing. They need another three months to become ready to split again.

Colony size typically ranges between 10,000 and 20,000. The size of a colony does not affect production or its readiness to split. The number of bees is static and does not change over time, even after splitting. When beekeepers "split" a colony, they do not actually separate a portion of it; instead, they duplicate the old colony and haul away a new stack of live bees. Both the old and new stack will contain the same number of bees, and the number of bees in the old hive remains unchanged in the process.

When the total number of colonized hives in a fortress reach over forty, the chance of production decreases as indicated by the warnings {{DFtext|Too many hives|6:1}} and {{DFtext|Output restricted|6:0}} seen in the building settings of colonized hives. When the number of colonies reach sixty, the warning turns red ({{DFtext|Too many hives|4:1}}) and products stop appearing. The limits do not affect the duration it takes for colonies to become ready to split, and hives can still be installed with new colonies; just nothing more is produced by hives until the number of colonies is reduced back below 60. [[Flower]]s and other surrounding vegetation do not affect production. The [[surroundings]], [[weather]], and the [[season]]s have no effect on the colony or honey production.

== Hazard ==
Honey bee workers spawn from colonized hives and will occasionally sting passersby. Honey bee workers die and leave [[remains]] after stinging. Placing a [[room]] or [[activity zone]] near colonized hives puts idle citizens, visitors, and animals at high risk of being stung. Honey bee stings are reported in the [[announcement]]s under the icon [[File:Announce vermin icon.png]] / {{DFtext|·|7:0}}{{DFtext|!|7:1}} in yellow text

[[Syndrome#List of syndromes|Honey bee stings]] cause strong swelling and slight pain. They are relatively harmless and inconsequential for dwarves - they do not even produce a bad [[thought]]. Bee stings are not recorded as wounds, but the health screen will display "Slight pain" for the stung dwarf, which can trigger a "recover wounded" task. This can trigger good thoughts about being rescued and resting, even though the hospital stay is instantaneous.

{{Gamedata|{{raw|DF2014:item_tool.txt|ITEM_TOOL|ITEM_TOOL_HIVE}}}}

{{Buildings}}

{{Category|Buildings}}

Hive

2023-07-12T20:56:51Z

Phlogisticated air: small v50 changes and changing info screen to be consistant with barrel and bin pages

{{migrated article}}
{{Quality|Unrated}}
{{av}}

{{v50_furniture|name=Hive
|tile=▬|col=6:0:1
|graphic=[[File:hive.png]]
|wood=y
|stone=y
|metal=y
|glass=y
|cloth=n
|leather=n
|ceramic=y
|bone=n
|shell=n
|gem=n
|wax=n
|value = 10
}}[[File:wooden_hive.jpg|thumb|230px|right|More honey than you'll ever care about. 🐝]]A '''hive''' is a [[tool]] and [[building]] that stores [[honey bee]] colonies. It is used in the [[beekeeping industry]] for the production of [[honeycomb]]s and [[royal jelly]], which can be processed into usable items. Citizens with the [[beekeeping]] labor enabled handle the building, removal, and management of hives. By deafult, the beekeeping labor is enabled for every dwarf in the fortress unless specifically specified by a [[labor|work detail]].

In ASCII graphics, Hives use the same character as [[log]]s. As an item, they have the color of their material, but built ones are displayed as yellow.

== Manufacturing ==
Hives can be made out of [[wood]], [[stone]], [[metal]], [[glass]], or [[ceramic]]. Each material is created from their respective [[workshop]]s by their appropriate [[labor]]s. Hives are categorized as "Tools" in [[finished goods]] [[stockpile]]s.

=== Forging and melting ===
* Metal hives cost '''one''' metal bar to forge, or '''one''' [[adamantine]] wafer.
* When a hive is melted down, it will return '''0.3''' metal bars/adamantine wafers for an efficiency of '''30%'''.

== Building and removal ==
Hives can be built using {{Menu icon|b|sep=+|o|f|h}}. For hives to produce honey, they must be built adjacent to (or on) an [[tile attributes|above ground]] tile. Subterranean hives can still store colonies but will not make products.

Removing a hive via its building interface returns the hive and any items inside it, including the colony, which is released as a single honey bee that eventually disappears if left outside. Removed honeycombs can be collected and hauled, but any royal jelly is spilled onto the ground and wasted.

== Settings ==
The hive's settings can be found by clicking on a constructed hive to open its interface. There are two options which control beekeepers from doing certain jobs with the hive:

'''Install colony when ready.''' This setting is enabled by default, and will cause a beekeeper to install a colony in this hive when one becomes available, either from a wild colony or a hive colony that is ready to split. Changing this setting to '''Do not install colony''' will not allow the hive to accept new colonies. Preexisting colonies in the hive are not affected.

'''Gather any products.''' This setting is enabled by default, and allows beekeepers to gather honeycombs and royal jelly from the hive, destroying the colony. Changing the settings to '''Do not gather products''' will prevent beekeepers from gathering the products inside the hive, leaving the colonies alive so they can be saved for splitting.

The settings also display additional information about the hive: whether it has outdoor access or not (relating to above ground and subterranean tile attributes, which affect honey production), if the colony is ready to be split, and if there are too many colonized hives on the map, which affects production speed.

== Function ==
:''Further information: [[Beekeeping industry#Hive management|Beekeeping industry § Hive management]]''

Items in the hive can be seen by clicking on it to open the hive interface. Each hive can store a colony, which is represented as a stack of live honey bees. Colonies are collected from the wild or by splitting colonies from other hives. Three months after installation, colonies become {{DFtext|Ready to be split|2:1}}, which allows them to be used to install other hives. It produces one [[honeycomb]] and [[royal jelly]] after six months after installation, unless the colony count limit was exceeded. Once both items are produced, a beekeeper with an empty [[jug]] goes to gather the items, storing the royal jelly in the jug. Beekeepers leave both the freed honeycomb and jug of royal jelly in the hive, and [[Hauling#Food hauling|food haulers]] carry them to a stockpile. When a hive's products are gathered, the colony is destroyed, and the hive requires a new colony in order to produce again.

Colonies used to install other hives are not destroyed after installing. They need another three months to become ready to split again.

Colony size typically ranges between 10,000 and 20,000. The size of a colony does not affect production or its readiness to split. The number of bees is static and does not change over time, even after splitting. When beekeepers "split" a colony, they do not actually separate a portion of it; instead, they duplicate the old colony and haul away a new stack of live bees. Both the old and new stack will contain the same number of bees, and the number of bees in the old hive remains unchanged in the process.

When the total number of colonized hives in a fortress reach over forty, the chance of production decreases as indicated by the warnings {{DFtext|Too many hives|6:1}} and {{DFtext|Output restricted|6:0}} seen in the building settings of colonized hives. When the number of colonies reach sixty, the warning turns red ({{DFtext|Too many hives|4:1}}) and products stop appearing. The limits do not affect the duration it takes for colonies to become ready to split, and hives can still be installed with new colonies; just nothing more is produced by hives until the number of colonies is reduced back below 60. [[Flower]]s and other surrounding vegetation do not affect production. The [[surroundings]], [[weather]], and the [[season]]s have no effect on the colony or honey production.

== Hazard ==
Honey bee workers spawn from colonized hives and will occasionally sting passersby. Honey bee workers die and leave [[remains]] after stinging. Placing a [[room]] or [[activity zone]] near colonized hives puts idle citizens, visitors, and animals at high risk of being stung. Honey bee stings are reported in the [[announcement]]s under the icon [[File:Announce vermin icon.png]] / {{DFtext|·|7:0}}{{DFtext|!|7:1}} in yellow text

[[Syndrome#List of syndromes|Honey bee stings]] cause strong swelling and slight pain. They are relatively harmless and inconsequential for dwarves - they do not even produce a bad [[thought]]. Bee stings are not recorded as wounds, but the health screen will display "Slight pain" for the stung dwarf, which can trigger a "recover wounded" task. This can trigger good thoughts about being rescued and resting, even though the hospital stay is instantaneous.

{{Gamedata|{{raw|DF2014:item_tool.txt|ITEM_TOOL|ITEM_TOOL_HIVE}}}}

{{Buildings}}

{{Category|Buildings}}