FKEscape / DOCS

Appearance

buffs.yml：战术增益 ​

增益 ID 由商店物品或战利品的 buff 字段引用。使用对应材料时，FKEscape 给玩家应用一组原版药水效果。

字段参考 ​

路径类型含义与约束生效
buffs.<id>配置段ID 应稳定且唯一热重载
buffs.<id>.effects[]EFFECT:等级:tickBukkit PotionEffectType；等级为程序传入的 amplifier；tick 为持续时间热重载；进行中的局也使用新定义

一秒为 20 tick；1200 即 60 秒。一个 ID 可包含多个效果。引用校验会确保 loot.yml 使用的 buff 存在；商店 buff 分类通常用同名 ID 和材料交付。

完整默认配置 ​

yaml
buffs:
  speed:
    effects:
      - "SPEED:1:1200"
  strength:
    effects:
      - "STRENGTH:1:1200"
  resistance:
    effects:
      - "DAMAGE_RESISTANCE:1:1200"
  adrenaline:
    effects:
      - "SPEED:1:600"
      - "FAST_DIGGING:1:600"

常见错误与验证 ​

  • 不要把持续时间写成 60s；这里必须是整数 tick。
  • 药水名必须是服务端版本可识别名称。等级是否从 0 计数以 Bukkit amplifier 语义为准。
  • 重载后用测试物品触发每个 ID，检查效果种类、显示等级、持续秒数；无效增益应不消耗物品并提示失败。