商店(shop)

Updated 11/18/2026

InfiniteBedWars Wiki · 商店配置(shop.yml)

文件位置:plugins/InfiniteBedWars/shop.yml 生效方式:改完后游戏内执行 /bwa reload,不用重启服务器。 商店货币 = 经验等级(捡资源点、击杀获得),不是物品也不是金币。


一、商店界面布局(6 行 54 格)

┌─────────────────────────────────────────┐
│  0   1   2   3   4   5   6   7   8      │ ← 分类图标行(快捷购买 + 各分类)
├─────────────────────────────────────────┤
│  9  10  11  12  13  14  15  16  17      │ ← 红色玻璃板分隔行(不可点击)
├─────────────────────────────────────────┤
│ 18  19  20  21  22  23  24  25  26      │
│ 27  28  29  30  31  32  33  34  35      │ ← 商品区(slot 填 18-53)
│ 36  37  38  39  40  41  42  43  44      │
│ 45  46  47  48  49  50  51  52  53      │
└─────────────────────────────────────────┘
  • 分类图标:slot 用 0-8,默认 0 是快捷购买,分类从 1 开始。

  • 商品:slot 用 18-53,同一分类内不能重复。


二、settings 全局设置

settings:
  version: 3                          # 配置版本号,插件自动迁移用,不要手改
  title: "&8经验商店"                 # 商店界面标题
  price-format: "&a%cost% 级经验"     # 商品价格显示格式,%cost% = 价格
  separator: RED_STAINED_GLASS_PANE   # 分隔行玻璃板材质

字段

作用

title

打开商店时界面顶部显示的名字,支持 & 颜色

price-format

每个商品 lore 里的价格行,%cost% 会被替换成实际价格

separator

第 2 行分隔板材质,可改成 BLACK_STAINED_GLASS_PANE 等


三、分类(categories)

categories:
  blocks:                        # 分类 ID(英文,quick-buy 引用时用)
    slot: 1                      # 分类图标位置 0-8
    name: "&6方块"               # 分类显示名
    icon: ORANGE_TERRACOTTA      # 分类图标材质
    items:                       # 该分类下的所有商品
      ...商品...

新增一个分类:复制一段改 ID、slot、name、icon 即可,例如:

  food:
    slot: 8
    name: "&a食物"
    icon: COOKED_BEEF
    items:
      steak:
        slot: 19
        cost: 6
        material: COOKED_BEEF
        amount: 4
        name: "&a牛排 x4"

四、商品字段全表

      商品ID:
        slot: 19                 # 必填,格子 18-53
        cost: 10                 # 价格(经验等级),最低 1
        material: STONE_SWORD    # 材质(Bukkit Material 名)
        amount: 1                # 数量,默认 1
        name: "&f石剑"           # 显示名,& 颜色
        lore:                    # 附加描述,可写多行
          - "&7第一行"
          - "&7第二行"
        enchants:                # 附魔列表
          - {type: sharpness, level: 20}
        effects:                 # 药水效果列表(material: POTION 时用)
          - {type: SPEED, seconds: 45, level: 2}
        unbreakable: true        # 不可破坏
        tag: fireball            # 特殊道具功能标签(见第六节)
        armor-upgrade: true      # 护甲套装(见第七节)
        tiered: true             # 分级工具(见第八节)

4.1 附魔(enchants)

        enchants:
          - {type: sharpness, level: 20}    # 一把武器可以写多个附魔
          - {type: knockback, level: 2}

常用附魔 ID:

ID

效果

ID

效果

sharpness

锋利

power

力量(弓)

knockback

击退

punch

冲击(弓)

efficiency

效率

flame

火矢

protection

保护

infinity

无限

unbreaking

耐久

fire_aspect

火焰附加

4.2 药水效果(effects)

      speed-potion:
        slot: 19
        cost: 6
        material: POTION            # 必须是 POTION
        name: "&b速度药水 (45秒 II)"
        effects:
          - {type: SPEED, seconds: 45, level: 2}
  • seconds:持续秒数;level:1 = I 级,2 = II 级,以此类推。

  • 一个 effects 列表可以写多条,做成混合药水。

常用药水 ID:SPEED(速度)、JUMP_BOOST(跳跃提升)、INVISIBILITY(隐身)、 STRENGTH(力量)、REGENERATION(生命恢复)、FIRE_RESISTANCE(抗火)、 ABSORPTION(伤害吸收)、HASTE(急迫)、WATER_BREATHING(水下呼吸)。


五、特殊道具 tag(功能由插件实现)

商品写了 tag 就拥有插件内置功能,material 只决定外观,功能看 tag。 例如把火焰弹的 material 改成 SNOWBALL,它依然是火焰弹。

tag

功能

默认外观

fireball

右键发射火焰弹,炸飞敌人

FIRE_CHARGE

bridge-egg

搭桥蛋,扔出后沿轨迹自动铺路

EGG

rescue-platform

救援平台,脚下生成一层平台自救

BLAZE_ROD

recall

回城卷轴,引导后传送回本队出生点

PAPER

tower

搭塔,原地快速升高

CHEST

defense-tower

