# 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

- Place a chest anywhere in the world

- *(Optional)* Put items inside the chest
→ These will become the **default contents for all players**

- Run the command: /privatechest select


- Right-click the chest

- 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

- **privatequestchest.admin**
- Allows selecting and registering chests
- Default: OP

- **privatequestchest.use**
- Allows opening private quest chests
- Default: true

---

## ⚙️ Configuration (`config.yml`)
physical-chest:
clear-after-registration: true

- **physical-chest.clear-after-registration**
- true → Clears the real chest after registering (recommended)
- false → Leaves items in the physical chest

---

## Developer Hooks

- **PrivateChestDepositEvent**
- Called when a player puts items into the chest

- **PrivateChestWithdrawEvent**
- Called when a player takes items out

---

## ️ 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!