DreamKeys 梦境钥匙系统

📝 插件介绍
DreamKeys是一款功能强大的Minecraft服务器插件，用于创建和管理特殊门系统。该插件允许管理员设置需要特定钥匙才能打开的门，支持多种交互方式，包括单人触发和多人协作触发。门打开后会自动倒计时并关闭，为服务器增添了更多的游戏玩法可能性。

✨ 主要功能
- 🚪 特殊门系统：创建需要钥匙才能打开的门，支持自定义门区域
- 🔑 钥匙系统：自定义钥匙物品，包括材质、名称、lore和自定义模型数据
- 🕒 倒计时功能：门打开后自动倒计时并关闭，支持自定义时间
- 👥 多人触发模式：支持需要多名玩家同时触发才能打开的门
- 🔊 音效系统：开门时播放音效，增强沉浸感
- ⏱️ 延迟开门：支持设置触发后延迟一段时间再开门
- 🔄 无钥匙模式：可设置特定门不需要钥匙即可打开

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/drkeys create <id>` | 创建一个新门并获取设置工具 | dreamkeys.admin |
| `/drkeys bind <id>` | 绑定触发方块 | dreamkeys.admin |
| `/drkeys key give <id>` | 获取指定门的钥匙 | dreamkeys.admin |
| `/drkeys toggle consume` | 切换是否消耗钥匙的设置 | dreamkeys.admin |
| `/drkeys nokey <id> [true/false]` | 设置门是否需要钥匙 | dreamkeys.admin |
| `/drkeys time <id> <close/delay> <秒数>` | 设置门的关闭时间或开门延迟 | dreamkeys.admin |
| `/drkeys multi <id> [on/off/players/time] [值]` | 设置多人触发模式 | dreamkeys.admin |
| `/drkeys reload` | 重新加载配置 | dreamkeys.admin |

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `dreamkeys.admin` | 允许使用所有梦境钥匙管理命令 | op |

🔄 使用方法

创建门流程:
1. 管理员使用命令 `/drkeys create <id>` 创建一个新门，获得两个设置工具
2. 使用左键工具点击左墙的上下两个点，设置左墙区域
3. 使用右键工具点击右墙的上下两个点，设置右墙区域
4. 使用命令 `/drkeys bind <id>` 后右键点击方块，绑定为触发方块
5. 使用命令 `/drkeys key give <id>` 获取该门的钥匙

使用门流程:
1. 玩家手持正确的钥匙右键触发方块
2. 左右墙会像粘液活塞一样打开，并播放活塞声音
3. 系统显示倒计时，提示多少秒后门会关闭
4. 倒计时结束后，门自动关闭

多人触发模式:
1. 管理员使用命令 `/drkeys multi <id> on` 开启多人触发模式
2. 使用命令 `/drkeys multi <id> players <数量>` 设置需要的玩家数
3. 使用命令 `/drkeys multi <id> time <秒数>` 设置触发时间窗口
4. 需要指定数量的不同玩家在时间窗口内触发不同的方块，才能打开门

💻 技术信息
- 支持版本: Paper 1.20.1+
- API版本: 1.20
- 开发语言: Java 17
- 数据存储: YAML配置文件

⚙️ 安装方法
1. 将插件放入服务器的plugins文件夹
2. 启动服务器，插件会自动生成配置文件
3. 根据需要修改config.yml和messages.yml文件
4. 使用命令创建和管理门系统

📊 数据存储结构
- `config.yml`: 插件主配置文件
- `messages.yml`: 插件消息配置文件
- `doors/<id>.yml`: 每个门的配置数据，包括区域、触发方块等
- `keys.yml`: 钥匙物品配置

⚠️ 注意事项
- 设置门区域时，确保区域内包含目标方块类型
- 多人触发模式需要不同的玩家触发不同的方块
- 门打开后会自动关闭，默认时间为30秒
- 可以通过配置文件自定义钥匙的外观和属性

---
感谢您选择DreamKeys插件！如有任何问题或建议，请随时联系我们。