> For the complete documentation index, see [llms.txt](https://edseries-plugins.gitbook.io/p/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://edseries-plugins.gitbook.io/p/edpets/customization/item-format.md).

# Item Format

Every configured item in EdPets (GUI buttons, pet icons, candy, scrolls, runes, boxes, backpacks) shares one format:

```yaml
material: DIAMOND          # a Material name, texture-<base64> or head-<playerName>
amount: 1
name: '&b&lMy Item'
lore:
  - '&7Line one'
  - ''
glow: false                # enchant glint
custom-model-data: -1      # resource pack CMD (-1 = none)
unbreakeable: true
```

## Materials

* `DIAMOND_SWORD` — any Bukkit material.
* `texture-eyJ0ZXh0dXJlcyI6...` — a custom head from a base64 skin texture (grab them from minecraft-heads.com → *Other* → *Value*).
* `head-{player}` — the viewer's own head (any player name works).

## Text

* Legacy colors `&a` and hex `&#RRGGBB`.
* **PlaceholderAPI** everywhere.
* Context `{placeholders}` (each feature documents its own).
* `\n` inside a lore line splits it into multiple lines — used by expanding placeholders like `{modes}`, `{runes}` and `{upgrades}`.