DOCS berries.games ↗

Messages & sounds

Every message is in lang.yml. Change the wording, colours, where it shows and what it sounds like, or turn it off.

Message format

A message can be one line of chat:

no-permission: "<prefix>&cYou don't have permission to do that."

or any mix of chat, action bar, title, subtitle and sound:

teleported:
  chat: "<prefix>Whoosh! You landed at &f<x>, <y>, <z> &7in <world>&7."
  title: "<world>"
  subtitle: "&7<x>, <y>, <z>"
  times: [5, 40, 10]                     # title fade-in, stay, fade-out (ticks)
  sound: ENTITY_ENDERMAN_TELEPORT 1 1    # sound, volume, pitch

chat can also be a list of lines. Set a message to "" to send nothing.

Colours

Both styles work, even mixed in one line:

Style Example
Classic codes &a green, &l bold, &n underline, &r reset
Hex &#FF4D6D
MiniMessage <green>, <bold>, <#FF4D6D>, <gradient:#ff0000:#00ff00>text</gradient>

Sounds

Any vanilla sound name from the Paper sound list, e.g. ENTITY_PLAYER_LEVELUP, or a sound key like entity.player.levelup, or a resource-pack sound like mypack:rtp.whoosh. Add volume and pitch after it. An unknown sound name is reported in the console once, at load.

Placeholders in messages

Every message can use <prefix> and <player>, plus PlaceholderAPI placeholders. The comment above each message in lang.yml lists its own placeholders, such as <time>, <world> or <x> <y> <z>.

<player_head> shows that player's head right in the chat line (Minecraft 1.21.9 and newer; on older servers it simply shows nothing). The queue announcement uses it by default.

Time format

time:
  hours: "<value>h"
  minutes: "<value>m"
  seconds: "<value>s"
  separator: " "
  ready: "&aReady"       # <cooldown_left> when there's no cooldown
  none: "None"           # <cooldown> when a world has none
  free: "Free"           # <cost> when RTP is free

All messages

Key When
prefix Used as <prefix>
no-permission, players-only Missing permission / console used a player command
reloaded, reload-failed /rtp reload
unknown-world, world-disabled, unknown-player Bad command input
usage-rtp, usage-rtp-admin, usage-queue Command help
cooldown, already-teleporting Can't RTP right now (sent at most once a second, so spamming /rtp doesn't flood chat)
in-combat, in-combat-plugin Blocked by the PvP tag / by a combat plugin
not-enough-money, paid Costs, when economy is on
warmup-start, warmup-tick Warmup started / each second of it
warmup-cancelled-move, warmup-cancelled-damage, warmup-cancelled-death Warmup cancelled (teleporting away counts as moving)
searching Only if the spot isn't ready yet
teleported, no-safe-spot, teleport-failed Landed / no spot found / another plugin blocked the teleport (nothing is charged)
sent-other To the admin using /rtp send
queue-disabled, queue-unknown-world, queue-cooldown Can't queue
queue-joined, queue-switched, queue-already, queue-left, queue-not-in, queue-left-world-change Joining and leaving
queue-broadcast To everyone (including the player, with broadcast-to-self), if broadcast-join is on
queue-waiting The "In queue" action bar
queue-match-found, queue-countdown Match found / countdown
queue-cancelled-left, queue-cancelled-move, queue-failed Match called off
queue-teleported Extra message when a match lands

Translating

Translate the text in lang.yml and keep the <placeholders> as they are. A message missing from your file falls back to the English default, so updates never break a translated file.