转载 经济 甜蜜锁具 1.0.8

[MD]
# 甜蜜锁具（SweetLocks）

一款复刻并改进经典“付费铁门”功能的服务端插件。

> 默认配置文件为中文。如需英文或其他语言版本，请查看 [localization](https://github.com/mcio-dev/localization) 仓库。

## 简介

我在 1.8 时代游玩 1.6 服务器时，曾见过一项名为 **Paid Door** 的功能。

只需在铁门上方的方块上放置告示牌，并按以下格式填写：

- 第一行：`[lock]`（类似 Lockette 中的 `[Private]` 锁定告示牌）
- 第二行：`Vault money price`，例如 `100`
- 第三行：留空
- 第四行：功能标记，可使用 `I`、`O`、`E`、`NM`、`NP`
- `I`：允许进入
- `O`：允许离开
- `E`：要求背包为空
- `NM`：要求 Vault 余额为 0
- `NP`：要求没有药水效果

这样即可创建一扇付费门。玩家支付 Vault 经济货币后，会被传送至门的另一侧，适合用于抽奖机、安全门等场景。

据我所知，原版付费门插件早已停止维护，因此本插件重新实现并扩展了这一功能。其核心逻辑并不复杂。

## 旧版本兼容性说明

**低于 1.14 的版本**仅提供**有限支持**。这些版本更容易与其他插件发生冲突，也难以准确判断冲突的来源。

如果其他插件对告示牌执行 `block.getState().update();`，付费门将无法正常工作。

这是由旧版 Bukkit API 的限制导致的。旧版本只能使用已弃用的 `§` 颜色代码进行格式化，而该操作会清除插件用于保存数据的文本组件。

## 命令

根命令：`/sweetlocks`
别名：`/slocks`、`/locks`、`/sl`

| 命令 | 说明 | 权限 |
|---|---|---|
| `/locks` | 查看帮助 | 无 |
| `/locks reload` | 重载配置文件 | OP / 控制台 |

## 权限节点

- `sweet.locks.create`：允许创建付费门。
- `sweet.locks.bypass.tax`：创建者收取付费门的 Vault 货币时免除税费。
- `sweet.locks.bypass.distance`：绕过付费门使用距离限制，默认限制为 2.6 格以内。

## 使用方法

在告示牌的**第一行**输入 `$lock`，或输入配置文件中自定义的关键词。

完成告示牌放置后，插件会创建一扇价格为 `0 money`、默认允许进出的付费门，并自动打开编辑菜单。

付费门创建者可对告示牌执行 **Shift + 右键单击**，打开编辑菜单并设置门的价格及功能标记。

其他玩家对付费门**右键单击**时，会看到类似以下提示：

> 进入需要支付 X 枚货币。按住 Shift 并右键单击即可进入或离开。

右键单击告示牌可查看该付费门的信息。

## 工作机制

所有付费门数据都会通过插件内嵌的 `item-nbt-api` 保存至告示牌方块。交易通知则保存在本地数据文件中，并会在玩家登录时发送和清除。

- 在 **1.14 及以上版本**中，数据保存在方块的 **PersistentDataContainer** 内。
- 在 **低于 1.14 的版本**中，数据保存在告示牌第一行的 `insertion` 字段中。
[/MD]