---
插件名称: Ultimate Vouches
版本: 1.0
Minecraft 版本: 1.21.1
API: Paper/Spigot
---
### 描述:
Ultimate Vouches 插件允许服务器管理员创建和分发自定义凭证。玩家可以通过右键单击凭证来兑换，这会触发预定义的命令在控制台中执行。
---
### 特性:
- **自定义命令**: 将任何控制台命令分配给凭证，并使用 {player} 等占位符表示玩家的名称。
- **交互式物品**: 凭证是具有自定义 NBT 数据的特殊物品，用于安全地存储命令。
- **用户友好的命令**: 管理员可以使用单个命令轻松创建和赠送凭证。
- **持久性数据**: 使用唯一的标识符和 NBT 数据在服务器重启后保存凭证。
- **可定制物品**: 管理员可以动态更改凭证的材质和名称。
- **简单的兑换**: 玩家可以通过右键单击物品来兑换凭证，从而触发关联的命令。
---
### 命令:
- **/ultimatevouches give ""**
- 描述: 创建一个带有指定命令的凭证并将其提供给玩家。
- 参数:
- ``: 将收到凭证的目标玩家。
- ``: 当凭证被兑换时执行的命令。使用 {player} 作为占位符表示玩家的名称。
- 示例:
- `/ultimatevouches give Steve "/give {player} diamond 5"`
- 这会创建一个凭证，该凭证会将 5 个钻石给予兑换它的玩家。
- **/ultimatevouches name **
- 描述: 更改你正在持有的凭证物品的名称。
- 参数:
- ``: 要设置的凭证名称（支持颜色代码）。
- 示例:
- `/ultimatevouches name "&6Epic Voucher"`
- 这会将你手中的物品的名称更改为“Epic Voucher”，并带有金色颜色。
---
### 使用方法:
- **创建凭证**: 使用 `/ultimatevouches give` 命令创建和向玩家赠送凭证。
- **兑换凭证**: 玩家可以通过在他们的物品栏中右键单击凭证来执行分配的命令。
- **更改凭证材质**: 使用 `/ultimatevouches item ` 更改凭证物品的材质。
- **更改凭证名称**: 使用 `/ultimatevouches name ` 更改凭证物品的名称。
### 事件:
- **玩家交互**: 该插件会监听 `PlayerInteractEvent` 以检测何时兑换凭证。
- **凭证移除**: 兑换后，凭证会从玩家的物品栏中移除。
要求:
- **NBT-API**: 该插件需要 NBT-API 来管理物品上的自定义 NBT 标记。
- **Paper/Spigot**: 运行 Minecraft 1.21.4 或更高版本的兼容服务器版本。
---
### 安装:
1. 下载插件 JAR 文件并将其放入服务器的 `plugins` 文件夹中。
2. 安装 NBT-API 插件（如果尚未安装）。
3. 重启服务器。
权限:
- **ultimatevouches.admin**: 授予对 `/ultimatevouches` 命令的访问权限。