🔐 LockIT: Physical Locks, Keys & Lockpicking

Protect your chests and doors with real items, not chat commands.

LockIT is a protection plugin for Paper 1.21+. You lock a block by fitting a lock item to it and opening it with a key you forged. Locks can be picked, so a strong lock costs real resources, and thieves need skill, tools and some luck.

---

✨ Features

• 🔒 Physical protection. Locks and keys are real items you craft, trade, lose and steal.
• 🗝️ Forged keys. Every key gets its own code at a Smithing Table.
• 🧩 Lockpicking minigame. Find the hidden pin order before you run out of lives.
• 🪤 Traps (new in 1.7). Ink, sound and spike traps go off on anyone who picks the wrong pin.
• 🔑 Master keys. Merge keys in an anvil so one key opens several locks.
• 🚪 Double doors and double chests. One lock covers both halves.
• 💥 Grief-proof. Locked blocks can't be broken, blown up or emptied by hoppers.
• 🎨 Built-in resource pack. Custom textures for locks, keys, traps and menus, sent automatically when players join.
• ⚙️ Fully configurable. Items, recipes, difficulty, traps and messages are all editable.

Lockable blocks: chests, trapped chests, barrels, shulker boxes, doors, trapdoors and fence gates.

---

🗝️ Keys

Action	How
Craft	Craft a blank key at a crafting table.
Forge	Right-click a Smithing Table while holding the blank key. It gets a unique code.
Copy	In your inventory, click a forged key onto a blank key. (Survival only)
Reset	Right-click a Grindstone to erase the code.
Master key	In an anvil, combine two coded keys. The first key keeps both codes. Repeat to add more.

🔒 Locks

1. Program the lock. In your inventory, click your forged key onto a lock. The lock takes the key's code.
2. Install it. Sneak and right-click a lockable block to open the lock menu, then put the lock in it.
3. Use it.
   • Right-click with the key to lock or unlock the block.
   • Sneak and right-click with the key to open the lock menu again and swap or remove the lock and trap.

You only need the key somewhere in your inventory to open a locked block. You don't have to hold it.

---

🧩 Lockpicking

Right-click a locked block with a Lockpick to open the minigame. Click the pins in the right order.

• ❌ Wrong pin: you lose a life and your lockpick loses durability.
• ✅ Whole sequence right: the block unlocks.
• 💀 No lives left: the attempt fails.

Level	Pins	Lives
1	6	5
2	7	5
3	8	5
4	8	4
5	9	4
6	Can't be picked	–

Every value can be changed in lockpick.yml.

---

🪤 Traps

Put a trap in the 4th slot of the lock menu. It goes off every time a thief clicks a wrong pin.

Trap	Effect
🖤 Ink Trap	Blinds the thief, makes them glow through walls and kicks them out of the minigame.
🔔 Sound Trap	Sets off an alarm and tells nearby players where it happened.
🗡️ Spike Trap	Damages the thief. They can keep picking if they're brave enough.

Traps can only go off a limited number of times (shown as Uses left in the tooltip). You get the trap back when you remove the lock. Durability, damage, blindness time, alert radius and kick behavior are all set in traps.yml.

---

⚙️ Configuration

File	What it controls
config.yml	Action bar messages, double-door behavior, master keys, resource pack
items.yml	Names, materials and Custom Model Data for every item
craftings.yml	Recipes for every item (or turn them off)
lockpick.yml	Pins, lives and lockpick durability
traps.yml	Trap durability and effects
messages.yml	Every message, ready to translate

Use /lockit reload to apply changes without restarting.

---

💻 Commands

You don't need any commands to play. These are for admins. Permission: lockit.admin (default: OP)

Command	Description
/lockit key	Get a blank key
/lockit customkey <id>	Get a key with a specific code
/lockit universalkey	Get a key that opens every lock
/lockit lock <1-6>	Get a lock of the chosen level
/lockit lockpick	Get a lockpick
/lockit trap <ink|sound|spike>	Get a trap
/lockit reload	Reload all config files

---

📦 Installation

1. Put the .jar in your server's /plugins folder.
2. Restart the server.
3. Edit the generated config files if you want, then run /lockit reload.

Requires: Paper 1.21+ and Java 21.

---

Heavily inspired by the old Locks and Lockpicking plugin, which was discontinued in 2019.

💬 For feature requests or bug reports, find me on Discord: o_stein