> For the complete documentation index, see [llms.txt](https://enchantedmobs.superiormc.cn/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://enchantedmobs.superiormc.cn/ultimatequest-zhong-wen-wen-dang/pei-zhi/custom-items.md).

# 自定义物品

`plugins/UltimateQuest/items/` 中的每个 `.yml` 文件定义一件可复用物品，去掉 `.yml` 的文件名就是物品 ID。保存一次后，即可在奖励等物品配置中通过 ID 使用它。

## 创建物品

把需要保存的物品拿在主手，执行：

```
/uq saveitem survey_pickaxe
```

物品会保存到 `items/survey_pickaxe.yml`。默认使用 Bukkit 序列化保存物品；如果希望保存为便于编辑的 [ItemFormat™](/ultimatequest-zhong-wen-wen-dang/gong-gong-ge-shi/itemformat-tm.md) 字段，请使用：

```
/uq saveitem survey_pickaxe itemformat
```

也可以手动创建文件：

```yaml
enabled: true
base-item:
  material: IRON_PICKAXE
  name: '&b勘探镐'
  lore:
    - '&7完成首次探险的奖励。'
```

## 配置项

| 字段          | 默认值    | 说明                     |
| ----------- | ------ | ---------------------- |
| `enabled`   | `true` | 是否加载并允许使用该物品。          |
| `base-item` | 必填     | 创建物品使用的 ItemFormat 配置。 |

名称、Lore、附魔和支持的物品组件均使用 ItemFormat。如需在生成时修改物品，可在 `base-item` 内加入 `change-item`，详见[物品修改格式](/ultimatequest-zhong-wen-wen-dang/gong-gong-ge-shi/change-item-rules.md)。

## 发放已保存物品

```
/uq givesaveitem survey_pickaxe
/uq givesaveitem survey_pickaxe Steve 2
```

第一条命令发给自己，第二条向在线玩家 Steve 发放两份已保存物品。数量参数会乘以保存时的堆叠数量：如果保存了 8 个物品，再发放 2 份，就会得到 16 个。控制台执行时必须指定在线玩家。

## 在奖励中使用

```yaml
rewards:
  pickaxe:
    type: item
    item:
      material: survey_pickaxe
      amount: 1
```

## 生成 ItemFormat

```
/uq generateitemformat
```

将主手物品导出到 `plugins/UltimateQuest/generated-item-format.yml`，不会在 `items/` 中创建物品。每次导出都会覆盖上一次的导出文件。可以根据需要将其中的字段复制到奖励的 `item` 或已保存物品的 `base-item` 中。

手动修改物品文件后，请先执行 `/uq reload` 再测试。命令权限见[命令与权限](/ultimatequest-zhong-wen-wen-dang/ji-chu-xin-xi/commands-permissions.md)。