Message Customisation Reference (advanced/messages/)¶
User-facing and console-facing messages in RTP are organised across categorical message files located in advanced/messages/. Edit these files to reword, recolour, or rebrand any message.
Updating Messages¶
You can update messages through:
1. In-game admin menu: Run /rtp admin or /rtp menu -> click Messages.
2. Command line: Use /rtp config messages <key>=<value>.
3. Direct editing: Edit files under advanced/messages/ on disk and run /rtp reload.
📎 See IN_GAME_CONFIG.md for full menu and command navigation details.
Message Files¶
| File | Contents |
|---|---|
player.yml |
Player-facing teleport flow: delay, arrival, cancel, cooldown, lockout, queue notifications, economy cost/failure. |
commands.yml |
Command descriptions, help entries, command-line parameter error messages, and menu interface rows. |
system.yml |
System notices: reload, startup/shutdown, permissions, admin inspection, and administrative audit logs. |
network.yml |
Multi-server and proxy network teleport messages, routing notices, and cross-server queue messages. |
placeholders.yml |
Shared placeholder definitions and time unit formatting. |
Formatting¶
Message values accept, in any combination:
| Form | Example | Notes |
|---|---|---|
| Bukkit legacy color codes | &a, &e, &c |
Supported on every platform. |
| Hex color codes | #2636ef |
|
| MiniMessage tags | <gradient:#5e4fa2:#f79459>, <rainbow>, <#rrggbb> |
Full support on Paper/Folia. On Spigot, gradient/rainbow/transition are expanded to per-character hex; other tags are stripped by the legacy pipeline. |
| PlaceholderAPI placeholders | %player_name% |
Resolved only when PlaceholderAPI is installed. |
Placeholders¶
- Shared
[Pn]placeholders are defined in theplaceholders:list insideadvanced/messages/placeholders.yml. Every[Pn]placeholder corresponds to the entry at indexnof that list ([P0]is the 0th item,[P1]is the 1st item, and so on). - Per-message placeholders (e.g.
[attempts],[world],[delay],[remainingCooldown],[money],[spot],[filename]) are documented in comments directly above each message that uses them. Only the placeholders listed for a given key are substituted in that message. - External & addon placeholders: For PlaceholderAPI (
%rtp_<key>%, such as%rtp_delay%,%rtp_remainingCooldown%,%rtp_queued%,%rtp_player_status%), see COMMANDS.md - PlaceholderAPI Placeholders. For GUI menu lore placeholders ({status},{cooldown},{uses},{price},{region},{world}inaddons/guimenu.yml), see CUSTOM_ITEMS.md - Template Placeholders. For action step tokens ([player],[x],[y],[z],[world],[region]), see ACTIONS.md - Available Tokens & Placeholders.
Web Editor Apply Messages (commands.yml)¶
Feedback sent to the operator running /rtp editor apply token=<token>.
| Key | Sent when | Placeholders |
|---|---|---|
editorApplyUsage |
The command has no token, or the token is malformed. | - |
editorApplyFetching |
The token was accepted and the payload lookup started. | - |
editorApplyValidating |
The payload arrived and its checksum and syntax are being checked. | - |
editorApplySuccess |
The payload was written (with .bak copies of changed files) and the configs hot-reloaded. |
- |
editorApplyFailed |
Fetching, validating or applying the payload failed. | [reason] |
editorApplyDigestMissing |
A byte-store payload has no sha256 checksum, so it was refused. |
- |
editorApplyFileUnreadable |
The offline drop file (editor/<token>.json) could not be read; the byte store is tried next. |
[reason] |
editorApplyRejected |
The configuration checks (BIT.md) found an ERROR in the edited files, so nothing was written and the running config is kept. |
[count] error count; [code], [source], [path] of the first error |
Reload Messages (system.yml)¶
Feedback sent to the sender of /rtp reload (and /rtp reload <file>). reloadRejected is also sent when Hot-Apply, /rtp config, a prefab, setup or a config import would produce a config that fails the checks.
| Key | Sent when | Placeholders |
|---|---|---|
reloading |
The reload started. | [filename] |
reloaded |
The reload finished and the new config is active. | [filename] |
alreadyReloading |
A reload was started while another reload is already in progress. | - |
reloadFailed |
The reload threw an error. The cause is logged at SEVERE in the server log. |
- |
reloadRejected |
The configuration checks (BIT.md) found an ERROR; nothing was swapped and the running config is kept. Run /rtp test subsystem=config for the full list. |
[count] error count; [code], [source], [path] of the first error |
Useful UI Glyphs & Icons¶
RTP menus, prompts, and message configurations utilize decorative glyphs and icons to deliver an intuitive, polished in-game interface. Because messages may be displayed both in-game and on the server terminal, consider the target medium when selecting glyphs:
- In-Game Client Displays (Book Menus, Chat, Titles, Boss Bars, Action Bars): Rendered natively by the Minecraft client font engine across all operating systems. Unicode symbols and emojis display cleanly.
- Console-Facing Messages (Logs, Startup, Console Command Feedback, Background Tasks): Displayed in the server host terminal. On Windows servers running legacy OEM code pages (such as Code Page 437 / CP437), multi-byte UTF-8 glyphs can result in mojibake (e.g.,
»rendering as┬╗). For messages that output to the console (such asscanStatus), use console-safe ASCII alternatives (>,-,|). - Book Menu Color Contrast: Adventure / Paper
Bookpages render on parchment-yellow backgrounds. Never combine glyphs with yellow (&e,&6) or white (&f) in book pages. Use dark high-contrast colors like#3E6B45(green),#1F6FB2(blue),#7A4FB8(purple),&0(black), or&8(dark gray). Chat messages (SendMessage) are exempt.
Glyph Reference Table¶
| Glyph | Unicode | Name / Meaning | Recommended Context | Console Safe? | ASCII Alternative | Notes & Best Practices |
|---|---|---|---|---|---|---|
» |
U+00BB |
Right double angle quote | Menu dividers, section headers | No | > |
Used in /rtp menu section dividers (menuFrontPageSectionTeleport). Avoid in console logs. |
« |
U+00AB |
Left double angle quote | Previous page, return button | No | < |
Used in paginated menus (menuPagePrev, menuAdminPanelRowBack). |
▶ |
U+25B6 |
Black right-pointing triangle | Action row, execute button | No | > |
Standard row bullet for clickable menu actions (menuAdminPanelRowConfig). |
◀ |
U+25C0 |
Black left-pointing triangle | Previous action, back button | No | < |
Alternative back/previous arrow for compact navigation. |
▲ |
U+25B2 |
Black up-pointing triangle | Ascend, scroll up, increment | No | ^ |
Useful for multi-page scroll up or incrementing numeric values. |
▼ |
U+25BC |
Black down-pointing triangle | Descend, scroll down, dropdown | No | v |
Useful for sub-menus and numeric decrement controls. |
→ |
U+2192 |
Rightwards arrow | Transition, dispatch, redirect | No | -> |
Indicates teleport routing or setting flow (e.g., spawn -> wilderness). |
← |
U+2190 |
Leftwards arrow | Return, source location | No | <- |
Indicates origin or previous state. |
↔ |
U+2194 |
Left-right arrow | Bidirectional sync, range | No | <-> |
Suitable for range displays (e.g., min/max radius bounds). |
\| |
U+007C |
Vertical line / pipe | Delimiter, column separator | Yes | \| |
Universal delimiter for console logs and status lines (scanStatus). |
• |
U+2022 |
Bullet | List item separator | No | * |
Ideal for in-game lore lists and sub-options. |
· |
U+00B7 |
Middle dot | Subtle separator, grid dot | No | . |
Used as empty-cell representation in ASCII map visualizers. |
✔ |
U+2714 |
Heavy check mark | Success, enabled, valid | No | [+] or Y |
Indicates active features, passed safety checks, or claim clearance. |
✓ |
U+2713 |
Check mark | Success, completed | No | [+] or v |
Lighter check mark for confirmation notices. |
✖ |
U+2716 |
Heavy multiplication X | Failure, disabled, invalid | No | [-] or X |
Indicates blocked biomes, unsafe blocks, or rejected attempts. |
✗ |
U+2717 |
Ballot X | Cancellation, error | No | [x] |
Indicates cancelled queue requests or failed checks. |
⚙ |
U+2699 |
Gear | Admin panel, configuration | No | * |
Primary title icon for /rtp admin (menuAdminPanelTitle). |
⚡ |
U+26A1 |
High voltage / lightning | Instant teleport, RTP menu | No | ! |
Primary title icon for player /rtp menu (menuRootTitle). |
⌖ |
U+2316 |
Position indicator | Visualizations, coordinates | No | + |
Title icon for operator visualization tools (menuVisualizationsTitle). |
✎ |
U+270E |
Pencil | Custom value input | No | _ |
Prompts player to enter custom parameters in chat (menuTypeValue). |
⌛ |
U+231B |
Hourglass | Cooldown, delay, ETA | No | T |
Represents active cooldowns or teleport warmup delays. |
⏳ |
U+23F3 |
Hourglass with flowing sand | Pending task, queue progress | No | ... |
Indicates queue wait time or pipeline processing. |
ℹ |
U+2139 |
Information source | Info notice, command tip | No | i |
Header for /rtp info summaries and general tips. |
❓ |
U+2753 |
Question mark | Help menu, unknown state | No | ? |
Row icon for /rtp help (menuFrontPageRowHelp). |
⚠ |
U+26A0 |
Warning sign | Diagnostic caution, notice | No | ! |
Warnings for costly diagnostics (menuAdminPanelHoverDiagnostics). |
⛔ |
U+26D4 |
No entry | Lockout, restricted region | No | X |
Indicates permission denied or world border lockdown. |
🔒 |
U+1F512 |
Closed lock | Permission required, claim | No | [L] |
Indicates a region requiring special permission nodes. |
🔓 |
U+1F513 |
Open lock | Public access, unlocked | No | [U] |
Indicates unrestricted or claim-bypassed areas. |
🎲 |
U+1F3B2 |
Game die | Random teleportation | No | * |
Primary action icon for instant teleport (menuFrontPageRowTeleport). |
🌍 |
U+1F30D |
Globe (Europe-Africa) | Region selector | No | @ |
Menu row icon for picking a region (menuFrontPageRowRegion). |
🌐 |
U+1F310 |
Globe with meridians | World selector, network mode | No | @ |
Menu row icon for world selection (menuFrontPageRowWorld). |
🌳 |
U+1F333 |
Deciduous tree | Biome selector | No | Y |
Menu row icon for biome selection (menuFrontPageRowBiome). |
⛏ |
U+26CF |
Pickaxe | Mining / resource world | No | / |
Ideal for resource/mining world presets in custom menus. |
⚔ |
U+2694 |
Crossed swords | Combat, PvP arena | No | x |
Used for PvP or danger-tier zone labels. |
🛡 |
U+1F6E1 |
Shield | Protection, safe landing | No | [S] |
Indicates claim protection or invulnerability period. |
💰 |
U+1F4B0 |
Money bag | Economy cost, fee | No | $ |
Displays transaction costs when Vault economy is enabled. |
█ |
U+2588 |
Full block | 100% bar fill, solid cell | No | # |
Progress bars or dense spatial memory map cells. |
▓ |
U+2593 |
Dark shade | 75% fill, high fail rate | No | + |
High-density heatmap / scan status indicator. |
▒ |
U+2592 |
Medium shade | 50% fill, medium fail rate | No | = |
Moderate-density heatmap / scan status indicator. |
░ |
U+2591 |
Light shade | 25% fill, low fail rate | No | - |
Low-density heatmap / scan status indicator. |
■ |
U+25A0 |
Black square | Solid badge, checkbox (checked) | No | [X] |
Sub-menu badge or option indicator. |
□ |
U+25A1 |
White square | Empty badge, checkbox (open) | No | [ ] |
Inactive sub-menu badge or unfilled option indicator. |
§ |
U+00A7 |
Section sign | Minecraft internal format code | No | & |
Used internally by the engine; use & or #RRGGBB in configs. |
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 unless optimizing a console-facing string for legacy terminal compatibility. See the Useful UI Glyphs & Icons table above.
- Never change
version- it is used internally for config migration.