LotteryBox
LotteryBox 1.0.4 提供 DIRECT 直接扣款与 KEY 钥匙两种抽奖模式、加权奖池、多经济路由、动画、全息和箱级管理。功能描述以当前源码、资源和构建文件为准；销售文案只作为功能线索，不作为兼容性或安全承诺。
版本与环境
| 项目 | 当前值 |
|---|---|
| 插件版本 | 1.0.4 |
| Minecraft/API | 1.21.11、26.1.2、26.2 |
| Java | Java 21 或 Java 25，取决于构建目标 |
| 目标服务端 | Folia 1.21.11、Folia 26.1.2 stable build 8、Luminol 26.2 build 726 |
| 经济软依赖 | PlayerCurrency、XConomy、Vault |
| 自定义物品软依赖 | CraftEngine |
Folia 证据边界
folia-supported: true 只允许 Folia 加载插件，不等同于线程安全证明。当前文档记录的是针对 1.0.4 源码和上述目标核心的静态审查；真实服压力、断电、经济插件故障与核心升级仍需单独做运行时验证。详情见 Folia 与 Luminol。
主要能力
- 每个箱子独立选择 DIRECT 或 KEY 抽奖流程。
- COMMON、RARE、EPIC 三档非空奖池按权重参与随机。
- PlayerCurrency、XConomy、Vault 独立探测并按箱配置支付方式。
- 54 格奖品预览、27 格支付界面与 36 格抽奖动画。
- 箱名全息、音效、全服播报、每日次数和额外次数。
- 箱级完整配置快照复制，并提供支付 token、退款和钥匙退还路径。
作者与源码状态
作者为 cloudfl4re。LotteryBox 为闭源付费项目，不提供公开源码仓库。