> For the complete documentation index, see [llms.txt](https://esmp-fun.gitbook.io/plugins/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://esmp-fun.gitbook.io/plugins/mythic-trials/messages-yml.md).

# messages.yml

Every chat-facing string the plugin sends lives here. Edit it, run `/tcpmt reload`, and changes apply immediately.

## Format

MiniMessage syntax throughout — gradients, hover events, click events, the lot. Placeholders use `{name}` style.

```yaml
prefix: "<dark_aqua>[MythicTrials]</dark_aqua> "

command:
  no-permission: "<red>You don't have permission to use this command."
  player-only: "<red>This command must be run by a player."
  unknown-subcommand: "<red>Unknown subcommand:</red> <yellow>{sub}"
  reload-success: "<green>Reloaded MythicTrials config."
  reload-failed: "<red>Reload failed: {error}"

progression:
  tier-up: "<gold>⚔ <yellow>{chamber}</yellow> cleared — you advanced to <gold>{tier}</gold>!"
  mythic-unlocked: "<gradient:#a020f0:#ff55ff>✦ MYTHIC UNLOCKED ✦</gradient> <gray>You broke through to <light_purple>{tier}</light_purple> in <yellow>{chamber}</yellow>!"

reward:
  currency: "<gold>+<yellow>{amount}</yellow> coins"
  key: "<gold>A <yellow>{crate}</yellow> key dropped at your feet!"

# Tier telegraph titles, shown to players inside a chamber when scaled mobs
# first spawn. Not auto-prefixed — they carry their own framing.
announce:
  tier-telegraph-title: "<{color}><bold>⚔ {tier}</bold></{color}>"
  tier-telegraph-subtitle: "<gray>{chamber} — brace yourself!"
```

## Placeholders

| Key                                    | Placeholders                            |
| -------------------------------------- | --------------------------------------- |
| `command.unknown-subcommand`           | `{sub}`                                 |
| `command.reload-failed`                | `{error}`                               |
| `progression.tier-up`                  | `{chamber}`, `{tier}`                   |
| `progression.mythic-unlocked`          | `{chamber}`, `{tier}`                   |
| `reward.currency`                      | `{amount}`                              |
| `reward.key`                           | `{crate}`                               |
| `announce.tier-telegraph-title`        | `{tier}`, `{color}`, `{kind}`           |
| `announce.tier-telegraph-subtitle`     | `{chamber}`, `{tier}`, `{color}`        |
| `announce.chamber-cleared-broadcast`   | `{chamber}`, `{tier}`, `{players}`      |
| `announce.subtitle-spawner-cleared`    | `{completed}`, `{total}`                |
| `announce.hud-idle` / `announce.hud-*` | `{tier}`, `{color}` and per-line values |
| `announce.boss-telegraph-title`        | —                                       |
| `announce.boss-telegraph-subtitle`     | `{seconds}`                             |
| `announce.boss-spawned-title`          | `{name}`                                |
| `announce.boss-spawned-subtitle`       | —                                       |
| `announce.boss-defeated`               | `{chamber}`                             |

`{tier}` renders as a short label — `T8`, `M2`, etc. `{color}` is a MiniMessage colour name chosen by tier (Mythic = `light_purple`, high Standard = `red` / `gold`, low Standard = `yellow`).

## Auto-prefixing

Player-facing keys are automatically prefixed with the `prefix` value, so you get a consistent `[MythicTrials]` lead-in without repeating it. Keys under `gui.` and `announce.` namespaces are *not* prefixed (they carry their own framing).

## Schema check

On startup the plugin compares your `messages.yml` against the keys it expects and logs a single warning listing any that are missing — so a key you accidentally deleted (or one added in an update) doesn't silently fall back without you noticing. Missing keys use the built-in defaults, so the plugin keeps working either way.

## Removing the prefix

Set `prefix` to an empty string (`prefix: ""`) for unprefixed messages.

***

Next: [**Integrations →**](/plugins/mythic-trials/integrations.md)