# SpawnChestPlugin v2.6 – 英文文档
**SpawnChestPlugin v2.6** 是一个完全平衡的，**适用于 Minecraft 1.21** 的插件，用于自动、全球范围内的宝箱事件。
### v2.6 新增功能
- **8 件传奇物品**，具有真正的自定义能力和可见的冷却时间。
- **改进的冷却时间跟踪**，使用 `/cooldowns` 命令。
- **更安全的异步位置搜索**，实现无延迟的宝箱放置。
- **持久性计时器**，具有更好的崩溃恢复逻辑。
---
## 快速开始
1. 将 JAR 文件放入您的 **Paper/Spigot 1.21+** 服务器的 `plugins` 文件夹中。
2. 编辑 `config.yml` 以调整计时器、消息或生成设置。
3. 使用 `/reloadchestconfig` 重新加载 — **无需服务器重启**。
---
## 玩家命令
| 命令 | 别名 | 描述 | 示例 |
|--------------|----------------|----------------------------------------------------|----------------|
| **/nextchest** | `/nc`, `/chest` | 显示下一次宝箱生成时间 | `/nextchest` |
| **/cheststats**| `/cstats` | 显示掉落几率、区域信息和插件版本 | `/cheststats` |
| **/cooldowns** | – | 列出所有传奇物品的剩余冷却时间 | `/cooldowns` |
---
## 管理员命令
| 命令 | 别名 | 权限 | 描述 |
|--------------------------|-------------------------|---------------------------------|-------------------------------------------|
| **/spawnchestnow** | `/chestnow` | `spawnchest.spawnchestnow` | 立即生成宝箱事件 |
| **/setchesttimer ** | `/settimer`, `/timer` | `spawnchest.setchesttimer` | 更改自动生成间隔 |
| **/reloadchestconfig** | `/ccr` | `spawnchest.reloadchestconfig` | 重新加载配置文件 |
| **/testchestzone** | – | `spawnchest.testchestzone` | 打印五个随机的有效生成坐标|
| **/getlegendaryitems** | `/getlegendary`, `/testgear` | `spawnchest.getlegendaryitems` | 给予所有传奇物品用于测试 |
---
## 宝箱等级
| 等级 | 几率 | 掉落 & 守卫者 | 效果 |
|------|-------:|------------------|--------|
| **普通** | 70 % | 基本掉落 & 装备，**1 僵尸** | 简单粒子效果，宝箱打开的声音 |
| **稀有** | 25 % | 有价值的材料 & 附魔装备，**2 骷髅** | 附魔粒子效果，信标声音 |
| **传奇** | 5 % | 史诗级宝藏 & 所有自定义物品，**3 凋零骷髅** | 龙息，闪电，龙爆炸声 |
* **生成范围:** X/Z ±500–2000, Y 60–200
* **持久性:** 计时器保存到 `timer.txt` 以便重启
* **警告:** 在 20 分钟、10 分钟、5 分钟、3 分钟、1 分钟和最后 1 分钟的每 10 秒广播
* **开箱前效果:** 螺旋粒子效果，每 30 秒发出环境音效，首次打开后 5 分钟自动销毁
---
## 传奇物品
* **龙 slayer 之刃** – +4 伤害，使敌人着火 *(3 秒冷却时间)*
* **大师镐** – 自动熔炼矿石，并可双倍掉落 *(1 秒冷却时间)*
* **泰坦斧** – 砍伐整棵树或添加 +3 伤害 *(4 秒 / 6 秒冷却时间)*
* **虚空铲** – 3×3 挖掘，并自动收集 *(5 秒冷却时间)*
* **风暴之锤** – 投掷闪电并造成范围伤害 *(8 秒冷却时间)*
* **守护者弓** – 双重射击，带有追踪箭 *(2 秒冷却时间)*
* **古老智慧之书** – 用平衡的高级附魔附魔物品栏中的所有装备
* **凤凰之羽** – 赋予复活和火焰免疫，在持有时生效
---
## 权限节点
### 玩家 (默认 **true**)
* `spawnchest.nextchest` – 使用 `/nextchest`
* `spawnchest.cheststats` – 使用 `/cheststats`
* `spawnchest.cooldowns` – 使用 `/cooldowns`
### 管理员 (默认 **op**)
* `spawnchest.spawnchestnow`
* `spawnchest.setchesttimer`
* `spawnchest.reloadchestconfig`
* `spawnchest.testchestzone`
* `spawnchest.getlegendaryitems`
### 大师
* `spawnchest.*` – 授予 **所有** 命令