袖珍防御塔,对地使用生成带护栏的 7x7 城堡平台把自己包住

CHEST

water-bucket

特殊水桶,水 10 秒后自动消失

WATER_BUCKET

magic-milk

魔法牛奶,清除自身药水效果

MILK_BUCKET

dream-defender

铁傀儡守卫,保护本队 120 秒

IRON_GOLEM_SPAWN_EGG

bedbug

蠹虫雪球,扔出召唤蠹虫攻击敌人

SNOWBALL

revival-bed

回春床,本队床被拆后可复原一次(每队一局一次)

RED_BED

示例:新增一个“回城卷轴”,价格 5 级:

      recall-cheap:
        slot: 36
        cost: 5
        material: PAPER
        name: "&b回城卷轴"
        tag: recall

六、护甲套装(armor-upgrade)

      iron-armor:
        slot: 20
        cost: 36
        material: IRON_BOOTS       # 材质前缀决定护甲等级
        name: "&f铁护腿/靴子(永久)"
        armor-upgrade: true

购买后的实际效果:

  • 只替换护腿 + 靴子,头盔和胸甲永远是本队颜色的皮革甲;

  • 自动穿上,不可移动、不可丢弃、不可破坏;

  • 死亡重生后保留,按已购等级重新发装;

  • material 写 _BOOTS 即可,插件按前缀(CHAINMAIL / IRON / DIAMOND / NETHERITE)生成一套。


七、分级工具(tiered)

      pickaxe:
        slot: 19
        tiered: true               # 开启分级,cost/material 写进 tiers
        tiers:
          "1":                     # 第一次购买拿到这一级
            cost: 10
            material: WOODEN_PICKAXE
            name: "&f木镐 &7(下一级: 铁镐)"
            unbreakable: true
          "2":                     # 再次购买升到这一级,以此类推
            cost: 12
            material: IRON_PICKAXE
            name: "&f铁镐 &7(效率II)"
            enchants:
              - {type: efficiency, level: 2}
            unbreakable: true
          "3":
            cost: 24
            material: DIAMOND_PICKAXE
            name: "&b钻石镐"

规则:

  • 按 "1" "2" "3"... 顺序写,每级有自己的价格、材质、附魔;

  • 玩家重复购买同一商品 = 升到下一级,满级后显示“已满级”;

  • 每级都可以写 enchants、unbreakable 等普通商品字段;

  • 想让工具更便宜/更贵,直接改对应等级的 cost。


八、快捷购买(quick-buy)

快捷购买是第 0 格分类,里面的商品只是引用,不单独定价:

quick-buy:
  slot: 0
  name: "&a快捷购买"
  icon: NETHER_STAR
  items:
    element1:  {slot: 19, category: blocks, item: wool}
    element2:  {slot: 20, category: melee, item: stone-sword}

字段

说明

slot

快捷购买界面里的格子(18-53)

category

引用哪个分类(categories 里的分类 ID)

item

引用该分类下哪个商品 ID

  • 价格、材质、功能全部跟随原商品,改原商品 = 快捷购买同步变化;

  • element1/element2... 只是键名,可随便起,不重复即可;

  • 想加一行快捷商品,复制一行改 slot 和引用即可。


九、常见修改速查

① 改价格:找到商品改 cost,例如羊毛 4 级 → 2 级:

      wool:
        slot: 19
        cost: 2
        material: WHITE_WOOL
        amount: 16
        name: "&f羊毛 x16"

② 改数量:改 amount,同时建议把 name 里的 x16 一起改掉。

③ 加一把新武器(近战分类 items 下加):

      fire-sword:
        slot: 26
        cost: 45
        material: DIAMOND_SWORD
        name: "&6烈焰之剑"
        enchants:
          - {type: sharpness, level: 5}
          - {type: fire_aspect, level: 2}
        unbreakable: true

④ 加一瓶新药水(药水分类 items 下加):

      strength-potion:
        slot: 22
        cost: 24
        material: POTION
        name: "&c力量药水 (30秒 I)"
        effects:
          - {type: STRENGTH, seconds: 30, level: 1}

⑤ 给道具加说明:加 lore 列表,颜色用 &。

改完统一执行 /bwa reload 进游戏右键商店 NPC 检查。


十、注意事项与排查

  1. YAML 缩进只能用空格(建议 2 格),不能用 Tab;{} 内联写法里逗号后要有空格。

  2. 材质名必须是 Bukkit Material(如 DIAMOND_SWORD),写错会在后台刷警告并跳过该商品。

  3. slot 冲突:同分类两个商品同格子,后读的会覆盖/异常,报错先看 slot。

  4. 商品 slot 超出 18-53、快捷购买引用了不存在的 category/item,后台会打印 shop.yml ... 开头的警告并被跳过。

  5. settings.version 是插件自动迁移标记,不要手动改,否则可能丢失自动补充的默认内容。

  6. 改完没生效 = 没执行 /bwa reload,或改的是服务端 plugins/ 之外的备份文件。

  7. 想恢复默认商店:备份后删除 shop.yml,重启服务器会重新生成默认文件(/bwa reload 只读取,不生成文件)。

Was this page helpful?