ChestProtection lets players protect their goods through a in-game GUI.
No complicated commands are required for normal players: sneak, hold the configured protection tool, right click a chest, and manage everything from the menu.

Features

• Protect chests, trapped chests, barrels, shulker boxes, colored shulker boxes, and copper chest variants
• Double chests are handled as one logical protection
• GUI-based protection management
• Add and remove trusted friends using player heads
• Nearby-player selector with configurable range
• Public view-only access: players can view contents without moving items
• Admin bypass command for staff members
• Optional custom protection tool with custom name, lore, model data, and crafting recipe
• Optional protection creation cost
• Optional explosion-protection upgrade cost
• Blocks unauthorized opening, breaking, hoppers, pistons, explosions, and dispenser/dropper insertion
• SQLite database created automatically
• Configurable language files
• Debug logging option for troubleshooting

Preview


How It Works

Players can protect a container by sneaking while holding the configured protection tool and right clicking the container.

By default, the protection tool is a stick, but server owners can change it in the config or enable a custom plugin-created item.

Once a container is protected, the owner can:

• Add friends
• Remove friends
• Enable public view-only access
• Buy explosion protection if enabled
• Remove the protection

Supported Containers

• Chest
• Trapped Chest
• Barrel
• Shulker Boxes
• Colored Shulker Boxes
• Copper Chest variants

Commands & Permissions
Configuration
ChestProtection includes options for:

• Changing the protection tool material
• Enabling a custom protection item
• Creating a custom crafting recipe
• Charging players to create protections
• Charging players for explosion-protection upgrades
• Changing the nearby-player range
• Enabling/disabling public view-only access
• Changing all player-facing messages through language files

Compatibility

• Built with Java 17
• Built against Spigot API 1.20.4
• Tested on Paper 1.20.4+

Installation

1. Download the jar
2. Place it inside your server's plugins folder
3. Restart the server
4. Edit plugins/ChestProtection/config.yml if needed
5. Use /cp reload after changing config or language files

Support
If you find a bug or have a feature request, please use the discussion section and include:

• Server version
• Plugin version
• Steps to reproduce the issue
• Any console errors, if present