> 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/getting-started/messages.md).

# Messages

Every chat message lives in `messages.yml`, grouped by feature:

| Section                              | Covers                                                    |
| ------------------------------------ | --------------------------------------------------------- |
| `main`                               | help, reload, permission/usage errors                     |
| `pets`                               | activate/deactivate, slots, cooldowns, level-ups, toggles |
| `candy`, `boxes`, `scrolls`, `runes` | item gives + applications                                 |
| `upgrades`                           | purchases, refunds, toggles                               |
| `fusion`, `bin`                      | results + selection errors                                |
| `boosts`, `enhancements`, `mastery`  | rolls + prestige                                          |
| `presets`                            | loadout actions + chat prompts                            |
| `backpacks`                          | storing/taking candy, backpack upgrades                   |
| `admin`, `listpets`                  | admin command feedback                                    |

## Format

* A value can be a **string or a list** (lists send multiple lines).
* Color codes: legacy `&a` and hex `&#RRGGBB`.
* **PlaceholderAPI** placeholders work in every message.
* `{token}` placeholders are message-specific (e.g. `{pet}`, `{level}`, `{amount}`) — each default shows which tokens it supports.

```yaml
pets:
  level-up: '&2&l[!] &aYour {pet} &aleveled up to &7[Lvl. {level}]&a!'
```

Per-currency command messages (balance/give/take/pay) live in the currency's own file under `currencies/` — see [Currencies](/p/edpets/core/currencies.md).