PlayerVaults
Lightweight Personal Storage for Your Server
Version 1.7.5 |
MC 1.16.5 - 1.21.x |
No Dependencies
PlayerVaults provides up to
99 personal vaults for each player on your server. Simple commands, permission-based access, and zero configuration required.
For Players
- Open vaults instantly with /pv <number>
- 54 slots per vault (full chest size)
- Automatic saving when closed
- Tab completion for easy access
- Clean, intuitive interface
For Administrators
- View and edit any player's vault (online or offline)
- Add, remove, or modify items with automatic saving
- One-command backup system
- Migrate vaults between players
- Real-time statistics and monitoring
- Manual cleanup commands
- Full configuration reload without restart
Performance
- Async I/O operations prevent server lag
- Smart caching system
- Automatic cleanup of empty vaults
- Efficient YAML storage
- Tested with 100+ players
Player Commands
Code (Text):
/pv <1-99> - Open a vault
/playervault - Show help
Admin Commands
Code (Text):
/pva info - Plugin statistics
/pva list <player> - List player's vaults
/pva view <player> <vault> - View and edit player's vault
/pva clear <player> <vault> - Clear a vault
/pva delete <player> - Delete all player vaults
/pva migrate <from> <to> - Transfer vaults between players
/pva backup - Create backup
/pva stats <player> - Player vault statistics
/pva cleanup - Manual cleanup
/pva reload - Reload config
The permission system uses inheritance: Giving
pv.vault.10 grants access to vaults 1-10.
Vault Access
Code (Text):
pv.vault.1 - Access to vault 1 (default: true)
pv.vault.5 - Access to vaults 1-5
pv.vault.10 - Access to vaults 1-10
pv.vault.25 - Access to vaults 1-25
pv.vault.50 - Access to vaults 1-50
pv.vault.99 - Access to all vaults
pv.vault.* - Wildcard for all vaults
Admin Permissions
Code (Text):
pv.admin - Full administrative access (default: op)
pv.reload - Reload configuration
Example Setup (LuckPerms)
Code (Text):
lp group default permission set pv.vault.1 true # Everyone: 1 vault
lp group vip permission set pv.vault.10 true # VIP: 10 vaults
lp group mvp permission set pv.vault.25 true # MVP: 25 vaults
lp group admin permission set pv.admin true # Admin: Full access
Simple 3-Step Setup:
- Download the plugin JAR
- Place in your plugins/ folder
- Restart your server
That's it! All players automatically get 1 vault. Configure permissions to grant more.
Simple YAML configuration with customizable messages:
Code (Text):
settings:
auto-cleanup-interval: 30 # Minutes between cleanup
cache-vaults: true # Enable caching
vault-size: 54 # Slots per vault
messages:
vault-title: "&8PlayerVault #{vault}"
vault-opened: "&aOpened vault #{vault}!"
admin-vault-opened: "&aViewing &e{player}'s &avault #{vault}! &7(You can edit items)"
admin-vault-saved: "&aChanges saved to &e{player}'s &avault #{vault}!"
Placeholders:
{vault},
{player},
{count}
Color Codes: Use
& for colors (
&a = green,
&c = red)
Use Cases
Survival Servers - Extra storage beyond ender chests
Prison Servers - Cell storage and personal vaults
Skyblock - Island storage management
Minigames - Kit storage and loadout management
Hub Servers - Personal storage across your network
Compatibility
- Minecraft: 1.16.5 - 1.21.x
- Server: Spigot, Paper, Purpur
- Java: 8 or higher
- Dependencies: None
Support
Need help?
Common Issues:
- Player can't access vault → Check pv.vault.X permission
- Admin commands not working → Need pv.admin permission
- Vault not saving → Check file permissions in plugins/PlayerVaults/
Why Choose PlayerVaults?
Simple - No complex setup, just works
Lightweight - Minimal resource usage
Flexible - Permission-based for any server structure
Reliable - Automatic backups and async operations
Made by Darumba
Version 1.7.5 | Minecraft 1.21