QueLuckyBlock —— 方可梦幸运方块｜权重奖池｜保底｜专属捕捉

给你的方可梦服务器加一套开箱玩法！

QueLuckyBlock（鹊之幸运方块） 是面向 Cobblemon 的免费幸运方块插件。打破，开出宝可梦、物品或者自定义指令奖励。

自带保底、权重概率、专属捕捉和防刷保护。

当前版本：1.0.3
作者：山鹊
QQ 群：1101161988
下载：论坛更新可能不及时推荐加入QQ群

点击展开...

插件有什么功能？

一个文件就是一个幸运方块

自带 starter（新手）和 advanced（冒险）两个示例。

默认问号头颅

方块外观默认是橙色问号头颅，换个纹理哈希就能换皮肤。

推荐五款适合使用的头颅纹理：

三种奖励

宝可梦奖励有两种投放方式：spawn 在方块上方原地生成，party 直接进队伍、满了自动进 PC。

权重概率 + 保底

权重不用凑够 100。写 80 / 15 / 5 就是 80% / 15% / 5%，写 8 / 1.5 / 0.5 结果一样。

pity: 20 表示连续 19 次没中稀有，第 20 次只从 rare: true 的奖励里抽。保底替代当次普通抽奖。

保底进度按玩家 UUID + 方块 ID 分别记，开新手方块不会影响冒险方块的计数。默认提前开出稀有就清零，也可以关掉这个行为。

专属捕捉

exclusive-capture: true 时，方块开出来的野生宝可梦只有开箱的人能对战和投球，捕获后标记自动解除，不怕被旁边的人截胡。

配套的 owner-only: true 则限制只有放置者能打破自己的方块。

物种怎么选都行

species: ['#gen1', 伊布, '25', '1-50', cobblemon:snorlax]
exclude: [超梦, 梦幻]

中文名、英文名、命名空间 ID、图鉴号、图鉴号范围、#标签、'*'（全部已实装）可以混着写，多个条件取并集去重再排除，组内每个物种等概率。

写错的物种名、空标签、查不到结果的范围都会在校验时直接报错。

做一个幸运方块

在 plugins/QueLuckyBlock/blocks/ 下新建 eevee.yml，写入：

# 显示名称，支持 & 颜色码
name: '&d伊布幸运方块'

# 20 次内必出稀有
pity: 20

rewards:
  normal:
    name: 普通伊布
    weight: 95
    species: [伊布]
    level: 10-20
  shiny:
    name: 闪光伊布
    weight: 5
    rare: true
    species: [伊布]
    shiny: 100
    perfect-ivs: 3

保存后执行：

/qlb validate
/qlb reload
/qlb give 你的ID eevee 5

方块 ID 就是文件名 eevee。没写 material 默认就是橙色问号头颅，没写 delivery 默认原地生成。

也可以用 /qlb create eevee 直接复制一份模板并立即加载，不会覆盖已有文件。

注意用空格缩进，不要用 Tab。 改完先校验再重载。

方块本身的设置

奖励怎么写

所有奖励都能用这四个：

宝可梦奖励（type 不写就是它）：

  friends:
    name: 初代伙伴
    weight: 80
    species: ['#gen1', 伊布]
    exclude: [超梦, 梦幻]
    level: 10-30
    shiny: 2.5          # 百分比，2.5 就是 2.5%
    perfect-ivs: 2-3    # 至少几项个体值为 31
    tradeable: true
    delivery: spawn     # spawn 原地生成 / party 直接进队伍

• level：1～100 的整数，或者 10-30 这样的范围，默认 10-30。
• shiny：0～100 的百分比，默认 0；100 就是必闪。
• perfect-ivs：0～6，表示至少几项个体值拉满 31，其余正常随机，默认 0。
• delivery: party 会在开箱前检查空间，队伍和 PC 都满时保留方块不消耗。
• delivery: spawn 需要方块上方有地方站得下，别在窄小房间里放会开出大型宝可梦的方块。

物品奖励：

  balls:
    name: 精灵球补给
    type: item
    weight: 20
    item: cobblemon:poke_ball
    amount: 8

指令奖励：

  bonus:
    name: 经验奖励
    type: command
    weight: 10
    commands:
      - 'experience add {player} 100 points'
      - 'say {player} 开出了大奖'

以控制台身份按顺序执行，只支持 {player} 和 {uuid} 两个占位符。

全局设置

plugins/QueLuckyBlock/config.yml

# 在这些世界里禁止放置和开启
disabled-worlds: []

# 同一玩家两次开箱的间隔毫秒数
cooldown-ms: 500

# 单个玩家同时能放置多少个未打破的幸运方块
max-placed-per-player: 128

# 创造模式可以无限复制物品，默认不允许放置和开启
allow-creative: false

常用命令与权限

普通玩家默认拥有 queluckyblock.use；管理权限 queluckyblock.admin 默认仅 OP。

queluckyblock.bypass-owner 默认谁都没有，包括 OP，单独授予后可以开启别人放置的方块，奖励和保底算在实际开箱的人头上。

装了 PlaceholderAPI 的话还有这几个变量：%qlb_total%、%qlb_opened_<ID>%、%qlb_pity_<ID>%（累计未重置次数）、%qlb_remaining_<ID>%（距离保底还差几次，关闭保底时为 0）。

常见问题

需要装 Vault 或 PlaceholderAPI 吗？
都不需要。只有要用 PAPI 变量时才装 PlaceholderAPI。

别人能抢我开出来的宝可梦吗？
exclusive-capture: true 时不能，投球和进对战都会被挡下，抓到后标记自动解除。

反馈

如遇到问题，欢迎在帖子下反馈：服务端类型与版本、加载器、Cobblemon 版本、插件版本、复现步骤和相关报错日志。涉及配置问题时，可以附上对应的方块 YAML 文件。（推荐加入QQ群直接反馈 论坛消息不一定能看到）