📦 Material & Cost System

MMOItemsUpgrade features a highly granular cost management and multi-layered level limit system.

🧩 Supported Material Sources (Providers)

You can mix and match materials from the following sources in materials/:

• VANILLA: Vanilla items (ID required).
• MMOITEMS: Format Type:ID.
• ITEMSADDER: Corresponding itemsadder-id.
• NEXO: Nexo plugin items.
• MYTHICMOBS: MythicMobs item ID.
• CRAFTENGINE: Dynamic item IDs.

📈 Level Limit Logic

The plugin controls the maximum upgrade level via two dimensions:

1. Tier Max: Defined in tier-max-levels of success-rates.yml (e.g., EPIC: 16).
2. Item Max: Defined in item-max-levels (e.g., SWORD:STARTER_SWORD: 3).

[!IMPORTANT] Calculation Rule: The plugin reads both the Tier limit and the ID-specific limit and takes the maximum of the two as the final upgrade cap.

📐 Flexible Cost Configuration (levels Override)

You can define a base cost and override specific levels in levels:

default_sword_config:
  type: SWORD
  base:              # Common cost for levels 1-10
    money: 100
    materials:
      - type: VANILLA
        id: IRON_INGOT
        amount: 2
  levels:
    "5":             # Special cost for level 5 -> 6
      money: 1000
      materials:
        - type: MMOITEMS
          id: MATERIAL:RARE_METAL
          amount: 1

---

[!TIP] Combine with money (Vault) and exp (Vanilla/AuraSkills) for multi-dimensional costs.