Compatibility
Minecraft: Java Edition
Platforms
Supported environments
Tags
Creators
Details
Pet Vault
Store your tamed companions inside a Keeper's Locket and summon them on demand — anywhere, any time.
Supports any player-owned creature: wolves, cats, parrots, horses, allays, and more.
Features
- 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.
- Left-click a slice to summon or store. Shift+left-click to summon and immediately mount. Ctrl+left-click to force-summon in front of you.
- Right-click a slice to toggle bodyguard mode — the pet auto-summons when you take damage.
- Shift+right-click a slice to select it; shift+right-click another slice to swap their order.
- 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 integration (NeoForge only) — equip the locket in a dedicated Curios slot.
Requirements
- Minecraft Java Edition
26.1.2 - One of: NeoForge, Forge, or Fabric with Fabric API
- Curios API (optional, NeoForge only — enables a dedicated equipment slot for the locket)
Getting Started
- Craft or obtain the Keeper's Locket and keep it in your inventory.
- Right-click any tamed companion you own to register it to the vault.
- Press V (default) to open the radial menu and summon or store pets by clicking their slice.
- Left-click on a slice to summon a companion. Left-click again, to store it.
Items
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
Configuration
A config file is generated at config/pet_vault-common.toml on first launch. All settings take effect after restarting or reloading the world.
| Setting | Default | Description |
|---|---|---|
maxPets |
10 |
Maximum pets stored per player (1–16) |
maxSummonedPets |
-1 (unlimited) |
Maximum pets summoned at once |
enableLifeCrystal |
true |
If false, Life Crystal does nothing and its recipe is removed |
enableSoulCrystal |
true |
If false, Soul Crystal does nothing and its recipe is removed |
healingRatePercent |
1.0 |
% of max health healed per heal tick |
healIntervalTicks |
60 |
Ticks between each heal tick (60 = every 3 seconds) |
reviveTimerSeconds |
300 |
Seconds a dead pet waits before it can be summoned again |
excludedEntities |
[] |
Entity types that cannot be stored, e.g. ["minecraft:wolf"] |
extraRideableEntities |
[] |
Entity types that can be auto-ridden via shift-left-click, e.g. ["minecraft:pig"] |
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.
FAQ
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.
Disclaimer
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.


