ROF_PlayerVault

ROF_PlayerVault adds personal virtual storage vaults to your Spigot/Paper server. Let players access multiple vaults, customize inventory sizes, and store items independently of their regular inventory.

With asynchronous storage operations, optional MySQL support, economy integration, and extensive permission controls, you can tailor the storage system to your server's needs.

✨ Features

• Multiple Personal Vaults — Configure the maximum number of vaults players can access.
• Flexible Vault Sizes — Choose from 1 to 6 inventory rows, with permission-based sizing and per-vault overrides.
• File or MySQL Storage — Store vault data locally or use a MySQL database.
• Asynchronous Storage I/O — Perform vault data reads and writes asynchronously to reduce main-thread work.
• Economy Integration — Optionally charge in-game currency to open specific vaults through Vault and a compatible economy plugin.
• PlaceholderAPI Support — Use vault placeholders in scoreboards, holograms, and other compatible plugins.
• Item Blacklist — Prevent specified materials from being stored in vaults.
• Automatic Item Pickup — Optionally collect nearby ground items into a player's vault when their inventory is full.
• Customizable Sounds and Titles — Configure opening sounds, volume, pitch, titles, subtitles, and animation timings.
• Admin Tools — Open, inspect, edit, and delete other players' vaults with appropriate permissions.
• Safe Vault Deletion — Choose whether deleted vault contents are dropped at the player's last known location or cleared.
• Customizable Messages — Adjust plugin messages to fit your server.
• Command Tab Completion — Get suggestions for supported commands, player names, and vault numbers.

🚀 Installation

1. Download the plugin JAR
2. Place the JAR file in your server's plugins folder.
3. Start or restart your server.
4. Open plugins/ROF_PlayerVault/config.yml to configure the plugin.
5. Assign vault permissions to your players or groups.
6. Run /rofvault reload to apply supported configuration changes.

🧰 Requirements

• Server: Spigot or Paper
• Vault: Optional; required for economy functionality
• Economy plugin: Required alongside Vault to charge in-game currency
• PlaceholderAPI: Optional; required for PlaceholderAPI placeholders

🕹️ Commands

Command	Description
/rofvault	Open your first vault
/rofvault open [number]	Open one of your accessible vaults
/rofvault open <player> [number]	Open another player's vault (admin permission required)
/rofvault list	List your accessible vaults
/rofvault delete <player> [number]	Delete another player's vault (admin permission required)
/rofvault reload	Reload the plugin configuration

Aliases: /vault, /pv

🔑 Permissions

Permission	Description
rofvault.use	Use personal vaults
rofvault.list	List accessible vaults
rofvault.storage.<number>	Access a specific vault number
rofvault.size.<rows>	Set vault size from 1 to 6 rows
rofvault.admin	Grant administrative permissions
rofvault.admin.open	Open another player's vault
rofvault.admin.view	Inspect another player's vault without editing
rofvault.admin.edit	Edit another player's vault
rofvault.admin.delete	Delete another player's vault
rofvault.admin.reload	Reload the configuration

Use your permissions plugin, such as LuckPerms, to assign vault access and sizes to groups or individual players.

⚙️ Configuration

ROF_PlayerVault provides configurable settings for:

• Maximum vault count
• Default and per-vault inventory sizes
• File or MySQL storage
• Automatic item pickup, including whitelist and blacklist modes
• Items prohibited from vaults
• Economy costs for individual vaults
• Vault opening sounds and titles
• Messages and deletion behavior

Automatic item pickup is disabled by default and can be enabled in the configuration.

📊 PlaceholderAPI

ROF_PlayerVault provides placeholders for information such as:

• The number of vaults a player can access
• The list of accessible vaults
• Whether a player has access to a particular vault
• Vault sizes
• Whether a vault is currently open and its number

See the PlaceholderAPI documentation for the full list.

📚 Links and Support

• Source Code: https://github.com/RageOfFire/ROF_PlayerVault
• Downloads: https://github.com/RageOfFire/ROF_PlayerVault/releases
• Documentation: https://github.com/RageOfFire/ROF_PlayerVault/wiki
• Bug Reports and Feature Requests: https://github.com/RageOfFire/ROF_PlayerVault/issues

Made by RageOfFire.