更新日志
本页依据项目 更新日志.md 倒序整理。旧版本描述只代表当时行为；当前使用说明以 1.0.4 源码、资源与构建文件为准。
1.0.4 — 2026-08-05
- 保留 Folia 1.21.11/Java 21 与 Folia 26.1.2 stable build 8/Java 25 构建。
- 新增精确绑定 Luminol 26.2 build 726 stable、Java 25 的第三套构建。
- 三个产物分别为
LotteryBox-1.0.4-1.21.11.jar、LotteryBox-1.0.4-26.1.2.jar、LotteryBox-1.0.4-26.2.jar。 - 26.2 构建从指定 Paperclip 核心提取 API，并校验核心与 API SHA-256；服务端核心/API 不打入插件。
- 三个目标共用业务实现与配置格式，Folia 检测、统一调度、至少一 tick 和禁用清理路径保持不变。
1.0.3 — 2026-08-05
- 提供 Folia 1.21.11/Java 21 与 Folia 26.1.2 build 8/Java 25 两套产物。
- Shadow 插件升级至 9.6.1 以处理 Java 25 字节码。
- 记录了检测缓存、Entity/Region 至少一 tick、包装层内 Paper 调度和禁用时清理 bStats/监听器的复查。
默认 config.yml 顶部仍保留“LotteryBox 1.0.3”注释；它不是 1.0.4 的运行版本来源。
1.0.2 — 2026-07-22
- 新增
/lb clone [cancel]单次完整复制；快照包含箱名、奖池、抽奖/动画模式、价格、限制和支付配置，不包含玩家次数、钥匙或进行中状态。 - 复制快照在执行命令时冻结，一次成功后自动退出。
- 奖品预览升级为当前 54 格界面，每页 45 个奖品。
- DIRECT 扣款成功后减少不必要的余额查询，尽快回到玩家上下文启动动画。
- 引入统一 Folia/Paper 调度层、至少一 tick 边界、跨线程快照和数据写入顺序控制。
1.0.1 — 2026-07-10
- 引入每箱 DIRECT 与 KEY 双模式，新箱及旧箱迁移默认 DIRECT。
- 恢复 27 格 DIRECT 货币选择界面，并保留 27 格 KEY 钥匙购买界面；两者每页最多九种货币。
- PlayerCurrency、XConomy、Vault 改为并行探测和独立路由，支付 ID 固定为
playercurrency:<type>、xconomy、vault。 - 新增箱级支付方式、独立价格和四级价格优先级。
- 增加玩家操作 token、价格快照复核、原后端退款、钥匙退还和结果冻结流程。
历史预览描述
1.0.1 日志中的“左键抽奖箱和 /lb open 打开固定 27 格奖品预览”是该版本的历史记录。1.0.2 已把奖品预览升级为 54 格、每页 45 个；1.0.4 当前配置与源码沿用 54 格行为。不要用旧日志覆盖当前说明。
升级检查
每次升级前备份 JAR、plugins/LotteryBox/ 和经济数据，并核对：
- JAR、服务端 API 和 Java 是否匹配；
- 旧配置是否补齐新键且保留自定义值；
/lb info的模式、支付 ID、价格来源与后端状态；- 54 格预览、DIRECT、KEY、退款、背包满和玩家离线路径；
- 目标 Folia/Luminol 版本上的所有权、跨 Region 与禁用清理。