PrivateChestFree

# 🔐 PrivateChest - Complete Container Protection System

PrivateChest is a lightweight yet powerful container protection plugin that lets players secure their chests, barrels, and shulker boxes with personal passwords. No complicated land-claim systems needed — just simple, secure, and optimized protection for survival servers, SMPs, and factions!

## ✨ Core Features

### 🔒 Password Protection System - Lock chests, trapped chests, barrels, and all 17 shulker box variants - Secure SHA-256 password encryption with salt - Only the owner can access protected containers - Automatic double chest detection and protection

### 🛡️ Advanced Security - Explosion Protection: TNT, Creepers, and other explosions cannot destroy locked containers - Hopper Protection: Blocks hoppers, droppers, and dispensers from bypassing security - Block Placement Protection: Prevents players from placing automated extraction blocks near protected containers - Configurable Hopper Access: Optional setting for servers that want automated sorting systems

### 🤝 Trust System - Share container access with other players without revealing your password - `/trust ` - Grant access to specific players - `/trust list` - View all trusted players - `/untrust ` - Remove access from a player - `/untrust all` - Remove all trusted players at once - Trusted players receive notifications when accessing shared containers

### 🏷️ Container Renaming - Give your locked containers custom names (up to 16 characters) - `/renamecontainer ` - Set a custom name - `/renamecontainer remove` - Remove custom name - Smart validation for name compatibility

### 📊 Flexible Limit System - Basic Limits: Set a global limit for all container types - Granular Limits: Configure different limits per container type (chests, barrels, shulker boxes) - Permission-Based: Fine-tune limits with permissions like `privatechest.limit.chest. 10` - Unlimited option available for VIP players

### 🪧 Sign Protection (Alternative Method) - Lock containers by placing a sign with `` on the first line - No password required — ownership-based protection - Works alongside password protection

## 🌐 Cross-Platform Compatibility

### Minecraft Versions Supported: 1. 16. 5 → 1. 21.x (and future updates)

### Server Software

Standard (Single-threaded): - CraftBukkit, Spigot, Paper - Purpur, Pufferfish - Any Spigot/Paper fork

Regionized (Multi-threaded): - Folia, Luminol, LightingLuminol - LeafMC, Kaiiju - Any Folia-based fork

### Bedrock Edition Support - Full compatibility via Geyser and Floodgate - Automatic detection of Bedrock players - Messages adapted for optimal display on each platform - Java and Bedrock players can seamlessly interact with the same protected containers

## 💬 Commands

| Command | Description | Permission | |:--------|:------------|:-----------| | `/lockchest ` | Lock the container you're looking at | `privatechest.use` | | `/unlockchest ` | Unlock your locked container | `privatechest.use` | | `/trust ` | Give a player access to your containers | `privatechest.use` | | `/trust list` | View your trusted players | `privatechest.use` | | `/untrust ` | Remove a player's access | `privatechest.use` | | `/untrust all` | Remove all trusted players | `privatechest.use` | | `/renamecontainer ` | Set a custom name for a container | `privatechest.use` | | `/renamecontainer remove` | Remove custom name | `privatechest.use` | | `/privatechest reload` | Reload configuration and messages | `privatechest.admin` | | `/clearchests` | Clean orphaned container data | `privatechest.admin` |

Aliases: `/privatechest` → `/pc`, `/renamecontainer` → `/renamechest`

## 🔐 Permissions

### Basic Permissions | Permission | Description | Default | |:-----------|:------------|:--------| | `privatechest.use` | Use all player commands | `true` | | `privatechest.admin` | Admin commands + bypass protection | `op` |

### Limit Permissions (Examples) | Permission | Description | |:-----------|:------------| | `privatechest.limit.unlimited` | Unlimited container locks | | `privatechest.limit. 50` | Lock up to 50 containers | | `privatechest.limit.chest. 25` | Lock up to 25 chests specifically | | `privatechest.limit.barrel. 10` | Lock up to 10 barrels specifically | | `privatechest.limit.shulker_box. 5` | Lock up to 5 shulker boxes specifically |

## ⚙️ Configuration Highlights

### Storage Options - YAML: Simple file-based storage (default) - SQLite: Database storage for large servers with many locked containers

### Key Settings ```yaml # Storage system storage-type: yaml # or 'sqlite'

# Message prefix use-prefix: true prefix: "&7[&6PrivateChest&7] "

# Sign protection enable-sign-protection: true

# Container limits enable-chest-limits: false default-chest-limit: 5

# Granular limits per container type container-limits: enabled: false types: