Player Vaults

Extra personal storage chests (playervaults) with a vault picker GUI, admin tools, and optional vault autopickup.

Module: playervaults in modules.yml
Config: playervaults.yml
Data: data/storage/vaults/{uuid}.yml

Commands

Command	Permission	Description
/sa vault	soapsadmin.vault	Open picker (or vault #1 if you only have one)
/sa vault gui	soapsadmin.vault	Open vault picker
/sa vault open [n]	soapsadmin.vault	Open vault n
/sa vault list	soapsadmin.vault	Chat summary + fill bars
/sa vault autopickup	soapsadmin.vault.autopickup	Cycle mode
/sa vault autopickup <off|direct|overflow>	mode perms	Set mode
/sa vault autopickup vault <n>	soapsadmin.vault.autopickup	Target vault for pickup
/sa vaultadmin open <player> [n]	soapsadmin.vaultadmin	Open another player's vault
/sa vaultadmin clear <player> [n]	soapsadmin.vaultadmin.clear	Clear a vault (closes viewers first)
/sa vaultadmin info <player> [page]	soapsadmin.vaultadmin	Show vault summary (paginated)

Edit other players' vaults requires soapsadmin.vaultadmin.edit. Without it, admin open is read-only ([view] in the title).

Picker GUI

Left-click a vault to open it. Right-click sets the autopickup target. Hopper / F cycles autopickup mode when permitted.

Aliases (customcommands)

Shipped defaults:

• /sa pv / /sa playervault → vault
• /sa pva / /sa playervaultadmin → vaultadmin

Permissions (tiers)

Regular players with soapsadmin.vault get one vault (default-vault-count). Extra vaults require an explicit numbered permission — ops / * wildcards alone do not unlock more.

Permission	Effect
soapsadmin.vault.limit.N	Max vaults (highest explicit N wins; else default-vault-count)
soapsadmin.vault.rows.N	Chest rows 1–6 (highest explicit N wins; else default-rows)
soapsadmin.vault.autopickup	Enable vault autopickup feature
soapsadmin.vault.autopickup.direct	Allow direct mode
soapsadmin.vault.autopickup.overflow	Allow overflow mode

Shipped examples: limit.2 / 3 / 5 / 10, rows.4 / 5 / 6 (all default false).

Example premium kit: grant limit.3, rows.6, autopickup, autopickup.direct, autopickup.overflow.

Autopickup modes

Separate from /sa autopickup (player inventory magnet).

Mode	Behavior
off	Disabled
direct	Nearby drops go straight into the target vault
overflow	Fill player inventory first; leftovers go into the vault

Radius and tick interval come from playervaults.yml. Pickup skips a vault that is currently open (avoids desync). Blacklisted materials and player item-filter entries are ignored. Blacklisted items are rejected on place (not only on close).

Item fidelity

Vault contents are stored with ItemStack.serializeAsBytes() (Base64 in YAML), so custom NBT, enchantments, attributes, PDC, and similar metadata survive restarts.

Config highlights

default-vault-count: 1
default-rows: 3
title: "<gradient:#9B59B6:#D2B4DE><bold>Vault #{vault}</bold></gradient> <dark_gray>·</dark_gray> <gray>{player}</gray>"
open-sound: BLOCK_CHEST_OPEN
blacklist: []
autopickup:
  radius: 3.0
  interval-ticks: 4
  default-mode: off
  default-vault: 1

Reload: /sa reload playervaults