MMMOUpgradeUser Wikiv2.0 docs
Modifiers

Stat modifiers and enchantment modifiers

stat-modifiers.yml controls how MMOItems stats change whenever an item gains or loses an upgrade level. Numeric, ranged numeric, and string range stats work in Free and Premium. Elemental stats and enchantment modifiers are Premium-only.

Operations

OperationOn UpgradeOn Downgrade
ADDAdds amountSubtracts amount
SUBTRACTSubtracts amountAdds amount
MULTIPLYMultiplies by amountDivides by amount if amount is not 0
SETSets to amountKeeps the current value

Full Example

enchantments:
  sharpness:
    operation: ADD
    amount: 1-1
    require-existing: false
    chance: 100
    min: 0
    max: 5
  fire-aspect:
    operation: ADD
    amount: 1-1
    require-existing: true
    chance: 100
    min: 0
    max: 50
  unbreaking:
    operation: ADD
    amount: 1-1
    require-existing: false
    chance: 100
    min: 0
    max: 3

stat-modifiers:
  attack-damage:
    operation: ADD
    amount: 0.5-1
  random-attack-damage:
    operation: ADD
    amount-min: 0.5-1
    amount-max: 0.5-1
  fire-damage:
    operation: ADD
    amount: 0.5-1
  fire-damage-percent:
    operation: ADD
    amount: 0.5-1
  fire-defense:
    operation: ADD
    amount: 0.5-1
  fire-weakness:
    operation: SUBTRACT
    amount: 0.5-1
  attack-speed:
    operation: SUBTRACT
    amount: 0.5-1
  critical-strike-chance:
    operation: ADD
    amount: 0.5-1
  armor:
    operation: ADD
    amount: 0.5-1
  max-health:
    operation: ADD
    amount: 0.5-1
  movement-speed:
    operation: ADD
    amount: 0.1-0.5
  max-durability:
    operation: ADD
    amount: 50-100
Premium: in Free mode, elemental entries such as fire-damage and the enchantments: section are skipped. Normal non-element entries in stat-modifiers: still work.

Key Reference

stat-id

Must be the MMOItems internal stat ID in lowercase, for example ATTACK_DAMAGE becomes attack-damage. Use /mmoupgrade stats to list registered stats.

amount

Can be fixed, such as 1, or a random range, such as 0.5-1. Ranges roll each time the modifier runs.

amount-min/amount-max

Used for range stats such as 15 - 30, allowing the lower and upper bounds to scale separately.

Element stats

Premium only. Use flattened IDs such as fire-damage, fire-damage-percent, fire-weakness, fire-defense, and fire-defense-percent. The element stat must already exist on the item.

Element ranges

Premium only. If MMOItems generated an element stat from a range, MMOUpgrade modifies the rolled value and preserves the stored lower and upper bounds. Use amount-min and amount-max to scale each bound separately.

chance

Chance for the modifier to apply, from 0 to 100. If omitted, it defaults to 100.

min/max

Clamps the value after calculation. For enchantments, min: 0 allows downgrade to remove the enchantment.

require-existing

Only for enchantments. If true, MMOUpgrade only modifies an enchantment that already exists on the item.