Configuration
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------------"
- "�FF11$ &fMoney: �FF11%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| Key | Description |
|---|---|
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) |
emojis | Shortcut and the text it becomes |
clear-lines | How 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.