• Store up to 10 tamed companions per player (configurable up to 1024): 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 release it from the vault (the animal stays in the world), or release any companion from the radial menu.
• Open the radial menu to see all stored companions with their names, health, and status: summoned, stored, dead, or lost (amber — see FAQ).
• 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 release 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
• Ctrl+right-click — mark a companion for release (slice turns red). Then left-click it to confirm, Ctrl+left-click to release it in front of you even without space, or right-click to cancel. A stored companion is placed next to you first; a summoned one stays where it is. Released companions are never killed.
• Mouse wheel or the arrows under the circle — change page (only appears when you have at least 1 page of pets)

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. This also applies if the pet dies while you're offline: the recovery is applied when you log back in.

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.

Radial menu pages (client setting): petsPerPage is a per-player setting and is never sent to the server, so each player chooses their own layout. When the server allows more pets than this, the radial menu gains pages: scroll the mouse wheel, or click the arrows under the circle (e.g. 2/8).

File: config/pet_vault-client.toml (NeoForge, Forge) or config/pet_vault_client.json (Fabric). On NeoForge you can also edit it in-game from the mod list.

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.

Click a lost companion's id to copy it, or, as an operator, to fill in the restore command.

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

Yes, to open the radial menu. If a Curios/Trinkets build is installed, the locket must be equipped in its accessory slot instead — enable the allowUnequippedLocket config option if you'd rather open it from the inventory regardless. 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 players, so a pet you left behind may be in an unloaded chunk. The mod remembers where each summoned pet was when its chunk unloaded, even if you were offline at the time. When you store it, the mod loads just that chunk, waits up to ~10 seconds for the pet, stores it, then lets the chunk unload again. You'll see "Recalling..." while this happens.

If the pet isn't there, it's marked as lost. It's never duplicated: see below.

My pet is "lost". Now what?

A pet is marked lost when you try to store it and the mod can't find it where it should be, but it also has no record of the pet dying. This happens when a pet leaves the world without dying, for example:

• It was transformed into another mob. A pig struck by lightning turns into a zombified piglin, which is a new mob the vault doesn't know.
• Another mod or tool removed it. World editors (e.g. WorldEdit), mods that clear mobs to reduce lag, or mods that pick mobs up into an item.
• The server crashed.

What you can do:

• Try storing it again. If it turns up later (e.g. another player loads its chunk), it's stored normally.
• Ask an operator to restore it. Run /petvault list lost, click the pet's id to copy it, and send it to them. They can bring it back from its last save with /petvault restore.
• Release it from the radial menu if it's gone for good. This frees its vault slot.

A lost pet keeps its vault slot, and counts toward the summon limit if your server sets one. Store-all skips it, so it isn't searched for on every press.

What if my pet dies while I'm offline?

It's handled exactly as if you were online. With a Soul Crystal it starts its recovery period; without one it's gone. You'll see a message when you log back in.

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.