VirtualChest
Last Update: 1.3 [1.21+ compatible] [1.21.11 tested]



The definitive high-performance virtual storage solution for your server. Fully optimized for Folia regional multithreading and Paper 1.21.1+.

Main Features
│➜ Folia & Paper Native: Engineered with Regional and Async
│➜ Schedulers to ensure 100% stability and zero "Thread Access"
│➜ errors.
│➜ Smart Storage Engine: Optimized YAML mapping that skips empty
│➜ slots, reducing database file size by up to 80%.
│➜ Dynamic Permission Limits: Automatically calculates chest access
│➜ based on numeric permissions (e.g., virtualchest.10).
│➜ 100% External Translations: Dedicated messages_en.yml and
│➜ messages_pt.yml files, including translatable console logs.
│➜ Staff Admin System: Professional GUI for administrators to inspect,
│➜ edit, or manage any player's virtual chest in real-time.
│➜ Realistic Sound Effects: High-quality chest opening and closing
│➜ sounds to improve player immersion on every interaction.
│➜ Command Aliases: Flexible system supporting /pv, /vc, and
│➜ /virtualchest for faster access and better UX.
│➜ Cross-Platform Ready: Optimized for Java and Bedrock (Geyser)
│➜ players with smooth GUI navigation and persistence.

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, limits, and all language
│➜ files (Alias: /vc reload).

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

Configuration (config.yml)
│➜ max_chests_per_player: Define the global default limit.
│➜ language: Switch between "en" or "pt" to load external files.
│➜ Custom Messages: Full control over every string via YAML.

Important Notice
│➜ Fresh Install Required: Owners MUST delete the old config.yml or
│➜ the entire plugin folder to generate the new configuration and
│➜ language files correctly.
│➜ Permission Change: The permission format has changed from
│➜ virtualchest.pv.X to virtualchest.X
│➜ Example: Granting virtualchest.10 now dynamically allows access
│➜ to chests 1 through 10.
│➜ Please update your permission plugin (LuckPerms/FoliaPerms)
│➜ accordingly.
│➜ Migration: Version 1.3 uses a new data structure. Ensure players
│➜ have backed up or removed their items from old chests before
│➜ clearing the data folder.
│➜ Java 21: This plugin requires Java 21 to run on 1.21.1+.
│➜ Performance: Optimized for high-population servers to prevent TPS
│➜ spikes during massive save operations.

Developed with ❤️ by Comonier