📚Information

Highly optimized, feature-packed, and unique Chat Color plugin.

Revitalize your server’s chat with vibrant and customizable color options! Our Chat Color system allows you to easily configure and apply a wide spectrum of colors to enhance player communication. From bold and bright hues to subtle shades, you can tailor the chat colors to fit your server’s theme and style.

Highlights:

• Unlimited Chat Colors: Design as many chat colors as you want at ease!

• HEX Support: All messages and chat colors have support for HEX colors, allowing you to have fully customized colors!

• Custom Chat Color: Players can create their own custom chat colors at ease with their own menu to manage them!

• AbyssChat Support: Hook into AbyssChat at ease with these colors, reducing the bloat in your chat configuration!

• Cross-Server Support: Seamlessly integrate and synchronize custom colors and color profiles across multiple servers.

Short Showcase Video

Need support or have some questions? Visit https://blockm.art or join our Discord server and open a ticket!

PlaceholderAPI Support

You must have PlaceholderAPI installed on your Minecraft Server for these Placeholders to register. You can grab the players current chatcolor, as well as it's name.

• %abysschatcolor_display% — Will return the equipped Chat Color (Example: &b)

• %abysschatcolor_name% — Will return the equipped Chat Color's name (Example: Blue)

Commands

Arguments wrapped in diamonds <arg> are required for the command to run properly. Arguments wrapped in square braces[arg] are treated as optional

Admin Commands (Permission: abysschatcolor.admin)

• /chatcolor reload

  • Reloads the TideChatColor plugin.

• /chatcolor help

  • Sends the admin chatcolor help message.

• /chatcolor givevoucher <player> <amount>

  • Gives the specificed player a custom chatcolor voucher so they can create their own chat colors.

Player Commands (Permission: None unless specified)

• /chatcolor

  • Opens up the Chat Color GUI.

Default Configuration Files

Chat Color Configuration

chatcolors.yml

custom:
  item:
    unequipped:
      material: "ORANGE_STAINED_GLASS_PANE"
      enchanted: false
      name: "&6&l[&e&lUNEQUIPPED&6&l] &eCustom Chat Color"
      lore:
        - "&8Informational Item"
        - "&7"
        - "&6&lINFORMATION:"
        - "&6 * &eStatus: &fUnequipped"
        - "&6 * &ePreview: %color%Hello, I am %player%!"
        - "&7"
    equipped:
      material: "LIME_STAINED_GLASS_PANE"
      enchanted: false
      name: "&2&l[&a&lEQUIPPED&2&l] &aCustom Chat Color"
      lore:
        - "&8Informational Item"
        - "&7"
        - "&2&lINFORMATION:"
        - "&2 * &aStatus: &fEquipped"
        - "&2 * &aPreview: %color%Hello, I am %player%!"
        - "&7"

