MMMOUpgradeUser Wikiv2.0 docs
Troubleshooting

Common issues

Start here when the GUI rejects an item, chances look wrong, levels are capped, or Premium features do not apply.

Stone or charm is rejected

Check that items.yml uses TYPE:ITEM_ID. The inserted item must be a real MMOItems item generated or given by MMOItems.

Item type cannot be upgraded

Add the MMOItems type to upgrade.yml allowed-types. Premium can also set MMOUPGRADE_ENABLED: true on a specific item.

Item stops at level 10

The server is probably in Free mode or the license was not verified. Free mode is capped by license-limits.free.max-level.

Chance never exceeds 75%

Free mode is capped by license-limits.free.max-success-chance. Premium uses success-chance.max-percent.

Custom stats do not work

Check Premium mode, exact stat IDs, correct value types, and whether the item was regenerated or given again after editing MMOItems config.

Element modifier does not apply

Element modifiers are Premium-only. Use flattened IDs such as fire-damage or fire-defense-percent, and make sure the element stat already exists on the item.

Enchantments are not upgraded

enchantments: is Premium-only. If Premium is active, enable debug.enchant-modifiers: true to inspect skip/apply logs.

Money is not charged

Check that charge-command works from console. {amount} must be placed where your economy plugin expects the amount.

Invalid money placeholder

money-placeholder must return a plain number. Do not use a placeholder with commas, currency symbols, or text for balance checks.

Quick Debug Checklist

  1. Run /mmoupgrade reload after editing files.
  2. Read the console to confirm whether the license is valid, expired, invalid, or unreachable.
  3. Use /mmoupgrade stats to verify stat IDs before writing stat-modifiers.yml.
  4. For element stats, confirm Premium is active and the MMOItems item has the matching element.<element>.<stat> entry before testing the upgrade.
  5. Test with a newly given MMOItems item instead of an old one after changing custom stats.
  6. Enable debug.enchant-modifiers when debugging Premium enchantment modifiers.