Player Vault

The Page-Based Vault (/pv)

/pv opens a 54-slot inventory that lives in the database under player_vault_pages. It is per-player and per-page: each page is its own row, saved the moment you close the inventory. You can own up to 100 pages — that's up to 5,400 slots of permanent storage — gated by permission nodes.

Open your own vault with /pv (page 1) or /pv <page>. To peek at another player's vault, use /pv <player> or /pv <player> <page> — but their view is read-only. Every interaction in a viewer session is cancelled at the click event, so you can look but not touch.

Page Count and Permissions

Your max page count is decided by walking down from 100 to 2 and returning the first page count you have permission for. The permission scheme is:

• imperiummc.pv.pages.1 — default, grants 1 page (54 slots).
• imperiummc.pv.pages.5 — grants up to 5 pages (270 slots). Common donor tier.
• imperiummc.pv.pages.25 — grants up to 25 pages (1,350 slots). Higher donor tier.
• imperiummc.pv.pages.100 — grants the full 100 pages (5,400 slots). Top donor tier.

If no higher permission is set, you fall through to 1 page by default. Page counts are checked live, so donor upgrades apply the moment the permission lands.

Anti-Dupe and Item Identity

The vault is a non-bypassable surface for the plugin's anti-dupe system. Every serial-bearing item entering the vault is escrowed — its player-claim is dropped so it doesn't manufacture false collisions in the owner's next scan. When the owner closes the vault, every item still inside is re-attributed to the owner. This mirrors the auction house and marketplace flows: vaults cannot be used to launder duped items.

Critically, only the owner closing their own vault triggers a save. A viewer closing a read-only session does nothing — their changes (which were blocked at the click event) are discarded entirely.

The Slot-Based Vault (/vault)

Alongside the GUI vault, the VaultManager exposes a slot-based vault sized in configurable increments. By default you start with 9 slots and can buy more in increments of 9 up to a cap of 54 slots. Unlike the GUI vault, this system stores materials by count — think of it as a high-capacity material silo rather than a free-form inventory.

It's configured in vaults.yml:

• default_slots — 9 (starting slots)
• max_slots — 54 (hard cap)
• slot_increment — 9 (slots per upgrade)
• cost_per_increment — 5,000 (Auctoritas per upgrade)
• currency — tokens (Auctoritas)
• playtime_required — 3600 (1 hour of play to unlock)

Playtime Requirement

Both the slot-based vault and (optionally) the page-based vault can be gated behind a playtime requirement. The default is 1 hour (3,600 seconds) of in-game playtime, measured by the PLAY_ONE_MINUTE statistic (which actually counts ticks at 20/sec despite the misleading name). Before you hit the threshold, vault access is refused with a clear error.

The placeholder %imperiummc_vault_playtime% reports your current playtime in hours so you can see how close you are.

Upgrading Your Slot Vault

/vault upgrade buys the next increment of 9 slots for the configured Auctoritas cost. The progression is flat-cost (not exponential), so going from 9 → 54 costs roughly the same per step:

Each upgrade enforces a short per-player cooldown (1 second) to prevent accidental double-clicks charging you twice. If you ever hit the 54-slot cap, the upgrade is refused.

Storing and Retrieving

The slot vault speaks in materials, not item instances. /vault store DIAMOND 64 pulls 64 diamonds out of your inventory and stacks them under the DIAMOND key in the vault. /vault retrieve DIAMOND 64 does the reverse, dropping them back into your inventory (or on the ground at your feet if your inventory is full).

Because materials stack by count rather than occupying item slots, the slot vault is extremely space-efficient for hoarding ores, gems, and bulk blocks. /vault list shows every material and the total amount you have stored.

Vault vs Cell vs Sarcina

Three storage systems serve different niches. Knowing which to use when keeps your inventory clean and your hoards safe:

Command Reference — Page Vault (/pv)

Command Reference — Slot Vault (/vault)

PlaceholderAPI hooks: %imperiummc_vault_slots%, %imperiummc_vault_items_stored%, %imperiummc_vault_free_slots%, and %imperiummc_vault_playtime%.

Tips

1. Keep a backup kit in /pv. A second set of armor and a pickaxe means a PVP death never leaves you empty-handed.
2. Use the slot vault for ore hoards. It's far more space-efficient than chest-stacking diamonds.
3. Reach the playtime cap early. The 1-hour gate is the only blocker — mine actively and the slot vault unlocks itself.
4. Let donors carry more. Donor tiers grant additional /pv pages; check your tier on the store.
5. Read-only views are safe. /pv <player> is a great way to show off a collection without risking theft.
6. Don't hoard in your inventory. Death drops everything; the vault doesn't. Move valuables before PVP.