🔍Custom Item Match Method

Default Item Match Method

Vanilla Items

By default, we support two item price match method, they are:

  • Bukkit: This match method require inventory's item must 100% same as the price item, if the item player has changed some thing, it can not be matched anymore. For example, add enchantments or change item name in anvil, they will change item's NBT info.

  • ItemFormat: ItemFormat can set ignore list of item's vanilla NBT. If you add enchants and name in ignore list, then player can still use this item as price even the item has more enchantments or changed item name.

Example config:

item-price:
  # Support Value: Bukkit or ItemFormat.
  # For each product, you can add match-item section to make custom match method, for more info, please view Wiki.
  check-method: Bukkit
  # Only support ItemFormat match method.
  item-format:
    require-same-key: false
    ignore-key:
      - 'lore'
      - 'damage'
      - 'enchants'
      - 'tool.damage-per-block'
      - 'nbt.CustomNBTKey'

For options in item-format section:

  • require-same-key: This means that the items in the shop must have all the data of the items owned by the player.

  • ignore-key: The list of ItemFormat™ Key that will be ignored when check whether items are same.

You can parse the ItemFormat of a handheld item by using the command /fc generateeitemformat, and the key can also be indented. For example, if you only want to ignore the sharpness enchantment and do not want to ignore other enchantments, you can fill in enchants.sharpness in ignore-keys option instead of enchants.

Third-plugin Item

Items generated by Supported Plugins will auto parse it's Item ID and compare it with the item ID you set in Item Format's hook-item option, so no matter how it changes, it will eventually match normally.

Custom Match Method for each product - Require MythicChanger

Although the ItemFormat method described above solves the problem of items being modifiable, its flexibility is still insufficient. Therefore, this feature can help you set custom price match modes for each item price.

You can add a match-item section in the configuration of each price, which means that if the item meets this matching rule, it is considered match.

This feature require your server must install MythicChanger plugin, please get it here:

FREE: Click to download

PREMIUM: Click to download

For how to configure the match-item section, please read MythicChanger's wiki, click here to visit. Please note that some of the match rules require PREMIUM version of MythicChanger.

An example product config can be found at this page.

Last updated