v50 Steam/Premium information for editors
  • v50 information can now be added to pages in the main namespace. v0.47 information can still be found in the DF2014 namespace. See here for more details on the new versioning policy.
  • Use this page to report any issues related to the migration.
This notice may be cached—the current version can be found here.

Difference between revisions of "Cage"

From Dwarf Fortress Wiki
Jump to navigation Jump to search
(→‎Alternate way of Opening Cages: Bridge-thrown cages keep their contents (and fly in completely random directions anyway).)
(Moved the hint to cages having no creature/size limit under the "Bugs" section (link to the related bugtracker issue also added); funny/speculative explanation of the issue moved under the "D for Dwarf" section; finally, added the "Buggy" template.)
 
(62 intermediate revisions by 38 users not shown)
Line 1: Line 1:
{{Migrated_article}}
+
{{Quality|Exceptional|12:28, 21 February 2023 (CST)}}
{{quality|unrated}}{{av}}
+
{{av}}
 +
{{buggy}}
  
{{furniture|name=Cage
+
{{V50_furniture
 +
|graphic=[[File:Cage_Premium.png]]
 +
|name=Cage
 
|tile=‼|col=0:6:0
 
|tile=‼|col=0:6:0
 
|wood=y
 
|wood=y
Line 12: Line 15:
 
:''For information on cage traps, see [[Trap#Cage_Trap|traps]].''
 
:''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 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 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.
  
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 haul animals" order ({{k-|o|a}}) is enabled.
+
Empty cage storage can be controlled by toggling the "empty cages" option for animal stockpiles.
  
To set a pile to accept ''only'' empty cages, set up an {{k|a}}nimal stockpile (or a custom pile) and in its settings {{k|b}}lock all and use {{k|u}} to enable (or disable) empty cages. ({{k|j}} toggles [[animal trap]]s.)
+
==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>]]
  
==Building and using a cage==
+
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]].
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|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.
+
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}}.
 
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===
 
===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]].
  
To assign creatures to a (built) cage, assign the cage to the location you want using {{k-|b|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]].
+
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.
  
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.
+
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.
  
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|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.
+
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 trapIf 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.
 
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.
+
[[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.
  
Bees shows up in the list of creatures that can be assigned to a cage, but dwarfs 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).
  
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).
+
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.
  
===Prisons===
+
"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.
  
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.
+
==== Trading contained creatures ====
  
===Remotely Opening Cages===
+
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===
 +
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.
 
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===
+
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.
 
 
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.
 
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]). 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.
+
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===
 
  
 +
===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.
 
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)
 
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 ===
+
===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).
+
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 ===
 
