Skip to main content

📦 耗材系统

MMOItemsUpgrade 拥有极为精细的消耗管理和多层级的等级限制方案。

🧩 支持的材质来源 (Providers)​

你可以在 materials/ 下的配置中混合使用以下来源：

  • VANILLA: 原版物品（需提供 id）。
  • MMOITEMS: 格式 Type:ID。
  • ITEMSADDER: 对应 itemsadder-id。
  • NEXO: Nexo 插件物品。
  • MYTHICMOBS: Mythic 掉落物 ID。
  • CRAFTENGINE: 动态物品 ID。

📈 等级上限控制逻辑​

插件通过两个维度控制装备的最高强化等级：

  1. 阶级上限 (Tier Max)：在 success-rates.yml 的 tier-max-levels 中定义（如 EPIC: 16）。
  2. 特定物品上限 (Item Max)：在 item-max-levels 中定义（如 SWORD:STARTER_SWORD: 3）。

[!IMPORTANT] 计算规则：插件会同时读取物品的阶级上限和 ID 专属上限，并取两者中的最大值作为最终的强化上限。

📐 弹性成本配置示例 (levels 覆盖)​

你可以定义一个 base 基础成本，并为特定关键等级设置 levels 覆盖：

default_sword_config:
  type: SWORD
  base:              # 1-10级的通用成本
    money: 100
    materials:
      - type: VANILLA
        id: IRON_INGOT
        amount: 2
  levels:
    "5":             # 从+5升+6时的特殊成本
      money: 1000
      materials:
        - type: MMOITEMS
          id: MATERIAL:RARE_METAL
          amount: 1

进阶：多插件联动消耗案例​

你可以在同一个等级中要求玩家同时拥有多种来源的材料：

# 位于 contents/materials/mythic_weapon.yml
mythic_sword_upgrade:
  type: CUSTOM
  item-id: SWORD:MYTHIC_BLADE
  levels:
    "15":
      money: 50000
      materials:
        # 消耗 1 个 ItemsAdder 的钢锭
        - type: ITEMSADDER
          itemsadder-id: "my_pack:steel_ingot"
          amount: 1
        # 消耗 5 个 Nexo 的自定义矿石
        - type: NEXO
          nexo-id: "custom_mineral"
          amount: 5
        # 消耗 1 个 MythicMobs 的领主级掉落物
        - type: MYTHICMOBS
          mythicmobs-id: "SkeletonKingEssence"
          amount: 1
        # 消耗 2 块原版的下界合金锭
        - type: VANILLA
          id: NETHERITE_INGOT
          amount: 2

[!TIP] 配合 money (金币) 和 exp (经验) 选项，你可以打造多维度的强化准入门槛。