🪤 Mob Cages
Capture, store, transport, and display peaceful and hostile mobs inside detailed 3D cages!**
Available for Minecraft Java Edition 1.21.1 on Fabric.*
---
🌟 Overview
Tired of leading animals thousands of blocks with wheat or building dangerous minecart tracks just to move a Villager, Cow, or Creeper?
Mob Cages: introduces tiered, reusable, and balanced cages that let you pick up living entities, safely carry them in your inventory, and place them down into your world as **fully functional 3D display blocks**!
Captured mobs preserve all of their original data: custom names, health, sheep wool colors, collar colors, villager professions, and baby stages.
---
📦 Cage Types
| Cage | Capacity | Allowed Mobs | Reusable? | Special Features |
| Wooden Cage | 1 Mob | Peaceful animals only | Consumed on release | Early-game affordable transport |
| Iron Cage | 1 Mob | Peaceful & Hostile mobs | ✅ Reusable | Durable steel build, retains cage upon release
|
| 🔮 Advanced Cage | Up to 3 Mobs | Peaceful & Hostile mobs | ✅ Reusable | Nether Star crown, Obsidian frame, Fireproof, Emits light level 7
How it works
1. Capturing a Mob
- Hold an empty cage in your hand.
- Right-Click on any valid living mob.
- The mob will safely vanish into the cage with custom audio and particle feedback!
2. Releasing a Mob
- Hold the occupied cage in your hand.
- Right-Click on the ground (top or side of a block).
- The mob will respawn facing your direction.
- Wooden Cages break on release.
- Iron Cages and *Advanced Cages return an empty cage to your hand!
3. Displaying as a 3D World Block (New!)
- Hold any cage (empty or holding mobs).
- Shift + Right-Click on the ground.
- The cage will be placed down as an interactable 3D block in the world!
- Contained mobs will be visible and gently rotate inside the cage.
- Advanced Cages cast a soft, ambient magical light.
- To pick it back up: Simply Shift + Right-Click the block or break it—all stored mobs will remain completely safe inside the dropped item!
🛡️ Safeguards & Performance
- Piston-Proof: Placed cages cannot be pushed or destroyed by pistons, eliminating entity duplication and void bugs.
- Blast Resistance: The Advanced Cage has blast resistance equivalent to obsidian (immune to Creepers and TNT).
- Fire & Lava Resistant: The Advanced Cage item never burns in fire or lava.
- Memory Optimized: Client-side entity caches dynamically refresh across dimensions and world leaves, preventing memory leaks and frame drops.
- Multiplayer Ready: Full client-server synchronization ensures no entity loss or inventory desync.
📋 Requirements
- Minecraft: `1.21.1`
- Mod Loader: [Fabric Loader](https://fabricmc.net/) (`>= 0.16.0`)
- Required Library: [Fabric API](https://modrinth.com/mod/fabric-api)
- Java: `21`
📄 License
Licensed under the [MIT License](LICENSE). Feel free to include Mob Cages in any modpack!
Mob Cages Team
