Back to mods
Animal cages project artwork

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

Choose a version Pick your version below, then grab the matching file.

Quick answer

Which Animal cages release matches 1.21.3?

Updated 3 months ago
Best match for your filters 4.0.2
Game version 1.21.0, 1.21.1-rc.1, 1.21.1-rc.2
Loader Built-in Vintage Story mod system

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.

Client Required
Dedicated server Optional
Loader for this release Built-in Vintage Story mod system
Required install it here Optional supported, not mandatory Not supported do not install here Source doesn’t say do not assume

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.3. Every mod below is checked against that same setup.

No extra mods listed for this file

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.3. Pick another file and the loader, install side or required mods may change.

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

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

  3. 03

    Put it on the correct side

    It must be installed on the client. Installation on the dedicated server is optional.

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

Spoiler!
Vanilla 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):

Spoiler!

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
},

Medieval Expansion Patch

*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
},

Feverstone Wilds

*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
},

Peacock Basses

{
"name": "cichla-*",
"scale": 1.0
},

Giant Gouramis

{
"name": "osphronemus-*",
"scale": 1.0
},

True Sunfishes

{
"name": "lepomis-*",
"scale": 1.0
},

Updated Hieronymus's Reptiles

*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 Critters Pack

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

46 available setups

Showing 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

1 of 28 releases match
Clear filters

Looking for an older file? The official Vintage Story Mod DB project page is in Resources.