▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Overview

PlayerVaults is a comprehensive storage solution designed to give each player access to personal vault inventories. Unlike traditional storage systems, PlayerVaults offers unmatched flexibility with support for over 2 billion vaults per player, a sophisticated permission inheritance system, and professional-grade administrative tools. Whether you're running a small survival server or a large network, PlayerVaults scales to meet your needs while maintaining optimal performance through async operations and smart caching.

The core philosophy behind PlayerVaults is simplicity for players, power for administrators. Players get straightforward commands to access their storage, while server staff receive enterprise-level tools for vault management, backup systems, and player data migration.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Features

Player Features
• Access up to 2 billion configurable vaults per player - no arbitrary limits
• Lightning-fast vault opening with the simple
/pv <number> command
• Intelligent permission inheritance system - pv.vault.10 automatically grants access to vaults 1 through 10
• Full chest inventory interface ( 27 slots per vault)
• Async operations ensure zero lag even during heavy usage
• Automatic cleanup system removes empty vaults to optimize storage
• Data persists across server restarts and player sessions
• Supports both online and offline player vault access

Administrative Tools

• Full Vault Management - View, edit, clear, or delete any player's vaults with dedicated commands
• Live Editing - Modify player vaults in real-time while they're online or offline
• Comprehensive Backup System - Create timestamped backups of individual player vaults with one command
• Restoration Tools - Restore player vaults from backups with automatic conflict handling
• Player Migration - Transfer all vault data from one player to another (perfect for username changes or account transfers)
• Statistics Dashboard - View detailed analytics including total vaults, storage usage, and per-player breakdowns
• Bulk Operations - Clear all vaults for a player or delete entire player datasets
• Permission Testing - Built-in tools to verify player vault access levels
• Hot Reload - Update configuration without restarting your server

Performance & Optimization

• Fully asynchronous database operations prevent server lag
• Smart caching system reduces database queries
• Efficient storage format minimizes disk space usage
• Empty vault auto-cleanup configurable intervals
• Connection pooling for optimal database performance
• Batch operations for large-scale vault management

Customization Options

• Fully configurable maximum vault limit (default: 99, supports up to 2+ billion)
• Complete message customization with full color code and hex color support
• Disable any message by setting it to an empty string in config
• Choose between MySQL or SQLite storage backends
• Configure auto-cleanup intervals and behaviour
• Set backup retention policies and automatic cleanup
• Customize vault titles and inventory names
• Flexible permission system with wildcard support

Data Management

• Choose between MySQL for networks or SQLite for single servers
• Automatic database schema creation and updates
• Built-in data integrity checks
• Export and import functionality for server migrations
• Backup scheduling with configurable retention
• Corruption detection and recovery tools

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Commands

Player Commands
Admin Commands
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Permissions

PlayerVaults uses an intuitive inheritance-based permission system. When you grant a player access to a specific vault number, they automatically gain access to all vaults below that number.

Vault Access Permissions

Administrative Permissions

Permission Examples
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Configuration

PlayerVaults provides extensive configuration options to tailor the experience to your server's needs:

Storage Settings
• Storage Type - Choose between MySQL (for networks) or SQLite (for single servers)
• MySQL Configuration - Host, port, database, username, password, and connection pool settings

• SQLite Configuration - Automatic file creation in the plugin data folder

Vault Settings
• Max Vaults - Set the maximum number of vaults per player (default: 99, supports up to 2,147,483,647)
• Auto Cleanup - Enable/disable automatic removal of empty vaults
• Cleanup Interval - Configure how often cleanup runs (in hours)
• Vault Title Format - Customize the inventory title players see

Backup Settings

• Backup Location - Directory for storing vault backups
• Retention Period - How long to keep old backups before auto-deletion
• Backup Format - Compression and format options

Message Customization

• Fully customize all player-facing messages
• Support for color codes (&a, &b, etc.) and hex colors (&#FF5733)
• Disable individual messages by setting them to empty strings
• Configure error messages, success messages, and informational text
• Placeholder support for player names, vault numbers, and more

Performance Settings

• Cache Size - Configure memory cache for frequently accessed vaults
• Batch Size - Set batch operation sizes for bulk actions
• Connection Pool - MySQL connection pool configuration
▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Use Cases

Survival Servers Give players extra storage without cluttering their bases. Perfect for organizing materials, keeping valuable items safe, or storing seasonal items.

Economy Servers Players can use vaults as personal shops, storage warehouses, or auction house alternatives. Combine with permission-based vault limits to create tiered storage ranks.

PvP Servers Provide secure storage that persists through deaths. Players can store backup gear, potions, and valuables safely away from combat.

Creative Servers Give builders unlimited storage for blocks, decorations, and building materials. No more cluttered inventories or lost items.

Network Servers Using MySQL, player vaults can sync across multiple servers in your network, providing consistent storage wherever players go.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Requirements

Minimum Requirements

• Minecraft Version: 1.8 - 1.21+
• Server Software: Spigot, Paper, Purpur, or any Spigot fork
• Java Version: 8 or higher
• RAM: 512MB minimum (1GB+ recommended for MySQL)


Recommended Setup

• Paper or Purpur for best performance
• Java 17+ for optimal async operations
• MySQL 5.7+ for network environments
• Regular backups of your database

Optional Dependencies
• Vault (economy plugin) - Not required, no dependencies
• LuckPerms or any permissions plugin - For permission management

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Installation

Step 1: Download PlayerVault.jar
Step 2: Place the jar file in your server's plugins folder
Step 3: Restart your server
Step 4: Configure config.yml in the plugins/PlayerVaults folder
Step 5: Set up permissions for your players

Step 6: Reload the config with /pvadmin reload or restart again
The plugin will automatically create its database and required files on first startup.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Support & Resources

Need help? Found a bug? Have a suggestion?

Discord - Get live support from the community

• Private Message: Contact me directly through the platform
• Reviews: Leave feedback and help others discover PlayerVaults

Response Time
I typically respond to support requests within 24 hours.
For urgent issues, please use Discord for the fastest response.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

Frequently Asked Questions

Q: Can players share vaults with each other?
A: No, vaults are personal to each player. However, admins can transfer vault data between players using the migrate command.

Q: What happens if a player loses access to a vault permission?
A: Their items remain safe in the vault. They simply can't open it until they regain permission. Admins can retrieve items if needed.

Q: Does this work across multiple servers?
A: Yes! When using MySQL, vaults sync across all servers in your network that use the same database.

Q: Can I limit vault access by rank?
A: Absolutely. Use the inheritance permission system to grant different vault limits to different ranks (e.g., VIP gets 10 vaults, MVP gets 50).

Q: Are vaults protected from item loss?
A: Yes. Items in vaults persist through server crashes, restarts, and player deaths. Regular backups add an extra layer of protection.

Q: Can I convert from another vault plugin?
A: Migration tools are available. Contact support with your current plugin name for assistance.

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬

License

This resource is licensed under Creative Commons BY-NC-SA 4.0 with additional restrictions:

• Non-Commercial - You may not use this for commercial purposes
• Share-Alike - Modifications must use the same license
• Attribution - You must give appropriate credit
• No Redistribution - You may not redistribute, reupload, or share this resource publicly without explicit written permission

▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬▬