## 📦 Virtual Chests **Virtual Chests** is a lightweight and powerful Paper plugin that gives server admins full control over who can access private, virtual chests. Instead of cluttering the world with physical chests, players can securely store their items in **virtual chests** that only they can access. Admins control access through permissions, making this system both flexible and safe. ### ✨ Features * 🔑 **Permission-based access** – Grant or restrict chest access with ease. * 📂 **Private virtual storage** – No physical chest needed, items are safe from griefers. * 🛠️ **Configurable** – Easily manage how many virtual chests players can access. * 🤝 **Seamless integration** – Works with existing permission plugins (LuckPerms, PermissionsEx, etc.). * 📜 **History & restore system** – View past chest states, preview snapshots, and restore older versions instantly. ### 🎮 Use Cases * Reward donators with extra storage. * Unlock additional chests as achievement rewards. * Protect inventories without relying on claim plugins. ## ⚙️ Usage ### 🔒 Permissions Control access to virtual chests using simple permissions: * **`virtualchests.use`** → Required to use the base command. * **`virtualchests.open.X`** → Grants access to chest number `X` (e.g., `virtualchests.open.1`). * **`virtualchests.multiple.3`** → Grants access to chests **1–3**. * **`virtualchests.multiple.5`** → Grants access to chests **1–5**. * **`virtualchests.multiple.10`** → Grants access to chests **1–10**. * **`virtualchests.admin`** → Allows admins to open other player's virtual chests. * **`virtualchests.update`** → Get update notification on join 👉 Example: If you want players to have **five private chests**, simply give them `virtualchests.multiple.5`. --- ### 📝 Commands * **`/chest`** → Lists all commands * **`/chest `** → Opens your own virtual chest with the given number. * **`/chest `** → *(Admin only)* Opens another player’s virtual chest. * **`/chest history`** → *(Admin only)* Shows the history for the specified player’s virtual chest. * **`/chest history -page `** → *(Admin only)* Displays a specific page of the chest’s history log. * **`/chest history view`** → *(Admin only)* Opens a preview of the historical chest snapshot. * **`/chest history restore`** → *(Admin only)* Restores the chest to the chosen historical snapshot. * **`/chest transfer `** → *(Admin only)* Transfer all Chests. * **`/chest transfer `** → *(Admin only)* Transfer single Chest. * **`/chest transfer `** → *(Admin only)* Transfer single Chest with different destination. 📌 *Note:* The base command `/chest` can be renamed in the `config.yml`. --- ### ⚙️ Configurable Options **Virtual Chests** comes with a flexible `config.yml` so you can adapt the plugin to your server: * Choose your **storage type**: SQLite (default) or MySQL. * Set the **number of rows per chest** (1–6). * Rename the **base command** to match your server style. * Customize **messages and chest names** to fit your language or formatting preferences. * Fully customize all history-related messages, pagination buttons, and date formatting. * Control how much history is stored using: * `keep_last`: Number of history entries to keep per chest (`-1` to keep all). * `history_page_size`: Number of entries shown per page in the history command. 📌 *Tip:* The configuration is easy to edit and helps you tailor the plugin for your community.

IdealMatrix