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.

Open Cage

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.

Trapped Mob

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.

Mob Renders

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.

Tooltip

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 Release

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.

Comparator

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