QuinzVault

A lightweight, secure, and dupe-free PlayerVaults alternative for Paper 1.21.x

✨ Features

• Unlimited Vaults: Give players access to virtual vaults based on their permissions (e.g. playervaults.amount.5).
• NBT & Custom Items Support: Safely stores enchanted items, custom lore, crate keys, and even written books without data loss.
• 🛡️ 100% Dupe-Proof System (Tested & Verified):
  • Concurrent Editing Protection: Vaults are strictly locked. If an admin deletes a vault while a player is viewing it, the plugin force-closes the inventory first, completely stopping the notorious "Undelete Dupe" bug.
  • Emergency Shutdown Save: If the server restarts or stops unexpectedly, all open vaults are instantly force-closed and data is force-saved to the disk, preventing rollback item duplication.
  • Memory Leak Prevention: Safely clears cached data when players disconnect.
  • Item Filtering: Blocks blacklisted items (like Bedrock or Command Blocks) from being dragged into the vault.
• Offline Management: Admins can view, edit, or delete the vaults of offline players anytime.
• Sign Integration: Create physical [Vault] signs to open vaults with a simple click.
• Legacy Conversion: Includes /pvconvert PlayerVaults to instantly migrate all old data from the original PlayerVaults plugin!

🚀 Commands & Permissions

Command	Permission	Description
/pv <#>	playervaults.amount.<#>	Open your personal vault.
/pv <player> <#>	playervaults.admin	Open another player's vault (even offline).
/pvdel <#>	playervaults.delete	Clear your own vault.
/pvdel <player> <#>	playervaults.admin	Delete another player's vault.
/pvsign <#>	playervaults.signs.set	Bind a sign to your vault.
/pvconvert PlayerVaults	playervaults.admin	Migrate data from old PlayerVaults.
/pvreload	playervaults.admin	Reload config.yml.

Sign Permissions

• playervaults.signs.set - Create a vault sign.
• playervaults.signs.use - Use a vault sign.

🔗 Dependencies & Integrations

• Required Plugins: None! QuinzVault is 100% standalone and does not require any other plugins to function.
• Recommended & Supported Plugins:
  • LuckPerms: Highly recommended for managing and granting vault permissions (like playervaults.amount.5) to your players/ranks.
  • PlaceholderAPI: Install this to unlock the %playervaults_vaults_max_by_perms% placeholder, which displays the maximum number of vaults a player is allowed to own.

🛠️ Installation

1. Download QuinzVault.jar.
2. Drop it into your plugins/ folder.
3. Restart your server.
4. (Optional) Configure config.yml to set vault sizes and blocked items!

📞 Support & Contact

If you need any help, found a bug, or want to request a feature, feel free to contact the author:

• Discord: dev_love_dookki (Quinz | Java)
• Developer: Hoàng Mạnh Quân (Quinz)

Thank you for using QuinzVault!