Editing v0.34:Cage

{{quality|Exceptional|22:58, 6 January 2011 (UTC)}}{{av}}{{buggy}}

{{furniture|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, [[pit]]s and aquariums. 
A glass cage is called a terrarium or, if filled with water for holding [[Captured live fish|captured]] live vermin [[fish]], an aquarium.

Cages are stored on the 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 {{k|o}}rders - dwarves haul {{k|a}}nimals option is set.

To set a pile to accept ''only'' empty cages, set up an animal pile (or a custom pile) and in its settings {{k|b}}lock all and use {{k|u}} to enable empty cages. Similarly, to block empty cages, use {{k|u}} to disable them. ({{k|j}} toggles [[animal trap]]s.)

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

You can then either build them on a tile via {{k|b}} - {{k|j}} (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 (built) cage, assign the cage to the location you want using {{k|b}}-{{k|j}}. Then press {{k|q}} and move the cursor over the cage. Use {{k|+}} and {{k|-}} to scroll up and down the list of [[creatures]], and {{k|Enter}} 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 apparently possible to fit hundreds of [[dog|puppies]] in a cage with dozens of [[blind cave ogre]]s with no ill effects or a [[dragon]], a thousand [[cat]]s, and whatever else is on hand, leading 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.  Use {{k|q}} to examine the cage (it must first be "built," not just stored - use {{k|b}}-{{k|j}} to build cages, and {{k|x}} to be sure to get the right cage), {{k|a}} to assign, and then use {{k|enter}} to toggle the animal(s) currently inside (animals assigned to the cage will have a green "+" next to them).  Any available dwarf will perform the job, so beware of pitting untamed or hostile creatures with a weak dwarf.

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 shows up in the list of creatures that can be assigned to a cage, but 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 military dwarves 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. Also creatures in cages 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).

===Prisons===

To set a cage as a [[jail]], {{k|q}}uery the cage, designate it as a {{k|r}}oom, and then set it to be used for {{k|j}}ustice. Only [[metal]] cages may be used in this way, despite [[wood]]en cages being strong enough to hold [[dragon]]s.

If you want your prisoners to survive their sentences, it is strongly recommended '''not''' to use cages but [[rope|chains or ropes]] for your prisons, with drink and food placed directly adjacent to the chains. Caged dwarves must be given water and drink by others, and the required jobs are almost never generated. Dwarves caged in the name of justice will ''normally'' die of thirst or starvation, due to a bug preventing prisoner care jobs from being queued up in many cases {{Bug|2606}}.

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

===Alternate way of Opening Cages===

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

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 [[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]). Possibly works when [[Bridge#Raising_and_Retracting_Bridges|flung by a raising bridge]] as well{{verify}}, but minecarts are easier to load via stockpiles. This combines timing control of a lever or pressure plate with 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 these cages contain a [[tame]]d [[creature]], 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 (see above) and then deconstruct the cage by {{K|q}}uerying it and pressing {{K|x}}. You can then select the cage in the trading menu.

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]]. Letting such monsters loose in the middle of your fort is good [[fun]].

=== How to disarm hostiles in cages ===
An easy way to take away all prisoner-held armor and clothing is via the mass designation tool.  Designate an area with {{K|d}}-{{K|b}}-{{K|c}} to claim and {{K|d}}-{{K|b}}-{{K|d}} to dump an area (i.e. your animal [[stockpile]], filled with caged prisoners).  Afterwards, hit {{K|k}}, and go over each cage and press {{K|d}} for each of them - this stops the dumping on the cages themselves. You will need a [[DF2012: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|d}}-{{K|b}}-{{K|c}} 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|o}}-{{K|r}}-{{K|o}} order set.


An easier way to selectively disarm prisoners is to designate mass forbid {{K|d}}-{{K|b}}-{{K|f}} and mass dump {{K|d}}-{{K|b}}-{{K|d}} on all of the caged prisoner stockpile. You will need a [[bookkeeper]] for this. Press {{K|z}} 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 {{K|d}}-{{K|b}}-{{K|c}} and mass undump {{K|d}}-{{K|b}}-{{K|D}} 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.

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

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 our dwarves shoot them down. This way you can kill the thieves and monsters too.

{{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}}
* Placing a vermin fish in an aquarium can cause [[purring maggot]]s to become unmilkable. {{Bug|6116}}
* Creatures escape from Artifact traps/cages. {{bug|6117}}
* Dwarves caged in the name of justice will often die of thirst or starvation, due to prisoner care jobs not being queued up in many cases {{Bug|2606}}.
* 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.

{{Category|Justice}}
{{Category|Buildings}}