Reforge System

Quality Reforge

Quality reforge rerolls item tier and applies stat modifiers from tier.yml.

tiers:
  rare:
    display-name: "&bRare"
    weight: 15
    name-prefix: "&b"
    tooltip-style: "minecraft:rare"
    stat-modifiers:
      ATTACK_DAMAGE: 4
      ATTACK_SPEED: 2
      CRITICAL_STRIKE_CHANCE: 5

Tier IDs are case-insensitive in tier.yml and are normalized to uppercase for MMOItems.

Tier Weights

weight controls how often a tier is selected. Higher weight means more common.

Example:

Tier	Weight	Result
common	50	Most common.
rare	15	Less common.
legendary	1	Very rare.

Tier Stat Modifiers

Stat modifiers support flat values and percentage values.

stat-modifiers:
  ATTACK_DAMAGE: 5
  ATTACK_SPEED: "10%"

Current versions also support type-specific tier stat modifiers, allowing different MMOItems types to receive different reforge stats.

Drop Effects

Each tier can configure optional drop effects:

drop-effect:
  glow: true
  glow-color: "AQUA"
  show-name: true
  vfx:
    enabled: true
    material: "POTION"
    model-data: 1
    color: "#55FFFF"

These effects are used when reforged items are dropped and the relevant listener is active.

Affix Reforge

Affix reforge rerolls item modifiers or affixes. It can use the internal affix system when reforge.use-internal-affix-system is enabled.

The item can be limited with:

reforge:
  max-affix-reforge-count: 10

When the item reaches this limit, the GUI should prevent further affix reforge and avoid consuming money, materials, or lucky points.

Per-Item Limits

Quality reforge and MMOItems upgrade attempts can also be limited per item:

reforge:
  max-quality-reforge-count: 10
  max-upgrade-attempt-count: 100

max-quality-reforge-count limits how many times an item can be quality-reforged. max-upgrade-attempt-count counts both successful and failed MMOItems upgrade attempts on the item.

Lucky Points

The lucky system can grant points after reforges and consume them for better quality outcomes.

reforge:
  lucky-system:
    enabled: true
    gain-per-reforge:
      min: 1
      max: 5
    min-lucky-required: 20

Quality bonus ranges are configured under quality-bonus-by-lucky. When the player enables the lucky bonus, accumulated points are consumed and the matching bonus range is applied.

Reforge Materials

Material rules are stored in:

reforge-materials/

Examples:

SWORD:
  materials:
    - type: VANILLA
      id: IRON_INGOT
      amount: 5
      display-name: "&fIron Ingot"

SWORD:EXCALIBUR:
  item-id: "SWORD:EXCALIBUR"
  materials:
    - type: MMOITEMS:MATERIAL
      id: MAGIC_DUST
      amount: 10
      display-name: "&dMagic Dust"

Supported material formats include vanilla items and MMOItems material types such as MMOITEMS:MATERIAL, MMOITEMS:CONSUMABLE, and MMOITEMS:GEM.