Physical Keys, Server Locks

LocksmithPassphrases, Iron Keys, Real Access Control

Locksmith locks blocks with actual keys instead of claim permissions. Register an iron key with a secret passphrase, lock a door or chest, then let matching keys decide who can open it.

Localization

1 Language

Compatibility Client, Server, Integrations

Client

Required Renders lock models, registration screen, HUD feedback, client prediction, Curios quick-equip, and synced profile visuals.

Server

Required Owns passphrase hashing, key data, door and chest lock data, access checks, sync packets, cleanup, and configurable lock profiles.

Singleplayer

Supported Works through the integrated server with the same key, lock, double-door, and chest behavior.

Curios Adds a dedicated key slot and supports shift-right-click quick equip for registered keys.

Optional

OpenPAC Recommended for protecting locked blocks from breaking or explosions, since Locksmith controls access rather than block invulnerability.

Optional

Modded Blocks Server profiles can add compatible modded doors, chests, and trapped-chest style blocks with custom lock render offsets.

Supported

Core Loop

Lock Blocks With Keys Players Can Carry

Blank Key

Stackable Until Registered

Blank iron keys can stack. Right click one in your main hand to open the registration screen.

Registered Key

Passphrase Becomes Access

The server hashes the passphrase, stores the registered-by tooltip data, and makes the key non-stackable.

Copied Key

Share The Same Lock

Mint copies from a registered key and a blank key. The source key returns to the grid, and the copy carries the same lock hash.

Features

Locksmith focuses on access control, not indestructible blocks. It decides who may open a block, while protection mods can handle breaking and explosions.

Keys Are Physical

An iron key starts blank and stackable. Register it with a secret passphrase, and the server stores a SHA-256 key hash plus the registering player's name.

Locks Live On Blocks

Right click a configured door or chest with a registered key to lock it. Players can open it only when they carry a key with the matching hash.

Copy Without Losing The Master

The minting recipe uses one registered key and one blank key. The source key stays in the grid, the blank key becomes a copied key, and tooltips mark master and copied roles.

Multiplayer First

Lock data is saved server-side, synced to clients on login, cleaned up when blocks disappear, and enforced by server interaction handlers.

How To Use

From Blank Key To Locked Door

01 Craft an Iron Key from one iron ingot above two iron nuggets.
02 Right click the blank key and enter a secret passphrase.
03 Right click a configured door, chest, or trapped chest with that registered key.
04 Hand out copied keys with the minting recipe when other players need access.

Server Profiles

Vanilla Defaults Modded Blocks Ready

Locksmith writes a server-authoritative locksmith_profiles.json file. Profiles define which blocks are lockable, whether they behave like doors or chests, and where the visible iron lock should render.

{
  "id": "reinforced_doors",
  "type": "door",
  "blocks": ["modid:steel_door"],
  "render": {
    "offsetY": 0.5,
    "scale": 0.75,
    "hingeNudgeLeft": 0.18
  }
}

Doors

Locked doors force-close after being locked, can auto-close after use, and can sync a paired locked double-door when both halves are valid mates.

Chests

Double chests normalize to one canonical lock position, so one lock protects the full pair instead of only the clicked half.

Feedback

Clients receive synced lock state for instant denial feedback, while the server remains authoritative for every access decision.

Credits Code + Assets

Core Credits

Author and development: Z2SIX
Project visuals and provided page assets: Z2SIX

Legal License + Scope

Custom license: Z2SIX Mod License (Code + Assets)

Review the license page for redistribution, derivative use, and asset rights details before reusing any Locksmith materials.