chatcolors:
  "red":
    chat-color: "&c"
    permission: "tidechatcolor.colors.red"
    items:
      locked:
        material: "RED_STAINED_GLASS_PANE"
        enchanted: false
        name: "&4&l[&c&lLOCKED&4&l] &cRed Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&4&lINFORMATION:"
          - "&4 * &cStatus: &fLocked"
          - "&4 * &cPreview: %color%Hello, I am %player%!"
          - "&7"
      unequipped:
        material: "ORANGE_STAINED_GLASS_PANE"
        enchanted: false
        name: "&6&l[&e&lUNEQUIPPED&6&l] &eRed Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&6&lINFORMATION:"
          - "&6 * &eStatus: &fUnequipped"
          - "&6 * &ePreview: %color%Hello, I am %player%!"
          - "&7"
      equipped:
        material: "LIME_STAINED_GLASS_PANE"
        enchanted: false
        name: "&2&l[&a&lEQUIPPED&2&l] &aRed Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&2&lINFORMATION:"
          - "&2 * &aStatus: &fEquipped"
          - "&2 * &aPreview: %color%Hello, I am %player%!"
          - "&7"
  "orange":
    chat-color: "&6"
    permission: "tidechatcolor.colors.orange"
    items:
      locked:
        material: "RED_STAINED_GLASS_PANE"
        enchanted: false
        name: "&6&l[&e&lLOCKED&6&l] &eOrange Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&6&lINFORMATION:"
          - "&6 * &eStatus: &fLocked"
          - "&6 * &ePreview: %color%Hello, I am %player%!"
          - "&7"
      unequipped:
        material: "ORANGE_STAINED_GLASS_PANE"
        enchanted: false
        name: "&e&l[&6&lUNEQUIPPED&e&l] &6Orange Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&e&lINFORMATION:"
          - "&e * &6Status: &fUnequipped"
          - "&e * &6Preview: %color%Hello, I am %player%!"
          - "&7"
      equipped:
        material: "LIME_STAINED_GLASS_PANE"
        enchanted: false
        name: "&2&l[&a&lEQUIPPED&2&l] &aOrange Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&2&lINFORMATION:"
          - "&2 * &aStatus: &fEquipped"
          - "&2 * &aPreview: %color%Hello, I am %player%!"
          - "&7"
  "yellow":
    chat-color: "&e"
    permission: "tidechatcolor.colors.yellow"
    items:
      locked:
        material: "RED_STAINED_GLASS_PANE"
        enchanted: false
        name: "&e&l[&6&lLOCKED&e&l] &eYellow Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&e&lINFORMATION:"
          - "&e * &6Status: &fLocked"
          - "&e * &6Preview: %color%Hello, I am %player%!"
          - "&7"
      unequipped:
        material: "ORANGE_STAINED_GLASS_PANE"
        enchanted: false
        name: "&e&l[&6&lUNEQUIPPED&e&l] &6Yellow Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&e&lINFORMATION:"
          - "&e * &6Status: &fUnequipped"
          - "&e * &6Preview: %color%Hello, I am %player%!"
          - "&7"
      equipped:
        material: "LIME_STAINED_GLASS_PANE"
        enchanted: false
        name: "&2&l[&a&lEQUIPPED&2&l] &aYellow Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&2&lINFORMATION:"
          - "&2 * &aStatus: &fEquipped"
          - "&2 * &aPreview: %color%Hello, I am %player%!"
          - "&7"
  "green":
    chat-color: "&a"
    permission: "tidechatcolor.colors.green"
    items:
      locked:
        material: "RED_STAINED_GLASS_PANE"
        enchanted: false
        name: "&2&l[&a&lLOCKED&2&l] &aGreen Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&2&lINFORMATION:"
          - "&2 * &aStatus: &fLocked"
          - "&2 * &aPreview: %color%Hello, I am %player%!"
          - "&7"
      unequipped:
        material: "ORANGE_STAINED_GLASS_PANE"
        enchanted: false
        name: "&e&l[&6&lUNEQUIPPED&e&l] &6Green Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&e&lINFORMATION:"
          - "&e * &6Status: &fUnequipped"
          - "&e * &6Preview: %color%Hello, I am %player%!"
          - "&7"
      equipped:
        material: "LIME_STAINED_GLASS_PANE"
        enchanted: false
        name: "&2&l[&a&lEQUIPPED&2&l] &aGreen Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&2&lINFORMATION:"
          - "&2 * &aStatus: &fEquipped"
          - "&2 * &aPreview: %color%Hello, I am %player%!"
          - "&7"
  "blue":
    chat-color: "&9"
    permission: "tidechatcolor.colors.blue"
    items:
      locked:
        material: "RED_STAINED_GLASS_PANE"
        enchanted: false
        name: "&1&l[&9&lLOCKED&1&l] &9Blue Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&1&lINFORMATION:"
          - "&1 * &9Status: &fLocked"
          - "&1 * &9Preview: %color%Hello, I am %player%!"
          - "&7"
      unequipped:
        material: "ORANGE_STAINED_GLASS_PANE"
        enchanted: false
        name: "&9&l[&1&lUNEQUIPPED&9&l] &1Blue Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&9&lINFORMATION:"
          - "&9 * &1Status: &fUnequipped"
          - "&9 * &1Preview: %color%Hello, I am %player%!"
          - "&7"
      equipped:
        material: "LIME_STAINED_GLASS_PANE"
        enchanted: false
        name: "&2&l[&a&lEQUIPPED&2&l] &aBlue Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&2&lINFORMATION:"
          - "&2 * &aStatus: &fEquipped"
          - "&2 * &aPreview: %color%Hello, I am %player%!"
          - "&7"
  "purple":
    chat-color: "&5"
    permission: "tidechatcolor.colors.purple"
    items:
      locked:
        material: "RED_STAINED_GLASS_PANE"
        enchanted: false
        name: "&3&l[&b&lLOCKED&3&l] &bPurple Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&3&lINFORMATION:"
          - "&3 * &bStatus: &fLocked"
          - "&3 * &bPreview: %color%Hello, I am %player%!"
          - "&7"
      unequipped:
        material: "ORANGE_STAINED_GLASS_PANE"
        enchanted: false
        name: "&b&l[&3&lUNEQUIPPED&b&l] &3Purple Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&b&lINFORMATION:"
          - "&b * &3Status: &fUnequipped"
          - "&b * &3Preview: %color%Hello, I am %player%!"
          - "&7"
      equipped:
        material: "LIME_STAINED_GLASS_PANE"
        enchanted: false
        name: "&2&l[&a&lEQUIPPED&2&l] &aPurple Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&2&lINFORMATION:"
          - "&2 * &aStatus: &fEquipped"
          - "&2 * &aPreview: %color%Hello, I am %player%!"
          - "&7"
  "pink":
    chat-color: "&d"
    permission: "tidechatcolor.colors.pink"
    items:
      locked:
        material: "RED_STAINED_GLASS_PANE"
        enchanted: false
        name: "&d&l[&f&lLOCKED&d&l] &dPink Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&d&lINFORMATION:"
          - "&d * &fStatus: &fLocked"
          - "&d * &fPreview: %color%Hello, I am %player%!"
          - "&7"
      unequipped:
        material: "ORANGE_STAINED_GLASS_PANE"
        enchanted: false
        name: "&f&l[&d&lUNEQUIPPED&f&l] &dPink Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&f&lINFORMATION:"
          - "&f * &dStatus: &fUnequipped"
          - "&f * &dPreview: %color%Hello, I am %player%!"
          - "&7"
      equipped:
        material: "LIME_STAINED_GLASS_PANE"
        enchanted: false
        name: "&2&l[&a&lEQUIPPED&2&l] &aPink Chat Color"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&2&lINFORMATION:"
          - "&2 * &aStatus: &fEquipped"
          - "&2 * &aPreview: %color%Hello, I am %player%!"
          - "&7"

