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.