Vintage Story Mod DB · Vintage Story mod
Animal cages
Note: v5.0.0 is out, and intended for 1.22!!! Summary Small utility mod that adds cages for capturing, transporting and releasing animals. Features Adds two new Blocks to the game: • Small animal cage: • Attack a small animal with the cage equipped to ca
Quick answer
Which Animal cages release matches 1.21.4?
Animal cages 4.0.2 targets 1.21.0, 1.21.1-rc.1, 1.21.1-rc.2. It must be installed on the client. Installation on the dedicated server is optional. No extra mods listed for this file.
Where it goes
Is Animal cages required on the client, server, or both?
It must be installed on the client. Installation on the dedicated server is optional.
This release supports both sides, but the source does not require it on the server.
What else does Animal cages 4.0.2 need?
4.0.2 on 1.21.4. Every mod below is checked against that same setup.
This file does not list any required mods. Do not add a library just because a different file uses it.
This file does not list any required or optional mods.
Before you install it
Add Animal cages without breaking your instance.
Built for Animal cages 4.0.2 on 1.21.4. Pick another file and the loader, install side or required mods may change.
- 01
Stick to this file
Use 4.0.2. It targets 1.21.0, 1.21.1-rc.1, 1.21.1-rc.2; another release may have different loader, side or dependency requirements.
- 02
Bring the mods it needs
This file does not list any required mods. Do not add a library just because a different file uses it.
- 03
Put it on the correct side
It must be installed on the client. Installation on the dedicated server is optional.
- 04
Pick the file you checked
Use the “Get this file” button beside 4.0.2. It opens that exact file at the source.
About this project
What does Animal cages add?
Note: v5.0.0 is out, and intended for 1.22!!!
Summary
Small utility mod that adds cages for capturing, transporting and releasing animals.
Features
Adds two new Blocks to the game:
- Small animal cage:
- Attack a small animal with the cage equipped to catch it
- Place the cage and break it to release the animal. Right click to pick it back up
- Medium animal cage:
- Attack an animal with the cage equipped to catch it
- Animal can only be caught, if it is either a small animal, a domesticated animal, or has less 50% HP
FAQ
- Is this mod compatible with mod X?
- Most likely yes. There is a variety of animals both vanilla and modded that is supported out of the box by this.
- If the animal you would like to catch is not catchable by this, take a look at the config and mod compatibility section of this page to see how you can make it catchable.
- Is this mod compatible with game version X?
- Most likely yes. If only the last number in the vanilla version (1.20.X) differs from whats listed here, there is a 95% chance that the mod will still work.
- I don't like having to bash animals until they are badly hurt, before I can catch them.
- All animals that are generation 1 or above can be caught without hurting them.
- If you want to be able to catch them from generation 0 on, you can change the value mustBeBelowHpInPercent to something higher (for example 1 to catch them first hit).
- Where is the config file?
- The file path to the configuration file should look like "Roaming->VintagestoryData->Modconfig", editing files in other places will cause weirdness
- The name of the configuration file is "animalcagesconfig.json", it must have this name for the game to read it
- My config file reverts to the unchanged version when I load up!
- There is now a line in the config called "alwaysUseDefaultConfig" - if the value here is set to "true" (the default setting), the config file will revert to the default version - deleting your changes. Change this value to "false" to keep your changes!!
- I need help figuring out editing the config file, or help in general please!
- unHallowed checks the comments a couple times a week, but that is the slow way to get their aide with troubleshooting. You can join their fan discord group HERE for more direct/immediate help. Reporting issues via Github ("Source" tab above) need crashlogs or error logs included to be of any use to Gerste, so far as code-related things go - and that is the best way to get those issues addressed.
Config
You can configure which entities are catchable by modifying the configuration file.
For example, if you want to make the buildingmaterials trader catchable, you have to do the following things:
- Open the animalcagesconfig.json file, located in your ModConfig folder (the folder path is Roaming->VintagestoryData->ModConfig)
- Add the new entity:
- ...{
"name": "humanoid-trader-buildmaterials", // entity code of the new "animal"
"scale": 0.4 // display scale (as the trader is to big for the small cage, we scale him down to 40% size)
},...
- ...{
- Change the "alwaysUseDefaultConfig" value to false
- Restart the game and capture the new entity
Mod Compatibility
As of v4.0.2 there is confirmed out-of-the-box compatibility with at least 45 mods!! So far, the confirmed list is;
- Fauna of the Stone Age (all 20 existing mods)
- Legacy of the Phanerozoic (all 14 existing mods)
- More Animals
- Gerste's Wolftaming and Cats
- Draconis, Equus, and Pegasus
- Mythic Legends
- Monoceros: Ancient Unicorns
- Untamed Wilds: Ursidae
- Truth and Beauty: Detailed Animals
- Silt Striders
- Haz's Monitor Lizards and Jackalopes
Below are mods that are not automatically included in the existing configuration file.
Just add them to either small-catchable-entities or medium-catchable-entities list AND change the "alwaysUseDefaultConfig" value to false. If you do not change the "alwaysUseDefaultConfig" value to false, the config file will revert to default.
FOR 1.22 - Other Creatures:
| Traders | { "name": "trader-*", "scale": 0.4 }, |
| Large Grey Hogs | { "name": "*-elder*", "scale": 0.7 }, |
Modded Creatures:
| Underwater Horrors | { "name": "seaserpent", "scale": 0.7 }, { "name": "seaserpent2", "scale": 0.7 }, { "name": "seaserpent3", "scale": 0.7 }, |
| Sonya's Quality Fowl (thanks BumbleBeagan) | { "name": "duck-*", "scale": 1.0 }, |
Other Creatures (for v4.0.2):
Vanilla Creatures:
|
Traders *this will also catch most modded traders |
{ "name": "humanoid-trader-*", "scale": 0.7 }, |
| Fish | { "name": "salmon", "scale": 1.0 }, { "name": "fish-*", "scale": 1.0 }, |
|
Monsters *this will also catch monsters edited by mods |
{ "name": "bell", "scale": 0.7 }, { "name": "bowtorn-*", "scale": 0.7 }, { "name": "drifter-*", "scale": 0.7 }, { "name": "locust-*", "scale": 0.7 }, { "name": "shiver-*", "scale": 0.7 }, { "name": "mechhelper", "scale": 0.7 }, |
Mod Creatures:
| Craftable Companion | { "name": "mechcompanion", "scale": 0.7 }, |
| Deep Sea Bioluminescence | { "name": "blackseadevil", "scale": 0.7 }, |
| Eldritch Monsters | { "name": "neutralwillowispsurface-*", "scale": 0.4 }, { "name": "monsterhollowsurface-*", "scale": 0.4 }, { "name": "monsterstalkersurface-*", "scale": 0.4 }, { "name": "stalkerundergroundwidowalpha-*", "scale": 0.4 }, { "name": "monsterunstablesurface-*", "scale": 0.4 }, { "name": "monsterwraithsurface-*", "scale": 0.4 }, |
|
*auroch lamb is included in default config |
{ "name": "aurochs-*", "scale": 0.7 }, |
| Spooky Nights | { "name": "spectralbear", "scale": 0.7 }, { "name": "spectralbowtorn", "scale": 0.7 }, { "name": "spectraldrifter", "scale": 0.7 }, { "name": "spectralshiver", "scale": 0.7 }, { "name": "spectralwolf", "scale": 0.7 }, |
| Wonderful Creatures | { "name": "chestmimic-normal", "scale": 0.5 }, |
| Something in the Water | { "name": "sunfish", "scale": 0.7 }, { "name": "shark", "scale": 0.7 }, { "name": "moonjelly", "scale": 0.7 }, { "name": "bigshark", "scale": 0.7 }, |
| Requiem Sharks | { "name": "blacktipshark", "scale": 1.0 }, { "name": "sandbarshark", "scale": 0.9 }, |
| Ornamental Fish | { "name": "betta-*", "scale": 1.0 }, { "name": "goldfish-*", "scale": 1.0 }, { "name": "guppy-*", "scale": 1.0 }, { "name": "koi-*", "scale": 1.0 }, |
| North American Catfish | { "name": "catfish-*", "scale": 1.0 }, |
| North American Salamanders | { "name": "nasalamanders-*", "scale": 1.0 }, |
| North American Darters | { "name": "darter-*", "scale": 1.0 }, |
| Feverstone Horses | { "name": "foal-*", "scale": 0.4 }, { "name": "horse-*", "scale": 0.4 }, { "name": "taminghorse-*", "scale": 0.4 }, |
|
*baby direwolves, bison, hellboar, cockatrice, and ostrich are included in the default config |
{ "name": "bison-*", "scale": 0.7 }, { "name": "*-cockatrice-*", "scale": 0.7 }, { "name": "*-direwolf-*", "scale": 0.7 }, { "name": "faunling-*", "scale": 0.7 }, { "name": "foal-*", "scale": 0.7 }, { "name": "geodecrab", "scale": 1.0 }, { "name": "giraffe-*", "scale": 0.7 }, { "name": "golem-*", "scale": 0.7 }, { "name": "hellboar-*", "scale": 0.7 }, { "name": "horse-*", "scale": 0.7 }, { "name": "*-ostrich-*", "scale": 0.7 }, { "name": "scorpion", "scale": 1.0 }, { "name": "spider", "scale": 1.0 }, { "name": "taminghorse-*", "scale": 0.7 }, { "name": "toad", "scale": 1.0 }, { "name": "buromenfish", "scale": 0.7 }, { "name": "discus", "scale": 0.7 }, { "name": "eel", "scale": 0.7 }, { "name": "ghostfish", "scale": 0.7 }, { "name": "orca", "scale": 0.7 }, { "name": "shark-*", "scale": 0.7 }, { "name": "stingray", "scale": 0.7 }, |
| { "name": "cichla-*", "scale": 1.0 }, |
|
| { "name": "osphronemus-*", "scale": 1.0 }, |
|
| { "name": "lepomis-*", "scale": 1.0 }, |
|
|
*African Monitor Lizards, Asian Monitor Lizards, and baby/juvenile New World Tortoises included in default config |
{ "name": "breviceps-*", "scale": 1.0 }, { "name": "rana-*", "scale": 1.0 }, { "name": "leiopelma-*", "scale": 1.0 }, { "name": "eublepharis-*", "scale": 1.0 }, { "name": "nephrurus-*", "scale": 1.0 }, { "name": "coleonyx-*", "scale": 1.0 }, { "name": "pogona-*", "scale": 1.0 }, { "name": "ensatina-*", "scale": 1.0 }, { "name": "chelonoidis-*", "scale": 1.0 }, { "name": "taricha-*", "scale": 1.0 }, |
|
*the following baby animals are included in the default config; yak, chipmunk, hedgehog, squirrel, crab, crow, all ducks, and all swans |
{ "name": "yak-*", "scale": 0.85 }, { "name": "chipmunk-*", "scale": 0.85 }, { "name": "hedgehog-*", "scale": 0.85 }, { "name": "fieldmus", "scale": 0.85 }, { "name": "squirrel-*", "scale": 0.85 }, { "name": "crab-baby", "scale": 0.85 }, { "name": "crab-both", "scale": 0.85 }, { "name": "owl-brown-f", "scale": 0.85 }, { "name": "crow_flying", "scale": 0.85 }, { "name": "*-duck-*", "scale": 0.85 }, { "name": "robin_flying", "scale": 0.85 }, { "name": "house-sparrow_f", "scale": 0.85 }, { "name": "*-swan-*", "scale": 0.85 }, { "name": "isopod-*", "scale": 0.85 }, { "name": "snail-default", "scale": 0.85 }, |
Contribute
Translations
If you want to help translate the mod into your language, head over to the Crowdin Project to upload your community translation. I use a small script that automatically downloads the translations before every new release.
Language Contributors:
- macoto_hino (japanese translation)
-
Samotarus (russian translation)
-
Cendar (french translation)
- burunduk (ukranian translation)
Features/ Bugfixes/ Assets/ Models
If there is a feature that you are desperately missing in this or you found a bug you want to fix yourself, feel free to hit me up on the Vintage Story Community discord with your idea and send in a Pull Request over on Github.
Project description from Vintage Story Mod DB.
Pick your setup
Animal cages releases for each Vintage Story version.
Choose the version and loader you play, then open the matching release.
1.22.0-rc.9
1 loader build1.22.0-rc.8
1 loader build1.22.0-rc.7
1 loader build1.22.0-rc.6
1 loader build1.22.0-rc.5
1 loader build1.22.0
1 loader build1.21.6
1 loader build1.21.5
1 loader build1.21.4
1 loader build1.21.3
1 loader build1.21.2-rc.3
1 loader buildShowing the newest 12 of 46 game versions. Older files are in the list below.
Check the dependencies, then try the file in a copied instance before changing a world you care about.
Recent files
Animal cages versions and loaders
4.0.2
animalcages_v4.0.2.zip
16 Nov 2025
Looking for an older file? The official Vintage Story Mod DB project page is in Resources.