🔐 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 <player> - Grant access to specific players
• /trust list - View all trusted players
• /untrust <player> - 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 <name> - 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 [Private] 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 <password> | Lock the container you're looking at | privatechest.use |
| /unlockchest <password> | Unlock your locked container | privatechest.use |
| /trust <player> | Give a player access to your containers | privatechest.use |
| /trust list | View your trusted players | privatechest.use |
| /untrust <player> | Remove a player's access | privatechest.use |
| /untrust all | Remove all trusted players | privatechest.use |
| /renamecontainer <name> | 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

# 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:
    chest: 10
    barrel: 5
    shulker_box: 2

# Notifications
notify-owner-on-open: true
notify-admin-on-open: true
notify-trusted-on-open: true

# Auto-cleanup of orphaned data
auto-cleanup:
  periodic-enabled: true

# Hopper protection (configurable for sorting systems)
hopper-protection:
  allow-hopper-access: false  # true for automated systems

🧩 Developer API

PrivateChest offers a simple API for developers to integrate with protected containers:

import me.tuplugin.privatechest.api.PrivateChestAPI;

// Check if a block is locked
boolean isLocked = PrivateChestAPI.isLocked(block);

// Check if a player owns a block
boolean isOwner = PrivateChestAPI.isOwner(block, player);

// Lock a container programmatically
PrivateChestAPI.lockBlock(block, player, "password");

// Unlock a container
PrivateChestAPI.unlockBlock(block);

// Get the owner UUID
UUID owner = PrivateChestAPI.getOwner(block);

🛠️ Installation

1. Download the JAR and place it in your /plugins folder
2. Start or reload your server
3. Edit config.yml and messages.yml to customize
4. Done! All players can start protecting their containers

🌍 Multilingual Support

PrivateChest is fully translatable! Edit messages.yml and config.yml to translate all messages to any language. The default language is English, but you can easily adapt it to fit your server's style and community.

📊 Plugin Statistics

Monitor anonymous usage statistics:
🔗 bStats - PrivateChest

🔥 Why Choose PrivateChest?

• Lightweight & Optimized: Minimal server impact with efficient code
• No Dependencies: Works standalone, no other plugins required
• Future-Proof: Regular updates for new Minecraft versions
• Active Development: Bug fixes and new features based on community feedback
• Easy Migration: Switch between YAML and SQLite storage anytime
• Automatic Cleanup: Orphaned data is cleaned automatically to maintain performance

📸 Screenshots

• https://imgur.com/j772ZCI
• https://imgur.com/iIHmZKu
• https://imgur.com/6CCrL16
• https://imgur.com/LZVsg5x

🎉 Thank you for using PrivateChest!

If you enjoy the plugin, please leave a ⭐ rating and share your feedback!

✨ Looking for more power and features?

PrivateChest Plus is now available!

Unlock premium features including:

• ✅ Shared chest access with advanced permissions
• ✅ Timed auto-unlock
• ✅ GUI-based lock system
• ✅ Sounds and holograms
• ✅ And much more...

Level up your server protection with PrivateChest Plus!