> 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/edcompanions/features/upgrades.md).

# Upgrades

`upgrades.yml` defines player-wide upgrades bought in the upgrades GUI. Two mechanic types:

* `type: luck` — each level adds `chance-per-level`% chance to re-roll an egg pull and keep the better rarity.
* `type: status` — each level adds `chance-per-level`% chance to pull the linked fusion `status` from eggs (on top of the status's `base-chance`).

```yaml
shiny:
  type: status
  status: shiny
  max-level: 50
  chance-per-level: 0.05
  cost:
    provider: pinnaprison   # or edtools / eddungeons / edprison / edcompanions / auto
    currency: beacons
    amount: 500000
    increase-per-level: 0   # added to the price per bought level
```

Add any number of upgrades — each becomes available to the GUI via `custom-item: {type: upgrade, upgrade: <id>}`. Purchases withdraw asynchronously through the configured provider and are race-safe.