Skip to main content

⌨️ 开发者 API

MMOitemsUpgrade 为开发者提供了稳定的 API 接口，方便在其他插件中集成强化逻辑或读取数据。

🛠️ 核心 API 方法​

1. 获取装备强化等级​

这是最常用的方法，用于读取物品当前的强化级数。

// 返回 Int？, 若物品不是强化装备或无等级则返回 null 或 0
val level = UpgradeAPI.getUpgradeLevel(itemStack)

2. 还原强化属性​

有些插件（如修改 NBT 的插件）可能会导致物品属性被重置。调用此方法可以强制读取等级并重新应用属性、药水和技能。

// 返回重构加成后的 ItemStack
val newItem = UpgradeAPI.restoreUpgradeStats(itemStack)

3. 设置物品等级​

手动修改物品的强化等级（不会产生消耗）。

UpgradeAPI.setUpgradeLevel(itemStack, 10)

🔑 核心 UUID 常量​

插件使用预定义的 UUID 来管理属性修正符（StatModifiers），以防止与其他插件产生冲突：

  • NAME_SUFFIX_UUID: 控制名称后缀（[+10]）显示逻辑。
  • PERM_EFFECTS_UUID: 负责药水效果的注册与清除。
  • ABILITIES_UUID: 负责技能的动态赋予。

[!NOTE] 开发时请确保已将 MMOItemsUpgrade 添加到你的 plugin.yml 依赖列表中，以确保类路径正确加载。