ChestLock

ChestLock is a lightweight Paper/Spigot plugin that lets players protect their chests using two custom items: a Lock and a Key. No commands needed to lock a chest — just place the item in your hand and right-click.

✨ Features

• Lock chests, trapped chests, barrels, and shulker boxes
• Bindable keys — create multiple keys tied to a specific chest and share access without giving up ownership
• Full protection against breaking, explosions, and piston pushing/pulling
• Master Key for staff/admins to override any lock
• In-game GUI to manage a locked chest (generate keys, view info, unlock)
• Optional crafting recipes for Lock and Key (toggleable in config)
• Fully configurable messages (colors supported)

🔧 How it works

1. A player (or an admin via command) obtains a Lock.
2. Right-click a chest → the chest gets locked and bound to the player (owner). The Lock item is consumed.
3. Only the owner (and admins with chestlock.bypass) can freely open the chest.
4. Other players see a "chest locked" message and cannot open it, break it, or move it with pistons or explosions.
5. The owner can create Key copies bound to that chest: shift + right-click the locked chest while holding an unbound Key → the key becomes bound. Anyone holding that key can open the chest even without being the owner.
6. The owner can unlock the chest: shift + right-click with an empty hand on the locked chest → the chest unlocks and the Lock item returns to their inventory.

📜 Commands

Command	Description	Required permission
/chestlock give lock <player> [amount]	Gives the Lock item	chestlock.admin
/chestlock give key <player> [amount]	Gives an unbound Key	chestlock.admin
/chestlock manage	Opens the management GUI for the chest you're looking at	none (any player)
/chestlock info	Shows info about the chest you're looking at	none (any player)
/chestlock masterkey [player]	Gives the Master Key	chestlock.admin
/chestlock reload	Reloads config.yml	chestlock.admin
/chestlock help	Shows the help menu	none (any player)

🔑 Permissions

Permission	Default	Description
chestlock.use	true	Allows using lock/key items
chestlock.bypass	op	Opens/breaks any locked chest
chestlock.admin	op	Administrative commands

⚙️ Requirements

• Paper or Spigot server, Minecraft 1.20.x
• Java 17+