?
Host a serverModrinth App
Sign in
ModsResource PacksData PacksShadersModpacksPluginsServers
Settings
LockIT

LockIT

LockIT transforms the protection of chests and doors into a real game mechanic, requiring keys and locks.

525downloads
9followers
525downloads
9followers

Compatibility

Minecraft: Java Edition

26.3
26.2
26.1.x
1.21.x

Platforms

Tags

Creators

Details

Licensed ARR
Published 9 months ago
Updated 4 days ago

šŸ” 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