跳到主要内容

安装

选择正确构建​

服务端目标插件文件Java编译 API
Folia 1.21.11LotteryBox-1.0.4-1.21.11.jarJava 21Folia 1.21.11
Folia 26.1.2LotteryBox-1.0.4-26.1.2.jarJava 25Folia 26.1.2 stable build 8
Luminol 26.2LotteryBox-1.0.4-26.2.jarJava 25Luminol 26.2 build 726 stable

不要只按文件名中的数字猜测兼容性。升级 Paper、Folia、Luminol 或 Java 后，先在测试服重新验证，再替换生产文件。

安装步骤​

  1. 停止测试服，并备份 plugins/LotteryBox/ 与原有 LotteryBox JAR。
  2. 删除或移走同插件的旧 JAR，避免同时加载多个版本。
  3. 将与服务端目标一致的 JAR 放入 plugins/。
  4. 按需安装软依赖，然后正常启动服务端。
  5. 确认控制台显示 LotteryBox 1.0.4 已启用，且没有 API、Java、类加载或经济后端异常。
  6. 执行 /lb reload 后检查经济后端重新探测结果，再创建测试箱完成一次预览、付费或钥匙抽奖。

不建议把插件热插拔工具当作重启替代。插件虽然在 onDisable 有任务、监听器和缓存清理路径，但服务端与第三方依赖的热重载契约并不一致。

软依赖​

plugin.yml 声明：

softdepend: [PlayerCurrency, Vault, XConomy, CraftEngine]
依赖用途没有安装时
PlayerCurrency多类型货币，ID 为 playercurrency:<type>不显示对应货币
XConomy原生 XConomy 余额、扣款与退款不显示 xconomy
Vault通过已注册的 Economy provider 处理余额、扣款与退款不显示 vault
CraftEngine解析和重建 CraftEngine 奖品只使用当前能解析的有效奖品

Vault 本身只是桥接层，还需要一个有效的 Vault Economy provider。若 Vault 当前 provider 就是 XConomy，界面只暴露 xconomy，不会把同一账户重复显示为 vault。

没有经济插件时​

经济后端不是插件启动的硬前置。没有可用后端时：

  • LotteryBox 仍可启动；
  • 玩家仍可查看奖品预览；
  • 已有钥匙且绑定正确箱子时仍可抽奖；
  • DIRECT 付款和 KEY 钥匙购买选项暂不可用。

后端恢复后执行 /lb reload，插件会重新探测 PlayerCurrency、XConomy 与 Vault。箱内已保存但暂不可用的支付 ID 不会仅因一次后端故障被删除。

首次健康检查​

  • /lb 能显示帮助，管理员能执行 /lb edit。
  • 普通玩家拥有 lottery.use，管理员拥有 lottery.admin。
  • /lb info 显示的支付方式、实际价格、价格来源和后端状态符合预期。
  • 左键箱子能打开当前 54 格奖品预览。
  • DIRECT 或 KEY 测试只使用小额测试账户，并同时检查扣款、次数、奖品和控制台日志。
  • Folia/Luminol 环境还应完成真实服的跨 Region、玩家离线、背包满、关闭 GUI 与后端异常测试。
最后于 更新