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 <name>
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 <old name> <new name>
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 <chestname>
Displays all players with granted access to the specified chest.
✔ Grant & Revoke Permissions
/chestpermission give <player> <chestname>
/chestpermission remove <player> <chestname>
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 <name>
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 <name> |
Lock and name a chest by looking at it | Player |
/chestunlock |
/chestunlock [name] |
Remove chest protection (look or by name) | Owner |
/chestrename |
/chestrename <old name> <new name> |
Rename a locked chest | Owner |
/chestdetails |
/chestdetails [name] |
Show chest metadata and coordinates | Owner / Trusted |
/chesttrustlist |
/chesttrustlist <chestname> |
View list of trusted players | Owner |
/chestpermission |
/chestpermission give|remove <player> <chest> |
Grant or revoke player access | Owner |
/chestlists |
/chestlists |
List all owned chests | Owner |
/chestsearch |
/chestsearch <name> |
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/
