Designing Your Chat

To begin customizing your chat appearance, navigate to the ChatDesign.yml configuration file located in Plugins/UniversalChat/

In the ChatFormat section, the "default" rank is pre-configured (but is changeable). To customize the chat for different ranks, add your own rank name from LuckPerms. For example, if you have a "VIP" rank in LuckPerms, it would look like this:

Built in placeholders

?playername

This will be replaced with the actual players name.

?playermessage

This will be replaced with the actual players message.

Using PlaceholderAPI

If you would like to show a players balance in chat for example, you would use PlaceholderAPI. It uses the same format as the built in placeholder, for example, if you want to show the balance of each player in the chat for the "default" rank, you would type this:

ChatFormat:
  default: <bold>[?luckperms_prefix] [Balance: ?vault_eco_balance] ?playername<blue> >> <white>?playermessage

Using Colors

Using the format <color> you can add color to a certain part of a chat message, for example if you want to make the players name blue, and the chat message white, here is what you would do:

ChatFormat:
  default: <blue>?playername: <white>?playermessage

Available colors and formatting:

<dark_blue>
<dark_green>
<dark_aqua>
<dark_red>
<dark_purple>
<gold>
<gray>
<dark_gray>
<blue>
<green>
<aqua>
<red>
<light_purple>
<yellow>
<white>
<bold>
<strikethrough>
<underline>
<italic>
<reset>
<magic> <- This tag requires Universal Chat 1.6.0 Beta 1 or later

Using Gradients

Gradients require Universal Chat 1.12.0 Beta 1 or later

The following format is used for gradients

<GRADIENT:#CODE> </GRADIENT:#CODE> Example:

ChatFormat:
default: <GRADIENT:#4accff>[PLAYER] ?playername</GRADIENT:#924aff> >> ?playermessage

Chat Themes

Chat Themes require Universal Chat 16.0 Beta 3 or later

What ChatThemes does

The ChatThemes section defines different styles for chat messages. Each theme changes how a player’s name, group, and message appear in chat.

• Each theme has a unique name, like Aqua, Ember, or Galaxy.

• Each theme has a Format, which tells the plugin how to display the chat message.

---

Preset Chat Themes

ChatThemes:
  Aqua:
    Format: <gradient:#00ffff:#00ff00>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Ember:
    Format: <gradient:#ff4500:#ffae42>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Oceanic:
    Format: <gradient:#1e90ff:#00ced1>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Radiant:
    Format: <gradient:#ffff00:#ffd700>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Mystic:
    Format: <gradient:#8a2be2:#da70d6>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Inferno:
    Format: <gradient:#ff0000:#ff8c00>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Emerald:
    Format: <gradient:#00ff7f:#006400>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Frostbite:
    Format: <gradient:#00f5ff:#1e3cff>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Twilight:
    Format: <gradient:#191970:#8b008b>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Sunset:
    Format: <gradient:#ff7e5f:#feb47b>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Glacier:
    Format: <gradient:#b3ffff:#80dfff>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Obsidian:
    Format: <gradient:#0f0f0f:#434343>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Dawn:
    Format: <gradient:#ff9a9e:#fad0c4>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Royal:
    Format: <gradient:#4169e1:#6a5acd>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Verdant:
    Format: <gradient:#adff2f:#228b22>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Crimson:
    Format: <gradient:#ff2400:#b22222>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Starfall:
    Format: <gradient:#00c6ff:#0072ff>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Phoenix:
    Format: <gradient:#ff512f:#dd2476>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Celestial:
    Format: <gradient:#00c9ff:#92fe9d>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Eclipse:
    Format: <gradient:#232526:#414345>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Blossom:
    Format: <gradient:#ffb6c1:#ff69b4>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Prism:
    Format: <gradient:#ff5f6d:#ffc371>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Shadow:
    Format: <gradient:#2c3e50:#000000>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Aurora:
    Format: <gradient:#00c6ff:#f7797d>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Solar:
    Format: <gradient:#f7971e:#ffd200>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Storm:
    Format: <gradient:#4b6cb7:#182848>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Horizon:
    Format: <gradient:#ff9966:#ff5e62>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Neon:
    Format: <gradient:#39ff14:#00ffff>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

  Galaxy:
    Format: <gradient:#0f2027:#203a43:#2c5364>[?luckperms_primary_group_name] ?playername >></gradient><white><bold> ?playermessage

Translation Design

This feature requires Universal Chat 16

  Translation: <blue><bold>[?playername] -> ?translatedmessage
  ServerConnectorTranslation: <blue><bold>[?servername] [?playername] -> ?translatedmessage

• Translation: Change the look of the translation message that is sent (placeholders: ?playername ?translatedmessage or any placeholderAPI placeholder using the ? syntax)

• ServerConnectorTranslation: Change the look of the translation message that is sent across other servers that use Server Connector (placeholders: ?servername ?playername ?translatedmessage or any other placeholderAPI placeholder using the ?syntax)