Messages
Messages
Create colored, weighted, multi-line greetings with safe placeholders.
Message lines use Placeholder API Simplified Text Format. This is not MiniMessage.
Supported placeholders:
| Placeholder | Replacement |
|---|---|
{player} | Joining or previewing player’s current username |
{server} | Configured serverName |
Placeholder values are escaped before parsing, so usernames cannot inject formatting tags.
Useful examples
Plain greeting
{
"id": "plain",
"weight": 1.0,
"lines": ["Welcome back, {player}!"]
}Colored greeting
{
"id": "colored",
"weight": 1.0,
"lines": ["<green>Welcome back, {player}!</green>"]
}Bold greeting
{
"id": "bold",
"weight": 1.0,
"lines": ["<gold><bold>Welcome to {server}!</bold></gold>"]
}Multi-line greeting
{
"id": "multiline",
"weight": 1.0,
"lines": [
"<gold>Welcome home, {player}.</gold>",
"<gray>It is good to see you again on {server}.</gray>"
]
}Both placeholders
{
"id": "both_placeholders",
"weight": 1.0,
"lines": ["<yellow>{player} has arrived on {server}.</yellow>"]
}Weighted rare greeting
{
"id": "rare",
"weight": 1.0,
"lines": ["<gold><bold>A legendary return!</bold></gold>"]
}Pair it with higher-weight common greetings in the same pool.
Player-only first-time greeting
Use the firstJoin pool with "audience": "PLAYER".
Broadcast returning greeting
Use the returningJoin pool with "audience": "BROADCAST".
Next
Found a problem in these docs? Report a documentation issue on GitHub.