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

# Pets

Every pet type is **one file** in `pets/` — the file name (without `.yml`) is the pet id. The shipped `pets/dragon.yml` is a fully commented example.

## Settings

```yaml
settings:
  name: '&d&lDragon Pet'
  tier: common                  # from tiers.yml
  owner-locked: true            # only the original owner can equip it
  activation-cooldown: 30       # seconds between activations
  allow-multiple-same-type: false
  blacklist: []                 # pet ids blocked while this pet is active
  enhancement-blacklist: []     # enhancement ids this pet can never roll
  withdrawable: true
```

## Leveling

```yaml
leveling:
  max-level: 100
  xp-base: 50                   # XP needed level 0 -> 1
  xp-increase-per-level: 25     # extra XP needed per level
  sources:
    pinnaprison-break-block:
      xp: 2
      xp-increase-per-level: 0.2
    eddungeons-swing-sword:
      xp: 1
      xp-increase-per-level: 0.1
  activation-xp:                # XP granted on each activation (0 = off)
    xp: 0
    xp-increase-per-level: 0
```

Each grind action of a listed source grants `xp + xp-increase-per-level × level`. The full list of source ids is on [Leveling & Grind Sources](/p/edpets/core/leveling-sources.md).

## Buffs

```yaml
buffs:
  pinnaprison-tokens:
    base: 1.0                # +1% at level 0
    increase-per-level: 0.25 # +0.25% more per level
```

All boost values in EdPets are **percent points** (`5` = +5%). See [Buffs & Boosts](/p/edpets/core/buffs.md) for the full math (boost rolls, runes, enhancements and mastery all stack here).

## Display (the floating entity)

```yaml
display:
  name: '&d&lDragon &7[Lvl. {level}]'
  name-visible: true
  name-height: 0.9      # how far ABOVE the pet the name hovers
  small: true
  offset: 0.0           # extra height offset for this pet
  swing-on-grind: true  # react to animation profiles
  model: none           # an EdLib model id (models/<id>/) or none for a floating head
  entity: armor-stand   # armor-stand (held item + swings) or item-display (interpolated)
  head: 'texture-<base64>'
  held-item: none       # default held item (animation profiles override while grinding)
  scale: 1.0            # model / item-display pets
```

See [Display Modes & Entities](/p/edpets/core/display-modes.md) for the entity type trade-offs.

## Item

The `item` section is the pet's icon in every menu, using the standard [Item Format](/p/edpets/customization/item-format.md). Available placeholders: `{level}`, `{max-level}`, `{exp}`, `{max-exp}`, `{percent}`, `{progress-bar}`, `{owner}`, `{tier}`, `{mastery}`, `{enhancement}`, `{boost_level}`, `{boost_buff}`, `{boost_experience}`, `{runes}`.

## Bin, Fusion, Mastery

Each pet carries its own `bin`, `fusion` and `mastery` sections — documented on [Pet Bin](/p/edpets/progression/bin.md), [Fusion](/p/edpets/progression/fusion.md) and [Mastery](/p/edpets/progression/mastery.md).