原创 付费 💰【1.12-1.21+|Folia】WarZCrates - 商业级抽奖系统｜38种动画｜网页编辑器｜保底+阶梯钥匙 1.4.3

[MD] ## 更新摘要 - 修复使用 `wc set` 绑定箱子后，重启服务器绑定丢失的问题。 - 根因：`BlockLocationManager` 加载绑定数据时，若世界尚未加载完成会直接丢弃绑定；服务器关闭时再将空数据写回文件，导致磁盘上的绑定被永久覆盖。 - 改为延迟解析世界引用：绑定数据在加载阶段只记录世界名字符串，等到实际使用时再从 Bukkit 解析 World 对象，不再因世界加载顺序丢失数据。 - 为所有涉及 Location 比较与操作的代码路径增加了空世界保护，避免延迟解析期间出现空指针异常。 [/MD]

[MD] ## 更新摘要 - 新增全局配置 `reward-display.show_rarity_lore`，可统一关闭预览界面、动画展示等奖励物品底部自动追加的“稀有度: ...” lore。 - 关闭该开关后，只会隐藏展示用的稀有度 lore，不影响奖励自身的 `rarity` 配置、稀有奖励判定、保底逻辑或全服公告。 - 保持与现有 `show_chance_lore` 风格一致，管理员只需在 `config.yml` 中修改一处并执行 `/warzcrates reload` 即可生效。 [/MD]

[MD] - 普通奖励现在支持奖励级 `notify_player` 开关，默认会在聊天栏单独提示获奖玩家“你获得了什么”，不必再依赖全服公告才能看到结果。 - 奖励聊天消息与全服播报中的“物品名称”改为优先使用可翻译聊天组件；对于未手动改名的原版物品，中文客户端会直接按自身语言资源显示中文名称，例如 `Golden Apple` 会显示为“金苹果”。 - 网页编辑器新增“私聊提示玩家”开关，配置读写、默认示例和消息模板已同步支持，方便把普通奖励设为“只提示本人、不广播全服”。 [/MD]

[MD] - 新增真正的全息图关闭能力，`config.yml` 现在支持 `hologram.enabled: false`，关闭后不会再为任何绑定箱子生成默认全息图。 - `hologram.provider` 现在额外支持 `NONE` / `OFF` / `DISABLED`，可直接通过 provider 配置禁用全息，而不是被强制回退到内置 `BuiltIn`。 - 调整启动日志输出：当全息图被显式关闭时，控制台会显示“全息图支持: 已关闭”，方便区分“未安装外部插件”与“管理员主动禁用”两种状态。 [/MD]

[MD] - 修复 `Leaf 1.21.8` 下 `DragonParticleEffect` 调用 `Particle.DRAGON_BREATH` 时传入 `Float` 数据、但服务端实际要求 `Void`，导致 `WorldSceneAnimation` 持续报 `data (class java.lang.Float) should be class java.lang.Void` 的问题。 - 将龙吐息粒子改为按运行时 `Particle.DRAGON_BREATH` 的实际数据类型自适应调用：需要 `Float` 的服务端自动补 `0.0F`，需要 `Void` 的服务端则改为无数据参数调用。 - 兼容范围从“只修一种高版本粒子参数缺失”扩展为同时兼容 `Float` / `Void` 两类 `DRAGON_BREATH` 实现，降低 `Leaf`、`Folia`、`Paper` 衍生核心之间的粒子差异风险。 [/MD]

[MD] # WarZCrates 1.1.4 发布日期: 2026-04-29 ## 更新摘要 - 继续补强 `Folia` 兼容层：世界场景类动画现在会优先绑定到开箱原点所在 region 调度，减少跨区执行动画逻辑带来的风险。 - 新增玩家线程安全封装，GUI 打开/关闭、背包刷新、奖励发放等玩家相关操作会优先切到玩家实体调度器执行。 - 将玩家锁定状态、GUI 会话状态、玩家抽奖数据、全息图缓存、箱子注册表等关键共享状态改为并发安全集合，降低多 region 同时访问时的冲突概率。 - 配合 `1.1.3` 的异步传送修复，进一步收口世界场景动画、预览界面、奖励发放这几条在 `Folia 1.21.11+` 下最容易出问题的调用链。 [/MD]

[MD] ## 更新摘要 - 修复 `1.1.0` 在 `Folia 1.21+` 环境下，奖励命令仍在实体区域线程直接执行，触发 `Dispatching command async` 异常的问题。 - 修复上述异常连带导致的“动画结束阶段反复重进”，从而让同一奖励被重复发放、玩家背包被刷满的问题。 - 奖励命令与全服广播现在会自动切换到 Folia 安全的全局调度线程执行。 - 为动画基类补充终止态保护，哪怕动画在结束发奖阶段再次抛错，也不会重复进入发奖逻辑。 [/MD]

• 新增高级多档保底 pity_rules，支持类似 10 抽小保底、20 抽大保底。
• 支持“小保底触发后不清零、大保底触发后清零”的循环逻辑。
• 支持同一轮里多个保底档位，且小保底不会在 11/12/... 抽重复触发。
• 单抽和十连统一走新保底逻辑，十连会按逐抽顺序正确结算。
• 保留旧版 max_pity + pity_reward 机制，旧配置不用改也能继续使用。
• 网页编辑器新增高级保底配置入口，PAPI 的保底占位符也兼容新进度。

新增发放虚拟钥匙命令。

• /warzcrates vkey room 玩家名 5
• 玩家自己执行时也可以省略玩家名：/warzcrates vkey room 5 不支持，这里仍然是现有风格，省略玩家时默认给自己，数量放第 3 位只在当前实现里不解析，所以推荐始终写全：/warzcrates vkey room 自己名字 5
• 发完后目标玩家用 /warzcrates keys room 就能看到余额增加

[MD] # WarZCrates 1.0.6 发布日期: 2026-04-12 ## 更新摘要 - 修复使用 `DecentHolograms` 时，执行 `/warzcrates reload` 或调整 `crate_locations.yml` 后，旧坐标全息图可能残留、与新全息图叠加显示的问题。 - 调整动态全息图模板兼容逻辑：当启用 `hologram.dynamic_lines` 时，`hologram.line1` 会覆盖首行标题，`hologram.line2` 会覆盖末行交互提示，便于沿用旧配置习惯。 - 保持中间的动态占位符行（如钥匙数、保底值）继续由 `dynamic_lines` 控制，不影响按玩家 PlaceholderAPI 解析。 ## 建议回归测试 - 在安装 `DecentHolograms` 的情况下，先绑定一个箱子，再修改 `crate_locations.yml` 坐标并执行 `/warzcrates reload`，确认旧位置全息图会被清除。 - 在 `messages.yml` 中仅修改 `hologram.line1` 与 `hologram.line2`，执行 `/warzcrates reload` 后确认标题行与底部交互行会同步更新。 - 在 `messages.yml` 中修改 `hologram.dynamic_lines` 的中间两行，执行 `/warzcrates reload` 后确认钥匙数、保底值等动态行仍正常显示。 --- [/MD]