Language Configuration

lang.yml

messages:
  no-permission:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou do not have permission to do this."
  invalid-player:
    message:
      enabled: true
      value:
        - "&c&lTech&4&lTide &8&l‣ &7You have specified an &cinvalid player&7."
  invalid-amount:
    message:
      enabled: true
      value:
        - "&c&lTech&4&lTide &8&l‣ &7You have specified an &cinvalid amount&7."
  reloaded:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bThe plugin &3TideChatColor&b has been reloaded in &3%time%ms&b."
  admin-help:
    sound:
      enabled: true
      value: "BLOCK_NOTE_PLING"
      volume: 1
      pitch: 1
    message:
      enabled: true
      value:
        - "&f&m----------------------------------"
        - " "
        - "&b&lTech&3&lTide &7— &bChat Color Admin Help"
        - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
        - " "
        - "&7<> = Required"
        - "&7[] = Optional"
        - " "
        - "&b&lCommands"
        - "&b&l→ &7/chatcolor reload"
        - "&b&l→ &7/chatcolor givevoucher <player> <amount>"
        - "&b&l→ &7/chatcolor"
        - " "
        - "&f&m----------------------------------"
  player-help:
    sound:
      enabled: true
      value: "BLOCK_NOTE_PLING"
      volume: 1
      pitch: 1
    message:
      enabled: true
      value:
        - "&f&m----------------------------------"
        - " "
        - "&b&lTech&3&lTide &7— &bChat Color Help"
        - "&7&oCarefully crafted with expertise by &f&oindustry leaders&7&o."
        - " "
        - "&7<> = Required"
        - "&7[] = Optional"
        - " "
        - "&b&lCommands"
        - "&b&l→ &7/chatcolor"
        - " "
        - "&f&m----------------------------------"
  no-permission-color:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou do not have permission to use the color %color%."
  voucher-given:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou have gave a voucher to %player%!"
  voucher-received:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou have received %amount%x chat color voucher(s)!"
  chatcolor-creation-started:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou have started you &fcustom&b chat color creation! Please"
        - "&btype your color in chat! Type `cancel` to cancel!"
  color-removed:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou have unselected the &f%color%&b color!"
  color-selected:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou have selected the &f%color%&b color!"
  no-custom-colors:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou do not have any custom chat colors!"
  invalid-custom-color:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bPlease enter a &fvalid&b chat color!"
  custom-color-created:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou have created a &fcustom&b chat color!"
  creation-cancelled:
    message:
      enabled: true
      value:
        - "&3&lTech&b&lTide &8‣ &bYou have cancelled your chat color creation!"

