> 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/items/scrolls.md).

# Scrolls

Scrolls are drag-and-drop consumables applied **onto pets in the menus** — `scrolls.yml`. Each scroll has a `type` deciding what it does:

| Type     | Effect                                                                                                                       |
| -------- | ---------------------------------------------------------------------------------------------------------------------------- |
| `OWNER`  | Claims ownership of the pet (for `owner-locked` pets)                                                                        |
| `RARITY` | Transforms the pet into its `fusion.fuse-into` target (the tier ladder)                                                      |
| `LEVEL`  | Grants levels — the amount is **stored on the item** (`/pets givescroll <player> <scroll> [amount] [levels]`)                |
| `BLACK`  | Chance-based extraction of a random [rune](/p/edpets/items/runes.md) — returns the rune item on success, shatters on failure |

```yaml
scrolls:
  level:
    type: LEVEL
    blacklist: []              # pet ids this scroll can't be used on
    item:
      material: QUARTZ
      name: '&3&lPet Level Scroll &7(+{amount})'   # {amount} = stored levels
      lore:
        - '&7Drop this scroll onto a pet'
        - '&7to increase its level by &f{amount}&7!'

  black:
    type: BLACK
    success-chance: 60         # percent
    item:
      name: '&0&lBlack Scroll &7({success-chance}%)'
```

Notes:

* LEVEL scrolls respect the pet's effective max level and grant levels through the normal XP pipeline (events + messages fire).
* One item id per scroll — add as many scroll definitions as you like (e.g. multiple level-scroll tiers with different stored levels).
* The **Rarity Hunter** upgrade finds rarity/level scrolls while grinding.