# \ud83d\udc3e Animal Pens Mod<\/p>\n
## \u2705 Optimize Your Farms & Reduce Lag!<\/p>\n
Tired of lag caused by massive animal farms? **Animal Pens** lets you store animals in specialized **pens**, **aquariums** and **aviaries** while keeping full functionality!
\nNo more overcrowded barns – keep your animals neatly contained while still breeding, shearing, milking, and collecting drops like normal.<\/p>\n
***<\/p>\n
## \ud83c\udfae How It Works:<\/p>\n
\u2714\ufe0f **Animal Cage & Container** \u2013 Capture land animals with the **Animal Cage** and water creatures with the **Animal Container**.
\n\u2714\ufe0f **Feeding animals acts as breeding** \u2013 No need for free-roaming animals, just feed them inside their pen!
\n\u2714\ufe0f **Most vanilla interactions**(1) are possible, including:
\n\u00a0\u00a0\u00a0\u00a0\ud83d\udde1\ufe0f _Animal farming_ for loot
\n\u00a0\u00a0\u00a0\u00a0\u2702\ufe0f _Shearing sheep_
\n\u00a0\u00a0\u00a0\u00a0\ud83e\udd5b _Milking cows, mooshrooms, and goats_
\n\u00a0\u00a0\u00a0\u00a0\ud83c\udf44 _Collecting mushroom stew from mooshrooms_
\n\u00a0\u00a0\u00a0\u00a0\ud83d\udc1d _Bee pollen regeneration_
\n\u00a0\u00a0\u00a0\u00a0\ud83d\udc22 _Turtle scutes dropping based on settings_
\n\u00a0\u00a0\u00a0\u00a0\ud83d\udd8c\ufe0f _Brush scutes from armadillo_
\n\u00a0\u00a0\u00a0\u00a0\ud83e\uddfa _Water bucket to pick up fishes or axolotls_<\/p>\n
\u2714\ufe0f **Custom Interactions:**
\n\ud83d\udd39 Chickens, Turtles and Sniffers \u2013 Use a bucket to collect eggs.
\n\ud83d\udd39 Turtles \u2013 Drop **scutes** after feeding (configurable timing).
\n\ud83d\udd39 Sniffers \u2013 Require a bowl to drop seeds.
\n\ud83d\udd39 Fish Feeding \u2013 Fish eat **kelp & seagrass**, while other water creatures eat **fish**.
\n\ud83d\udd39 Frogs \u2013 Drop **Frog Lights** when fed a Magma Cube.<\/p>\n
\u2714\ufe0f **Variant Storage & Selection**
\n\u00a0\u00a0\u00a0\u00a0\u2022 Picking up an animal **saves its variant** inside the cage.
\n\u00a0\u00a0\u00a0\u00a0\u2022 Right-click an empty-handed pen to **view stored variants**.
\n\u00a0\u00a0\u00a0\u00a0\u2022 If _visual animal growing_ is enabled, you can adjust the display size of the animals.
\n\u00a0\u00a0\u00a0\u00a0\u2022 You can adjust the minimal amount of animals that should be protected from killing.
\n\u00a0\u00a0\u00a0\u00a0\u2022 You can toggle if animal pen\/aquarium should be interactable only by you.<\/p>\n
\u2714\ufe0f **Releasing animals** by crouch clicking on ground.
\n\u2714\ufe0f Animal Pens, Aquariums and Aviaries can send **Redstone** signal with comparator.
\n\u2714\ufe0f **Dispenser** can be used on Animal Pens, Aquariums and Aviaries with certain tools.<\/p>\n
(1) Features not added:
\n\u00a0\u00a0\u00a0\u00a0 Any animal transformation
\n\u00a0\u00a0\u00a0\u00a0 Any animal interaction with other entities<\/p>\n
***<\/p>\n
## \ud83d\udd27 Customizable Settings:<\/p>\n
Easily adjust gameplay with the **mod\u2019s configuration file** _[config\/animal_pen_config.json]_, allowing you to tweak:<\/p>\n
\ud83d\udde1\ufe0f **Attack cooldown** – Allows to change how fast players can kill animals in pen.<\/p>\n
\ud83d\udccf **Animal Growth System** (Optional):
\n\u00a0\u00a0\u00a0\u00a0\u2022 If enabled, **more animals = larger pen display**.
\n\u00a0\u00a0\u00a0\u00a0\u2022 Adjustable growth multiplier.<\/p>\n
\ud83c\udfa8 **Stored Variants** \u2013 Allows to change how many variants can be stored per pen.<\/p>\n
***<\/p>\n
## \ud83d\udd27 Data Driven Settings:<\/p>\n
### Added Three New Item Tags:<\/p>\n
These tags define which items can attack their respective blocks:<\/p>\n
* **`animal_pen:can_attack_aquarium`** \u2013 Items in this tag can attack the **Aquarium** block.
\n* **`animal_pen:can_attack_pen`** \u2013 Items in this tag can attack the **Animal Pen** block.
\n* **`animal_pen:can_attack_aviary`** \u2013 Items in this tag can attack the **Aviary** block.<\/p>\n
### Example: Adding Custom Weapons<\/p>\n
To allow **custom_knife** and **modded_dagger** to attack pens, create the following file in your **datapack**:<\/p>\n
#### \ud83d\udcc2 **For Minecraft 1.20.6 and Below:**<\/p>\n
Path: `your_custom_datapack\/data\/animal_pen\/tags\/items\/can_attack_pen.json`<\/p>\n
#### \ud83d\udcc2 **For Minecraft 1.21 and Above:**<\/p>\n
Path: `your_custom_datapack\/data\/animal_pen\/tags\/item\/can_attack_pen.json`<\/p>\n
“`
\n{
\n “replace”: false,
\n “values”: [
\n “mod1_id:custom_knife”,
\n “mod2_id:modded_dagger”
\n ]
\n}
\n“`<\/p>\n
This allows **custom weapons** to be used for attacking animal pens and aquariums.<\/p>\n
### Added Three New Entity Tags:<\/p>\n
These tags define which items can attack their respective blocks:<\/p>\n
* **`animal_pen:animal_cage_pickable`** \u2013 Mobs that can be picked up by Animal Cage.
\n* **`animal_pen:bird_catcher_pickable`** \u2013 Mobs that can be picked up by Bird Catcher.
\n* **`animal_pen:water_mob_container_pickable`** \u2013 Mobs that can be picked up by Water Animal Container.<\/p>\n
#### \ud83d\udcc2 **For Minecraft 1.20.6 and Below:**<\/p>\n
Path: ` #### \ud83d\udcc2 **For Minecraft 1.21 and Above:**<\/p>\n Path: ` ### Customizable Interaction<\/p>\n You can also add or change interactions each animal. You can do it with data packs. The interaction definition you can check at: [Wiki] (https:\/\/github.com\/BONNePlayground\/AnimalPen\/wiki\/Animal-Interaction)<\/p>\n ***<\/p>\n ## \ud83d\udcdc Commands:<\/p>\n Use these commands (server moderators) to manage the mod:<\/p>\n \ud83d\udcbe `\/animal_pen reset` \u2013 Resets the config file to default values. ***<\/p>\n ## \ud83d\udee0\ufe0f Requirements:<\/p>\n \ud83d\udccc **Architectury API** (Required). ***<\/p>\n ## \ud83c\udfa8 Mod Artwork:<\/p>\n Credit to **Breadcrumb5550** for the mod\u2019s blocks and items!<\/p>\n ***<\/p>\n With **Animal Pens**, you can **reduce lag, keep your farms organized, and maintain full interactivity!**<\/p>\n","protected":false},"excerpt":{"rendered":" Reduce lag and keep your animals neatly stored while maintaining full interactivity!<\/p>\n","protected":false},"featured_media":14881,"template":"","meta":{"_minecraft_slug":"animalpens","_minecraft_project_id":"K5CAV4wi","_minecraft_author":"BONNe","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":66273,"_minecraft_follows":79,"_minecraft_client_side":"required","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"animalpens.zip","_minecraft_size_bytes":116340985,"_minecraft_version_count":289,"_minecraft_updated_at":"2026-05-16T03:33:53.110051Z","_minecraft_date_created":"2025-02-25T08:35:16.391036Z","_minecraft_date_modified":"2026-05-08T20:17:29.499413Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/animalpens","_minecraft_icon_attachment_id":14881,"_minecraft_imported_at":"2026-05-31T18:10:57+00:00","_minecraft_import_hash":"41282c1dc1d9a6ba0fedc1f09f1433af","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[156,97,104,89,158,90,92],"mod_loader":[99,106,160],"minecraft_version":[53,54,55,56,57,58,59,36,60,93,94,101,102,62,37,40,41,73,74,38,78,79,80,81,82,83,167,163],"class_list":["post-14880","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-decoration","mod_category-fabric","mod_category-forge","mod_category-game-mechanics","mod_category-neoforge","mod_category-optimization","mod_category-utility","mod_loader-fabric","mod_loader-forge","mod_loader-neoforge","minecraft_version-1-18-2","minecraft_version-1-19","minecraft_version-1-19-1","minecraft_version-1-19-2","minecraft_version-1-19-3","minecraft_version-1-19-4","minecraft_version-1-20","minecraft_version-1-20-1","minecraft_version-1-20-2","minecraft_version-1-20-3","minecraft_version-1-20-4","minecraft_version-1-20-5","minecraft_version-1-20-6","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9","minecraft_version-26-1","minecraft_version-26-1-1","minecraft_version-26-1-2"],"yoast_head":"\n
\nTo add animal interaction you need to create a file: `
\nTo change animal interaction you need to change animal file: `
\n\ud83d\udd04 `\/animal_pen reload` \u2013 Reloads the config file without restarting the game. <\/p>\n
\n\ud83d\udcd6 **Patchouli** (Optional, adds an in-game guidebook).
\n\ud83d\udcd6 **ClothConfigAPI** (Optional, adds config editing GUI).<\/p>\n