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
OnLoginandOnScrolldetermine 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