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

# Candy

Candy is consumable pet XP, defined in `candy.yml`:

```yaml
candies:
  common:
    xp: 10-30                       # granted XP (a fixed number or a range)
    message: '&2&l[!] &aYour pet gained &f{amount} XP&a!'   # optional
    sound: 'ENTITY_PLAYER_LEVELUP:1:2'                      # optional
    item:                           # standard item format
      material: 'texture-<base64>'
      name: '&7&lCommon Candy'
      lore:
        - '&7Drop this candy onto any pet'
        - '&7to feed it &f&l{xp} XP&7!'   # {xp} renders the range
```

## Using candy

**Drag & drop**: pick the candy up in your inventory while a pets menu is open and **drop it onto a pet** — one candy is consumed and the rolled XP applies through the normal leveling pipeline (level-ups, events, visuals). Pets at their max level refuse candy.

## Where candy comes from

* The [Pet Bin](/p/edpets/progression/bin.md) — per-pet `bin.candies` tables.
* The **Candy Finder** [upgrade](/p/edpets/progression/upgrades.md) — chance per grind action.
* Admin command: `/pets givecandy <player> <candy> [amount]`.
* Found candy is intercepted by [Candy Backpacks](/p/edpets/items/candy-backpacks.md) first (with fortune + auto-feeder effects) and only overflows into the inventory.