Legacy Vault

作者：gottsch

Legacy Vault is a Minecraft mod that allows a player(s) to store inventory between worlds.

模组 Forge NeoForge 存储

介绍

中文介绍正在准备中，下面暂时显示原文。

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 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.

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

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):