常见问题

没有经济后端，插件为什么仍然启动？

经济是软依赖。没有 PlayerCurrency、XConomy 或有效 Vault provider 时，预览、管理和已有正确钥匙仍能工作；DIRECT 付款与 KEY 购买暂时隐藏。后端恢复后执行 /lb reload。

后端恢复了，为什么 GUI 仍没有货币？

先执行 /lb reload，再用 /lb info 检查后端状态。GUI 只显示“当前箱已添加”且“当前可用”的支付方式；恢复后端不会自动把所有货币加入旧箱，必要时执行 /lb addcurrency。

为什么 Vault 和 XConomy 只显示一个？

若 Vault 的当前 provider 就是 XConomy，LotteryBox 只暴露 xconomy，避免同一账户被当作两种货币重复显示。

价格来自哪里？

依次检查：箱级货币独立价格、PlayerCurrency 配置价格、箱级后备基础价格、全局 lottery.cost。使用 /lb info 查看当前实际价格和来源。

持有其他箱子的钥匙会被吃掉吗？

不会进入正常消耗路径。错误箱钥匙显示 wrong-key，不转入扣款或购买。仍建议升级后用测试钥匙复核 PDC 与箱 ID。

从 KEY 切换到 DIRECT 后，已有钥匙还能用吗？

能。已有正确钥匙在两种模式都优先使用；切换模式不删除钥匙、支付方式、价格或奖池。

为什么提示奖池为空？

只有当前能解析且所在分类非空的奖品才参与。检查编辑界面、CraftEngine 是否可用、物品数据是否还能解析，并用 /lb open 查看当前 54 格预览。

背包满了会怎样？

奖品或退回钥匙会进入掉落路径，并分别显示 inventory-full-drop 或 key-inventory-full-drop。检查箱子/玩家位置的掉落保护和清理插件，不能把聊天提示当作物品最终存在的唯一证据。

关闭动画 GUI 能重新抽吗？

不能。结果在动画前冻结，关闭界面不重随机也不取消结算。玩家离线时，冻结奖品按箱子位置掉落路径处理。

出现 refund-failed 怎么办？

立即停止让玩家重复操作，保存控制台日志，核对玩家、箱坐标、支付 ID、后端、金额、次数、钥匙和奖品，再根据经济流水人工退款或补发。自动退款失败不是“再点一次”的提示。

/lb clone 后源箱改了，副本会跟着变吗？

不会。命令执行时就冻结完整配置快照。一次创建成功后待复制状态结束；使用 /lb clone cancel 可手动取消。

/lb setmode 为什么没有切换 DIRECT/KEY？

setmode <wool|item> 只切换动画显示类型。支付流程使用 /lb setdrawmode <direct|key>，动画方向使用 /lb setanimation <上下|左右>。

folia-supported: true 是否代表已经完成 Folia 压测？

不代表。它只声明可加载。当前文档提供静态审查结论；不同 Region 并发、经济故障、玩家离线和核心升级仍需在目标 Folia/Luminol 上运行时验证。