> For the complete documentation index, see [llms.txt](https://spintowin.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/gong-neng/custom-item-match-method.md).

# 🔍自定义物品匹配

## 默认匹配方式

### 原版物品

物品价格支持两种匹配方式：

* **Bukkit**：要求玩家背包物品与价格物品一致。添加附魔、在铁砧改名等操作会改变物品数据，可能导致匹配失败。
* **ItemFormat**：通过物品格式比较数据，可以忽略指定字段。例如忽略附魔和名称后，玩家仍可使用附魔或改名后的物品支付价格。

配置示例：

```yaml
item-price:
  # 可选值：Bukkit 或 ItemFormat。
  # 可在单个价格中通过 match-item 自定义匹配规则。
  check-method: Bukkit
  # 仅 ItemFormat 匹配方式使用。
  item-format:
    require-same-key: false
    ignore-key:
      - 'lore'
      - 'damage'
      - 'enchants'
      - 'tool.damage-per-block'
      - 'nbt.CustomNBTKey'
```

`item-format` 中的选项：

* `require-same-key`：控制匹配时对物品格式字段一致性的要求。
* `ignore-key`：匹配时忽略的物品格式字段列表。

使用 `/s2w generateitemformat` 可将手持物品解析到 `generated-item-format.yml`，据此查找字段名称。字段可以通过点号指定子项，例如只忽略锋利附魔时填写 `enchants.sharpness`，而不是忽略整个 `enchants`。

### 第三方插件物品

[支持的物品插件](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/ji-ben-xin-xi/compatibility.md)会通过其物品 ID 与 `hook-item` 匹配，因此即使名称、Lore 等外观数据改变，也可继续识别。

## 为单个价格指定匹配规则

此功能需要安装 **MythicChanger**。在单个价格中添加 `match-item`，符合该规则的物品即可用于支付。

* [MythicChanger 免费版](https://www.spigotmc.org/resources/mythicchanger-match-and-modify-all-your-items-without-trouble-1-14-1-21.98523/)
* [MythicChanger 高级版](https://www.spigotmc.org/resources/mythicchanger-premium-match-and-modify-all-your-items-without-trouble-1-14-1-21.115913/)

规则详见 [MythicChanger 匹配文档](https://mythicchanger.superiormc.cn/configs/match-item)。部分规则需要 MythicChanger 高级版。

完整价格示例见[价格配置](https://spintowin.superiormc.cn/jian-ti-zhong-wen-2/zhuan-pan-ui/ui-pei-zhi/jia-ge-pei-zhi.md)。
