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

# Mastery

Mastery is pet **prestige**: once a pet reaches its required level it can prestige — level and XP reset to 0, mastery rises by one, granting permanent bonuses.

## Per-pet settings — `pets/<id>.yml`

```yaml
mastery:
  enabled: true
  max-prestige: 5
  level-boost-per-prestige: 5      # extra max levels per prestige
  xp-boost-per-prestige: 0.5       # +% pet XP per prestige
  buff-boost-per-prestige: 0.5     # +% on the pet's buffs per prestige
  requirements: {}                 # optional per-prestige required level override
  # requirements:
  #   '1': 100
  #   '2': 120
```

Without `requirements`, the required level is the pet's **effective max level**.

## Global — `mastery.yml`

```yaml
settings:
  broadcast:
    - '&b&lEdPets &8➛ &3{player} &bhas reached pet mastery &f{level} &bfor their {pet}&b!'
```

## Prestiging

In the Mastery GUI (`guis/mastery.yml`): select a pet and click the prestige button. The button exposes `{mastery}`, `{max-prestige}`, `{required-level}` and current/next bonus placeholders (`{level-boost}`, `{xp-boost}`, `{buff-boost}` + `-next` variants). Fires `PetMasteryEvent`.