团队升级(Upgrade)

Updated 11/18/2026

InfiniteBedWars Wiki · 团队升级配置(upgrades.yml)

文件位置:plugins/InfiniteBedWars/upgrades.yml 生效方式:改完后游戏内执行 /bwa reload,不用重启服务器。 打开方式:对局内右键团队升级 NPC(/bwa setnpc <房间> upgrade 放置)。 货币 = 背包里的物品(默认钻石),和经验商店(经验等级)是两套独立经济。


一、界面与购买逻辑

  • 升级界面 54 格,每个升级项只占 1 个格子(slot 0-53 自由摆放)。

  • 格子里只显示下一级的图标、名称、价格;买完后同一格子自动变成再下一级。

  • 满级后显示“已满级”;lore 里会显示“当前等级: x/上限”。

  • 界面标题实时显示你背包里的货币数量,例如 团队升级 (钻石: 3)。

  • 购买是全队共享:一人购买,全队在线成员立即生效,并对全局播报。


二、settings 货币设置

settings:
  currency: DIAMOND        # 货币材质(Bukkit Material 名)
  currency-name: 钻石       # 显示名(界面标题、价格 lore、提示语)

例如想改成绿宝石经济:

settings:
  currency: EMERALD
  currency-name: 绿宝石

货币是实物扣减:购买时从玩家背包逐格扣除对应数量的物品。 改货币后,玩家需要用新货币(默认去资源点捡)才能购买。


三、升级项结构

upgrades:
  sharpness:                       # 升级 ID(英文,唯一)
    slot: 10                       # 界面格子 0-53
    effect: SHARP                  # 效果类型(见第四节)
    icon: IRON_SWORD               # 兜底图标(某级没写 material 时用)
    levels:                        # 等级表,从 1 开始连续递增
      1: { cost: 1, name: "&c锋利 I",   material: IRON_SWORD, amount: 1 }
      2: { cost: 2, name: "&c锋利 II",  material: IRON_SWORD, amount: 2 }
      3: { cost: 3, name: "&c锋利 III", material: IRON_SWORD, amount: 3 }
      4: { cost: 4, name: "&c锋利 IV",  material: NETHERITE_SWORD, amount: 4 }

每级字段

字段

作用

cost

该级价格(货币数量),逐级独立定价

name

该级显示名,支持 & 颜色

material

该级图标材质,不写则用升级项的 icon

amount

图标堆叠数量,一般填等级数,让玩家一眼看出是几级

升级项级字段

字段

必填

作用

slot

是

界面格子 0-53,不能和其他升级冲突

effect

是

SHARP / PROT / POTION / MAX_HEALTH / FURNACE / TRAP

potion

POTION 时

药水效果 ID,如 HASTE、SPEED

health-bonus

MAX_HEALTH 时

每级提供的额外血量(4.0 = 2 颗心)

icon

否

兜底图标材质


四、6 种 effect 效果详解

1. SHARP — 全队锋利

  • 每买一级,全队所有人背包里所有的剑锋利 +1(叠加在武器原有附魔上)。

  • 之后在经验商店新买的剑也会自动附加当前团队锋利等级。

  • 例:金剑本身锋利 20,团队锋利 II 后变成锋利 22。

2. PROT — 全队保护

  • 每买一级,全队身上穿的盔甲(头盔/胸甲/护腿/靴子)保护 +1。

3. POTION — 全队常驻药水

  haste:
    slot: 12
    effect: POTION
    potion: HASTE            # 药水类型
    icon: GOLDEN_PICKAXE
    levels:
      1: { cost: 1, name: "&e急速挖掘 I", material: WOODEN_PICKAXE, amount: 1 }
      2: { cost: 2, name: "&e急速挖掘 II", material: IRON_PICKAXE, amount: 2 }
  • 等级 N = 药水 N 级(1 级 = I,2 级 = II),无限时长、无粒子。

  • 死亡重生后依然保留。

  • 常用 ID:HASTE(急迫)、SPEED(速度)、STRENGTH(力量)、 RESISTANCE(抗性提升)、REGENERATION(生命恢复)、FIRE_RESISTANCE(抗火)。

