> 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/for-ultimatequest/configuration/custom-items.md).

# Custom Items

Every `.yml` file in `plugins/UltimateQuest/items/` defines a reusable item. The file name without `.yml` is its ID. Save an item once, then use its ID in rewards and other item configurations.

## Creating an item

Hold the item in your main hand and run:

```
/uq saveitem survey_pickaxe
```

The item is saved to `items/survey_pickaxe.yml`. By default it uses Bukkit serialization to preserve the item. To save editable [ItemFormat™](/for-ultimatequest/shared-formats/itemformat-tm.md) fields instead, use:

```
/uq saveitem survey_pickaxe itemformat
```

You can also create the file manually:

```yaml
enabled: true
base-item:
  material: IRON_PICKAXE
  name: '&bSurvey Pickaxe'
  lore:
    - '&7A reward for your first expedition.'
```

## Fields

| Field       | Default  | Description                               |
| ----------- | -------- | ----------------------------------------- |
| `enabled`   | `true`   | Whether this item can be loaded and used. |
| `base-item` | Required | The ItemFormat used to create the item.   |

Names, lore, enchantments, and supported item components use ItemFormat. To modify an item during creation, put a `change-item` section inside `base-item`; see [Change Item Format](/for-ultimatequest/shared-formats/change-item-rules.md).

## Giving saved items

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

The first command gives the item to yourself. The second gives two copies of the saved stack to the online player Steve. The amount multiplies the saved stack size: saving a stack of 8 and giving an amount of 2 gives 16 items. The console must specify an online player.

## Using an item in a reward

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

## Generating ItemFormat

```
/uq generateitemformat
```

This exports your main-hand item to `plugins/UltimateQuest/generated-item-format.yml`. It does not create an item in `items/`. Each export replaces the previous export file. Copy the fields into a reward's `item` section or a saved item's `base-item` as needed.

After manually editing an item file, run `/uq reload` before testing. Command permissions are listed in [Commands & Permissions](/for-ultimatequest/information/commands-permissions.md).