Legacy Vault

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:

Item Whitelist and Blacklist

Control what can go in vaults using datapack item tags:

• legacyvault:vault_items_whitelist — only these items are allowed
• legacyvault: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.

Requirements

• Required Library: GottschCore

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.