锁定箱子系统

箱子与工作台锁定系统 (0.5.6+)

使用一个简单但完善的箱子和工作台锁定系统，保护你在 Hytale 中的物品安全。

LockChest 是一个 Hytale 服务器插件，用于保护箱子、容器以及选定的工作台。玩家可以共享访问权限，而无需给予受信任的玩家管理或破坏受保护方块的权限。

预览

功能

• 锁定支持的箱子、容器、大箱子以及已配置的工作台。
• 服务器重启后，所有权和受信任玩家列表保持不变。
• 阻止未授权玩家打开或破坏受保护方块。
• 允许受信任玩家使用容器或工作台，但不允许他们管理或破坏它。
• 允许所有者破坏自己的受保护方块；其已保存的锁定信息会被自动移除。
• 通过独立的概览和访问管理标签页管理锁。
• 通过输入在线玩家精确的昵称来添加他们，并可从可滚动的受信任列表中移除玩家。
• 显示上下文相关的箱子管理和工作台管理标题及图标。
• 使用右下角的 Toast 通知，而非聊天栏来显示操作状态和错误信息。
• 播放客户端的上锁、解锁和移除玩家音效。
• 支持管理员管理，需 lockchest.admin 权限。
• 当方块未被锁定时，所有正常交互保持不变。

支持的工作台

工作台锁定由 config.json 中的 StationsLock 控制。仅包含以下工作台：

• 农夫工作台
• 建筑师工作台
• 家具工作台
• 铁匠砧
• 工作台
• 盔甲匠工作台
• 厨师炉灶
• 熔炉
• 炼金术士工作台
• 分解工作台
• 奥术师工作台
• 制革架
• 鸡舍
• 织布机
• 锻造炉

其他工作台、合成方块、椅子和通用交互式家具不可被锁定。

命令

每个命令都会在有限时间内启用一个动作。左键点击目标方块来执行该动作；此次点击会被消耗，因此不会对方块造成伤害。

命令	动作
/lc	打开你下一个锁定的箱子或工作台的管理界面。
/lc lock	锁定下一个支持的箱子、容器或工作台。
/lc unlock	解锁你的下一个受保护方块。
/lc trust player	让一个在线玩家使用你的下一个受保护方块。
/lc untrust player	从一个受保护方块中移除一个在线玩家的访问权限。

受信任玩家只能打开/使用受保护方块。他们无法打开其管理界面、更改访问列表、解锁或破坏该方块。

管理员命令

这些命令需要 lockchest.admin 权限，Hytale 管理员默认拥有此权限：

命令	动作
/lc admin	打开任意锁定的箱子或工作台的管理界面。
/lc admin unlock	强制解锁任意锁定的箱子或工作台。
/lc admin trust player	授予一个玩家对任意锁定箱子或工作台的访问权限。
/lc admin untrust player	撤销一个玩家对任意锁定箱子或工作台的访问权限。

配置

插件会在插件 JAR 旁创建 LockChest/config.json：

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

设置项	描述
language	预留的语言代码。文本目前从 LockChest/lang.json 加载，缺失的键会使用捆绑的英文默认值。
enableNotifications	启用或禁用右下角的 Toast 通知。
pendingActionTimeoutSeconds	/lc 动作保持启用状态的秒数。
maxUseDistance	应用已启用动作时允许的最大距离。设为 0 可禁用距离限制。
StationsLock	允许在支持的工作台上创建新的锁定。当此项为 false 时，已有的工作台锁定仍受保护并可管理。

现有的旧配置文件会自动迁移，以包含当前设置并移除过时的基于关键词的工作台选项。

持久化与大箱子

锁定信息保存在 LockChest/locks.properties 中，因此所有权和访问列表在服务器重启后保持不变。玩家显示名称会缓存在 LockChest/names.json 中。

相连的大箱子方块会被解析为一个规范化的锁定记录。与任何一侧交互都会找到相同的保护记录，包括当之前锁定的单个箱子成为大箱子的一部分时。

安装

1. 下载 LockChest-1.0.1.jar 或从 CurseForge 获取发布版本。
2. 将 JAR 文件放入用于 Hytale 插件/模组的服务器目录中。
3. 重启服务器。
4. 如有需要，编辑生成的 LockChest/config.json，然后重启以应用配置更改。

计划中的功能

• 撬锁小游戏。
• 用于保护容器的分级挂锁物品。

支持与建议

建议可以发布在 CurseForge 的评论区。

如需支持，请加入 Discord 服务器。