Skip to main content

MMOitemsUpgrade

MMOitemsUpgrade is an upgrade system plugin built for MMOItems equipment. It adds configurable upgrade levels, material costs, success rates, failure penalties, support scrolls, direct enhancement scrolls, player statistics, notifications, and optional integrations for common server ecosystems.

The plugin is designed for servers that want a controlled long-term equipment progression system. Administrators can define which MMOItems can be upgraded, what each level costs, how stats scale, which scrolls can modify the result, and how upgrade feedback should appear to players.

Features​

  • MMOItems equipment upgrade levels.
  • Configurable success rates and per-item or tier-based level caps.
  • Upgrade materials from vanilla items, MMOItems, ItemsAdder, Nexo, MythicMobs, and other supported providers.
  • Dynamic stat gains, permanent effects, and ability rewards.
  • GUI support scrolls for success bonuses, protection, and amplifier behavior.
  • Direct enhancement scrolls that can be dragged onto target equipment.
  • Optional hold-action minigame before the upgrade roll.
  • Failure penalties such as level drop and optional item destruction.
  • Player upgrade statistics and PlaceholderAPI placeholders.
  • AuraSkills integration for skill experience, success bonuses, and cost reduction.
  • FILE, SQLITE, and shared database storage modes.
  • Optional compatibility mode for MMOItems native upgrade data.

Requirements​

  • Paper or compatible Bukkit server.
  • Minecraft 1.20+ server API environment.
  • MMOItems installed and loaded before MMOitemsUpgrade.
  • MythicLib, as required by MMOItems.
  • Vault when economy costs are used.

Optional integrations:

  • AuraSkills
  • ItemsAdder
  • CraftEngine
  • MythicMobs
  • Nexo
  • PlaceholderAPI

File Layout​

After first startup, the plugin generates its configuration under:

plugins/MMOitemsUpgrade/

Important files:

config.yml
database.yml
contents/gui.yml
contents/success-rates.yml
contents/materials/
contents/upgrade-gains/
contents/scrolls.yml
contents/enhancement-scrolls.yml
contents/notify.yml

config.yml controls language, cooldown, storage, name suffixes, failure penalties, feedback sounds, AuraSkills settings, and MMOItems native upgrade compatibility.

contents/ contains the actual upgrade rules: GUI layout, costs, success rates, materials, stat gains, scrolls, and notification behavior.

Quick Start​

  1. Install MMOItems and its required dependencies.
  2. Put MMOitemsUpgrade into the server plugins folder.
  3. Start the server once to generate configuration files.
  4. Edit plugins/MMOitemsUpgrade/config.yml.
  5. Configure upgrade costs in contents/materials/.
  6. Configure stat gains in contents/upgrade-gains/.
  7. Run /mmoupgrade reload.
  8. Open the upgrade GUI with /mmoupgrade gui.

Use /mmoupgrade give scroll <id> [player] [amount] or /mmoupgrade give successscroll <id> [player] [amount] to issue configured scroll items.