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

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.

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:

Configuration

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

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

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

1. Download LockChest-1.0.1.jar or obtain the release from CurseForge.
2. Place the JAR in the server directory used for Hytale plugins/mods.
3. Restart the server.
4. 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.