HomeJavaModsPrivateQuestChests
PrivateQuestChests
# 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!

Commands

Plugin details

Read from the plugin's own plugin.yml.

Quick facts

Install steps are the general flow for this file type — How to install Minecraft Java mods & modpacks walks through it step by step.

PrivateQuestChests is a free Minecraft Java mod. Compatible with Minecraft 1.21. Downloaded 9 times (via Spigot). Download it and open it directly in the game.

Explore more