Configuration

Main Options

Option	Description
`config-version`	Internal config version.
`language`	Message language.
`debug`	Enables detailed console debug output.
`metrics`	Enables anonymous BStats metrics.
`update-checker`	Checks for new plugin versions and notifies admins.

Supported language values:

Value	Language
`en_US`	English
`zh_CN`	Simplified Chinese
`zh_TW`	Traditional Chinese

Reforge Modes

reforge:
  allow-all-items: false
  cost: 50.0
  affix-cost: 100.0
  max-affix-reforge-count: 10
  max-quality-reforge-count: 10
  max-upgrade-attempt-count: 100
  modes:
    quality:
      enabled: true
    affix:
      enabled: true

Option	Description
`allow-all-items`	Ignores item type restrictions when enabled.
`cost`	Vault money cost for quality reforge.
`affix-cost`	Vault money cost for affix reforge.
`max-affix-reforge-count`	Maximum affix reforges per item. `0` means unlimited.
`max-quality-reforge-count`	Maximum quality reforges per item. `0` means unlimited.
`max-upgrade-attempt-count`	Maximum MMOItems upgrade attempts counted per item. `0` means unlimited.
`modes.quality.enabled`	Enables quality reforge.
`modes.affix.enabled`	Enables affix reforge.

Internal Affix System

reforge:
  use-internal-affix-system: true

When enabled, the plugin uses its configured modifier files instead of relying only on MMOItems native generation behavior.

Data Preservation

reforge:
  preserve-nbt-tags:
    - "MMOITEMS_UPGRADE"
    - "MMOITEMS_UPGRADE_LEVEL"
    - "MMOITEMS_UPGRADE_DATA"
    - "MMOitemsUpgrade"
    - "MMOITEMS_PGEM_SLOTS"
    - "MMOITEMS_GEM_STONES"
    - "MMOITEMS_GEM_SOCKETS"

Use this list for extension-plugin data that must survive reforge. Do not preserve MMOITEMS_TIER when quality reforge should reroll the item tier.

Reforge Options

reforge-options:
  keep-name: true
  keep-lore: true
  keep-enchants: true
  keep-gems: true
  keep-upgrades: true
  keep-soulbound: true
  keep-external-sh: true
  keep-skins: true

These options control which MMOItems and vanilla data should be kept during reforge.

GUI

The main GUI configuration is under reforge.gui.

Important slots:

Slot Key	Purpose
`item`	Item to reforge.
`materials`	Required material input slots.
`confirm`	Reforge confirmation button.
`info`	Current item and limit information.
`lucky`	Lucky bonus toggle.
`mode-toggle`	Switches between quality and affix mode when both are enabled.

item, confirm, info, and mode-toggle accept either a single slot number or a list of slot numbers; materials must be a list. When mode-toggle is a list, the toggle button is rendered in every listed slot.

The GUI also supports filler items, empty slot displays, enabled/disabled confirm buttons, lucky button states, mode toggle icons, and custom buttons.

Custom Buttons

reforge.gui.custom-buttons.<id> defines an extra button. action accepts a single action string or a list of action strings; actions run in the configured order.

reforge.gui.custom-buttons:
  close:
    slot: 8
    enabled: true
    material: BARRIER
    display-name: "&cClose"
    action: "close"
  example:
    slot: 0
    enabled: true
    material: PAPER
    display-name: "&eExample"
    action:
      - "console: say {player} opened the reforge menu"
      - "command: mmoreforge"
      - "close"

Action	Description
`close`	Closes the GUI.
`nothing`	Does nothing; useful for decorative buttons.
`command:<command>`	Runs a command as the player.
`console:<command>`	Runs a command from the console.

Commands support the {player} and {uuid} placeholders. When a button contains a command action, the GUI closes before the commands run.

The GUI supports these limit placeholders: {affix_count}, {affix_max_count}, {quality_count}, {quality_max_count}, {upgrade_count}, {upgrade_max_count}.

Main Options​

Reforge Modes​

Internal Affix System​

Data Preservation​

Reforge Options​

GUI​

Custom Buttons​

See Also​