转载 开源 简易锁具 1.0.0+26.2-neoforge

[MD]
# 简易锁具（Simple Locks）

Simple Locks 是一款为 Minecraft 添加锁、钥匙和开锁器的模组。


## 撬锁机制

撬锁时，玩家需要使用开锁器将锁芯中的销钉逐一推起并固定到位。销钉的排列顺序完全随机。

部分销钉第一次被推到顶部时不会立即固定，而是会以不同速度回落：有时较慢，有时很快。对于这类会回落的销钉，必须在其跌落至图示“第二区域”以下前按下空格键或点击鼠标，将其固定。

如果操作失误，导致所有销钉全部落下，销钉的排列顺序不会改变；但哪些销钉无法在第一次推起时固定将重新随机生成。若开锁器损坏，则整组销钉的排列顺序都会重置并完全随机化。




## 命令

- **`/simple_locks lockpick [enable/disable]`**
启用或禁用开锁器功能，默认启用。

- **`/simple_locks lockpickBreakChance <lock> <0 - 100 | default>`**
设置指定锁具的开锁器损坏概率。可填入 0 至 100 的数值，或使用 `default` 恢复该锁具的默认概率。

有效锁具类型：
- `ironLock`
- `goldLock`
- `diamondLock`
- `netheriteLock`

示例：
```text
/simple_locks lockpickBreakChance ironLock 50
```

- **`/simple_locks multiLock [enable/disable]`**
启用或禁用“一把钥匙管理多个锁”的功能。启用后，一把钥匙可解锁由它锁上的多个锁；禁用后，每把钥匙只能绑定一个锁。默认启用。

- **`/simple_locks keyReset [enable/disable]`**
启用或禁用已使用钥匙的重置功能。启用后，将带有锁 ID 的钥匙放入任意合成栏，即可获得一把相同材质、未绑定 ID 的空白钥匙。默认启用。

- **`/simple_locks unlock`**
无需钥匙，直接解锁玩家当前准星指向的已上锁方块。

## 配置

模组会在 Minecraft 的 `config` 文件夹中生成 `simple_locks.json` 配置文件。通过在该文件中添加方块的命名空间 ID，可以让任意原版方块或其他模组的方块支持上锁。

### 配置示例

```
{
"lockable_blocks": [
"minecraft:tnt",
"minecraft:furnace"
]
}
```

按照上述配置，TNT 和熔炉现在都可以安装锁具。除原版方块外，也可以将其他模组方块的 ID 添加至该 JSON 文件，使其成为可上锁方块。

当锁具安装在方块上且处于锁定状态时，在使用正确钥匙解锁前，该方块将具有以下限制：

- 无法被破坏；
- 无法通过漏斗等方式向其中存入或取出物品；
- 完全不受红石信号影响；
- 无法被活塞推动。

> **注意：** 将某些结构复杂或不兼容的方块加入列表，可能导致游戏崩溃。添加模组方块时请谨慎测试。














[/MD]