Configuration

yaml
chat:
  formats:
    vip:
      permission: chatcard.format.vip
      format: "%vault_prefix%{player}&7: &#FFE400{message}"
    default:
      permission: ""
      format: "%vault_prefix%{player}&7: &f{message}"
  delete-button: "&c✖ "
  delete-hover: "&cDelete this message"

hover:
  lines:
    - "%luckperms_prefix%%player_name%"
    - "&7------------"
    - "&#00FF11$ &fMoney: &#00FF11%vault_eco_balance_formatted%"
    - "&#A52CF5⭐ &fShards: &#A52CF5%shards%"
    - "&#FF0000🗡 &fKills: &#FF0000%statistic_player_kills%"
    - "&#FFE400⌚ &fPlaytime: &#FFE400%statistic_time_played%"
    - "&#FA7600☠ &fDeaths: &#FA7600%statistic_deaths%"
    - "&7------------"
  click: "/msg %player_name%"

join:
  message: "&8[&a+&8] &7{player}"
  first-join: "<gradient:#FFE400:#FA7600>Welcome</gradient> &f{player} &7to the server!"

quit:
  message: "&8[&c-&8] &7{player}"

death:
  message: "&#FA7600☠ &7{message}"

mentions:
  highlight: "&#FFE400@{name}"
  sound: "entity.experience_orb.pickup"
  volume: 1.0
  pitch: 1.0
  actionbar: "&#FFE400{player} &7mentioned you"

filter:
  cooldown: 1.0
  duplicate-seconds: 30
  caps:
    min-letters: 6
    max-percent: 60
  words:
    - fuck
    - shit
    - ...

emojis:
  ":heart:": "❤"
  ":star:": "★"
  ":skull:": "☠"
  ...

clear-lines: 100
KeyDescription
formats: under chat:Checked from top to bottom. A player gets the first format whose permission they have. An empty permission matches everyone, so keep default last
{player}The player's name with the hover card and the click command. Works in chat formats, join, quit and death messages
{message}The chat message, or the vanilla death message in message: under death:
delete-button: under chat:Shown before every chat message to players with chatcard.delete
lines: under hover:The hover card. Placeholders are filled in for the player whose name it is
click: under hover:The command the clicking player runs. Placeholders are filled in for the player whose name was clicked
first-join: under join:Shown instead of message: under join: the first time a player joins
highlight: under mentions:How a mention looks to the mentioned player. {name} is their name
sound: under mentions:Any Minecraft sound, written as entity.experience_orb.pickup or ENTITY_EXPERIENCE_ORB_PICKUP
actionbar: under mentions:{player} is the player who sent the message
cooldown: under filter:Seconds between two messages of the same player
duplicate-seconds: under filter:The same message again within this many seconds is blocked
caps: under filter:A message with at least min-letters letters and more than max-percent capital letters is made lowercase
words: under filter:Replaced with *. Matches whole words, any case, with repeated letters (shiiit)
emojisShortcut and the text it becomes
clear-linesHow many empty lines /chat clear sends

Set a text to "" to turn it off. That works for join, quit, first-join, death, the delete button, the click command, the mention highlight, sound and actionbar, and every line in messages.yml. lines: [] under hover: turns the hover card off.

Players' own messages never go through PlaceholderAPI, and only get colors with the permissions above. Tags like <click> or <hover> always stay plain text.

Hover card size

Minecraft has no character limit on the hover card. The limit is the player's screen:

  • Lines wrap at half the screen width. On a 1080p screen at the largest GUI scale, that is about 40 characters.
  • A card taller than the screen is cut off. On a 1080p screen at the largest GUI scale, that is about 25 lines.

Keep the card under about 20 lines and it fits on every screen.

Message deletion

The delete button uses Minecraft's own message deletion, which only works on signed chat (online-mode=true with enforce-secure-profile=true, the default). On servers without signed chat, or with a plugin that removes chat signatures, the button is not shown.