ChestProtect

## 🔒 Core Protection Features

### Automatic Container Protection - Instant Protection: All containers are automatically protected when placed by players - Extensive Container Support: Protects 30+ container types including: - Storage: Chests, Trapped Chests, Barrels, Ender Chests - All Shulker Boxes: All 17 colors (configurable) - Processing: Furnaces, Blast Furnaces, Smokers, Brewing Stands - Redstone: Dispensers, Droppers, Hoppers - Utility: Beacons, Anvils, Enchanting Tables, Lecterns, Jukeboxes, and more - Double Chest Support: Automatically protects both halves of double chests - SQLite Database: Persistent protection storage with efficient indexing

### Access Control System - Owner-Only Access: Only the player who placed the container can access it by default - Admin Bypass: Configurable admin override with permission `chestprotect.admin.bypass` - Break Protection: Prevents unauthorized players from breaking protected containers

## 👥 Friend System

### Global Friend Lists - Add Friends: `/chestprotect friend add ` - Add players to your friend list - Remove Friends: `/chestprotect friend remove ` - Remove players from your list - View Friends: `/chestprotect friend list` - See all your friends - Clear List: `/chestprotect friend clear` - Remove all friends at once

### Friend Access Benefits - Global Access: Friends can access ALL your protected containers - Offline Player Support: Add friends even when they're not online - Cached Performance: Friend lists are cached for fast access checking - Database Persistence: Friend relationships survive server restarts

## 🎨 Visual Indicators

### Particle Effects System - Real-time Visual Feedback: See protection status with particle effects - Color-Coded Indicators: - 🟢 Green Particles (Happy Villager) - Containers you own - 🔵 Blue Particles (Enchant) - Containers your friends shared with you - 🔴 Red Particles (Angry Villager) - Protected containers you can't access - Smart Display: Only shows particles within 10 blocks of players - Performance Optimized: Updates every 2 seconds to minimize lag - Configurable: Enable/disable visual indicators in config

## 🔄 Ownership Transfer

### Container Transfer System - Easy Transfer: `/chestprotect transfer ` - Transfer ownership to another player - Look-at-Target: Simply look at the container you want to transfer (no coordinates needed) - Instant Transfer: Ownership changes immediately with database update - Notifications: Both players receive confirmation messages - Validation: Ensures you own the container and target player exists

## 🧹 Automatic Cleanup

### Inactive Player Management - Last Access Tracking: Records when containers were last opened - Automatic Expiry: Removes protections from containers unused for 30+ days (configurable) - Background Cleanup: Runs automatically every 24 hours - Manual Cleanup: Admins can trigger cleanup with `/chestprotect cleanup` - World Cleanup: Removes containers from deleted worlds

## ⚙️ Advanced Configuration

### Hopper Control - Configurable Hopper Access: Choose whether hoppers can extract/insert items from protected containers - Complete Block Prevention: When disabled, hoppers cannot interact with protected containers at all - All Container Types: Works with chests, furnaces, dispensers, and all other containers

### Customizable Messages - Color Code Support: Full `&` color code support in all messages - Dynamic Placeholders: `{container}` placeholder shows the actual container type - Multilingual Ready: All messages configurable in config.yml - Admin Notifications: Separate messages for admin bypass actions

### Protection Settings - Admin Bypass Toggle: Enable/disable admin override permissions - Double Chest Protection: Auto-protect both halves of double chests - Shulker Box Toggle: Enable/disable shulker box protection - Placement Notifications: Configure whether players see protection messages

## 📊 Information & Statistics

### Player Information - Protection Stats: `/chestprotect info` shows: - Number of containers you have protected - Number of friends in your list - Auto-cleanup expiry setting - Database Queries: Real-time statistics from the database

## 🛡️ Security Features

### Database Security - SQLite Backend: Lightweight, reliable database storage - Prepared Statements