Editing Cage

{{Quality|Exceptional|12:28, 21 February 2023 (CST)}}
{{av}}

{{V50_furniture
|graphic=[[File:Cage_Premium.png]]
|name=Cage
|tile=‼|col=0:6:0
|wood=y
|metal=y
|glass=y
|rooms=
* [[Jail]] (if metal)
}}
:''For information on cage traps, see [[Trap#Cage_Trap|traps]].''

'''Cages''' are used in [[cage trap]]s, [[jail]]s, [[zoo]]s, [[Activity_zone#Pit/Pond|pit]]s and aquariums. A glass cage is called a '''terrarium''' or, if filled with [[water]] for holding [[Captured live fish|captured]] live aquatic [[vermin]], an '''aquarium'''.

Cages are stored in an animal [[stockpile]] (unless they have been [[Wear|worn out]] somehow, in which case they are stored in a refuse stockpile). Dwarves will attempt to collect and store cages in stockpiles if the "Dwarves Gather Animals" [[Standing_orders|order]] ({{k|y}} - '''Standing orders''' tab - '''Hauling''' tab) is enabled.

Empty cage storage can be controlled by toggling the "empty cages" option for animal stockpiles.

==Building and using a cage==
[[File:cage_preview.jpg|thumb|270px|right|Cages work well for humanoids as well.]][[File:cage_trap_preview.jpg|thumb|270px|right|Capturing that thing was the "easy" part.<br><small>''Art by kruggsmash''</small>]]

A cage can be constructed from a log of [[wood]] at a [[carpenter's workshop]], three bars of [[metal]] at a [[metalsmith's forge]], or from [[glass]] at a [[glass furnace]].

You can then either build them on a tile via {{k-|b|r|g}} (this is needed for linking a [[lever]] to them, or assigning a tame animal to it) or simply keep them stockpiled so they can be used to load cage [[trap]]s.

When building a cage, you can choose a cage that already has something inside. To precisely select which cage to use, you can expand the list of cages with {{k|x}}.

===Creature containment===
To assign creatures to a cage, first build the cage in the location you want using {{k-|b|r|g}}. You can only assign creatures to a cage that is not part of a dungeon zone. Cages in a dungeon will have prisoners assigned automatically as part of the [[Justice#Cages_and_Chains|justice]] system. To assign a creature to the cage, first select the cage, and then press the "+" button on its status page. Use {{k|Shift}} and the mouse wheel to quickly scroll up and down the list of [[creatures]], and {{k|click}} to assign them to the cage. Creatures currently assigned to the cage are listed at the top; the rest of the creatures are listed in order of arrival on the map (including any inaccessible creatures). Note that tame grazing creatures will starve if left in cages, though pet owners may feed their pets. Instead of caging grazers, assign them to a [[zone|pasture]] that has plenty of tasty [[grass]] and/or [[cave moss]].

Multiple creatures can be assigned to the same cage with no penalty. It is possible to fit hundreds of [[dog|puppies]] with dozens of [[dragon]]s, and whatever other animals are on hand, in a single cage with no ill effects.  This has led some players to conclude that cages include some sort of hidden "cage space" that allows infinitely tight packing of creatures.

There is no particular labor for releasing creatures from built cages.  Select the cage to examine it (it must first be "built," not just stored - use {{k-|b|r|g}} to build a cage, and then to toggle the animal(s) currently inside (animals assigned to the cage will show up on the cage's page).  Any available dwarf will perform the job, so beware of pitting untamed or hostile creatures with a weak dwarf.

Alternatively, creatures can be released from un-built cages provided that they are able to be assigned to a pasture, i.e. animals, tame or otherwise.  Once assigned to a pasture, a dwarf will automatically remove them from their cage and lead them to their assigned pasture.  Note that if the cage containing the creature is already within the pasture, the creature will '''not''' be released, as it is considered to be already in its pasture.

Caged citizens of (and visitors to) your fort, if wounded, will be freed by the "Recover Wounded" job and taken to the nearest hospital zone.  This mostly occurs during loyalty cascades, when separatists are knocked unconscious while fighting on a cage trap.  If the hauling dwarf is from the other faction, it is possible that they lay the patient in bed and then immediately attack her.

You can get details about the creatures which are in a built cage by pressing {{k|t}} and then {{k|enter}}. There, you can scroll the list of creatures and get details, for example, you can tell whether a creature is male or female, which is useful if you are preparing a breeding program.

[[Vermin]] can also be assigned to cages, to save space or [[animal trap]]s. However, if you try to release them ({{k|q}} and then {{k|a}}), the dwarf will pickup an animal trap and put the poor creature back in a stock cage.  To explicitly release an animal, instead "pull" the animal somewhere else: either assign the animal to a [[pit]] (which could simply be a hillside outside your fortress), or a pasture.  This has the benefit of making it clear where the animal is being released.  However, keep in mind the dwarf will uncage the animal first and then lead it to the release, so large/dangerous animals may escape en route.  Consider using the [[dump]] command to move the cage before release, or assign the animal stockpile next to the pit/pasture.

Bees show up in the list of creatures that can be assigned to a cage, but the dwarves will not start the task, and it will not be shown in the {{k|j}}obs list.

Creatures in cages cannot be attacked (though any existing attack orders will '''not''' automatically cancel, leaving your militiadwarves milling around the cage uselessly). Most caged creatures are also unable to attack, although some special attacks (such as gaseous noxious secretions) can still be used. Creatures in cages are also immune to damage from falling, and falling objects. [[Breeding]] creatures are unable to get pregnant if caged, although they will give birth while caged if they were already pregnant.  Creatures in cages also age, so [[kitten]]s in a cage will eventually become adult cats. Creatures in cages are affected by extreme temperatures, and [[dwarven atom smasher|atom smashing]] the cage will also obliterate the occupants, even if they are normally immune to smashing. Casting a cage in [[obsidian]] will not harm the occupants (though the temperature might, if the cage is subjected to magma for very long).

Beware of cages that contain creature(s) with very high internal temperature, such as [[fire imp]]s. They cannot harm your dwarves directly while caged, but their body heat ''can''; by heating up the tile that the cage occupies. If the cage-hauler is very slow and weak, they may spend enough time in each tile to feel the effects of the heat, and they will, dutifully but foolishly, continue to haul the cage until their head melts off. To move "hot" cages safely over long distances, make sure that a strong or fast dwarf hauls it.

"Deconstructing" a cage via {{k-|q|x}} with creatures in it does not harm the cage, the dwarves will return the cage (with the creatures in it) to the nearest animal stockpile.

If you melt the cages, creatures inside will be released.

===Prisons===
If the cage is already located within a designated [[jail]] room, it will be automatically included in the jail.

===Remotely opening cages===
A built cage can be linked to a [[lever]] to remotely open it.  When the cage opens, the occupant(s) inside are released, the cage and [[mechanism]] deconstruct and can be returned to their respective stockpiles. Note that you have to use a "built" cage as described above, it won't work with cages on your stockpile.  Also note that the mechanism attached to the lever will '''not''' automatically deconstruct; you have to manually deconstruct the lever to get back the mechanism used to open the cage.

Alternately, when traders are around, you can select "move good to trading depot" and select the cage of choice. When a hauler takes the cage, any untameable creatures inside will be released; be sure to disarm the creature beforehand... This is also the easiest way of releasing caged dwarves.

A way to release creatures from stockpiled cages (which have not been built) is to assign the creatures to a [[pasture]] (which is possible for any living thing except dwarves).  The same precautions as for trading the cage should be taken first.

Another way is to use the [[container]] spilling effect: cages [[Trap_design#Shotgun|hurled from a colliding minecart]] ''also'' spill their contents upon collision (see [http://www.bay12forums.com/smf/index.php?topic=109460.msg3340230#msg3340230 this forum message]). This combines timing control of a lever or pressure plate with the reusability of pitting. If you want to deliver Goblin snatchers into your target practice room despite [[Thief|thieves]]' ability to wriggle out of normal pitting, or a bunch of [[cave floater]]s toward invaders, this method may be preferable.

===Cages and fluids===
A cage will protect a creature inside it from [[swimmer|drowning]], so if you want to drown a creature in a cage, you must open it remotely, as explained in the above section (as a corollary, if your fortress is drowning in water, you can cage your dwarves and rescue them later). However, built cages will not protect caged creatures from [[magma]], making this a somewhat faster option, as it doesn't require linking each cage to a lever. Cages which are not [[magma-safe]] will be degraded and/or destroyed by this process, and cages which are made of flammable materials (such as wood) may be set on [[fire]]. Any items the creature had equipped will teleport {{verify}} to wherever the creature was caged, typically a tile with a [[cage trap]] on it. These items may or may not be on fire; no case of teleporting !!large cave spider silk sock!!s have yet been observed, but this doesn't prove it can't happen. Exercise caution.

It's also possible to cage fluids(done by pushing uncaged animals/invaders over armed cage traps with water.) The cage containing the liquid must be built to remove the liquid. *magma not tested (yet)

===Buying cages ===
Traders may bring cages for sale. If those contain a [[tame]]d [[creature]] or [[vermin]], the item will be listed as ''(creature) cage'', and the material will only be mentioned in parentheses behind the item name, e.g. Wolf Cage (Oaken).

===Selling caged creatures ===
If you want to sell an animal, you need to assign it to a constructed cage first, which is simply done by clicking on a cage, then clicking on the assign button near the center of the GUI box.

Note that only tamed animals can be traded safely. The dwarf assigned to hauling a container will look through its contents and chuck out anything that can't be traded. In the case of cages, this means anything sentient - including such nasties as [[cyclops|cyclopes]].{{Bug|4065}} Letting such monsters loose in the middle of your fort is good [[fun]].

=== How to disarm hostiles in cages===
''(Section needs verification)''<br>
An easy way to take away all prisoner-held armor and clothing is via the mass designation tool.  Designate an area with {{Menu icon|i|}} to dump an area (i.e. your animal [[stockpile]], filled with caged prisoners).  Afterwards, go over each cage and click on the garbage can icon for each of them - this stops the dumping on the cages themselves. You will need a [[Activity zone#Garbage Dump|garbage dump]] set up already for the dwarves to take the dumped items to. The dwarves will strip the prisoners naked and haul the items away. The cages themselves (and the creatures within) will remain in place.  The items will end up in the garbage dump zone. If you want to reuse the items, you need only to designate claim {{K|i}} on your garbage dump zone to reclaim the items after they are dumped there. If your animal stockpile is outdoors, you need to have the "Dwarves Gather Refuse from Outside" {{K|y}}/Standing order set.

An easier way to selectively disarm prisoners is to designate mass forbid and mass dump by also using {{Menu icon|i}} on all of the caged prisoner stockpile. You will need a [[bookkeeper]] for this. Press {{K|k}} and go to the [[stocks]] screen. Find an item category with items marked '''F''' and '''D'''. Press {{K|f}} to remove the '''F''' for those items, but don't remove the '''D'''. This will unforbid them, but they will remain marked for dumping. When you exit the stocks screen, the dwarves will haul those items from the cages and drop them into the garbage dump. When the dwarves have finished the hauling tasks, designate a mass claim and mass undump on the same area as earlier to remove the forbid and dump designations from the cages and the rest of the contents. 

This method can be used to confiscate specific items from caged prisoners, like weapons, armor or bags containing stolen property or kidnapped children. It can be more useful to just remove their weapons if you want to use your caged prisoners for target practice;  they will be more durable with their clothes and armor equipped, but not very dangerous without their weapons.

To selectively remove only weapons from caged prisoners, first claim the entire prisoner stockpile, then {{K|d}}-{{K|b}}-{{K|h}} to hide everything including cages, buildings and prisoner equipment. Go in to your standard (non-dfhack) stock screen and browse the weapons section. Anything tagged with a blue '''H''' is a hidden prisoners' weapon, dump them. Once you have selectively removed only their weapons, use {{K|d}}-{{K|b}}-{{K|H}} to unhide everything. This works with everything like shields and armor, not just weapons.

[http://www.bay12forums.com/smf/index.php?topic=81601.0 Source.]

Alternatively, [https://dfhack.readthedocs.io/en/stable/docs/_auto/base.html#stripcaged dfhack 'stripcaged'] is available, but the 'weapons' switch also removes their shields.

'''An updated process for v50 can be found in the following reddit conversation:''' https://www.reddit.com/r/dwarffortress/comments/zluzq6/disarming_caged_prisoners/

=== Emptying refuse ===
If you [[animal trainer|tame an animal]] while it is inside a cage (a process which involves feeding a plant to the caged animal), you may leave seeds inside the cage.  To get these out, you must mark them for [[activity zone#Garbage_Dump|dumping]], designate a garbage zone, and wait for a dwarf to dump the seeds in the garbage zone.  Then you can reclaim them.

Animals that expire in a cage (built in a [[zoo]], or just sitting in an animal stockpile) also clutter up the cage until removed. If the cage is unbuilt and the animal is [[butcher]]able, your dwarves may haul the animal, cage included, to the butcher shop for processing. If not, you will need to manually clean the cage by dumping the corpse and any other items.

<!-- Marking refuse for dumping can be done by pressing {{k|k}} for an unbuilt cage ({{k|t}} for a built cage), then selecting the cage and pressing {{k|Enter}}, then selecting the item and pressing {{k|Enter}} again, and finally pressing {{k|d}} to mark the item (rather than the cage) for dumping.  Or if there is a lot of refuse, you can use {{k|d}}-{{k|b}}-{{k|d}} to mass-dump everything in the tile, and then un-mark the cage itself. -->
=== How to quickly empty out many cages ===
If you have many [[Trap#Cage_Trap|cage traps]] then you may have trouble emptying out cages quickly enough at times. See [[Mass pitting]] for suggestions on how to quickly recycle cages. Be advised that there are now reports of frequent escapes while using this method.

Another easy way to quickly empty cages is to simply send the imprisoned creatures to a pasture, where your squad can slaughter them.
(Your dwarves can drag every goblin except thieves).
The easiest way is to place the pasture right next to the cages and let your dwarves shoot them down. This way you can kill the thieves and monsters too.

Another fun method is to put a 1×1 pasture in the middle of your barracks. Next, tell a squad to kill the target creature in the cage and watch them line up around the prisoner.  Finally, assign the prisoner to the pasture in the middle of the barracks.  A dwarf will be along shortly to drag the prisoner from the stockpile to the pasture, while your squad beats on them en route.  Even thieves that can't be dragged are still mobbed by your squad waiting as soon as the cage is opened.

== Comparison of cage types ==
As stated before, cages can be made either of wood, metal, or glass. The choice of material reflects the cage's usefulness at certain tasks. To compare:
* '''Wooden''' cages are [[weight|light]] and [[value|cheap]], and easy to mass-produce in most [[biome]]s. They are notably not resistant to [[fire]], and will burn up in a forest fire, even when already loaded into an otherwise fire-safe [[cage trap]]. Wooden cages can also be bought from [[elf|elven]] [[caravan]]s if your site has no access to wood itself.

* '''Metal''' cages have the advantage of not being flammable. These are usually [[fire-safe]], and a few types are [[magma-safe]] as well, but this varies depending on what [[metal]] they are made of. These cages are inferior for usage in cage traps, though, because of their high [[weight]] they take ''a lot'' of time to be hauled back and forth. Cages made of cheap metals (copper, tin, zinc, nickel, lead) can be bought in bulk from [[human]] and [[dwarf|dwarven]] merchants, and are the only type of cages these merchants will ever sell.

* '''Glass''' terrariums can be made at a [[glass furnace]] from as little as a [[bag]] of renewable [[sand]]. The three types of glass have exactly the same physical properties, they differ only in [[value]]. All are magma-safe, having a melting temperature higher than any metal. They are heavier than wooden, but much lighter than metal ones, and their weight usually does not inhibit hauling jobs. For all non-decorative uses, green glass should be chosen, as it requires less ingredients and takes less time to be produced than other types of glass.

If you wish to know, how to build a fish tank, otherwise known as an aquarium, I shall link this guide here for you : https://steamcommunity.com/sharedfiles/filedetails/?id=2924311982
{{D for Dwarf}}

Dwarf scientists are trying to develop a new type of portable cage traps, small enough that even a dwarf child can throw it at wild animals to catch it. So far they haven't made any significant progress.

{{buildings}}

==Bugs==
* Creatures in cages that come from dead merchants can only be freed by assigning them to a [[Zone#Pen/Pasture|pen/pasture zone]] and then when they have been put there, deassigning them from the pen/pasture.
* When bringing a cage to the Trade Depot in order to trade it, any untameable creatures inside the cage will be freed.  Tamed (and presumably also wild but tameable) animals can be safely traded. {{Bug|4065}}
* Aquariums cannot be used to store large fish (they will drown), though vermin fish work just fine. {{Bug|1590}}
* Dwarves trapped in cages cannot be directly freed. They can only be released by building the cage and connecting a [[lever]] to it, or ordering the cage be brought to a trade depot. {{bug|3070}}

{{Translation
| dwarven = mokez
| elvish  = ofúru
| goblin  = obtux
| human   = tin
}}



{{Category|Justice}}
{{Category|Buildings}}
@@ Line 53: / Line 53: @@
 If you melt the cages, creatures inside will be released.
-==== Trading contained creatures ====
-Most creatures can be traded, but not sapients (such as goblins, trolls, trologdytes). If you attempt to haul caged sapient creatures to the trade depot, they will try to escape instead, and many times they will not go without a fight!
 ===Prisons===