SwornHeroWiki
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:

PlaceholderReplacement
{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.

On this page