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