pluginiPlugin

AttributePlus

AttributePlus 插件集成，实现 Zaphkiel 物品自定义属性功能

快速开始

基本配置

在物品配置文件中，您只需要在 data 节点下添加 attribute-plus 配置即可：

plugins/Zaphkiel/item/def.yml
my_sword:
  display: sword_display
  icon: diamond_sword
  name:
    item_name: '&6传说之剑'
  data:
    attribute-plus:
      物理伤害: "10-20"
      暴击几率: "0.15"
      生命力: "50"

属性值格式

  • 固定属性值：直接写数字，如 "10"
  • 随机属性值：使用范围格式，如 "10-20"
  • 百分比属性：按 AttributePlus 标准格式，如 "0.15" 表示 15%

重要提醒

查找您的属性名称

必须使用 AttributePlus 配置文件中定义的确切属性名称。

例如：

  • ✅ 正确：物理伤害: "35"（对应 AttributePlus 中的 attack: 物理伤害）
  • ❌ 错误：damage: "35"（不匹配 AttributePlus 配置）

如何查看您的属性配置

  1. 打开您服务器的 plugins/AttributePlus/attribute.yml 文件
  2. 查看 attribute.key 节点下的各个分类
  3. 使用右侧的中文名称作为 Zaphkiel 配置中的属性名

配置示例

假设您的 AttributePlus 配置中有：

plugins/AttributePlus/attribute.yml
attribute:
  key:
    attackOrDefense:
      attack: 物理伤害
      crit: 暴击几率
    update:
      health: 生命力

那么在 Zaphkiel 中应该这样配置：

plugins/Zaphkiel/item/def.yml
warrior_sword:
  display: default_display_1
  icon: diamond_sword
  data:
    attribute-plus:
      物理伤害: "35"        # 对应 attack
      暴击几率: "0.12"      # 对应 crit
      生命力: "100"         # 对应 health

伤害叠加机制

注意：Zaphkiel 物品的属性会与原版物品属性叠加。例如：

  • 钻石剑原版伤害：7
  • Zaphkiel 物理伤害：35
  • 最终伤害：42（7 + 35）

实用配置示例

战士武器

plugins/Zaphkiel/item/def.yml
warrior_sword:
  display: warrior_display
  icon: netherite_sword
  data:
    attribute-plus:
      物理伤害: "25-35"
      暴击几率: "0.12"
      暴伤倍率: "150"
      护甲穿透: "10"

法师装备

plugins/Zaphkiel/item/def.yml
mage_staff:
  display: mage_display
  icon: blaze_rod
  data:
    attribute-plus:
      真实伤害: "20-30"
      燃烧几率: "0.25"
      燃烧伤害: "15"
      生命力: "100"

防护装备

guardian_armor:
  display: armor_display
  icon: diamond_chestplate
  data:
    attribute-plus:
      护甲值: "100-150"
      物理防御: "20-30"
      生命力: "200"
      闪避几率: "0.15"

工作机制

系统会自动处理属性应用： 2

  • 装备时：自动检测并应用物品属性
  • 卸下时：自动移除对应属性
  • 切换时：无缝更新属性值
  • 多件装备：自动叠加同类属性

使用技巧

属性分类理解

AttributePlus 将属性分为四类：

  • attackOrDefense：攻击与防御类，在战斗中实时计算
  • update：更新类，属性刷新时触发
  • runtime：运行类，每隔几秒触发一次
  • other：其他类，特殊计算逻辑

随机范围使用

使用随机范围可以增加物品的多样性：

# 固定值
物理伤害: "50"
 
# 随机范围（最小值-最大值）
物理伤害: "45-55"

常见问题解答

属性没有生效？

  1. 检查属性名称是否与 AttributePlus 配置完全一致
  2. 确认使用的是 Zaphkiel 生成的物品，而非原版物品
  3. 确认 AttributePlus 插件正常运行

属性值显示异常？ 验证数值格式是否正确，随机范围是否使用了正确的分隔符（-）。

伤害比预期高？ 检查是否考虑了原版物品的基础属性。最终伤害 = 原版基础伤害 + Zaphkiel 属性伤害。

如何查看当前属性？ 使用 AttributePlus 插件提供的命令查看玩家当前属性状态。

目录