Setup

Install MMOUpgrade

Install the required dependencies first, start the server once to generate configs, edit the files, then reload the plugin.

Requirements

Server

Paper or Folia. Java 21 is recommended, with a server version matching the build you are using.

Required Plugins

MMOItems and MythicLib are required. PlaceholderAPI is needed for economy placeholders in the GUI.

Source Items

Upgrade stones, lucky charms, and protect charms must be MMOItems items registered in items.yml.

Install Flow

Copy the MMOUpgrade jar into the server plugins/ folder.
Make sure MMOItems, MythicLib, and PlaceholderAPI are installed and load correctly.
Start the server once so MMOUpgrade can generate its config files.
Stop the server or run /mmoupgrade reload after editing configs.
Use /mmoupgrade upgrade in game to open the GUI and test an upgrade.

Generated Files

plugins/MMOUpgrade/
  config.yml
  commands.yml
  gui.yml
  items.yml
  upgrade.yml
  stat-registration.yml
  stat-modifiers.yml
  announcements.yml
  message.yml

Important: keep stat IDs in stat-registration.yml stable after items are created. MMOItems stores stat data in NBT based on those IDs.