Skip to content

Styling

This module adds chat formatting and limited toggleable Markdown formatting to player chats.

Also you can replace chunks of text with something else.

Players with the solstice.chat.advanced permission node also unlock the full capabilities of the text formatting. See Text Formatting.

Players with solstice.chat.legacy can use legacy color codes (&0&9, &a&f, &k&r) in chat messages.

Players with solstice.chat.activity.silent do not receive join, leave, or death messages.

Configuring

These options can be configured in the styling section of the config file.

enable-markdown

Enable Markdown in chat.

Format

  • bold **bold**
  • italic *italic*
  • underline __underline__
  • strikethrough ~~strikethrough~~
  • Links [URLs](https://example.com) (it shows original URL when hovering over it)
  • quotes `quotes`
  • ||spoilers|| ||spoilers|| (it shows text when hovering over it)

Markdown

welcome-new-players

Send a welcome message to players joining the server for the first time.

replacements

Key-Value-Pair list of words to be replaced in chat.

You can add a replacement by adding a line like this to the list:

"original"="replacement"

Advancement configurations

There are 3 kinds of advancements, called frames: task, challenge, goal.

Advancements

You can read more about them in the Minecraft Wiki.

The advancement titles and descriptions are automatically translated to the client's locale.

advancement-task

Format for task advancements.

Placeholders

  • ${title} - Title of the advancement.
  • ${description} - Description of the advancement.

advancement-challenge

Format for challenge advancements.

Placeholders

  • ${title} - Title of the advancement.
  • ${description} - Description of the advancement.

advancement-goal

Format for goal advancements.

Placeholders

  • ${title} - Title of the advancement.
  • ${description} - Description of the advancement.

Deprecated: chat-format

The chat-format setting is deprecated. If present in your config it will be automatically migrated to chat-formats on next server start and removed.

chat-formats

Chat format per LuckPerms group. The map key is the group name and the value is the format string.

chat-formats {
    default="%player:displayname%<gray>:</gray> ${message}"
    admin="<red>[Admin]</red> %player:displayname%<gray>:</gray> ${message}"
}

Placeholders

  • ${message} - Message after formatting.

The highest-priority group the player belongs to is used. Falls back to default.

Chat message

nameplate-formats

Scoreboard nameplate format per LuckPerms group. Controls the prefix and suffix displayed above players' heads.

nameplate-formats {
    default {
        prefix=""
        suffix=""
    }
}

Warning

Nameplate placeholders are not refreshed frequently. Avoid placeholders that change often.

do-color-nameplate

Whether to color the username part in the scoreboard nameplate. Default: true.

emote-format

Emote format (/me).

join-format

Player join message format.

join-renamed-format

Player join message after changing username.

Placeholders

  • ${previousName} - Previous name of the player.

leave-format

Player leave message format.

death-format

Player death message format.

Placeholders

  • ${message} - The death message, it already contains the player name.

Death

welcome

New player welcome message.