Messages and language

Editing the plugin's player-facing text.

2 min read 335 words

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:

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.