SwornHeroWiki
Messages

Formatting

Placeholder API Simplified Text Format examples for greeting messages.

Dynamic Join Greetings renders message lines with Placeholder API Simplified Text Format.

Official reference: Placeholder API text format.

Not MiniMessage

Versions before 1.0.2+26.2 used Adventure MiniMessage. Current releases use Placeholder API Simplified Text Format. Do not mix the two syntaxes.

Common tags

<gold>Gold text</gold>
<#FFAA00>RGB text</#FFAA00>
<red><bold>Bold red text</bold></red>
<italic>Italic text</italic>
<underline>Underlined text</underline>
<reset>Clears active formatting
<gradient:#F6C344:#FF8C32>Gradient text</gradient>
<rainbow>Rainbow text</rainbow>

Most tags can be closed with </tag> or </>. An unclosed style continues to the end of the line. Use <reset> when you need to clear all active formatting.

Multi-line formatting

Each array entry is a separate chat line. Formatting does not automatically carry across lines unless you repeat tags:

{
  "id": "formatted_multiline",
  "weight": 1.0,
  "lines": [
    "<gold><bold>Welcome back, {player}!</bold></gold>",
    "<gray>Your tools are ready on {server}.</gray>"
  ]
}

Interactive tags

Simplified Text Format can include hover text and click actions. Because configuration files are controlled by server administrators, add interactive tags only to trusted messages.

Validation

/joingreetings reload validates every configured line. Invalid formatting causes the reload to fail and preserves the previously active configuration.

Found a problem in these docs? Report a documentation issue on GitHub.

On this page