Getting Started
This page walks through a first Locksmith setup from blank key to locked block.
1. Craft an Iron Key
Craft a key with one Iron Ingot above two Iron Nuggets.
Unregistered keys stack up to 64. Registered keys become single-stack items.
2. Register The Key
Hold an unregistered Iron Key in your main hand and right-click. The registration screen asks for a secret passphrase.
The passphrase is trimmed, limited to 64 characters, hashed with SHA-256 on the server, and stored on the key as item data. The passphrase itself is not stored on the key.
Locks compare the stored key hash. Two independently registered keys with the same passphrase can open the same locks.
3. Lock A Block
Right-click a supported, currently unlocked door or chest with a registered key in your main hand.
- The interaction is consumed so the door or chest does not open by accident.
- Doors are forced closed when the lock is placed.
- Chests and double chests use one saved lock entry for the protected container.
- A short HUD message confirms the lock.
4. Open A Locked Block
Carry any registered Iron Key with the same passphrase hash. The key can be in your inventory, offhand, armor slots, or the Curios key slot.
Players without a matching key are denied and receive a short HUD message.
Support This Project
Like this wiki and these mods?
Every bit of support helps me keep building features, writing docs, and shipping updates.