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

- 🧪 default inventory for every player - 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 not shared between players 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 fully independent - 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!