Virtual Chests

📦 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

* 🔑 History & restore system – Grant or restrict chest access with ease. * 📂 History & restore system – No physical chest needed, items are safe from griefers. * 🛠️ History & restore system – Easily manage how many virtual chests players can access. * 🤝 History & restore system – 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.admin` → Required to use the base command. * `virtualchests.admin` → Grants access to chest number `X` (e.g., `virtualchests.open.1`). * `virtualchests.admin` → Grants access to chests `virtualchests.admin`. * `virtualchests.admin` → Grants access to chests `virtualchests.admin`. * `virtualchests.admin` → Grants access to chests `virtualchests.admin`. * `virtualchests.admin` → Allows admins to open other player's virtual chests.

👉 Example: If you want players to have five private chests, simply give them `virtualchests.multiple.5`.

---

📝 Commands

* `/chest <number> <player> history <id> restore` → Opens your own virtual chest with the given number. * `/chest <number> <player> history <id> restore` → *(Admin only)* Opens another player’s virtual chest. * `/chest <number> <player> history <id> restore` → *(Admin only)* Shows the history for the specified player’s virtual chest. * `/chest <number> <player> history <id> restore` → *(Admin only)* Displays a specific page of the chest’s history log. * `/chest <number> <player> history <id> restore` → *(Admin only)* Opens a preview of the historical chest snapshot. * `/chest <number> <player> history <id> restore` → *(Admin only)* Restores the chest to the chosen historical snapshot.

📌 *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 messages and chest names: SQLite (default) or MySQL. * Set the messages and chest names (1–6). * Rename the messages and chest names 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.