Menus Configuration

menus.yml

menus:
  main-menu:
    title: "&8&nChat&r &8&nColor&r &8&nMenu"
    rows: 3
    borders:
      "grey":
        material: "BLACK_STAINED_GLASS_PANE"
        name: " "
        lore: [ ]
        slots:
          - "0-26"
    items:
      info:
        slot: 13
        material: "END_CRYSTAL"
        name: "&4&l[&c&l!&4&l] &cChat Color Info"
        lore:
          - "&8Menu Item"
          - "&7"
          - "&c&lINFORMATION"
          - "&4 * &cCurrent Chat Color: &f%type%"
          - "&7"
      default-colors:
        slot: 11
        material: "YELLOW_DYE"
        name: "&6&l[&e&l!&6&l] &eDefault Chat Colors"
        lore:
          - "&8Menu Items"
          - "&7"
          - "&e&lINFORMATION"
          - " &6 * &eChat Colors: &f%colors%"
          - "&7"
      custom-colors:
        slot: 15
        material: "NAME_TAG"
        name: "&2&l[&a&l!&2&l] &aCustom Chat Colors"
        lore:
          - "&8Menu Items"
          - "&7"
          - "&a&lINFORMATION"
          - " &2 * &aChat Colors: &f%custom-colors%"
          - "&7"
  chatcolor-menu:
    title: "&8&nSelect&r &8&nChat&r &8&nColor"
    rows: 3
    slots: [10,11,12,13,14,15,16]
    borders:
      "grey":
        material: "BLACK_STAINED_GLASS_PANE"
        name: " "
        lore: [ ]
        slots:
          - "0-26"
    items:
      current-page:
        slot: 22
        material: "COMPASS"
        name: "&8&lCurrent &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
      next-page:
        slot: 24
        material: "SPECTRAL_ARROW"
        name: "&8&lNext &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
      previous-page:
        slot: 20
        material: "TIPPED_ARROW"
        potion-type: "INSTANT_HEAL"
        hide-flags: true
        name: "&8&lPrevious &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
  custom-chatcolor-menu:
    title: "&8&nCustom&r &8&nChat&r &8&nColors"
    rows: 3
    slots: [10,11,12,13,14,15,16]
    borders:
      "grey":
        material: "BLACK_STAINED_GLASS_PANE"
        name: " "
        lore: [ ]
        slots:
          - "0-26"
    items:
      current-page:
        slot: 22
        material: "COMPASS"
        name: "&8&lCurrent &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
      next-page:
        slot: 24
        material: "SPECTRAL_ARROW"
        name: "&8&lNext &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"
      previous-page:
        slot: 20
        material: "TIPPED_ARROW"
        potion-type: "INSTANT_HEAL"
        hide-flags: true
        name: "&8&lPrevious &7&lPage &8(&f%page%&8)"
        lore:
          - "&8Informational Item"
          - "&7"
          - "&8&lINFORMATION:"
          - "&7- &8&lPage: &f%page%"
          - "&7"

Settings Configuration

settings.yml

command:
  permission: "chatcolor.admin"
  base-command: "chatcolor"
  aliases:
    - "chatcolors"
    - "colors"
    - "tidechatcolors"
  sub-commands:
    "reload":
      base-alias: "reload"
      aliases:
        - "reloadconfig"
    "help":
      base-alias: "help"
      aliases:
        - "?"
    "givevoucher":
      base-alias: "givevoucher"
      aliases:
        - "customcolorvoucher"

custom-color-voucher:
  material: "BELL"
  name: "&3&l[&b&l!&3&l] &bCustom Chat Color Voucher &8(&7Right-Click&8)"
  lore:
    - "&8Redeemable Item"
    - "&7"
    - "&bInformation"
    - "&b&l→ &7Action: &fRight-Click"
    - "&b&l→ &7Usage: &fCustom Chat Color Creation!"
    - "&7"

Storage Configuration (Cross-Server Profile Support with SQL)

storage.yml

storage:
  type: "JSON" # JSON | SQL
  host: 0.0.0.0
  username: "username"
  password: "password"
  database: "database"
  port: 3306