# ChestGuard ChestGuard is an advanced chest protection and management plugin for PaperMC servers. It provides chest ownership, permissions, secure item transfers, activity tracking, real-time alerts, and protection against unauthorized interaction and destruction. ## Core Features ### 🔐 Chest Protection - Lock and name single or double chests with `/chestlock ` - Unlock protected chests with `/chestunlock [name]` - Rename locked chests with `/chestrename ` - View detailed chest information with `/chestdetails [name]` - Display live chest information through an action bar while looking at a chest - Shows chest name, owner, coordinates, and lock status ### 💥 Unbreakable & Explosion Protection Locked chests are protected from unauthorized destruction in Creative, Survival, Adventure, and Spectator modes. Protection includes: - TNT explosions - Creeper explosions - Wither destruction - Ender Dragon destruction - Unauthorized hopper and minecart access - Unauthorized adjacent chest placement ## 👥 Permission & Trust System - `/chesttrustlist ` — View trusted users - `/chestpermission give ` — Grant access - `/chestpermission remove ` — Revoke access - `/chestlists` — List your owned chests - `/chestsearch ` — Find an owned chest - `/lastchestplaced` — Locate your last interacted chest Permissions are designed to allow controlled access to protected storage without giving away ownership. ## 📦 Activity Monitoring ChestGuard tracks inventory activity on protected chests. - `/chestitems [name]` — View chest contents - `/chestactivity` — View interaction history - Real-time notifications when trusted users access a chest - Tracks items removed or deposited - Shows player, item, quantity, chest name, and coordinates ## 🔄 Secure Item Transfer ChestGuard includes a controlled item transfer system for moving items between chests. ### Select Items `/itemtake [x y z] [all|item amount]` Select items from a source chest by looking at it or using coordinates. Examples: - `/itemtake all` - `/itemtake emerald all` - `/itemtake diamond 10` ### Transfer Items `/itemtransfer [x y z]` Transfers the selected items into a target chest. Items automatically merge with existing stacks and are inserted starting from slot 0. When another player's locked chest is involved, the chest owner receives a private approval request with a **30-second approval window**. ### Transfer Approval - `/transfer confirm` — Approve the transfer - `/transfer deny` — Reject the transfer ## 📋 Command Reference | Command | Description | Access | | --- | --- | --- | | `/chestlock ` | Lock and name a chest | Player | | `/chestunlock [name]` | Unlock a chest | Owner | | `/chestrename ` | Rename a locked chest | Owner | | `/chestdetails [name]` | View chest information | Owner / Trusted | | `/chesttrustlist ` | View trusted users | Owner | | `/chestpermission give/remove ` | Manage permissions | Owner | | `/chestlists` | List owned chests | Owner | | `/chestsearch ` | Find a chest by name | Owner | | `/lastchestplaced` | Locate last interacted chest | Player | | `/chestitems [name]` | View chest contents | Owner / Trusted | | `/chestactivity` | View activity history | Owner | | `/itemtake [x y z] [all\|item amount]` | Select items | Owner / Trusted | | `/itemtransfer [x y z]` | Transfer selected items | Owner / Trusted | | `/transfer confirm/deny` | Manage transfer requests | Chest Owner | | `/chestguardhelp [page]` | View in-game help | Player | ## ⚙️ Technical Highlights - UUID-based ownership - Persistent world-level JSON storage - Client-side block resynchronization - Explosion-resistant protected storage - Hopper and minecart protection - Real-time inventory tracking - Automatic item stack merging - Top-row inventory insertion - Tab completion filtering - Multiplayer-friendly permission management - Lightweight server-side processing ## ⚠️ Important ChestGuard is designed for **PaperMC multiplayer servers**. Extremely large-scale protected-storage setups may still increase server workload depending on the server environment.

TrickoMods