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

# Rarities & Statuses

## Rarities (`rarities.yml`)

Define as many rarities as you want. Egg rolls pick a rarity **weighted by `weight`**, then a companion inside it (weighted by each companion's own `weight`).

```yaml
mythical:
  display-name: '&#996AFFMythical'
  color: '&#8220FF'          # {rarity-color}
  secondary-color: '&#996AFF' # {rarity-color-2}
  weight: 2                  # share of the total (2 / 100 total = 2%)
  order: 4                   # higher = better (used by the Luck upgrade)
```

The default set: basic (50), rare (30), epic (12), legendary (6), mythical (2).

{% hint style="info" %}
The **Luck** upgrade gives a `chance-per-level × level` % chance to roll twice and keep the higher-`order` result.
{% endhint %}

## Statuses (`config.yml` → `statuses:`)

Statuses are the fusion ladder — plain → shiny → rainbow → void by default. Each status:

* multiplies the companion's buff amount (`boost-multiplier`),
* prefixes the companion's name (`name-prefix`),
* can drop straight from eggs (`base-chance` % + the matching status upgrade).

Bulk-delete groups, egg previews and the storage GUI all read rarity/status colors through the `{rarity-*}` and `{status*}` placeholders, so custom rarities need zero code.