跳到主要内容

快速开始

下面以默认 designation.mode: ADMIN_TOOL、允许 CHEST 与 TRAPPED_CHEST 为例。所有瞄准箱子的管理命令都要求玩家准星指向六格内的目标。

1. 获取编辑工具​

管理员执行：

/lb edit

默认编辑工具是名为“抽奖箱编辑工具”的 BLAZE_ROD。手持它右键普通箱子会认定并创建 LotteryBox；右键已有 LotteryBox 会进入编辑流程。若配置改为 PLACE_WITH_TOOL，则以手持编辑工具放置允许方块作为认定入口。

2. 编辑奖池​

创建后进入编辑界面，选择 COMMON、RARE 或 EPIC 分类，再把希望发放的物品放入对应编辑格。保存后的概率不是按三个分类固定三等分，而是仅由当前非空奖池的权重决定。

  • 原版 ItemStack 会按插件当前序列化流程保存。
  • 安装 CraftEngine 后可以放入其自定义物品；发奖时仍须能成功解析奖品。
  • 上线前用 /lb open 检查预览内容，空奖池不参与随机。

3. 选择抽奖模式​

新箱默认是 DIRECT：

/lb setdrawmode <direct|key>
  • direct：玩家选择货币，扣除单次价格后开始抽奖。
  • key：玩家先购买绑定本箱的钥匙，再持钥匙抽奖。

动画方向和显示物不是抽奖模式：

/lb setanimation <上下|左右>
/lb setmode <wool|item>

4. 添加支付方式和价格​

先执行 /lb info 查看检测到的后端。然后根据实际 ID 添加支付方式并设置独立价格，例如：

/lb addcurrency xconomy
/lb setcurrency xconomy 1000

PlayerCurrency 使用 playercurrency:type 形式，例如：

/lb addcurrency playercurrency:point
/lb setcurrency playercurrency:point 10

也可以设置箱级后备基础价格：

/lb setcost 1000

完整价格优先级见货币与价格。

5. 设置运营参数​

/lb name 新手抽奖箱
/lb setlimit 10
/lb info

/lb name clear 清除箱名，/lb setlimit default 恢复全局 lottery.daily-limit，/lb setcost default 恢复使用全局价格。

6. 完成玩家闭环测试​

  1. 普通玩家左键箱子，确认打开 54 格奖品预览。
  2. DIRECT：空手右键，选择测试货币，检查扣款后进入 36 格动画。
  3. KEY：空手右键购买钥匙，再手持正确钥匙右键；确认购买本身不计抽奖次数，真正抽奖才计数。
  4. 重复检查背包满、关闭动画 GUI、持错误箱钥匙和经济余额不足。
  5. 核对获得物品、余额、每日次数、退款消息和控制台日志。

生产上线前不要只验证“能打开 GUI”。支付提交、玩家退出、后端故障与 Folia Region 上下文都需要独立验证。

最后于 更新