# Messages and language

URL: https://greenarrowlol.github.io/TNTGamesCore/docs/configuration/messages/
Section: configuration
Description: Editing the plugin's player-facing text.

---

> For a complete page index, fetch https://greenarrowlol.github.io/TNTGamesCore/llms.txt.

How to change the text players see.

Every player-facing message lives in `messages.yml`. Edit the values, then run `/tt reload` to apply them. The plugin ships with English text only; to translate it, replace the values with your language.

## The prefix

Most messages start with a shared prefix:

```yaml
prefix: '&8[&#FFD700TNT Games&8] &r'
```

Messages include `{prefix}`, which is replaced with the value above. Change the prefix once and it updates everywhere.

## Placeholders in messages

Messages use curly-brace fields that the plugin fills in. These are not PlaceholderAPI placeholders; they are specific to each message. Common ones:

| Field | Filled with |
| --- | --- |
| `{prefix}` | The shared prefix. |
| `{player}` | A player name. |
| `{arena}` | An arena name. |
| `{time}` | A time value, usually seconds. |
| `{current}` / `{max}` | Current and maximum players. |
| `{count}` | A number, for example players remaining. |

Keep the field names as they are. The plugin looks for those exact names.

## How the file is grouped

`messages.yml` is split into sections so related lines sit together:

| Section | Covers |
| --- | --- |
| Top level | Permissions, arena join and leave, game start, win, elimination. |
| `tnt-run` | Floor-breaking messages. |
| `tnt-tag` | Tagger, tagged, explosion, and round messages. |
| `bow-spleef` | Shooting and falling messages. |
| `setup` | Confirmations shown while building an arena. |
| `errors` | Invalid input and setup errors. |
| `broadcasts` | Waiting and countdown broadcasts. |

## Colour and formatting

Messages support `&` colour codes and hex colours as `&#RRGGBB`. Titles and subtitles are separate keys, so you can style the on-screen title differently from the chat line.

:::{warning}
Do not change `messages-version` at the bottom of the file. The plugin uses it to update older message files.
:::

## Related

- [Configuration](/docs/configuration/configuration/)
- [Scoreboards and stats](/docs/features/scoreboards-and-stats/): scoreboard text lives in `scoreboard.yml`.