===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.
+
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]].
 
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 ===
+
=== 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.
+
''(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.]
  
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.  
+
Alternatively, [https://dfhack.readthedocs.io/en/stable/docs/_auto/base.html#stripcaged dfhack 'stripcaged'] is available, but the 'weapons' switch also removes their shields.
  
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.
+
'''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 ===
 
=== Emptying refuse ===
Line 85: Line 103:
 
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.
 
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.
+
<!-- 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 ===
 
=== 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 (confirmed for v0.40.10).
+
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.
 
Another easy way to quickly empty cages is to simply send the imprisoned creatures to a pasture, where your squad can slaughter them.
(Your dwarfs can drag every goblin except thieves).
+
(Your dwarves can drag every goblin except thieves).
The easiest way is to place the pasture right next to the cages and let our dwarfs shoot them down. This way you can kill the thieves and monsters too.
+
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.
 +
The fact that an unlimited number of creatures - regardless of size - can fit in a single cage has led some players to conclude that cages include some sort of hidden "cage space" that allows infinitely tight packing of creatures ("quantum cages").
  
 
{{buildings}}
 
{{buildings}}
  
 
==Bugs==
 
==Bugs==
 
+
* 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. {{bug|12919}}
 
* 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.
 
* 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}}
 
* 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}}
 
* 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.
+
* 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|Justice}}
 
{{Category|Buildings}}
 
{{Category|Buildings}}

Latest revision as of 13:39, 7 July 2024

This article is about the current version of DF.
Note that some content may still need to be updated.

Cage
Cage Premium.png
/
Construction
Materials Workshops Labors
Rooms
For information on cage traps, see traps.

Cages are used in cage traps, jails, zoos, pits and aquariums. A glass cage is called a terrarium or, if filled with water for holding captured live aquatic vermin, an aquarium.

Cages are stored in an animal stockpile (unless they have been 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" order (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[edit]

Cages work well for humanoids as well.
Capturing that thing was the "easy" part.
Art by kruggsmash

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

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

Creature containment[edit]

To assign creatures to a cage, first build the cage in the location you want using 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 system. To assign a creature to the cage, first select the cage, and then press the "+" button on its status page. Use Shift and the mouse wheel to quickly scroll up and down the list of creatures, and 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 pasture that has plenty of tasty grass and/or cave moss.

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 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 t and then 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 traps. However, if you try to release them (q and then 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 jobs 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 kittens in a cage will eventually become adult cats. Creatures in cages are affected by extreme temperatures, and 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 imps. 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 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.

Trading contained creatures[edit]

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[edit]

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

Remotely opening cages[edit]

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 hurled from a colliding minecart also spill their contents upon collision (see 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 thieves' ability to wriggle out of normal pitting, or a bunch of cave floaters toward invaders, this method may be preferable.

Cages and fluids[edit]

A cage will protect a creature inside it from 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[edit]

Traders may bring cages for sale. If those contain a tamed 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[edit]

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 cyclopes.Bug:4065 Letting such monsters loose in the middle of your fort is good fun.

How to disarm hostiles in cages[edit]

(Section needs verification)
An easy way to take away all prisoner-held armor and clothing is via the mass designation tool. Designate an area with Ui i.pngi 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 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 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" y/Standing order set.

An easier way to selectively disarm prisoners is to designate mass forbid and mass dump by also using Ui i.pngi on all of the caged prisoner stockpile. You will need a bookkeeper for this. Press k and go to the stocks screen. Find an item category with items marked F and D. Press 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 d-b-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 d-b-H to unhide everything. This works with everything like shields and armor, not just weapons.

Source.

Alternatively, 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[edit]

If you 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 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 butcherable, 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.

How to quickly empty out many cages[edit]

If you have many 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[edit]

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 light and cheap, and easy to mass-produce in most biomes. 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 elven caravans 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 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

D4Dwarf.png This article or section has been rated D for Dwarf. It may include witty humour, not-so-witty humour, bad humour, in-jokes, pop culture references, and references to the Bay12 forums. Don't believe everything you read, and if you miss some of the references, don't worry. It was inevitable.


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. The fact that an unlimited number of creatures - regardless of size - can fit in a single cage has led some players to conclude that cages include some sort of hidden "cage space" that allows infinitely tight packing of creatures ("quantum cages").


Furniture
Animal trapAnvilArmor standBedBlocksBox (chest • coffer) • BucketCabinetCage (aquarium • terrarium) • Coffin (casket • sarcophagus) • RestraintSlabStatueTableThrone (chair) • Weapon rack
Tools
AltarBookcaseDisplay (display case • pedestal) • HiveNest box

Access
BarsBridgeDoor (portal) • FloodgateGrateHatchRoadWindow
Constructions
Machine and trap parts
Other buildings

Related articles

Bugs[edit]

  • Multiple creatures can be assigned to the same cage with no penalty. It is possible to fit hundreds of puppies with dozens of dragons, and whatever other animals are on hand, in a single cage with no ill effects. Bug:12919
  • Creatures in cages that come from dead merchants can only be freed by assigning them to a 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
"Cage" in other Languages Books-aj.svg aj ashton 01.svg
Dwarven: mokez
Elven: ofúru
Goblin: obtux
Human: tin