# ChestGuard – Advanced Chest Protection & Secure Transfer System ChestGuard is a high-level chest protection and management plugin built for PaperMC multiplayer servers. It provides structured ownership, granular permission control, secure item transfers, real-time interaction alerts, explosion-proof storage, and full chest tracking. This is infrastructure-level protection — not a basic lock command. --- # 🔐 Core Protection Features ## ✔ Lock & Name Chests `/chestlock ` Locks the targeted chest (single or double chest) and assigns a custom name. ## ✔ Unlock Chests `/chestunlock [name]` Removes protection and ownership from the targeted chest (by looking at it or by chest name). ## ✔ Rename Locked Chests `/chestrename ` Renames a locked chest directly without needing to unlock it. ## ✔ Detailed Chest Information `/chestdetails [name]` Displays: * Lock status (Locked / Unlocked) * Exact coordinates (and double-chest pair coordinates) * Owner name and status ## ✔ Live Chest Info (Look-Based Action Bar Display) When looking at any chest, players automatically see an action bar overlay showing: * Custom chest name * Owner name (if locked) * Coordinates * Lock status (`[LOCKED]` / `[Unlocked]`) No command required. ---

# 💥 Unbreakable & Explosion-Proof Protection Locked chests are 100% unbreakable by non-owners across all 4 game modes (**Creative, Survival, Adventure, and Spectator**) with client-side block resynchronization. Locked chests are immune to: * TNT explosions * Creeper explosions * Wither & Ender Dragon destruction * Unauthorized Hopper & Minecart item extraction/insertion * Unauthorized adjacent chest placement attacks Protected storage remains intact in hostile environments. --- # 👥 Permission & Trust System ## ✔ View Trusted Users `/chesttrustlist ` Displays all players with granted access to the specified chest. ## ✔ Grant & Revoke Permissions `/chestpermission give ` `/chestpermission remove ` Assigns or revokes access permissions for selected players on your locked chests. ## ✔ List Owned Chests `/chestlists` (or `/chestsearch`) Shows all chests owned by the executing player. ## ✔ Search Chests `/chestsearch ` Returns coordinates of a specified owned chest by name. ## ✔ Locate Last Interacted Chest `/lastchestplaced` Displays the exact coordinates of the last chest you interacted with. --- # 📦 Activity Monitoring & Real-Time Alerts ## ✔ View Chest Contents `/chestitems [name]` Displays chest inventory contents (permission-based access). ## ✔ Activity Log `/chestactivity` Shows complete interaction history for your locked chests. ## ✔ Real-Time Item Alerts When a locked chest is accessed by a trusted player, the owner is notified instantly via formatted chat alerts. If a player **removes items**, the owner receives: * Player name * Items removed * Quantity * Chest name & coordinates If a player **adds items**, the owner receives: * Player name * Items deposited * Quantity * Chest name & coordinates Every inventory change is tracked and logged for full accountability. --- # 🔁 Secure Item Transfer System ## ✔ Select Items `/itemtake [x y z] [all|item amount]` Marks items for secure transfer from a source chest (by looking at the chest or specifying coordinates `x y z`). * *Example*: `/itemtake all` * *Example*: `/itemtake emerald all` * *Example*: `/itemtake diamond 10` ## ✔ Transfer Items `/itemtransfer [x y z]` Transfers selected items into the target chest (by looking at the target chest or specifying coordinates `x y z`). Transferred items automatically merge into existing matching stacks and fill starting from slot 0 (top row). If transferring to or from another player’s locked chest: * A 30-second approval window is initiated. * A private message is sent strictly to the chest owner. ## ✔ Approve or Reject Transfer `/transfer confirm` `/transfer deny` Approves or cancels pending transfer and selection requests. --- # 📜 Command Reference Table | Command | Syntax | Description | Access Scope | | :--- | :--- | :--- | :--- | | `/chestlock` | `/chestlock ` | Lock and name a chest by looking at it | Player | | `/chestunlock` | `/chestunlock [name]` | Remove chest protection (look or by name) | Owner | | `/chestrename` | `/chestrename ` | Rename a locked chest | Owner | | `/chestdetails` | `/chestdetails [name]` | Show chest metadata and coordinates | Owner / Trusted | | `/chesttrustlist` | `/chesttrustlist ` | View list of trusted players | Owner | | `/chestpermission` | `/chestpermission give\|remove ` | Grant or revoke player access | Owner | | `/chestlists` | `/chestlists` | List all owned chests | Owner | | `/chestsearch` | `/chestsearch ` | Locate owned chest by name | Owner | | `/lastchestplaced` | `/lastchestplaced` | Locate last interacted chest | Player | | `/chestitems` | `/chestitems [name]` | View chest inventory contents | Owner / Trusted | | `/chestactivity` | `/chestactivity` | View interaction history log | Owner | | `/itemtake` | `/itemtake [x y z] [all\|item amount]` | Select items for transfer (look or x y z) | Owner / Trusted | | `/itemtransfer` | `/itemtransfer [x y z]` | Initiate secure transfer to chest (look or x y z) | Owner / Trusted | | `/transfer` | `/transfer confirm\|deny` | Approve or deny transfer requests | Chest Owner | | `/chestguardhelp` | `/chestguardhelp [page]` | View in-game help guide | Player | --- # 🧠 Technical Highlights * UUID-based ownership (not username-dependent) * Persistent world-level JSON storage system * 4-Game-Mode unbreakable locked chests with client resync * Explosion-resistant & hopper-blocked locked chests * Real-time inventory change alerts * Top-row inventory insertion & automatic stack merging * Tab-completion filtering (no fallback `chestguard:` namespace clutter) # 📞 Support Visit Our Website: https://trickomods.com/

TrickoMods