Better Cage Trap

Capture, transport, and display any mob with a simple craftable trap.

Cage Trap adds a mechanical trap block that automatically captures any mob 
that walks onto it. The captured mob is stored in full — health, name, 
equipment, and all data preserved. Release it with a right-click, a redstone 
signal, or pick up the cage and take it anywhere.

How It Works

Place the cage trap on the ground. The trap opens automatically, spreading 
its panels flat. Any mob that walks onto it is instantly captured and the 
cage snaps shut around them.

Capturing Mobs

Any mob that walks onto an open cage trap is automatically captured — 
passive mobs, hostile mobs, and even modded mobs are all fair game. 

See What's Inside

The captured mob is rendered inside the closed cage, slowly rotating so 
you can see it from all angles. Hover over a cage item in your inventory 
to see exactly what mob is stored inside.

Transport Mobs Anywhere

Break a closed cage and it drops as an item with the mob safely stored 
inside. Place it back down anywhere to restore the cage with the mob 
still inside. Mob health, name tags, equipment, and all other data are 
fully preserved through the entire process.

Redstone Integration

Right-click a closed cage to release the mob, or wire it up 
to a redstone signal for automated release. A comparator placed next 
to a cage outputs a signal strength based on the captured mob's max 
health — stronger mobs emit a stronger signal.

Crafting

Configuration

All options are in `config/cagetrap-common.toml`:

- **easy_capturing** — allow capturing mobs that are actively in combat
- **release_cooldown** — how long before the cage can capture again after 
  releasing (default 10 seconds)
- **blacklist** — entity IDs that can never be captured 
  (default: Ender Dragon, Wither)
- **comparator_max_health** — health value that maps to signal strength 15 
  (default: 500, the Warden's health)

Datapack Support

Cage Trap is fully datapack extensible. Modpack makers can:

- Add or remove mobs from the capture blacklist
- Override the render scale of any mob that appears too large or too small 
  inside the cage

See the mod's README for full datapack documentation.

Compatibility

- **NeoForge 1.21.1**
- Compatible with any mod that adds standard LivingEntity mobs
- Modded mobs can be added to the blacklist or given custom render scales 
  via datapack with no code changes required

*Inspired by the cage trap from 
[Untamed Wilds](https://www.curseforge.com/minecraft/mc-mods/untamedwilds) 
— reimplemented from scratch for NeoForge 1.21.1 with additional features.*