PrivateQuestChest

# 📦 PrivateQuestChests ### A powerful per-player chest system designed for quest-based gameplay. PrivateQuestChests allows you to turn any placed chest into a **shared-location, per-player private inventory**, perfect for quest systems, item collection objectives, or progression-based gameplay. --- ## ✨ Features - 🔒 **Per-player chest inventories** - Every player gets their own inventory for the same chest - No shared storage between players - 📍 **Location-based chests** - The chest remains physically in the world - No custom blocks or IDs required - 🧩 **Perfect for quest systems** - Track what players deposit or withdraw - Ideal for “collect and deliver” objectives - 🧪 **Template system** - Pre-fill a chest with items before registering - These items become the **default inventory for every player** - 🔄 **Live interaction tracking** - Detect when players: - Put items in - Take items out - 💾 **Persistent storage** - Data is saved and survives restarts - ⚡ **Compatible with Paper 1.21 – 1.21.11** --- ## 🧠 How It Works 1. **Place a chest** anywhere in the world 2. *(Optional)* Put items inside the chest → These will become the **default contents for all players** 3. Run the command: /privatechest select 4. Right-click the chest 5. Done! 🎉 The chest is now a **Private Quest Chest** --- ## 🔄 Player Behavior - Each player sees **their own version** of the chest - Items are **not shared between players** ### Example: - Player A removes an item → only removed for Player A - Player B opens the chest → still sees the item - Player A adds items → only visible to Player A --- ## 📦 Template Behavior If the chest contains items when it is registered: - Those items are saved as a **default inventory** - Every player starts with the same contents - After that, inventories are **fully independent** --- ## 🔐 Permissions | Permission | Description | Default | |----------|------------|--------| | `privatequestchest.admin` | Allows selecting and registering chests | OP | | `privatequestchest.use` | Allows opening private quest chests | true | --- ## ⚙️ Configuration (`config.yml`) ```yaml physical-chest: clear-after-registration: true ## Options: - **physical-chest.clear-after-registration** - true → Clears the real chest after registering (recommended) - false → Leaves items in the physical chest --- ## 🛠️ Installation - Place the `.jar` file in your server’s `plugins/` folder - Start or restart your server --- ## 📌 Requirements - Paper 1.21 – 1.21.11 --- ## 🚀 Use Cases - Quest systems - RPG servers - Delivery missions - Collection objectives - Player progression systems --- ## 💬 Support - Need help or want additional features? Feel free to reach out!