1.17 - 1.21.8 PenguinVaults Player Vaults with Money & XP

PenguinVaults — Player Vaults with Money & XP Banks

PenguinVaults is a configurable and performance-focused player vaults system.

Players can open vaults with /pv, with vault count and size fully controlled via permissions.

Includes optional money storage (Vault) and experience storage (levels or XP) built directly into the GUI.

Items, money, and XP persist across restarts

Fully configurable with clean messages

Lightweight, modern, and Paper-optimized

Website

Discord Support

Key Features

• Player Vaults
  • Open with /pv
  • Vault sizes in multiples of 9 (9–54)
  • Fully permission-based (vault count + size)
• Money & XP Banks
  • Optional money storage via Vault
  • Configurable XP mode: LEVELS or XP
  • Shift-click = deposit/withdraw ALL
  • Click = prompt in chat for precise amounts
  • GUI always shows stored amounts
• Persistence & Safety
  • Auto-save on close, disable, and money/XP operations
  • Items, money, and XP saved across restarts
  • Automatic XP conversion between LEVELS XP if config changes
  • Per-player YAML storage (simple backups & portability)
• Config & Messages
  • config.yml to toggle features and GUI buttons
  • messages.yml for clean, fully editable English messages

Commands

• /pv [player] → Open vault (self or others, admin required)
• /pv reload → Reload config & messages
• /penguinvaults reload → Alternative reload command

Permissions

• penguinvaults.use → Use /pv (default true)
• penguinvaults.vault.NUMBER → Access a specific vault
• penguinvaults.vault.* → Access all vaults (default OP)
• penguinvaults.size.NUMBER → Set vault size (9–54)
• penguinvaults.size.* → Max size (default OP)
• penguinvaults.admin → Admin features (reload, open for others)

User Experience

• Example: /pv 1 → open your first vault (requires permissions)
• GUI controls (bottom-left):
  • Money Bank → deposit/withdraw money
  • XP Bank → deposit/withdraw XP
• Left-click = deposit | Right-click = withdraw
• Shift-click = ALL | Normal click = prompt in chat

Configuration

config.yml

• Default vault size (9–54)
• Toggle money/experience storage
• XP mode: LEVELS or XP
• Shift-click ALL option
• Protect UI slots

messages.yml

• Fully editable
• Prefix for chat messages
• Clean formatting for stored amounts in GUI

Persistence & Conversion

• Stored per vault: items, money, XP, mode, size
• Data path: plugins/PenguinVaults/data/vaults/*.yml
• On load: automatic XP conversion if config mode changed

Compatibility

• Server: Paper 1.20/1.21+ (works on forks with Paper API)
• Java: 17+
• Economy: Vault (optional, hidden if missing)
• Storage: YAML files (no database needed)

Installation

1. Drop the JAR into /plugins/
2. (Optional) Install Vault + economy plugin for money storage
3. Start the server (configs generated)
4. Configure config.yml & messages.yml
5. Reload with /pv reload

Why PenguinVaults?

• Clean GUI with built-in banks
• Full permission control
• Immediate saving & robust persistence
• Safe XP conversion (LEVELS XP)
• Lightweight, modern codebase

Links

Website

Discord Support