
Screenshots

About this Mod
Allows the locking of blocks using physical keys instead of permissions.
By default, vanilla doors, chests, and trapped chests are supported. Additional blocks — including modded ones — can be configured server-side.
🔑 Craft iron keys and register them with a secret passphrase
🔒 Lock doors, chests, and other blocks using those keys
📋 Duplicate keys safely (master & copied key system)
🚪 Optional auto-opening/closing for locked doors (incl. double-doors)
🧩 Supports modded blocks via simple configuration
🌐 Fully server-authoritative & multiplayer-safe
🛠️ Curios compatibility (Key slot)
1️⃣ Craft an iron key (1x iron ingot, 2x iron nugget below)
2️⃣ Right-click while holding the key to register it.
3️⃣ Enter a secret passphrase when prompted.
4️⃣ Right-click a door or chest with the registered key to lock it.
5️⃣ Duplicate keys using the minting recipe if multiple players need access.
Players without a matching key will be unable to open the locked block.
Server administrators can define exactly which blocks are lockable. This includes vanilla blocks as well as blocks added by other mods.
Example: adding a custom door:
{
"id": "my_mod_doors",
"type": "door",
"blocks": [
"modid:steel_door",
"modid:reinforced_door"
],
"render": {
"offsetX": -0.05,
"offsetY": 0.5,
"offsetZ": -0.5,
"rotX": 0.0,
"rotY": 0.0,
"rotZ": 0.0,
"scale": 0.75,
"hingeNudgeLeft": 0.18,
"hingeNudgeRight": 0.325
}
}
These profiles control locking behavior only. They do not affect block hardness or explosion resistance.
💡 Tips
This mod does not make locked blocks invulnerable. I'd strongly recommend combining this mod with something like OpenPAC (this mod was built exactly for that scenario).
📝 Licensing and distribution
Locksmith is released under the Z2SIX Mod License.
Available Versions
How to Install Locksmith on Your Server
Order Server
Order a Minecraft Java server with at least 3 GB RAM (4 GB recommended).
Set neoforge Loader
In the panel under "Egg", select the neoforge loader and matching Minecraft version (1.21.1).
Install Mod
Open the mod browser in the dashboard and search for "Locksmith". Click "Install" – done! Alternatively, upload the .jar via SFTP to the /mods folder.
Compatibility
Mod Loaders
Minecraft Versions
1.21.1
Server-side
✓ RequiredRecommended RAM
4 GB(min. 3 GB)Frequently Asked Questions
Locksmith server crashes on startup – what to do?
Most common cause: wrong neoforge version or insufficient RAM. Check the server log (latest.log) for "OutOfMemoryError" or "Mixin" errors. With Mado Hosting: ensure at least 3 GB RAM is allocated and the loader matches the mod version (1.21.1). You can switch loaders with one click in the panel.
Is Locksmith compatible with neoforge?
Locksmith officially supports neoforge for Minecraft 1.21.1. The Mado dashboard automatically detects incompatible loader combinations.
Server lagging with Locksmith – how to optimize performance?
Recommended RAM: 4 GB (per 8 players). Use /spark profiler to check if Locksmith consumes the most tick time. Common fixes: reduce server view-distance to 8-10, install "performant" or "starlight" as supplementary mods on Forge. With Mado Hosting, your server runs on NVMe SSDs with dedicated CPU cores for minimal latency.
Similar Mods
Rent Modded Server
Install Locksmith with just one click on your server.