Skip to main content

๐Ÿ“ˆ Upgrade Gains (Stats/Effects/Abilities)

Each level of upgrade injects more power into the equipment. Three dimensions of growth are supported.

๐Ÿ—ก๏ธ Stat Format (MMOItems Stats)โ€‹

In the config files under contents/upgrade-gains/, you can use two formats:

Scale based on the item's original base attributes.

  • Example: ATTACK_DAMAGE: "5%" (Adds 5% of base damage)
  • Supports negative values: "+3%", "-2%"

2. Flat Value Formatโ€‹

Direct additive stacking on item attributes.

  • Example: CRITICAL_STRIKE_CHANCE: 2.0 (Adds a flat 2.0 crit chance)
  • Supports negative values: 10, "+5", "-3"

๐Ÿงช Permanent Potion Effects (PERM_EFFECTS)โ€‹

Buffs obtained when holding the equipment at specific upgrade levels.

levels:
  6:
    PERM_EFFECTS:
      SPEED: 1      # Speed I
  10:
    PERM_EFFECTS:
      SPEED: 2      # Auto-upgrades to Speed II
      STRENGTH: 1   # Grants Strength I additionally

โšก Ability Rewards (ABILITIES)โ€‹

The ultimate reward for top-tier upgrades.

levels:
  10:
    ABILITIES:
      - type: FIREBOLT  # Ability ID in MMOItems
        mode: RIGHT_CLICK
        damage: 100
        cooldown: 5

๐Ÿ” Compatibility (Compat Mode)โ€‹

Configure mmoitems-upgrade-compat in config.yml:

  • TEMPLATE Mode: Stats are fully controlled by MMOItems' UpgradeTemplate. This plugin acts as the trigger for GUI and costs.
  • PLUGIN Mode: Stats are controlled by this plugin, but levels are synced to the MMOItems backend for cross-plugin compatibility.

[!CAUTION] Stat bonuses are calculated in real-time. If you modify the configuration, existing equipment will apply the new values upon next hold.