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

# Messages

Every player-facing message lives in `messages.yml`. Colors support standard `&` codes plus hex (`&#RRGGBB`). Reload with `/momentum reload`.

## Single messages

| Key                | Shown when                                               |
| ------------------ | -------------------------------------------------------- |
| `prefix`           | Prepended to most messages.                              |
| `no-permission`    | A player lacks the required permission.                  |
| `players-only`     | A console runs a player-only subcommand.                 |
| `player-not-found` | The target of an admin subcommand is offline. `{player}` |
| `reloaded`         | `/momentum reload` finishes.                             |
| `reset-done`       | `/momentum reset <player>` finishes. `{player}`          |
| `level-set`        | `/momentum setlevel` finishes. `{player}` `{level}`      |
| `blocks-added`     | `/momentum addblocks` finishes. `{player}` `{blocks}`    |
| `toggle-on`        | The boss bar is shown again via `/momentum toggle`.      |
| `toggle-off`       | The boss bar is hidden via `/momentum toggle`.           |

## Chat lines

**`level-up-chat`** — sent on every level-up. Placeholders: `{level}`, `{multiplier}`. Set to `''` to disable (titles/sounds/particles are configured per level in `config.yml`).

**`lost-chat`** — sent when momentum is fully lost. Placeholders: `{reason}`. Set to `''` to disable.

## Loss reasons

The `reasons:` map provides the text used for `{reason}` in the boss bar and `lost-chat`:

```yaml
reasons:
  idle: 'Stopped mining'
  death: 'You died'
  teleport: 'Teleported out of the mine'
  logout: 'Logged out'
```

## Multi-line blocks

**`help`** — the list of commands shown by `/momentum help`.

**`stats`** — the panel shown by `/momentum` or `/momentum stats`. Available placeholders: `{level}`, `{max_level}`, `{multiplier}`, `{progress}`, `{required}`, `{percent}`, `{time}`, `{blocks}`, `{record_level}`, `{record_time}`, `{record_blocks}`.