VirtualChest



Last Update: 1.5

• v1.5 - Admin List & Dynamic Titles Update
• 1.21.11 tested

Virtual Storage solution for your server. Fully optimized for Paper/Folia regional multithreading, Paper 1.21.1+, and now featuring professional-grade data security.

Main Features
│➜ Security First: Implementation of a custom InventoryHolder system
│➜ that prevents any data corruption from third-party menu conflicts.
│➜ Smart Storage Engine: Support for SQLite and MySQL with
│➜ high-speed
│➜ Async saving to ensure zero impact on your server's TPS.
│➜ Automated Backups: Generates a safety copy of your database on
│➜ every restart with a configurable cleanup policy for old files.
│➜ Mass Migration: Seamlessly converts your old 1.3 YAML data files
│➜ to the new SQL database structure automatically on first boot.
│➜ Folia & Paper Native: Engineered with Regional Schedulers for
│➜ 100% stability in multithreaded environments.
│➜ Dynamic Permission Limits: Automatically calculates chest access
│➜ based on numeric permissions (e.g., virtualchest.10).
│➜ Expanded Localization: Now officially supports English (EN),
│➜ Portuguese (PT), Spanish (ES), and Russian (RU).
│➜ Staff Admin System: Inspect, edit, or manage any player's virtual
│➜ chest in real-time with administrative priority.
│➜ Realistic Sound Effects: High-quality chest opening sounds to
│➜ improve player immersion on every interaction.
│➜ Command Priority: Hardened registration system that ensures
│➜ /pv belongs to VirtualChest, even if other plugins try to use it.

Commands
│➜ /pv <id> Opens a specific virtual chest (Alias: /vc [id]).
│➜ /pv admin <player> <id> Administrative command to inspect or edit
│➜ another player's chest.
│➜ /pv reload Instantly reloads configurations and all language files.

Permissions
│➜ virtualchest.use Basic permission to use the system.
│➜ virtualchest.[number] Set the max number of chests a player can
│➜ open (Ex: virtualchest.20 allows chests 1 to 20).
│➜ virtualchest.admin Master permission to inspect others, reload
│➜ the plugin, and bypass all limits.

Configuration (config.yml)
│➜ storage_type: Choose between SQLITE or MYSQL.
│➜ language: Switch between "en", "pt", "es", or "ru".
│➜ max_backups_to_keep: Control how many history files to store.

Important Notice
│➜ Legacy Support: Version 1.4 includes an automatic migration tool.
│➜ Just keep your old "data" folder, and it will be moved to SQL.
│➜ Backup Policy: Old backups are automatically deleted when the
│➜ limit is reached to save disk space. Check your config.yml.
│➜ Java 21: This plugin requires Java 21 to run on 1.21.1+.
│➜ Support: If you have issues, please contact us before leaving a
│➜ review. We are committed to high-performance stability.

Special Thanks ❤️
│➜ A huge thanks to the developer Wackenzie (Mackenzie). After a
│➜ review misunderstanding, Mackenzie reached out to guide me on
│➜ implementing professional security standards (InventoryHolder).
│➜ This update is a direct result of that learning experience,
│➜ ensuring your player data is now safer than ever.

Developed with ❤️ by Comonier