Configuration

ChatColor uses multiple YAML files to keep settings, colors, patterns, and messages organized and easy to customize.

config.yml

This file controls general settings and the titles used in the plugin's graphical user interface.

gui:
  main-menu-title: "<gradient:blue:aqua><bold>ChatColor"
  color-selector-title: "<aqua><bold>Solid Colors"
  gradient-selector-title: "<gradient:red:blue><bold>Gradients"
  pattern-selector-title: "<rainbow><bold>Patterns"

settings:
  apply-to-message: true   # Whether to apply colors to chat messages
  apply-to-name: false     # Whether to apply colors to the player's display name
  default-color: "NONE"    # The default color for new players
  event-priority: "LOWEST" # The listener priority for the chat event

---

colors.yml

This file defines all your solid colors and gradients. You can add as many as you'd like!

Solid Colors Example:

colors:
  red:
    display-name: "Red"
    tag: "<red>"
    permission: "chatcolor.color.red"
    icon: "RED_WOOL"

Gradients Example:

gradients:
  sunset:
    display-name: "Sunset"
    tag: "<gradient:#FF4500:#FF8C00:#FFD700>"
    permission: "chatcolor.gradient.sunset"
    icon: "ORANGE_WOOL"

---

patterns.yml

Patterns cycle colors character-by-character throughout the message.

patterns:
  rainbow:
    display-name: "Rainbow"
    permission: "chatcolor.pattern.rainbow"
    icon: "YELLOW_WOOL"
    colors:
      - "<red>"
      - "<gold>"
      - "<yellow>"
      - "<green>"
      - "<aqua>"
      - "<blue>"
      - "<light_purple>"

---

messages.yml

All plugin messages can be fully customized with MiniMessage formatting.

prefix: "<dark_gray>[<gradient:blue:aqua>ChatColor<dark_gray>] "
color-applied: "<prefix><green>Color <reset><color> <gray>has been applied!"
color-reset: "<prefix><gray>Your chat color has been <red>reset<gray>."