Pet Vault

• Store up to 10 tamed companions per player (configurable): wolves, cats, parrots, horses, donkeys, mules, llamas, allays, and any other player-owned mob.
• Right-click your tamed companion to register it to the vault.
• Right-click a summoned companion to permanently unregister it from the vault (the animal stays in the world).
• Open the radial menu to see all stored companions with their names, health, and status.
• Companions and upgrades are bound to you, not the locket — losing or replacing the locket never affects your stored companions.
• Unlock passive healing with a Life Crystal — stored pets slowly regenerate health.
• Unlock pet revive with a Soul Crystal — if a summoned pet dies it recovers after 5 minutes at full health.
• Healing and revive timers catch up while you were offline.
• Curios / Trinkets integration — equip the locket in a dedicated equipment slot where supported (see Mod Compatibility below).
• Works out of the box with any mod's pets or mounts built on vanilla's TamableAnimal/OwnableEntity — no extra setup needed.

• One of: NeoForge, Forge, or Fabric with Fabric API

Optional equipment-slot mods — the locket works from your inventory without them, but a dedicated slot frees the space up:

• ✅ Supported — implemented, works today
• 🛠️ Planned — other mod supports this loader; not yet implemented by me
• ⏳ Blocked — other mod has no build for this loader/version yet
• — Not applicable — other mod won't support this

"Trinkets" means different mods depending on version: the original dev.emi/trinkets on 1.20.1 and 1.21.1, but eu.pb4/trinkets ("Trinkets Updated") on 26.1.x — a from-scratch rewrite with a different API, since the original isn't maintained for that version.

1.20.1 has no NeoForge column — I don't support that version.

Pets and mounts from other mods: works automatically for anything built on vanilla's TamableAnimal/OwnableEntity. Auto-riding (shift-left-click to summon and mount) is opt-in per entity type — add the entity to the pet_vault:auto_rideable tag or the extraRideableEntities config option to enable shift-click-mounting for it. Entities with no ownership concept at all (e.g. iron golems, happy ghasts) aren't storable by default — see Configuration below to opt one in via the storableEntities config option or the pet_vault:storable tag.

1. Craft or obtain the Keeper's Locket and keep it in your inventory.
2. Right-click any tamed companion you own to register it to the vault.
3. Press V (default) to open the radial menu and summon or store pets by clicking their slice.
4. Left-click on a slice to summon a companion. Left-click again, to store it.

Keeper's Locket

The core item. Keep it in your inventory to access the radial menu. Right-click a tamed companion you own to register it to the vault. Right-click a summoned companion to permanently unregister it from the vault (the animal stays in the world).

Radial menu controls:

• Left-click — summon or store
• Shift+left-click — summon and immediately mount (rideable companions only)
• Ctrl+left-click — force-summon directly in front of you
• Right-click — toggle bodyguard mode; the pet auto-summons when you take damage (shown with a blue line)
• Shift+right-click — select a slice (highlighted yellow); shift+right-click a second slice to swap their order; click the same slice again to deselect

Life Crystal

Craft with a golden apple surrounded by four emeralds (shapeless). Consuming it permanently unlocks passive healing for all your stored pets — they regenerate 1% of max health every 3 seconds while stored.

Soul Crystal

Craft with a totem of undying surrounded by four emeralds (shapeless). Consuming it permanently unlocks pet revive — if a summoned pet dies, instead of being lost it enters a 5-minute recovery period and returns at full health.

Debug Items (creative only)

Available in the Pet Vault creative tab.

• Golden Bone — right-click any untamed tamable creature to instantly tame it to yourself
• Keeper's Magnifier — inspect vault data and entity state for nearby creatures

A config file is generated at config/pet_vault-common.toml on first launch. All settings take effect after restarting or reloading the world.

Allowing specific mobs: some entities have no ownership concept at all in vanilla (e.g. iron golems, happy ghasts). Add entity IDs to the storableEntities config option, or entity types to the pet_vault:storable data-pack tag — either one opts them into storage. They're stored first-come, first-served since there's no owner to check, but summoning one stamps it as yours so nobody else can re-store it while it's out.

Blocking specific mobs via data pack: add entity types to the pet_vault:excluded tag so your mod can ship its own exclusions without touching config.

Allowing more auto-rideable mobs via data pack: add entity types to the pet_vault:auto_rideable tag so your mod can ship its own auto-rideable mounts without touching config.

Do I need to keep the Keeper's Locket in my inventory?

Yes, to open the radial menu. Losing the locket does not delete your stored pets — they are saved to your player data and will still be there when you get a new locket.

Does healing or the revive timer work while I'm offline?

Yes — when you log back in, the mod calculates how much time passed and applies healing and revive timers accordingly.

Can another player steal my pets by picking up my locket?

No. Pets are bound to you specifically — picking up your locket gives no access to your pets.

What happens if I try to store a pet whose chunk has unloaded?

Minecraft only keeps entities loaded near a player, so a pet you left behind can end up in a chunk the server has unloaded. When that happens, the mod marks the pet's last known position at the moment its chunk unloads. If you then try to store that pet, it force-loads just that chunk, waits (up to ~10s) for the pet to reappear, stores it normally, then releases the chunk again — you'll see a "Recalling..." message and a short cooldown wedge while this happens.

This has a low chance of failing (e.g. the chunk takes too long to load, or something else already moved/removed the entity). If it does, the pet isn't lost — the vault slot falls back to its stored state so you can summon it again later. On the way back, it's given a fresh identity, since the old one may still be tied to the entity that failed to load. There's a much smaller theoretical edge case where that original entity is still alive somewhere after all (e.g. it starts ticking again a moment too late) — in that unlikely case you could briefly end up with two of it. Practically negligible, but worth knowing about.

This mod is provided "as-is" without any warranty of any kind.
By using this mod, you agree that the author(s) are not responsible for any damages, data loss, misuse, or unintended consequences that may arise from its use.
This project is not affiliated with Mojang, Microsoft, or CurseForge.