# LockedChests Plugin<\/p>\n
A lightweight chest locking plugin for Paper 1.21 built by theTWIXhunter<\/p>\n
## Features<\/p>\n
– **Key-Based Locking**: Lock chests with customizable keys that can be crafted, given, and duplicated
\n– **Password Protection**: Set passwords on locked chests for additional security
\n– **Blank Keys**: Craft blank keys to lock chests, then create specific keys for each locked chest
\n– **Key Duplication**: Duplicate existing keys with blank keys to share access
\n– **World-Specific**: Configure whitelist or blacklist mode for specific worlds
\n– **Flexible Access Control**: Multiple authentication methods (owner, key in hand, key in inventory, password)
\n– **Customizable Keys**: Fully customize key appearance, name, and lore
\n– **Admin Tools**: Give keys to players with `\/givekey` command<\/p>\n
## Commands<\/p>\n
– `\/lockedchests` (aliases: `\/lc`, `\/chest`) – Main plugin command with reload functionality ## Permissions<\/p>\n – `lockedchests.use` – Allows using locked chests (default: true) ## Configuration<\/p>\n Edit `config.yml` to customize the plugin:<\/p>\n **World Filtering** **Key Customization** **Crafting** **Accesscontrol** ### Locking Behavior ### Key Duplication ## Building<\/p>\n Run `mvn clean package` to build the plugin. The compiled JAR will be in the `target` folder.<\/p>\n ## Installation<\/p>\n 1. Build the plugin or download the JAR ## How It Works: 1. **Locking a Chest with a new key**: 2. **Opening a Locked Chest**: 3. **Sharing Access**: ## Author<\/p>\n me.thetwixhunter<\/p>\n","protected":false},"excerpt":{"rendered":" Allow players to craft keys and lock their chests to make sure nobody can steal\/break them. Fully configurable as always.<\/p>\n","protected":false},"featured_media":95058,"template":"","meta":{"_minecraft_slug":"locked-chests","_minecraft_project_id":"NsvSILkY","_minecraft_author":"theTWIXhunter","_minecraft_license":"GPL-3.0-or-later","_minecraft_downloads":102,"_minecraft_follows":2,"_minecraft_client_side":"unsupported","_minecraft_server_side":"required","_minecraft_storage_type":"zip","_minecraft_archive_name":"locked-chests.zip","_minecraft_size_bytes":61902,"_minecraft_version_count":2,"_minecraft_updated_at":"2026-05-15T19:39:47.992144Z","_minecraft_date_created":"2026-02-21T00:02:07.805598Z","_minecraft_date_modified":"2026-03-08T16:05:10.824550Z","_minecraft_project_url":"https:\/\/modrinth.com\/mod\/locked-chests","_minecraft_icon_attachment_id":95058,"_minecraft_imported_at":"2026-06-05T10:38:14+00:00","_minecraft_import_hash":"927eb88931d2e02f7802dc8a3b3c2bf1","_minecraft_versions":"","_minecraft_links":"","_minecraft_gallery":"","_minecraft_api_metadata":""},"mod_category":[124,89,126,127,128,867,129],"mod_loader":[130,132,133,134],"minecraft_version":[62,37,40,41,73,74,38,78,79,80,81,82],"class_list":["post-95057","mod","type-mod","status-publish","has-post-thumbnail","hentry","mod_category-bukkit","mod_category-game-mechanics","mod_category-management","mod_category-paper","mod_category-purpur","mod_category-social","mod_category-spigot","mod_loader-bukkit","mod_loader-paper","mod_loader-purpur","mod_loader-spigot","minecraft_version-1-21","minecraft_version-1-21-1","minecraft_version-1-21-10","minecraft_version-1-21-11","minecraft_version-1-21-2","minecraft_version-1-21-3","minecraft_version-1-21-4","minecraft_version-1-21-5","minecraft_version-1-21-6","minecraft_version-1-21-7","minecraft_version-1-21-8","minecraft_version-1-21-9"],"yoast_head":"\n
\n– `\/setpassword
\n– `\/unlock` – Unlock a chest you own
\n– `\/givekey
\n– `lockedchests.admin` – Admin permissions for commands like `\/givekey` (default: op)
\n– `lockedchests.bypass` – Bypass all chest locks (default: op)<\/p>\n
\n-worlds-mode: `false` for blacklist (works everywhere except listed), `true` for whitelist (works only in listed worlds)
\n– worlds: List of worlds to enable\/disable the plugin<\/p>\n
\n– key material: Item type for keys (default: TRIPWIRE_HOOK)
\n– key name: Display name for keys
\n– key.lore: Lore text for keys (use `%id%` for chest ID)<\/p>\n
\n– crafting-recipe enabled?: Enable\/disable blank key crafting
\n– crafting-recipe shape: Shapeless or shaped recipe
\n– crafting-recipe ingredients: Define crafting materials<\/p>\n
\n– allow-owner: Allow chest owner to open without needing a key
\n– allow-key-click: Allow opening with key in hand
\n– allow-key-inventory: Allow opening with key in inventory, not just in the hand
\n– allow-password: Enable password authentication to be able to share a chest with players without a key.
\n– password-timeout: Timeout for password entry (seconds)<\/p>\n
\n– ask-on-place: Prompt to lock when placing chest
\n– locking.allow-key-click-lock: Lock by clicking with blank key
\n– locking.require-just-placed: Only allow locking recently placed chests
\n– locking.place-time-window: Time window for locking after placement (seconds)<\/p>\n
\n– key-duplication.enabled: Allow duplicating keys by combining them with blank keys in a crafting table<\/p>\n
\n2. Place the JAR in your server’s `plugins` folder
\n3. Restart the server
\n4. Configure the plugin in `plugins\/LockedChests\/config.yml`
\n5. Reload or restart the server<\/p>\n
\n1. **Locking a Chest with a new key**:
\n – Place the chest.
\n – Craft a blank key using the configured recipe
\n – Right-click the chest with the blank key to lock it
\n – A specific key for that chest will be created<\/p>\n
\n – Place the chest.
\n – Right-click the chest with the key to lock it
\n – This key will now be able to open that chest<\/p>\n
\n – Have the correct key in your inventory or hand
\n – Enter the password if one is set
\n – Be the chest owner<\/p>\n
\n – Duplicate keys using blank keys in crafting
\n – Set a password with `\/setpassword` and share it
\n – Admins can give keys with `\/givekey`<\/p>\n