4. MAX_HEALTH — 全队生命提升

  heal:
    slot: 14
    effect: MAX_HEALTH
    health-bonus: 4.0        # 额外血量,20 = 10 颗心;4.0 = 2 颗心
    icon: GOLDEN_APPLE
    levels:
      1: { cost: 1, name: "&d生命提升 I", ... }
      2: { cost: 2, name: "&d生命提升 II", ... }
      3: { cost: 3, name: "&d生命提升 III", ... }
  • health-bonus 是整个升级项共用的数值:升到任意已购等级,就加这么多血 (取已购等级中的最大值,不是逐级累加)。

  • 想要“每级加得更多”,需要拆成多个 MAX_HEALTH 升级项,或保持单值让等级只解锁购买次数。

5. FURNACE — 熔炉加速

  • 每级让本队出生点最近的铁、金资源点刷新间隔 -20%(基于原始秒数): 1 级 -20%、2 级 -40%、3 级 -60%、4 级 -80%。

  • 只影响铁和金两类资源点,钻石/绿宝石不受影响。

  • 资源点的基础间隔在 generators.yml 里配置。

6. TRAP — 陷阱入口

  • 这个升级项本身不升级,点击后打开独立的陷阱购买界面。

  • levels 里保留一级用于定义入口图标和名字即可。


五、陷阱机制(代码内置,不在 yml 里)

陷阱

效果

持续

挖掘疲劳

触发者挖掘疲劳

10 秒

失明

触发者失明

10 秒

发光显形

触发者发光(破隐身)

15 秒

全队急速+跳跃

本队全员速度 II + 跳跃 II

15 秒

规则:

  • 触发条件:敌人进入本队床周围 15 格(config.yml 的 game.trap-trigger-radius 可调)。

  • 队列机制:最多囤积 3 个陷阱,先买的先触发,触发一个后才可再补。

  • 价格递增:第 1 个 1 钻、第 2 个 2 钻、第 3 个 3 钻。

  • 触发时本队收到提示与音效,触发者也会收到警告。

  • 陷阱种类、持续时间、图标是代码固定的,改 yml 不会变;触发半径可以在 config.yml 改。


六、默认升级一览

升级 ID

效果

级数

价格(每级)

sharpness

全队锋利

4

1 / 2 / 3 / 4 钻

protection

全队保护

4

1 / 2 / 3 / 4 钻

haste

全队急迫

2

1 / 2 钻

speed

全队速度

2

1 / 2 钻

heal

全队生命提升(+4 血)

3

1 / 2 / 3 钻

furnace

铁金资源加速

4

1 / 2 / 3 / 4 钻

trap

陷阱购买入口

—

1 / 2 / 3 钻(按持有数)


七、常见修改示例

① 改价格

把锋利 IV 从 4 钻改成 8 钻:

      4: { cost: 8, name: "&c锋利 IV", material: NETHERITE_SWORD, amount: 4 }

② 加一级(锋利 V)

在 sharpness.levels 里追加:

      5: { cost: 8, name: "&c锋利 V", material: NETHERITE_SWORD, amount: 5 }

等级上限自动变成 5,无需改其他地方。

③ 新增一个药水升级(全队力量)

在 upgrades: 下加一段,slot 用空格:

  strength:
    slot: 19
    effect: POTION
    potion: STRENGTH
    icon: BLAZE_POWDER
    levels:
      1: { cost: 4, name: "&c力量 I", material: BLAZE_POWDER, amount: 1 }

④ 调整生命提升数值

把每级额外血量从 2 颗心改成 5 颗心:

  heal:
    effect: MAX_HEALTH
    health-bonus: 10.0

⑤ 删掉某个升级

把 upgrades: 下对应的整段删除即可,/bwa reload 后界面不再显示。


八、注意事项与排查

  1. 等级必须从 1 开始连续写(1、2、3…),插件按数字排序取“当前等级+1”显示下一级。

  2. slot 范围 0-53,重复或越界会在后台打印 upgrades.<id>: 缺少合法的 slot,已跳过。

  3. effect 写错(如写成 sharp 小写以外的非法词)会提示“未知 effect”并跳过;其实大小写不敏感,但必须是 6 种之一。

  4. amount 只影响图标显示数量,不影响实际效果,建议填等级数。

  5. 材质、药水 ID 写错会在后台刷 upgrades.yml 相关警告。

  6. 改完不生效 = 没执行 /bwa reload。

  7. 已购买的升级当局有效,新一局重置;改配置不影响已经开始的这一局的已购等级。

  8. 恢复默认:备份后删除 upgrades.yml,重启服务器重新生成(/bwa reload 只读取不生成)。

Was this page helpful?