Chest & Stations Locking System (0.5.6+)

Keep your items safe with a simple but complete Chest & WorkBenches Lock system for Hytale.

LockChest is a Hytale server plugin for protecting chests, containers, and selected crafting stations. Players can share access without giving trusted players permission to manage or break the protected block.

Preview

LockChest Preview

LockChest UI

Features

Lock supported chests, containers, double chests, and configured stations.
Persistent ownership and trusted-player lists across server restarts.
Prevent unauthorized players from opening or breaking protected blocks.
Let trusted players use the inventory or station without allowing them to manage or break it.
Let owners break their own protected block; its saved lock is removed automatically.
Manage locks through separate Overview and Access Management tabs.
Add an online player by entering their exact nickname and remove players from a scrollable trusted list.
Display context-aware Chest Management and Station Management titles and icons.
Use bottom-right toast notifications instead of chat for action status and errors.
Play client-side lock, unlock, and remove-player sounds.
Support administrator management with the lockchest.admin permission.
Keep all normal interactions unchanged when a block is not locked.

Supported stations

Station locking is controlled by StationsLock in config.json. Only these stations are included:

Farmer's Workbench
Builder's Workbench
Furniture Workbench
Blacksmith's Anvil
Workbench
Armorer's Workbench
Chef's Stove
Furnace
Alchemist's Workbench
Salvager's Workbench
Arcanist's Workbench
Tanning Rack
Chicken Coop
Loom
Forge

Other benches, crafting blocks, chairs, and generic interactive furniture are not made lockable.

Commands

Every command arms an action for a limited time. Left-click the target block to perform it; the hit is consumed so it does not damage the block.

Command	Action
`/lc`	Open the management UI for your next locked chest or station.
`/lc lock`	Lock the next supported chest, container, or station.
`/lc unlock`	Unlock your next protected block.
`/lc trust player`	Let an online player use your next protected block.
`/lc untrust player`	Remove an online player from your next protected block.

Trusted players can only open/use the protected block. They cannot open its management UI, change its access list, unlock it, or break it.

Administrator commands

These commands require lockchest.admin, which is granted to Hytale administrators by default:

Command	Action
`/lc admin`	Open the management UI for any locked chest or station.
`/lc admin unlock`	Force-unlock any locked chest or station.
`/lc admin trust player`	Grant a player access to any locked chest or station.
`/lc admin untrust player`	Revoke a player's access to any locked chest or station.

Configuration

The plugin creates LockChest/config.json beside the plugin JAR:

{
  "language": "en",
  "enableNotifications": true,
  "pendingActionTimeoutSeconds": 30,
  "maxUseDistance": 6.0,
  "StationsLock": true
}

Setting	Description
`language`	Reserved language code. Text currently loads from `LockChest/lang.json`, using bundled English defaults for missing keys.
`enableNotifications`	Enables or disables bottom-right toast notifications.
`pendingActionTimeoutSeconds`	Number of seconds a `/lc` action remains armed.
`maxUseDistance`	Maximum distance allowed when applying an armed action. Use `0` to disable the distance limit.
`StationsLock`	Allows new locks to be created on the supported stations. Existing station locks remain protected and manageable when this is `false`.

Existing older configuration files are migrated automatically to include current settings and remove obsolete keyword-based station options.

Persistence and double chests

Locks are saved in LockChest/locks.properties, so ownership and access lists survive server restarts. Player display names are cached in LockChest/names.json.

Connected double-chest blocks are resolved to one canonical lock. Interacting with either side finds the same protection record, including when a previously locked single chest becomes part of a double chest.

Installation

Download LockChest-1.0.1.jar or obtain the release from CurseForge.
Place the JAR in the server directory used for Hytale plugins/mods.
Restart the server.
Edit the generated LockChest/config.json if needed, then restart to apply configuration changes.

Planned features

Lockpick minigame.
Tiered padlock items for protecting containers.

Support and suggestions

Suggestions can be posted on CurseForge comments section.

For support, join the Discord server.

Lock Chest System