DreamRTChest 梦境摸金宝箱

📝 插件介绍
DreamRandomTreasureChest是一款功能丰富的Minecraft服务器随机宝箱搜索插件，为服务器增添探索和寻宝的乐趣。玩家可以搜索特定的箱子，通过精心设计的搜索动画获得随机物品，管理员可以轻松创建和管理物品组，设置物品掉落概率，绑定到不同的世界。该插件基于Paper API开发，支持自定义搜索界面和全息显示。

✨ 主要功能
- 📦 随机宝箱系统：将普通箱子或任意方块转变为可搜索的宝箱
- 🎲 物品组管理：创建多个物品组，每组包含带概率的物品（含完整NBT）
- 🌍 世界绑定：将不同物品组绑定到特定世界，实现区域性物品掉落
- 🔍 搜索动画：精美的搜索动画效果，增强游戏体验
- 🕒 每日限制：每个箱子每天只能搜索一次，固定时间重置
- 🔊 音效系统：搜索过程中播放音效，增强沉浸感
- 💫 全息显示：在可搜索箱子上方显示全息文字（需DecentHolograms）

🔑 命令列表
| 命令 | 描述 | 权限 |
|------|------|------|
| `/drrtc create <物品组名>` | 打开GUI创建物品组 | drrtc.command.use |
| `/drrtc bind` | 进入搜索箱绑定模式 | drrtc.command.bind |
| `/drrtc unbind` | 进入搜索箱解绑模式 | drrtc.command.unbind |
| `/drrtc group bind <世界名> <物品组名>` | 绑定物品组到世界 | drrtc.command.group |
| `/drrtc group unbind <世界名> <物品组名>` | 解绑世界与物品组 | drrtc.command.group |
| `/drrtc reload` | 重载所有配置文件 | drrtc.command.reload |
| `/drrtc clear <玩家名>` | 清除指定玩家当日记录 | drrtc.command.clear |

🔑 权限节点
| 权限 | 描述 | 默认 |
|------|------|------|
| `drrtc.command.use` | 允许使用插件基本命令 | true |
| `drrtc.command.admin` | 允许使用插件管理员命令 | op |
| `drrtc.command.bind` | 允许绑定搜索箱 | op |
| `drrtc.command.unbind` | 允许解绑搜索箱 | op |
| `drrtc.command.group` | 允许管理物品组 | op |
| `drrtc.command.reload` | 允许重载插件配置 | op |
| `drrtc.command.clear` | 允许清除玩家搜索记录 | op |

🔄 使用方法

创建物品组:
1. 执行命令 `/drrtc create <物品组名>`（例如：`/drrtc create 普通物品`）
2. 在打开的GUI中放入想要添加的物品
3. 关闭GUI后，物品组会自动保存到 `plugins/DreamRandomTreasureChest/itemgroups/<物品组名>.yml`

绑定搜索箱:
1. 执行命令 `/drrtc bind` 进入绑定模式
2. 右键点击想要设置为搜索箱的方块
3. 如果启用了全息显示，会在箱子上方显示全息文字

绑定物品组到世界:
1. 执行命令 `/drrtc group bind <世界名> <物品组名>`（例如：`/drrtc group bind world 稀有物品组`）
2. 绑定后，该世界的搜索箱将可能掉落该物品组中的物品

使用搜索箱:
1. 玩家右键点击已绑定的搜索箱或默认世界中的箱子
2. 打开GUI界面，显示若干个搜索按钮
3. 点击搜索按钮，开始搜索动画
4. 搜索完成后，显示获得的物品，玩家可以点击取出

💻 技术信息
- 支持版本: Paper 1.20.1+
- API版本: 1.20
- 开发语言: Java 17
- 依赖插件:
- DecentHolograms (软依赖): 用于显示全息文字
- Item-NBT-API: 用于处理物品NBT数据

⚙️ 安装方法
1. 将插件放入服务器的plugins文件夹
2. 启动服务器，插件会自动生成配置文件
3. 根据需要修改config.yml文件
4. 创建物品组并绑定到世界
5. 开始绑定搜索箱或使用默认世界的箱子

📊 数据存储结构
- `config.yml`: 插件主配置文件
- `world_groups.yml`: 世界与物品组绑定关系
- `bound_blocks.yml`: 手动绑定的搜索箱数据
- `player_records.yml`: 玩家搜索记录
- `itemgroups/`: 存储各个物品组配置

⚠️ 注意事项
- 物品组中的物品支持完整NBT数据，包括自定义名称、lore和模型数据
- 每个箱子每天只能被同一玩家搜索一次，重置时间为config.yml中的reset_hour
- 如果服务器未安装DecentHolograms，全息显示功能将自动禁用
- 物品概率基于权重系统，总权重超过100会自动按比例压缩

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