奖池与概率
默认稀有度
| 稀有度 | 默认显示 | 默认权重 | 默认羊毛 | 默认玻璃 |
|---|---|---|---|---|
| COMMON | 普通 | 100 | WHITE | WHITE_STAINED_GLASS_PANE |
| RARE | 精品 | 20 | MAGENTA | MAGENTA_STAINED_GLASS_PANE |
| EPIC | 史诗 | 10 | ORANGE | ORANGE_STAINED_GLASS_PANE |
显示名、颜色、羊毛、权重和玻璃均可在 lottery.rarity.* 中调整。
概率计算
只有非空奖池参与权重总和:
某稀有度概率 = 该非空奖池权重 / 所有非空奖池权重之和
默认三档都有有效奖品时,总权重为 130:COMMON 约 76.92%,RARE 约 15.38%,EPIC 约 7.69%。如果 EPIC 为空,它不进入分母,此时 COMMON 与 RARE 分别约为 83.33% 和 16.67%。选中稀有度后,再从该分类的有效奖品中选择最终结果。
空奖池不会因为配置了正权重就产生“空气奖品”;如果所有奖池都没有可解析奖品,抽奖会在扣款或消耗钥匙前以 pool-empty 或 prize-unavailable 路径终止。
预览界面
当前 config.yml 与当前源码使用 54 格奖品预览,每页显示 45 个奖品,其余槽位用于分类、信息和翻页。玩家可以左键箱子或执行:
/lb open [player]
1.0.1 的历史更新记录曾写过“固定 27 格奖品预览”,那是旧版本说明;1.0.2 已升级为 54 格、每页 45 个,不能把旧记录当作 1.0.4 当前行为。
原版与 CraftEngine 奖品
- 原版物品按当前 ItemStack 序列化路径保存并在发奖前复制。
- CraftEngine 为软依赖;安装后可保存其标识并在抽中时重建物品。
- 如果奖品在当前环境无法解析,插件应在提交前取消,而不是扣款后发放无效内容。
- 资源包、CraftEngine 配置或服务端版本变更后,应重新打开预览并做真实抽奖测试。
发奖边界
动画开始前会冻结最终奖品。关闭 GUI 不会重新随机;玩家在动画期间退出时,冻结奖品进入箱子位置的投放路径;背包满时进入脚边掉落路径。以上是源码流程,不是对进程崩溃、磁盘损坏或第三方插件拦截掉落的无条件保证。