📦 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)

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!