Item Updater

Updates the item on MM reload when ItemVersion differs. This allows you to update items when MM reloads by changing the ItemVersion. This feature is disabled by default, and requires being enabled in the:
plugins/MythicMobs/config/config-items.yml:

Configuration:
  ItemUpdating:
    Enabled: true

Additional settings, such as OnLogin and OnScroll determine when items are checked for updates.

Once enabled, this allows for the following options to be used inside items:

example_item:
  Id: stone
  ItemUpdater:
    Version: 0                # Defaults at 0
    PreserveStatRatio: true   # Defaults at true

Examples

yet_another_example_item:
  Id: diamond_sword
  ItemUpdater:
    Version: 1
    PreserveStatRatio: true
  Lore:
    - "Really really cool sword."

Once the above config is iterated to a higher version, existing copies of the item will update to reflex the new lore:

yet_another_example_item:
  Id: diamond_sword
  ItemUpdater:
    Version: 2
    PreserveStatRatio: true
  Lore:
    - "I hated the old lore so I updated it."

Preserving Item Data

An updated item is rebuilt from its new config. These settings in config-items.yml, under Configuration.ItemUpdating, choose what the rebuilt item keeps from the old one:

Setting Description Default
Preserve.Enchantments Keeps the enchantments of the old item true
Preserve.Trims Keeps the armor trim of the old item when the updated item has none true
Preserve.Level Keeps the upgrade level of the old item true
Preserve.Augments Keeps the augment slots and applied augments of the old item true
Preserve.SkillComponents Keeps the components set on the item with SetItemComponents true
Preserve.Components Data components always copied from the old item []

A preserved component keeps the old item's value even when the new config sets that component. custom_data cannot be preserved, because it holds the item's version and plugin data. Preserve.SkillComponents and Preserve.Components need Minecraft 1.21.4 or newer.

Configuration:
  ItemUpdating:
    Enabled: true
    Preserve:
      Enchantments: false
      Components:
      - custom_name
      - damage
Updated Nov 18, 2026