Your items, always waiting for you — no matter what world you're on.
Legacy Vault gives every player a personal inventory that lives outside the world. Place a vault block, open it, and anything you store stays yours. Switch to a new world or start over — your vault is still there. Vault data is stored on the server, so your items are available across any world on that server.
Vault Types
Rustic Vault
A personal vault. Only you can open it. Craft it with a Chest at the center of the recipe.
Classic Vault
Also a personal vault, with a different look. Craft it with a Barrel at the center.
Community Vault
A shared vault that any player (or any player on an allowlist) can access. Great for server shops, donation chests, or faction storage. The full expansion and search features are available here too.
Vault Expansion
New players start with 1 row of 9 slots. Use Vault Upgrade items to unlock more rows, up to 10 rows (90 slots).
- Right-click your vault while holding a Vault Upgrade to unlock the next row.
- Upgrades are consumed on use (unless you're in creative mode).
- Your tier carries over between worlds — reach tier 5 in one world and your expanded vault is waiting in the next.
- Vault Upgrades can drop from adventure chests — dungeons, mineshafts, strongholds, temples, woodland mansions, end city, nether fortress, bastion remnants, and ancient cities. The drop chance and count are configurable.
Server admins can change the starting size, the maximum size, and whether tier progress resets per-world.
Vault GUI Features
- Scrollbar — scroll through all your rows in one screen.
- Locked-slot indicator — rows you haven't unlocked yet show a clear X overlay so you can see what's coming.
- Search bar — type to dim items that don't match. Items stay in place so you can see where everything is.
- Sort button (Az) — sorts your unlocked rows alphabetically in one click. Locked rows are untouched.
- Item count tooltip — hover over an item and see "× N in vault" if you have more of the same thing in other slots.
Admin and Server Features
All commands require permission level 2 and live under /legacyvault:
| Command |
What it does |
inspect <player> |
View a player's vault contents and slot usage |
reload <player> |
Reload a player's vault from disk |
clear <player> |
Wipe all items from a player's vault (asks for confirmation) |
transfer <from> <to> |
Move everything from one player's vault to another |
locations <player> |
List the coordinates of all of a player's placed vaults |
locations clear <player> |
Clear a player's vault location list |
count <targets> [value] |
Show or set a player's vault count |
spawn <pos> [targets] [type] [direction] |
Place a vault in the world |
tier inspect <player> |
Show a player's current tier and slot count |
tier set_tier <targets> <value> |
Set a player's tier directly |
tier reset <targets> |
Reset a player to the starting tier |
tier max <targets> |
Set a player to the maximum tier |
encryption status |
Show whether vault encryption is on or off |
encryption on|off |
Toggle encryption without restarting the server |
Item Whitelist and Blacklist
Control what can go in vaults using datapack item tags:
legacyvault:vault_items_whitelist — only these items are allowedlegacyvault:vault_items_blacklist — these items are blocked
The tag lists are checked first. Config-based regex patterns still work as a fallback.
Blocked by default (to prevent cheating the slot limit):
- Iron Chests
- Sophisticated Backpacks, Sophisticated Storage
- Traveler's Backpack
- Treasure2 chests and containers
Vault Encryption (Optional)
Turn on encryptVaultData in the server config (or use /legacyvault encryption on) and vault files on disk are scrambled so no one can read them without the server's key. Protects against file theft and UUID spoofing. Safe to toggle at any time — existing files keep working either way.
Important: Back up config/legacyvault/legacyvault-secret.dat. If you lose this file, encrypted vaults cannot be read.
Crash-Safe Saves
Vault files are written to a temp file first, then swapped in — so a crash or power cut during a save can't corrupt your data.
Configuration Highlights
All settings live in serverconfig/legacyvault-server.toml.
| Setting |
Default |
What it does |
startingVaultTier |
1 |
How many rows players start with |
maxVaultTier |
10 |
Maximum rows a player can unlock |
enablePersonalVault |
true |
Allow personal (Rustic/Classic) vaults |
enableCommunityVault |
true |
Allow Community vaults |
resetTierPerWorld |
false |
Reset tier on each new world (items still carry over) |
encryptVaultData |
false |
Encrypt vault files on disk |
vaultUpgradeLootEnabled |
true |
Vault Upgrades can drop from chests |
vaultUpgradeLootChance |
0.02 |
Drop chance per eligible chest (2%) |
vaultUpgradeLootCount |
1 |
Upgrades per drop |
Requirements
Mod Compatibility
Legacy Vault is designed to coexist with popular mods. The following storage mods are blocked from being placed inside a vault by default (they would otherwise bypass the slot limit):
- Iron Chests
- Sophisticated Backpacks / Sophisticated Storage
- Traveler's Backpack
- Treasure2
Server admins can customize this list using item tags or regex patterns in the config.
