Colors

The chat/colors.yml file defines all the chat colors and gradients that players can choose from in the colors GUI (/colors).

GUI Configuration

Customize the appearance and behavior of the colors selection menu.

  • title: The display name of the GUI. Supports MiniMessage.
  • size: The number of slots in the GUI (must be a multiple of 9).
  • fill: Define background items and their positions.
  • previous-page and next-page: Configuration for the pagination items.
  • reset-item: The item used to reset the player's chat color to the default.

Item Templates

Define how each color item will look in different states (available, selected, or locked).

  • {display_name}: Replaced with the color's display name.
  • {preview_text}: Shows a live preview of how the color will look in chat.
  • {permission}: The permission required to use the color.

Defining Colors

You can add unlimited colors, gradients, and special formatting using MiniMessage.

Example Color:

ocean:
  display-name: "<gradient:#2E3192:#1BFFFF>Ocean Gradient</gradient>"
  material: BLUE_WOOL
  code: "<gradient:#2E3192:#1BFFFF>"
  permission: "solaritychat.color.ocean"
  • display-name: How the color is named in the GUI.
  • material: The Minecraft item used to represent this color.
  • code: The MiniMessage or hex code that will be applied to the player's chat.
  • permission: The permission required for the player to select this color.