Messages

messages.yml holds every player- and console-facing string RTP emits. It is the file to edit for wording, color, and formatting changes - read it before requesting formatting support, since most "can I change this text?" questions are answered by a single key here.

Edit on disk and /rtp reload, or change one key at runtime with /rtp config messages <key>=<value>.

Formatting

Message values accept, in any combination:

• Bukkit legacy color codes - e.g. &a, &e, &c.
• Hex color codes - e.g. #2636ef.
• MiniMessage tags - e.g. <gradient:#5e4fa2:#f79459>, <rainbow>, <#rrggbb>.
  • On Paper/Folia all MiniMessage tags are supported.
  • On Spigot, gradient/rainbow/transition tags are expanded to per-character hex codes; other MiniMessage tags are stripped by the legacy pipeline.
• PlaceholderAPI placeholders - resolved when PlaceholderAPI is installed.

Placeholders

• Shared [Pn] placeholders come from the placeholders: list at the top of the file. [P0] is the plugin prefix (a rainbow [RTP] by default) and is reused in nearly every message. Add more entries to the list to define [P1], [P2], etc.
• Per-message placeholders (e.g. [attempts], [world], [delay], [remainingCooldown], [money], [spot]) are documented in a comment directly above each message that uses them. Only the placeholders listed for a given key are substituted in that message.

Layout

The file is divided into commented sections so related strings stay together:

Section	Contents
1. General Configuration	The shared placeholders list.
2. Teleportation	Player-facing teleport flow: delay, success, cancel, cooldown, lockout, no-locations, queue position, not-enough-money.
3. Time Formatting	Unit suffixes for time placeholders (days, hours, minutes, seconds, millis).
4. System & Management	Reload, version, permission-denied, and other management strings.
5. Administrative Logs	Console audit/log lines.
6. Scan Command	/rtp scan progress and result strings.
7. Info Command	/rtp info output.
8 / 8b. Command Descriptions & Menu Framework	Help text and the generalized book/chat menu rows, headers, and dividers.
9. PlaceholderAPI Support	PAPI-specific strings.
10. Visuals	Visualization-related strings.
11. Metadata	Internal version marker (do not change).
12. Developer Options	Developer-facing toggles/strings.

Notes

• Icon glyphs are intentional. Some values embed single-codepoint UI icons (type-a-value, paginator arrows, run/row markers, the section sign). Preserve them verbatim; do not ASCII-fold or delete them.
• Localization. When a non-English locale is active (see language.yml), the translated messages.yml is read from lang/<code>/ instead of this baseline file. Mirror any custom key you add into each locale you ship, or it falls back to English.
• version is an internal config version - do not change it.