Formatting & Placeholders

The channel format defines how chat messages should be formatted. The message content itself is always appended after the formatting. Note that uncleared formatting will persist and apply to the message contents. You can make use of MineDown formatting to use modern (1.16+) hexadecimal colors and easily make use of advanced effects such as gradients. You can embed this formatting within the prefix and suffix contents of LuckPerms groups as well. Within the channel formatting you can make use of the following placeholders to format text.

Regular placeholders

  • %name% - Username
  • %fullname% - LuckPerms prefix, username & LuckPerms suffix
  • %prefix% - LuckPerms prefix
  • %suffix% - LuckPerms suffix
  • %ping% - User’s ping
  • %uuid% - User’s uuid
  • %servername% - Server the user is on
  • %serverplayercount% - Number of players on the server the user is on

Time placeholders

These display the current time

  • %timestamp% - yyyy/MM/dd HH:mm:ss
  • %time% - HH:mm:ss
  • %short_time% - HH:mm
  • %date% - yyyy/MM/dd
  • %british_date% - dd/MM/yyyy
  • %day% - dd
  • %month% - MM
  • %year% - yyyy

Private message placeholders

In private messages, the placeholders are applied to the sender of the message for inbound messages, and the receiver for outbound messages. You can use all placeholders above after the sender_ or receiver_ prefix. (e.g. %sender_(placeholder)% and %receiver_(placeholder)%).

There are additional placeholders for group private messages:

  • %group_amount% (number of members in the group private message)
  • %group_amount_subscript% (number of members in the group private message, in subscript font)
  • %group_members_comma_separated% (comma separated list of members in the group private message)
  • %group_members% (newline separated list of members in the group private message)

The social spy message formatting lets you format both the message sender and receiver with the same placeholders listed above. The sender and receiver are disambiguated with prefixes, so you can use both; i.e. %sender_(placeholder)% and %receiver_(placeholder)%