# \ud83d\udc3e Animal Pens Paperized<\/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** and **aquariums** 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
This plugin is reimplementation of Animal Pens mod.<\/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 **Releasing animals** by crouch clicking on ground.<\/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 animal to **view stored variants**.<\/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** _[plugins\/AnimalPenPlugin\/config.json]_, allowing you to tweak:<\/p>\n
\u2699\ufe0f **Cooldowns for actions** \u2013 Example:
\n\u00a0\u00a0\u00a0\u00a0\u2022 Feeding animals
\n\u00a0\u00a0\u00a0\u00a0\u2022 Shearing sheep
\n\u00a0\u00a0\u00a0\u00a0\u2022 Collecting eggs from chickens\/turtles
\n\u00a0\u00a0\u00a0\u00a0\u2022 Milking cow<\/p>\n
\ud83d\udde1\ufe0f **Attack cooldown** – Allows to change how fast players can kill animals in pen.<\/p>\n
\ud83d\udce6 **Drop Limits** \u2013 Prevent item overflow:
\n\u00a0\u00a0\u00a0\u00a0\u2022 \ud83d\udc11 Wool drop limit
\n\u00a0\u00a0\u00a0\u00a0\u2022 \ud83e\udd5a Egg drop limit<\/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
\ud83d\udcca **Statistics** \u2013 Allows to toggle if interactions with animal in pen should affect statistics.<\/p>\n
\ud83d\udd3c **Advancements** \u2013 Allows to toggle if interactions with animal in pen should affect advancements.<\/p>\n
\ud83d\udeab **Blocked Animals List** \u2013 Prevent specific mobs from being captured.<\/p>\n
***<\/p>\n
### Customizable Food Items<\/p>\n
You can also add or change food items for each animal. You can do it with data packs.
\nTo add\/change animal food you need to create a file: `[plugins\/AnimalPenPlugin\/animal_foods.json].json`<\/p>\n
“` ### Recipes<\/p>\n Recipes can be adjusted via datapacks, however, you must follow examples that are added by default: Recipes Data Pack<\/p>\n ### Resource Pack<\/p>\n Plugin comes with resource pack you can add to your client to show custom item icons as well as make animal pen and aquarium look nicer. Resource Pack is available under Animal Pens Paperized Resource Pack<\/p>\n ### Localization<\/p>\n Plugin comes with server side messages `messages.yml`. However, using resource pack you can customize translations for client.<\/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 ## \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 ## \u2753 FAQ<\/p>\n \ud83d\udd39 Precise Clicking<\/p>\n In Minecraft Paper, you have limited control over the overall system, which is why interactions are separated between entities and blocks:<\/p>\n – Animal cages and water containers can only interact when placed on smooth stone slabs. \ud83d\udd39 Is Water Necessary for Aquariums?<\/p>\n In Minecraft, fish outside of water will always appear sideways. This is a hard-coded behavior for all water animals – they automatically change their pose when out of water. While this can be modified in modded environments, it is not possible in a Paper plugin. Simple plugin that allows to put animals into pens instead of having them roaming around the world<\/p>\n","protected":false},"featured_media":14885,"template":"","meta":{"_minecraft_slug":"animalpenspaperized","_minecraft_project_id":"hLPvTz2Q","_minecraft_author":"BONNe","_minecraft_license":"GPL-3.0-only","_minecraft_downloads":334,"_minecraft_follows":0,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"animalpenspaperized.zip","_minecraft_size_bytes":2170882,"_minecraft_version_count":13,"_minecraft_updated_at":"2026-05-16T11:29:03.838657Z","_minecraft_date_created":"2025-08-29T19:03:37.049359Z","_minecraft_date_modified":"2025-12-10T10:37:23.495083Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/animalpenspaperized","_minecraft_icon_attachment_id":14885,"_minecraft_imported_at":"2026-05-31T18:11:29+00:00","_minecraft_import_hash":"849225b10b66b28f598f96ec3f2ebc4a","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[89,137,90,127,92],"mod_loader":[132],"minecraft_version":[40,41,78,79,80,81,82],"class_list":["post-14884","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-game-mechanics","mod_category-mobs","mod_category-optimization","mod_category-paper","mod_category-utility","mod_loader-paper","minecraft_version-1-21-10","minecraft_version-1-21-11","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"],"yoast_head":"\n
\n{
\n \/\/ optional value. Defines when the food items should be loaded
\n “
\n “
\n “#
\n ]
\n}
\n“`<\/p>\n
\nDefault Resource Pack: https:\/\/github.com\/BONNePlayground\/AnimalPenPaperized\/tree\/master\/src\/main\/resources\/animal_pen_resource_pack<\/p>\n
\n\ud83d\udd04 `\/animal_pen reload` \u2013 Reloads the config file without restarting the game.
\n\ud83c\udf92 `\/animal_pen items` \u2013 Custom creative menu to get custom items.<\/p>\n
\n– Killing and other entity interactions can only be performed by clicking directly on the entity.
\n– Breaking pens and aquariums is only possible by breaking the base smooth stone slab.<\/p>\n
\nYou can reduce this issue by using the Animal Pens Resource Pack.<\/p>\n","protected":false},"excerpt":{"rendered":"