> 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/pinnapass/reference/notifications.md).

# Notifications

What players see while they play. Switches and sounds are in `config.yml` → `notifications`, every text in `messages.yml`.

|                                                                                     | config.yml                                     | messages.yml                               |
| ----------------------------------------------------------------------------------- | ---------------------------------------------- | ------------------------------------------ |
| Action bar after earning XP (gains are added up, shown at most every `interval-ms`) | `xp-actionbar.enabled`, `interval-ms`          | `notifications.xp-actionbar`               |
| Action bar when a quest moves (instead of the XP line)                              | `quest-actionbar`                              | `notifications.quest-actionbar`            |
| Boss bar with the tier progress, hidden `seconds` after the last gain               | `bossbar.enabled`, `color`, `style`, `seconds` | `notifications.bossbar`                    |
| Title + sound on a tier up                                                          | `tier-up.title`, `tier-up.sound`               | `titles.tier-up.title` / `subtitle`        |
| Title + sound on a finished quest                                                   | `quest-complete.title`, `quest-complete.sound` | `titles.quest-complete.title` / `subtitle` |
| Sound on a claim                                                                    | `claim-sound`                                  | -                                          |

Default action bar: `&d+{gained} Pass XP &8┃ &fTier {tier} {bar} &7{percent}%`.

Tokens of the XP action bar and boss bar: `{gained}` `{tier}` `{max_tier}` `{xp}` `{needed}` `{percent}` `{bar}` `{infinite_level}`; of the quest action bar: `{quest}` `{progress}` `{goal}` `{percent}` `{bar}`.

`{bar}` is drawn from `messages.yml` → `bar` (`length`, `filled`, `empty`), e.g. `&a▮▮▮▮▮&8▮▮▮▮▮`. Set a text to `''` to turn it off.
