ChestGuard Documentation

ChestGuard is an advanced chest protection and management system designed for multiplayer servers. It provides chest ownership, access permissions, activity monitoring, secure item transfers, and strong protection against unauthorized interactions and destruction.

ChestGuard allows players to protect individual chests by assigning them a custom name and ownership. Once locked, the chest can only be accessed or managed according to its owner's permissions.

▸Locking a Chest:

Look at the chest you want to protect and use:

This locks the chest and assigns the specified name to it. Both single and double chests are supported.

Unlocking a Chest

Removes protection and ownership from a chest. You can unlock a chest either by looking at it or by specifying its name.

Renaming a Chest

Renames an existing locked chest without requiring you to unlock it first.

Chest Details

Displays information about a protected chest, including: Lock status, Chest name, Owner, Owner status, Coordinates, and Double-chest pair coordinates.

Live Chest Information

When looking at a chest, ChestGuard can display information directly through the action bar. No command is required to view this information. The information includes:

• Chest name
• Owner
• Coordinates
• Lock status

Locked chests receive protection against unauthorized interactions and destruction. Protection is designed to keep player storage secure even in hostile environments.

Protected chests are resistant to:

• TNT explosions
• Creeper explosions
• Wither destruction
• Ender Dragon destruction
• Unauthorized hopper extraction
• Unauthorized hopper insertion
• Unauthorized minecart item extraction
• Unauthorized minecart item insertion
• Unauthorized adjacent chest placement attacks

ChestGuard allows owners to share access to individual chests without giving other players complete control over their storage.

View Trusted Players

Displays all players who have access to the specified chest.

Grant Access

Grants the specified player access to a protected chest.

Remove Access

Removes a player's access to the chest.

List Owned Chests

Displays all chests owned by you. /chestsearch can also be used as an alternative.

Search for a Chest

Searches for an owned chest by its custom name and displays its location.

Last Interacted Chest

Displays the coordinates of the last chest you interacted with.

View Chest Contents

Displays the contents of a protected chest. Access is permission-based, so only authorized users can view protected storage.

ChestGuard tracks interactions with protected chests.

Activity Log

Displays the interaction history associated with your protected chests. Tracked activity includes inventory changes and player interactions.

Real-Time Item Alerts

ChestGuard can notify chest owners when trusted players modify protected storage.

• When Items Are Removed: The owner receives player name, item removed, quantity, chest name, and coordinates.
• When Items Are Added: The owner receives player name, item deposited, quantity, chest name, and coordinates.

ChestGuard provides a secure system for transferring items between chests.

Selecting Items

Selects items from a source chest. You can either look at the chest or specify its coordinates.

• /itemtake all — Selects all transferable items.
• /itemtake emerald all — Selects all emeralds.
• /itemtake diamond 10 — Selects 10 diamonds.

Transferring Items

Transfers the selected items into a target chest. ChestGuard automatically:

• Merges items with existing matching stacks
• Inserts items starting from slot 0
• Handles the selected quantities automatically

Transfer Approval System

When a transfer involves another player's locked chest, ChestGuard requires owner approval. A 30-second approval window is created and a private request is sent to the chest owner:

• Approve: /transfer confirm
• Reject: /transfer deny

Complete quick reference for all ChestGuard commands and required access levels:

▸Technical Details:

• UUID-based ownership ensures that protection is tied to the player's unique account identity rather than their username.
• Persistent world-level JSON storage.
• Client-side block resynchronization for protected blocks.
• Real-time inventory tracking and cached chest data.
• Automatic stack merging and secure transfer approval.

▸Troubleshooting:

• A chest cannot be accessed: Check whether the chest is locked, whether you are the owner, or whether permission was revoked.
• A transfer is not completing: Ensure the source and target chests are accessible, the items exist, target has space, and the owner approved.
• A protected chest appears incorrectly: If a chest appears out of sync after an explosion attempt, allow the protection system to resynchronize block state.