原创 娱乐 经济 游戏模式 [1.20-1.21] TreasureCoffer 轻量抽奖插件, 宝箱设置, 钥匙/点券/金币/单抽/连抽/ 保底 1.1.1.17

修复ItemDisplay奖品全息展示

1. 配置文件设置
   • 在
     <span tabindex="0">config.yml</span>
     中添加了 reward-display.default-enabled-for-new-crates: false
   • 新创建的宝箱默认不显示ItemDisplay，但全局功能默认启用
2. 宝箱模型扩展
   • 在 Crate 类中添加了 itemDisplayEnabled 字段
   • 支持保存和加载该设置到配置文件
3. 管理器功能
   • CrateManager 添加了 setItemDisplayEnabled() 方法
   • RewardDisplayManager 会检查宝箱的 itemDisplayEnabled 设置
   • 当设置改变时，会自动创建或移除ItemDisplay展示
4. 命令系统
   • 添加了 /tc setitemdisplay &lt;宝箱名&gt; &lt;true/false&gt; 命令
   • 支持Tab补全（宝箱名和true/false）
   • 需要 treasurecoffer.admin.setitemdisplay 权限
     

现在的完整音效体系​

1. 开箱音效 (openSound) - 当玩家打开任何宝箱界面时播放
2. 普通抽奖音效 (normalSound) - 当玩家进行普通抽奖获得奖励时播放
3. 保底音效 (luckySound) - 当玩家触发保底机制获得保底奖励时播放

音效播放时机​

• 点击宝箱方块/实体 → 播放开箱音效 → 打开界面
• 在界面中点击抽奖按钮 → 根据抽奖结果播放普通抽奖音效或保底音效
• 使用命令打开宝箱 → 播放开箱音效 → 打开界面

• 钥匙检查只在背包槽位0-35中进行，不会检测装备槽位的钥匙
• 避免了玩家将钥匙戴在头部来绕过钥匙消耗的漏洞

- 玩家可以创建个人宝箱（基于权限限制数量）
- 玩家可以向宝箱添加物品作为奖励
- 玩家可以删除宝箱并返还物品
- 其他玩家可以使用玩家宝箱进行抽奖

[MD]
# TreasureCoffer 更新说明
**更新日期：2025年5月21日**
## 新增功能：命令奖励系统
我们很高兴地宣布，TreasureCoffer 插件现已支持命令奖励功能！这一全新功能允许服务器管理员设置特殊的奖励，当玩家中奖时，系统将以OP权限执行预设的命令，而不是直接给予物品。
### 功能特点
- **命令执行奖励**：中奖后不发放物品，而是执行指定命令
- **变量支持**：命令中的 `%player%` 会自动替换为中奖玩家的名称
- **空格处理**：使用下划线 `_` 代替命令中的空格，避免参数解析错误
- **自定义图标**：可以使用任意物品作为命令奖励的显示图标
- **概率控制**：与普通物品奖励一样，可以设置获取概率
### 使用方法
#### 添加命令奖励
1. 手持一个物品（该物品将作为命令奖励的显示图标）
2. 输入命令：
```
/tc addcmd <宝箱名> <命令> [概率]
```
- `<宝箱名>` - 要添加奖励的宝箱ID
- `<命令>` - 要执行的命令，使用下划线代替空格，使用 `%player%` 表示中奖玩家
- `[概率]` - 可选参数，设置获取概率（默认为10%）
#### 示例
```
/tc addcmd default eco_give_%player%_10000 20
```
这个命令会在玩家中奖时以OP身份执行：`eco give 玩家名 10000`，概率为20%。
```
/tc addcmd vip lp_user_%player%_parent_add_vip_7d 5
```
这个命令会在玩家中奖时以OP身份执行：`lp user 玩家名 parent add vip 7d`，概率为5%。
### 注意事项
- 命令奖励会以控制台（OP权限）身份执行，请确保命令安全
- 命令中的 `%player%` 会被自动替换为中奖玩家的名称
- 命令中的所有下划线 `_` 会被自动替换为空格
- 命令奖励在GUI中显示时会使用您添加时手持的物品作为图标
- 命令奖励目前只能添加到普通奖池，不支持添加到保底奖池
### 权限节点
- `treasurecoffer.admin.addcmd` - 允许添加命令奖励
### 命令列表
| 命令 | 描述 |
|------|------|
| `/tc addcmd <宝箱名> <命令> [概率]` | 添加命令奖励到指定宝箱 |
---
感谢您使用TreasureCoffer插件！如有任何问题或建议，请随时联系我们。
[/MD]

1.0.8.5 修复自定义广播,奖品GUI翻页

修复奖品超过28个时没有出现下一页按钮

修复reload一些配置不生效BUG

修复广播开关