Integrations and API

AuraSkills

AuraSkills integration is configured in config.yml.

auraskills:
  exp-reward:
    enabled: true
    skill: forging
    base-exp: 50.0
    exp-per-level: 10.0
  skill-bonus:
    enabled: true
    skill: forging
    bonus-per-level: 0.001
    max-bonus: 0.15
  stat-bonus:
    enabled: true
    luck-stat: luck
    luck-bonus-per-point: 0.002
    luck-max-bonus: 0.10
    wisdom-stat: wisdom
    wisdom-cost-reduction: 0.005
    wisdom-max-reduction: 0.30

Supported behavior:

Feature	Description
Skill experience	Grants configured skill experience after successful upgrades.
Skill success bonus	Adds success chance based on a configured skill level.
Luck bonus	Adds success chance from AuraSkills luck.
Wisdom reduction	Reduces money and material cost from AuraSkills wisdom.

PlaceholderAPI

When PlaceholderAPI is installed, player upgrade statistics are available through the mmoupgrade placeholder identifier.

Common placeholders include:

Placeholder	Description
%mmoupgrade_total%	Total upgrade attempts.
%mmoupgrade_success%	Successful attempts.
%mmoupgrade_failure%	Failed attempts.
%mmoupgrade_leveldrop%	Level-drop count.
%mmoupgrade_destroyed%	Destroyed item count.
%mmoupgrade_rate%	Success rate percentage.
%mmoupgrade_level_<n>%	Times the player reached level n.

Custom Item Providers

Upgrade materials can integrate with multiple item systems:

• Vanilla materials.
• MMOItems items.
• ItemsAdder items.
• Nexo items.
• MythicMobs items.
• CraftEngine where supported by the current build.

Developer API

MMOitemsUpgrade exposes API helpers for reading and restoring item upgrade data.

Get Upgrade Level

val level = UpgradeAPI.getUpgradeLevel(itemStack)

Restore Upgrade Stats

If another plugin rewrites an item and strips generated upgrade gains, rebuild the configured upgrade data:

val rebuiltItem = UpgradeAPI.restoreUpgradeStats(itemStack)

Use the API when your plugin edits MMOItems equipment after MMOitemsUpgrade has already applied levels or stat modifiers.