License

Free vs Premium

Free mode keeps the basic upgrade system usable. Premium unlocks full limits, per-item overrides, elemental stat upgrades, and enchantment upgrades.

Feature Matrix

Feature	Free	Premium
GUI, upgrade stones, lucky charms, protect charms	Available	Available
Maximum item level	Limited by `license-limits.free.max-level`	Uses `max-level` and `MMOUPGRADE_MAX_LEVEL`
Maximum success chance	Limited by `license-limits.free.max-success-chance`	Uses `success-chance.max-percent`
Per-item custom stats	Ignored except `MMOUPGRADE_LEVEL`	Available
Upgrade element stats from `stat-modifiers.yml`	Not applied	Available
Upgrade enchantments from `stat-modifiers.yml`	Not applied	Available
Custom formulas for stone/lucky/protect chance	Not available	Available

License Config

# config.yml
license-key: ""

debug:
  enchant-modifiers: false

An empty license-key runs Free mode. With a valid key, startup or reload logs that the Premium license was verified.

# upgrade.yml
license-limits:
  free:
    max-level: 10
    max-success-chance: 75

Premium modifiers: element stat modifiers and the enchantments: section in stat-modifiers.yml only run when licenseManager().isPremium() is true. Normal non-element stat modifiers still run in Free mode.